polyester-sdk 0.1.0a0__tar.gz

polyester_sdk-0.1.0a0/.env.example

@@ -0,0 +1,31 @@
+POLYESTER_API_KEY_ID=ak_your_key_id_here
+POLYESTER_API_PRIVATE_KEY=your_64_char_ed25519_private_key_hex
+
+# Profile account id (base58) for scoped ledger operations
+POLYESTER_ACCOUNT_ID=your_base58_account_id_here
+
+# Live test tiers (local only — not used in CI)
+# POLYESTER_TEST_MUTATION=1
+# POLYESTER_TEST_FUNDED=1
+# POLYESTER_TEST_TREASURY=1
+# POLYESTER_TEST_SMOKE_SYMBOL=ETH-USDT
+# POLYESTER_TEST_MIN_TRADING_QUOTE=10
+# POLYESTER_TEST_INTERNAL_TRANSFER_DEST=
+# POLYESTER_TEST_SKIP_FUNDING_CHECK=1
+# POLYESTER_TEST_TRADE_E2E=1
+# POLYESTER_TEST_TRADE_SYMBOL=BTC-USDT
+# Optional deterministic maker account for fill e2e (otherwise uses visible devnet asks)
+# POLYESTER_TEST_MAKER_API_KEY_ID=
+# POLYESTER_TEST_MAKER_API_PRIVATE_KEY=
+# POLYESTER_TEST_TRADE_PRICE=500000
+# POLYESTER_TEST_TRADE_QTY=
+
+# Opt-in ledger_write mutation smoke (route may be unmounted on devnet)
+# POLYESTER_TEST_LEDGER_WRITE_SMOKE=1
+
+# Legacy smoke aliases (still supported)
+# POLYESTER_SMOKE_MUTATION=1
+# POLYESTER_SMOKE_SYMBOL=BTC-USDT
+
+# Optional overrides (defaults to devnet)
+# POLYESTER_API_URL=https://api-devnet.polyester.ai

polyester_sdk-0.1.0a0/.gitignore

@@ -0,0 +1,27 @@
+.env
+.env.*
+!.env.example
+
+docs/
+
+.coverage
+.coverage.*
+htmlcov/
+
+*.egg-info/
+*.py[cod]
+__pycache__/
+
+.venv/
+.python-version
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+.tox/
+.nox/
+
+build/
+dist/
+pip-wheel-metadata/
+
+.DS_Store

polyester_sdk-0.1.0a0/CHANGELOG.md

@@ -0,0 +1,29 @@
+# Changelog
+
+## Unreleased
+
+### SDK surface
+- Orders: `batch_create`, `batch_cancel`, `cancel_all_after`; `cancel(symbol=…)` resolves `symbol_id`
+- API keys: `create`, `update`, `delete`
+- Withdraw: `create_wallet_trading_withdraw`
+- Address book: full CRUD, views, whitelist, counterparties
+- New services: `policies`, `sub_accounts`, `guard_signer`
+- `market_overview.create_subscription()` — snapshot-then-stream merge (TS parity)
+
+### Codecs
+- Proto decode migration for balances history/equity/holds, triggers, transfers, deposit, withdraw, internal transfers, api keys, resolve, and public market services
+- `order_mutation_from_proto` handles `CancelOrderResponse` (no `client_order_id` field)
+
+### Testing
+- Restructured `tests/unit`, `tests/integration`, `tests/e2e`, `tests/e2e/funded`
+- Pytest markers: `integration`, `smoke`, `mutation`, `funded`, `treasury`, `optional`, `realtime`
+- `POLYESTER_TEST_TRADE_SYMBOL` for order/trigger mutation (separate from `POLYESTER_TEST_SMOKE_SYMBOL`)
+- Dynamic mutation pricing from `market_overview` (~2% of last trade)
+- `test_orders_get_round_trips_list_open` — proof-style when open orders exist
+- `scripts/test_all.sh` and `scripts/smoke_test.py` (pytest wrapper)
+- CI: `pytest tests/unit` with coverage on non-`gen/` code
+- Full devnet suite documents honest skips for OMS read lag, JWT routes, optional mounts, and account-specific prerequisites
+
+## 0.1.0a0
+
+- Initial alpha release with core trading and market data services.

