SDK Reference - Surface Area

Each page below lists the public APIs of one feature area with its exact signature, a parameter table, and a runnable example, verified against the gatewaysdk source. The Python SDK pages cover the same APIs as task walkthroughs.

Page	Covers
Tracing	`tracing.init`, the trace/span decorators, `tracing.session`, `identify`, semantic-convention keys, the exporter, auto-instrumentation registry
Runs & Scoring	The `run` decorator, the `Run` class, `success()` and `score()`, rollouts, experiments
Sessions, Replay & Users	Loading and dumping sessions, replay suites and reports, the users client

Install the package and set credentials once; every example assumes:

pip install gatewaysdk
export GATEWAY_HOST="https://your-instance.example.com"
export GATEWAY_PUBLIC_KEY="pk-lf-..."
export GATEWAY_SECRET_KEY="sk-lf-..."

The world clients — world_sessions, world_tasks, world_data, environments and benchmark_hub — are documented under Python SDK rather than here. These pages cover the Python package. The TypeScript package @withgateway/sdk has its own reference section covering worlds, live sessions, the parallel task runner, pull request validation, the hub, scores, replay and tracing. See TypeScript SDK. For narrative walkthroughs, start with Get Started or Worlds. For the HTTP surface, see the REST API; for the terminal, The gateway CLI.