polyester_sdk-0.1.0a0/LICENSE

@@ -0,0 +1,7 @@
+Copyright (c) Fabric Blockchain Labs Inc.
+
+All rights reserved.
+
+This repository contains generated and handwritten SDK code for the Polyester
+API. No license is granted to copy, modify, distribute, sublicense, or use this
+work except under a separate written agreement with Fabric Blockchain Labs Inc.

polyester_sdk-0.1.0a0/PKG-INFO

@@ -0,0 +1,236 @@
+Metadata-Version: 2.4
+Name: polyester-sdk
+Version: 0.1.0a0
+Summary: Official Python SDK for Polyester APIs.
+Project-URL: Homepage, https://github.com/Fabric-Labs/polyester-sdk-python
+Project-URL: Documentation, https://polyester.ai/docs
+Project-URL: Repository, https://github.com/Fabric-Labs/polyester-sdk-python
+Project-URL: Issues, https://github.com/Fabric-Labs/polyester-sdk-python/issues
+Author: Fabric Blockchain Labs Inc.
+License: Proprietary
+License-File: LICENSE
+Keywords: connectrpc,polyester,protobuf,sdk,trading
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: Other/Proprietary License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: base58>=2.1.1
+Requires-Dist: connectrpc>=0.9.0
+Requires-Dist: cryptography>=42
+Requires-Dist: httpx>=0.27
+Requires-Dist: msgspec>=0.18
+Requires-Dist: protobuf>=7.35.0
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == 'dev'
+Requires-Dist: mypy>=1.13; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-cov>=5; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: python-dotenv>=1.0; extra == 'dev'
+Requires-Dist: ruff>=0.8; extra == 'dev'
+Requires-Dist: twine>=5; extra == 'dev'
+Provides-Extra: realtime
+Requires-Dist: websockets>=15; extra == 'realtime'
+Description-Content-Type: text/markdown
+
+# Polyester Python SDK
+
+Official Python SDK for Polyester APIs, built for trading bots, backend jobs,
+research notebooks, and automation.
+
+**Status:** Alpha (`0.1.0a0`). The repo is **public** (visible on GitHub) under a
+**proprietary** license — not open source. API-key-only; no browser or JWT flows.
+
+Generated protobuf types and ConnectRPC clients live in `src/polyester/gen/` and are
+updated automatically when public API protos change. Hand-written SDK code (client,
+services, models, codecs) lives alongside them under `src/polyester/`.
+
+## Install
+
+Install the SDK from PyPI:
+
+```bash
+pip install "polyester-sdk[realtime]"
+```
+
+For local development from a checkout:
+
+```bash
+cd polyester-sdk-python
+python3.11 -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev,realtime]"
+```
+
+## Authentication
+
+Pass credentials to the client from your app's config or secrets manager:
+
+```python
+from polyester import AsyncPolyester
+
+client = AsyncPolyester(
+    api_key_id="ak_...",
+    api_private_key="...",  # 64-char hex Ed25519 secret or raw 32-byte key
+)
+```
+
+If your app uses environment variables, read them in your application code and pass
+them explicitly:
+
+```python
+import os
+
+from polyester import AsyncPolyester
+
+client = AsyncPolyester(
+    api_key_id=os.environ["POLYESTER_API_KEY_ID"],
+    api_private_key=os.environ["POLYESTER_API_PRIVATE_KEY"],
+    default_account_id=os.getenv("POLYESTER_ACCOUNT_ID"),
+)
+```
+
+For scripts and local tests, `AsyncPolyester.from_env()` and `Polyester.from_env()`
+are convenience helpers that read `POLYESTER_*` from `os.environ`. The plain
+constructor does not implicitly read environment variables.
+
+## Quickstart
+
+```python
+from polyester import AsyncPolyester
+
+async with AsyncPolyester(
+    api_key_id="ak_...",
+    api_private_key="...",
+) as client:
+    overview = await client.market_overview.list(limit=5)
+    for market in overview.markets:
+        print(market.symbol, market.last_price_ticks)
+
+    open_orders = await client.orders.list_open()
+    print(f"{len(open_orders.orders)} open orders")
+```
+
+## Create And Cancel
+
+```python
+from polyester import AsyncPolyester
+
+async with AsyncPolyester(
+    api_key_id="ak_...",
+    api_private_key="...",
+    default_sub_account_id="",
+) as client:
+    result = await client.orders.create(
+        symbol="BNB-USDT",
+        side="buy",
+        order_type="limit",
+        tif="gtc",
+        qty="0.01",
+        price="100",
+        post_only=True,
+        client_order_id="my-bot-001",
+    )
+    print(result.status, result.order_id)
+
+    await client.orders.cancel(client_order_id="my-bot-001")
+```
+
+Use **decimal strings** for `qty` and `price`. Do not pass floats.
+
+## Balances: funding vs trading
+
+Ledger balances expose separate **funding** and **trading** buckets per asset. Spot
+orders spend **trading** balance. Deposits land in **funding** until you move them
+(Funding → Unified Trading in the UI or on-chain via the funding wallet).
+
+- **Funding → trading:** on-chain `TradingGateway.deposit` (not an API-key RPC).
+- **Trading → funding:** `client.trading_withdraws.create_to_funding(...)` with a signed intent payload.
+- **Trading → trading (another account):** `client.internal_transfers.create(...)` or `client.ledger_write.transfer_trading_to_trading(...)`.
+
+Format u128 wire amounts with the public helper (18-decimal scale):
+
+```python
+from polyester import format_ledger_u128
+
+print(format_ledger_u128(balance.funding), format_ledger_u128(balance.trading))
+```
+
+Set `POLYESTER_ACCOUNT_ID` to your profile base58 id (not a raw decimal uint64) for
+bucket transfers.
+
+## Public Market Data
+
+```python
+candles = await client.market_data.get_candles(symbol="BTC-USDT", timeframe="1m", limit=50)
+current = await client.market_data.get_current_candle(symbol="BTC-USDT", timeframe="1m")
+trades = await client.market_data.get_trades(symbol="BTC-USDT", limit=20)
+health = await client.balances.get_health()
+
+async with client.market_data.subscribe_trades(symbol="BNB-USDT") as sub:
+    async for trade in sub:
+        print(trade.price_ticks, trade.qty_scaled)
+        break
+```
+
+Realtime requires `pip install polyester-sdk[realtime]` (websockets).
+
+Merged market overview stream (snapshot + live updates):
+
+```python
+sub = await client.market_overview.create_subscription()
+async for markets in sub:
+    print(len(markets), "rows")
+    break
+await sub.aclose()
+```
+
+## Testing
+
+**CI (no network):** `pytest tests/unit -q`, plus ruff and package build.
+
+**Full local suite:** devnet integration/e2e tests read `.env` in the test harness and pass credentials to the client as explicit constructor parameters.
+
+```bash
+cp .env.example .env
+# POLYESTER_API_KEY_ID, POLYESTER_API_PRIVATE_KEY, POLYESTER_ACCOUNT_ID
+
+pip install -e ".[dev,realtime]"
+
+./scripts/test_all.sh          # unit + tiered live (reads .env flags)
+# or
+pytest tests/unit -q           # CI-equivalent
+pytest tests/ -v               # full suite
+python scripts/smoke_test.py   # backwards-compatible read/mutation wrapper
+```
+
+Useful markers include `smoke`, `mutation`, `funded`, `treasury`, `optional`, `realtime`, and `jwt_session`.
+
+### Known devnet skips (not SDK failures)
+
+| Skip reason | Tests affected |
+|-------------|----------------|
+| OMS read never indexes after `orders.create` | `test_order_round_trip`, `test_batch_create_and_cancel` |
+| No open orders on book | `test_orders_get_round_trips_list_open` |
+| `list_holds` unmounted | balance holds tests |
+| JWT/session-only routes | profile, whiteboard, resolve, etc. |
+| Guard signer not on account | `test_guard_signer_get_status` |
+| No BTC-USDT asks / `POLYESTER_TEST_TRADE_E2E` | `test_spot_fill` |
+
+Attach a **read/trade policy** to your API key. Spot orders need **USDT in unified trading** (not BTC).
+
+Some RPCs return HTTP 404 on devnet. The SDK raises `PolyesterRouteNotFoundError` with a clearer message than `[unimplemented]: Not Found`.
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md).
+
+## Transport
+
+Connect RPC over HTTP via generated clients in `src/polyester/gen/`. Wire format
+defaults to **binary protobuf**; pass `wire_format="json"` for debugging.
+

polyester_sdk-0.1.0a0/README.md

@@ -0,0 +1,197 @@
+# Polyester Python SDK
+
+Official Python SDK for Polyester APIs, built for trading bots, backend jobs,
+research notebooks, and automation.
+
+**Status:** Alpha (`0.1.0a0`). The repo is **public** (visible on GitHub) under a
+**proprietary** license — not open source. API-key-only; no browser or JWT flows.
+
+Generated protobuf types and ConnectRPC clients live in `src/polyester/gen/` and are
+updated automatically when public API protos change. Hand-written SDK code (client,
+services, models, codecs) lives alongside them under `src/polyester/`.
+
+## Install
+
+Install the SDK from PyPI:
+
+```bash
+pip install "polyester-sdk[realtime]"
+```
+
+For local development from a checkout:
+
+```bash
+cd polyester-sdk-python
+python3.11 -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev,realtime]"
+```
+
+## Authentication
+
+Pass credentials to the client from your app's config or secrets manager:
+
+```python
+from polyester import AsyncPolyester
+
+client = AsyncPolyester(
+    api_key_id="ak_...",
+    api_private_key="...",  # 64-char hex Ed25519 secret or raw 32-byte key
+)
+```
+
+If your app uses environment variables, read them in your application code and pass
+them explicitly:
+
+```python
+import os
+
+from polyester import AsyncPolyester
+
+client = AsyncPolyester(
+    api_key_id=os.environ["POLYESTER_API_KEY_ID"],
+    api_private_key=os.environ["POLYESTER_API_PRIVATE_KEY"],
+    default_account_id=os.getenv("POLYESTER_ACCOUNT_ID"),
+)
+```
+
+For scripts and local tests, `AsyncPolyester.from_env()` and `Polyester.from_env()`
+are convenience helpers that read `POLYESTER_*` from `os.environ`. The plain
+constructor does not implicitly read environment variables.
+
+## Quickstart
+
+```python
+from polyester import AsyncPolyester
+
+async with AsyncPolyester(
+    api_key_id="ak_...",
+    api_private_key="...",
+) as client:
+    overview = await client.market_overview.list(limit=5)
+    for market in overview.markets:
+        print(market.symbol, market.last_price_ticks)
+
+    open_orders = await client.orders.list_open()
+    print(f"{len(open_orders.orders)} open orders")
+```
+
+## Create And Cancel
+
+```python
+from polyester import AsyncPolyester
+
+async with AsyncPolyester(
+    api_key_id="ak_...",
+    api_private_key="...",
+    default_sub_account_id="",
+) as client:
+    result = await client.orders.create(
+        symbol="BNB-USDT",
+        side="buy",
+        order_type="limit",
+        tif="gtc",
+        qty="0.01",
+        price="100",
+        post_only=True,
+        client_order_id="my-bot-001",
+    )
+    print(result.status, result.order_id)
+
+    await client.orders.cancel(client_order_id="my-bot-001")
+```
+
+Use **decimal strings** for `qty` and `price`. Do not pass floats.
+
+## Balances: funding vs trading
+
+Ledger balances expose separate **funding** and **trading** buckets per asset. Spot
+orders spend **trading** balance. Deposits land in **funding** until you move them
+(Funding → Unified Trading in the UI or on-chain via the funding wallet).
+
+- **Funding → trading:** on-chain `TradingGateway.deposit` (not an API-key RPC).
+- **Trading → funding:** `client.trading_withdraws.create_to_funding(...)` with a signed intent payload.
+- **Trading → trading (another account):** `client.internal_transfers.create(...)` or `client.ledger_write.transfer_trading_to_trading(...)`.
+
+Format u128 wire amounts with the public helper (18-decimal scale):
+
+```python
+from polyester import format_ledger_u128
+
+print(format_ledger_u128(balance.funding), format_ledger_u128(balance.trading))
+```
+
+Set `POLYESTER_ACCOUNT_ID` to your profile base58 id (not a raw decimal uint64) for
+bucket transfers.
+
+## Public Market Data
+
+```python
+candles = await client.market_data.get_candles(symbol="BTC-USDT", timeframe="1m", limit=50)
+current = await client.market_data.get_current_candle(symbol="BTC-USDT", timeframe="1m")
+trades = await client.market_data.get_trades(symbol="BTC-USDT", limit=20)
+health = await client.balances.get_health()
+
+async with client.market_data.subscribe_trades(symbol="BNB-USDT") as sub:
+    async for trade in sub:
+        print(trade.price_ticks, trade.qty_scaled)
+        break
+```
+
+Realtime requires `pip install polyester-sdk[realtime]` (websockets).
+
+Merged market overview stream (snapshot + live updates):
+
+```python
+sub = await client.market_overview.create_subscription()
+async for markets in sub:
+    print(len(markets), "rows")
+    break
+await sub.aclose()
+```
+
+## Testing
+
+**CI (no network):** `pytest tests/unit -q`, plus ruff and package build.
+
+**Full local suite:** devnet integration/e2e tests read `.env` in the test harness and pass credentials to the client as explicit constructor parameters.
+
+```bash
+cp .env.example .env
+# POLYESTER_API_KEY_ID, POLYESTER_API_PRIVATE_KEY, POLYESTER_ACCOUNT_ID
+
+pip install -e ".[dev,realtime]"
+
+./scripts/test_all.sh          # unit + tiered live (reads .env flags)
+# or
+pytest tests/unit -q           # CI-equivalent
+pytest tests/ -v               # full suite
+python scripts/smoke_test.py   # backwards-compatible read/mutation wrapper
+```
+
+Useful markers include `smoke`, `mutation`, `funded`, `treasury`, `optional`, `realtime`, and `jwt_session`.
+
+### Known devnet skips (not SDK failures)
+
+| Skip reason | Tests affected |
+|-------------|----------------|
+| OMS read never indexes after `orders.create` | `test_order_round_trip`, `test_batch_create_and_cancel` |
+| No open orders on book | `test_orders_get_round_trips_list_open` |
+| `list_holds` unmounted | balance holds tests |
+| JWT/session-only routes | profile, whiteboard, resolve, etc. |
+| Guard signer not on account | `test_guard_signer_get_status` |
+| No BTC-USDT asks / `POLYESTER_TEST_TRADE_E2E` | `test_spot_fill` |
+
+Attach a **read/trade policy** to your API key. Spot orders need **USDT in unified trading** (not BTC).
+
+Some RPCs return HTTP 404 on devnet. The SDK raises `PolyesterRouteNotFoundError` with a clearer message than `[unimplemented]: Not Found`.
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md).
+
+## Transport
+
+Connect RPC over HTTP via generated clients in `src/polyester/gen/`. Wire format
+defaults to **binary protobuf**; pass `wire_format="json"` for debugging.
+

polyester_sdk-0.1.0a0/SECURITY.md

@@ -0,0 +1,14 @@
+# Security Policy
+
+If you believe you have found a security issue in the Polyester Python SDK, do
+not open a public issue.
+
+Email security reports to `security@polyester.com` with:
+
+- affected package version or commit
+- impacted API, generated type, or helper
+- reproduction steps or proof of concept
+- potential impact
+
+We will acknowledge valid reports and coordinate remediation before public
+disclosure.

polyester_sdk-0.1.0a0/examples/basic_bot.py

@@ -0,0 +1,35 @@
+import asyncio
+import os
+
+from polyester import AsyncPolyester
+
+
+async def main() -> None:
+    async with AsyncPolyester(
+        api_key_id=os.environ["POLYESTER_API_KEY_ID"],
+        api_private_key=os.environ["POLYESTER_API_PRIVATE_KEY"],
+        default_account_id=os.getenv("POLYESTER_ACCOUNT_ID"),
+        default_sub_account_id="",
+    ) as client:
+        overview = await client.market_overview.list(limit=3)
+        for row in overview.markets:
+            print(row.symbol, row.last_price_ticks)
+
+        open_orders = await client.orders.list_open()
+        print(f"Open orders: {len(open_orders.orders)}")
+
+        # Uncomment when your API key has trade policy on devnet:
+        # created = await client.orders.create(
+        #     symbol="BNB-USDT",
+        #     side="buy",
+        #     order_type="limit",
+        #     tif="gtc",
+        #     qty="0.001",
+        #     price="100",
+        #     post_only=True,
+        # )
+        # print("Created", created.status, created.order_id)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

polyester_sdk-0.1.0a0/pyproject.toml

@@ -0,0 +1,110 @@
+[build-system]
+requires = ["hatchling>=1.26"]
+build-backend = "hatchling.build"
+
+[project]
+name = "polyester-sdk"
+version = "0.1.0a0"
+description = "Official Python SDK for Polyester APIs."
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "Proprietary" }
+authors = [{ name = "Fabric Blockchain Labs Inc." }]
+keywords = ["polyester", "trading", "sdk", "connectrpc", "protobuf"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "License :: Other/Proprietary License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Typing :: Typed",
+]
+dependencies = [
+  "base58>=2.1.1",
+  "connectrpc>=0.9.0",
+  "cryptography>=42",
+  "httpx>=0.27",
+  "msgspec>=0.18",
+  "protobuf>=7.35.0",
+]
+
+[project.optional-dependencies]
+realtime = [
+  "websockets>=15",
+]
+dev = [
+  "pytest>=8",
+  "pytest-asyncio>=0.23",
+  "pytest-cov>=5",
+  "python-dotenv>=1.0",
+  "ruff>=0.8",
+  "mypy>=1.13",
+  "build>=1.2",
+  "twine>=5",
+]
+
+[project.urls]
+Homepage = "https://github.com/Fabric-Labs/polyester-sdk-python"
+Documentation = "https://polyester.ai/docs"
+Repository = "https://github.com/Fabric-Labs/polyester-sdk-python"
+Issues = "https://github.com/Fabric-Labs/polyester-sdk-python/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/polyester"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+  "/.env.example",
+  "/CHANGELOG.md",
+  "/LICENSE",
+  "/README.md",
+  "/SECURITY.md",
+  "/examples",
+  "/pyproject.toml",
+  "/src",
+]
+exclude = [
+  "/.coverage",
+  "/.coverage.*",
+  "/.env",
+  "/docs",
+  "/scripts",
+  "/tests",
+]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+exclude = ["src/polyester/gen"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "SIM"]
+
+[tool.pytest.ini_options]
+addopts = ["-ra"]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "session"
+pythonpath = ["."]
+testpaths = ["tests"]
+filterwarnings = [
+  "ignore:SelectableGroups dict interface is deprecated\\. Use select\\.:DeprecationWarning:opentelemetry\\.util\\._importlib_metadata",
+]
+markers = [
+  "integration: live devnet (requires POLYESTER_* env)",
+  "mutation: writes state on devnet",
+  "funded: balance-changing devnet tests",
+  "treasury: withdraw/guard ops",
+  "realtime: Centrifugo subscriptions",
+  "optional: may skip when route unavailable",
+  "jwt_session: JWT/session or app-user route; not part of API-key SDK acceptance",
+  "smoke: shallow live RPC check (shape only; empty results OK)",
+]
+
+[tool.coverage.run]
+source = ["src/polyester"]
+omit = ["src/polyester/gen/*"]
+
+[tool.coverage.report]
+fail_under = 40
+show_missing = true