pi-agent-python-sdk 0.1.0__tar.gz

pi_agent_python_sdk-0.1.0/.gitignore

@@ -0,0 +1,12 @@
+.venv/
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+dist/
+*.egg-info/
+node_modules/
+.coverage
+htmlcov/
+upstream-report.md

pi_agent_python_sdk-0.1.0/CHANGELOG.md

@@ -0,0 +1,28 @@
+# Changelog
+
+## Unreleased
+
+## 0.1.0
+
+- Introduce the `pi-agent-python-sdk` distribution with the `pi_agent` Python
+  import. Users of earlier source checkouts must update their imports.
+- Keep the standalone SDK scoped to core RPC with zero runtime dependencies;
+  document loading caller-owned extensions through native Pi arguments.
+- Prevent owned runs from claiming delayed events after low-level submissions.
+- Bound retained run messages independently of event queues.
+- Preserve unknown usage measurements, concatenate final text blocks directly,
+  and measure run latency from submission to settlement.
+- Reject malformed known text deltas while preserving unknown event variants.
+- Add `AsyncPiClient` and `PiClient` with explicit methods for all 33 Pi 0.85.1 RPC commands.
+- Add typed wire payloads, future-only event subscriptions, extension dialogs,
+  streamed text, and settled results with session identity and observed usage.
+- Preserve Pi configuration while owning process readiness, bounded I/O,
+  checked failures, cancellation cleanup, and offline compatibility checks.
+- Add deterministic subprocess tests and isolated real-Pi integration using a
+  local faux provider, including retries, compaction, tools, and saved sessions.
+- Add nine runnable examples and guides for the API, errors, compatibility,
+  dependency updates, and releases.
+- Add Python/platform CI, Dependabot, daily latest-Pi checks, reviewed source
+  fingerprints, distribution inspection, and Trusted Publishing workflows.
+- Verify published wheel and source hashes, and smoke-test index installations
+  before promoting the same artifacts from TestPyPI to PyPI.

pi_agent_python_sdk-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 cheenulabs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pi_agent_python_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,231 @@
+Metadata-Version: 2.5
+Name: pi-agent-python-sdk
+Version: 0.1.0
+Summary: Typed async and synchronous Python clients for Pi's agent RPC runtime
+Project-URL: Homepage, https://github.com/cheenulabs/pi-agent-python-sdk
+Project-URL: Documentation, https://github.com/cheenulabs/pi-agent-python-sdk/tree/v0.1.0/docs
+Project-URL: Issues, https://github.com/cheenulabs/pi-agent-python-sdk/issues
+Project-URL: Changelog, https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.1.0/CHANGELOG.md
+Author: cheenulabs
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agent,asyncio,pi,rpc
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# Pi Agent Python SDK
+
+[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-3776AB?style=flat-square)][metadata]
+[![MIT license](https://img.shields.io/badge/license-MIT-blue?style=flat-square)][license]
+
+**Run Pi from Python. Stream responses, continue conversations, and control sessions.**
+
+A community Python SDK for [Pi coding agent](https://github.com/earendil-works/pi).
+Use synchronous or asynchronous clients with typed access to Pi's RPC commands
+and no third-party Python runtime dependencies. Pi runs as a subprocess and keeps
+its usual models, authentication, tools, extensions, skills, and configuration.
+
+> Requires Python **3.11+** and a separate Pi installation. The tested protocol
+> baseline is **Pi 0.85.1**; see [compatibility][compatibility] for version and
+> platform scope.
+
+[Quick start](#quick-start) · [Streaming](#streaming) · [Async](#async-usage) ·
+[Configuration](#configuration) · [RPC](#rpc-access) · [Documentation](#documentation)
+
+## Quick start
+
+Install Pi with Node.js **22.19.0 or newer**:
+
+```sh
+npm install -g @earendil-works/pi-coding-agent@0.85.1
+pi --version
+```
+
+Run `pi` once to configure your provider and model using Pi's normal setup.
+The SDK uses that configuration when it starts Pi.
+
+Install the Python package:
+
+```sh
+python -m pip install pi-agent-python-sdk==0.1.0
+```
+
+The distribution is named `pi-agent-python-sdk`; import it as
+`pi_agent`.
+
+```python
+from pi_agent import PiClient
+
+with PiClient() as pi:
+    result = pi.run("Explain the current project without changing files.")
+    print(result.text)
+```
+
+The context manager starts and closes Pi. `run()` waits for the conversation to
+settle, including retries and queued follow-ups. The result includes finalized
+messages, session identity, elapsed time, and observed assistant usage.
+
+## What you can do
+
+- **Run and stream:** get a final answer or consume text, thinking, and tool events.
+- **Keep a conversation:** send follow-up prompts, resume sessions, fork, or clone.
+- **Control Pi:** select models, adjust thinking, steer work, compact context, and
+  call all 33 RPC commands in the pinned baseline.
+- **Integrate with your application:** use sync or async clients, typed results,
+  raw event dictionaries, and extension UI callbacks.
+
+## Streaming
+
+```python
+from pi_agent import PiClient
+
+with PiClient() as pi:
+    with pi.stream("Explain this project's entry points without editing files.") as stream:
+        for event in stream:
+            if event.text_delta is not None:
+                print(event.text_delta, end="", flush=True)
+        result = stream.result()
+    print(f"\nStop reason: {result.stop_reason}")
+```
+
+`event.raw` contains the full Pi event, including fields the SDK does not yet
+recognize. Keep the stream inside its context: leaving early clears queued input
+and aborts the work it owns. See [errors and cancellation][errors] for
+handling timeouts and partial results.
+
+## Async usage
+
+Use `AsyncPiClient` in applications that already run an event loop. Command
+arguments and results match the synchronous client.
+
+```python
+import asyncio
+
+from pi_agent import AsyncPiClient
+
+
+async def main() -> None:
+    async with AsyncPiClient() as pi:
+        result = await pi.run("Explain the current project without changing files.")
+        print(result.text)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+Async streaming uses `async with pi.stream(...)`, `async for event in stream`,
+and `await stream.result()`. See the [complete streaming example][stream-example].
+
+## Configuration
+
+Choose the project directory and whether to save the conversation:
+
+```python
+from pi_agent import PiClient
+
+with PiClient(cwd=".", no_session=True) as pi:
+    print(pi.run("Describe this project without changing files.").text)
+```
+
+Leave `no_session` unset to preserve Pi's normal session persistence. Use
+`provider=` and `model=` to override Pi's configured model, or `session=` to open
+an existing session. See [constructor options][constructor-options]
+for environment overrides, executable paths, and deadlines.
+
+Extensions are installed and configured through Pi. To load your own extension,
+pass `extra_args=["--extension", "/absolute/path/to/your-extension.ts"]` to either
+client. See [using your own extensions][extensions]
+for details and [extension UI][ui-example] for an interactive example.
+
+## RPC access
+
+The SDK speaks Pi's existing JSONL protocol over stdin/stdout:
+
+```text
+Your Python application
+    PiClient / AsyncPiClient
+        pi --mode rpc
+            Models · tools · extensions · sessions
+```
+
+Choose the interface that fits the work:
+
+| You need | Use |
+| --- | --- |
+| A completed conversation result | `run()` |
+| Events while a conversation runs | `stream()` |
+| Prompt acknowledgement and your own event handling | `prompt()` with `events()` |
+| A specific Pi operation | `get_state()`, `set_model()`, `fork()`, and other command methods |
+| A raw command response envelope | `request()` |
+
+For example, inspect session state without starting a model run:
+
+```python
+from pi_agent import PiClient
+
+with PiClient() as pi:
+    state = pi.get_state()
+    print(state["sessionId"])
+```
+
+Python arguments use `snake_case`; wire dictionaries retain Pi's `camelCase`
+fields. `prompt()` acknowledges submission, which may be handled entirely by an
+extension. It does not wait for a completed answer.
+
+One client owns one conversation at a time; create separate clients for
+independent conversations. After a low-level prompt submitted outside an owned
+run, use a fresh client for `run()` or `stream()` so events cannot be attributed
+to the wrong work. The SDK launches a new process and cannot attach to an existing
+Pi terminal session.
+
+See [RPC structure][rpc] for the protocol mapping and module layout, and
+the [command reference][commands] for every method.
+
+## Documentation
+
+| Guide | Contents |
+| --- | --- |
+| [Usage][usage] | Sessions, images, concurrency, events, and extension UI |
+| [API reference][api] | Constructors, commands, types, and results |
+| [Errors and cancellation][errors] | Deadlines, partial results, cleanup, and recovery |
+| [RPC structure][rpc] | How the Python client maps to Pi's protocol |
+| [Compatibility][compatibility] | Runtime versions and platform validation |
+| [Examples][examples] | Runnable sync, async, streaming, sessions, steering, and UI examples |
+
+Examples use your configured Pi and may make provider calls. Development checks
+use an isolated local test provider; see [CONTRIBUTING.md][contributing] for
+setup and validation commands.
+
+Maintainers: [protocol discovery][discovery] ·
+[maintenance][maintenance] · [release checklist][releasing].
+
+## License
+
+[MIT][license]
+
+[metadata]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.1.0/pyproject.toml
+[license]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.1.0/LICENSE
+[compatibility]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.1.0/docs/compatibility.md
+[errors]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.1.0/docs/errors.md
+[stream-example]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.1.0/examples/stream.py
+[constructor-options]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.1.0/docs/api.md#constructor-options
+[extensions]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.1.0/docs/usage.md#using-your-own-extensions
+[ui-example]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.1.0/examples/ui.py
+[rpc]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.1.0/docs/rpc.md
+[commands]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.1.0/docs/api.md#all-33-rpc-commands
+[usage]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.1.0/docs/usage.md
+[api]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.1.0/docs/api.md
+[examples]: https://github.com/cheenulabs/pi-agent-python-sdk/tree/v0.1.0/examples
+[contributing]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.1.0/CONTRIBUTING.md
+[discovery]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.1.0/docs/discovery.md
+[maintenance]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.1.0/docs/maintenance.md
+[releasing]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.1.0/docs/releasing.md

pi_agent_python_sdk-0.1.0/README.md

@@ -0,0 +1,208 @@
+# Pi Agent Python SDK
+
+[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-3776AB?style=flat-square)][metadata]
+[![MIT license](https://img.shields.io/badge/license-MIT-blue?style=flat-square)][license]
+
+**Run Pi from Python. Stream responses, continue conversations, and control sessions.**
+
+A community Python SDK for [Pi coding agent](https://github.com/earendil-works/pi).
+Use synchronous or asynchronous clients with typed access to Pi's RPC commands
+and no third-party Python runtime dependencies. Pi runs as a subprocess and keeps
+its usual models, authentication, tools, extensions, skills, and configuration.
+
+> Requires Python **3.11+** and a separate Pi installation. The tested protocol
+> baseline is **Pi 0.85.1**; see [compatibility][compatibility] for version and
+> platform scope.
+
+[Quick start](#quick-start) · [Streaming](#streaming) · [Async](#async-usage) ·
+[Configuration](#configuration) · [RPC](#rpc-access) · [Documentation](#documentation)
+
+## Quick start
+
+Install Pi with Node.js **22.19.0 or newer**:
+
+```sh
+npm install -g @earendil-works/pi-coding-agent@0.85.1
+pi --version
+```
+
+Run `pi` once to configure your provider and model using Pi's normal setup.
+The SDK uses that configuration when it starts Pi.
+
+Install the Python package:
+
+```sh
+python -m pip install pi-agent-python-sdk==0.1.0
+```
+
+The distribution is named `pi-agent-python-sdk`; import it as
+`pi_agent`.
+
+```python
+from pi_agent import PiClient
+
+with PiClient() as pi:
+    result = pi.run("Explain the current project without changing files.")
+    print(result.text)
+```
+
+The context manager starts and closes Pi. `run()` waits for the conversation to
+settle, including retries and queued follow-ups. The result includes finalized
+messages, session identity, elapsed time, and observed assistant usage.
+
+## What you can do
+
+- **Run and stream:** get a final answer or consume text, thinking, and tool events.
+- **Keep a conversation:** send follow-up prompts, resume sessions, fork, or clone.
+- **Control Pi:** select models, adjust thinking, steer work, compact context, and
+  call all 33 RPC commands in the pinned baseline.
+- **Integrate with your application:** use sync or async clients, typed results,
+  raw event dictionaries, and extension UI callbacks.
+
+## Streaming
+
+```python
+from pi_agent import PiClient
+
+with PiClient() as pi:
+    with pi.stream("Explain this project's entry points without editing files.") as stream:
+        for event in stream:
+            if event.text_delta is not None:
+                print(event.text_delta, end="", flush=True)
+        result = stream.result()
+    print(f"\nStop reason: {result.stop_reason}")
+```
+
+`event.raw` contains the full Pi event, including fields the SDK does not yet
+recognize. Keep the stream inside its context: leaving early clears queued input
+and aborts the work it owns. See [errors and cancellation][errors] for
+handling timeouts and partial results.
+
+## Async usage
+
+Use `AsyncPiClient` in applications that already run an event loop. Command
+arguments and results match the synchronous client.
+
+```python
+import asyncio
+
+from pi_agent import AsyncPiClient
+
+
+async def main() -> None:
+    async with AsyncPiClient() as pi:
+        result = await pi.run("Explain the current project without changing files.")
+        print(result.text)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+Async streaming uses `async with pi.stream(...)`, `async for event in stream`,
+and `await stream.result()`. See the [complete streaming example][stream-example].
+
+## Configuration
+
+Choose the project directory and whether to save the conversation:
+
+```python
+from pi_agent import PiClient
+
+with PiClient(cwd=".", no_session=True) as pi:
+    print(pi.run("Describe this project without changing files.").text)
+```
+
+Leave `no_session` unset to preserve Pi's normal session persistence. Use
+`provider=` and `model=` to override Pi's configured model, or `session=` to open
+an existing session. See [constructor options][constructor-options]
+for environment overrides, executable paths, and deadlines.
+
+Extensions are installed and configured through Pi. To load your own extension,
+pass `extra_args=["--extension", "/absolute/path/to/your-extension.ts"]` to either
+client. See [using your own extensions][extensions]
+for details and [extension UI][ui-example] for an interactive example.
+
+## RPC access
+
+The SDK speaks Pi's existing JSONL protocol over stdin/stdout:
+
+```text
+Your Python application
+    PiClient / AsyncPiClient
+        pi --mode rpc
+            Models · tools · extensions · sessions
+```
+
+Choose the interface that fits the work:
+
+| You need | Use |
+| --- | --- |
+| A completed conversation result | `run()` |
+| Events while a conversation runs | `stream()` |
+| Prompt acknowledgement and your own event handling | `prompt()` with `events()` |
+| A specific Pi operation | `get_state()`, `set_model()`, `fork()`, and other command methods |
+| A raw command response envelope | `request()` |
+
+For example, inspect session state without starting a model run:
+
+```python
+from pi_agent import PiClient
+
+with PiClient() as pi:
+    state = pi.get_state()
+    print(state["sessionId"])
+```
+
+Python arguments use `snake_case`; wire dictionaries retain Pi's `camelCase`
+fields. `prompt()` acknowledges submission, which may be handled entirely by an
+extension. It does not wait for a completed answer.
+
+One client owns one conversation at a time; create separate clients for
+independent conversations. After a low-level prompt submitted outside an owned
+run, use a fresh client for `run()` or `stream()` so events cannot be attributed
+to the wrong work. The SDK launches a new process and cannot attach to an existing
+Pi terminal session.
+
+See [RPC structure][rpc] for the protocol mapping and module layout, and
+the [command reference][commands] for every method.
+
+## Documentation
+
+| Guide | Contents |
+| --- | --- |
+| [Usage][usage] | Sessions, images, concurrency, events, and extension UI |
+| [API reference][api] | Constructors, commands, types, and results |
+| [Errors and cancellation][errors] | Deadlines, partial results, cleanup, and recovery |
+| [RPC structure][rpc] | How the Python client maps to Pi's protocol |
+| [Compatibility][compatibility] | Runtime versions and platform validation |
+| [Examples][examples] | Runnable sync, async, streaming, sessions, steering, and UI examples |
+
+Examples use your configured Pi and may make provider calls. Development checks
+use an isolated local test provider; see [CONTRIBUTING.md][contributing] for
+setup and validation commands.
+
+Maintainers: [protocol discovery][discovery] ·
+[maintenance][maintenance] · [release checklist][releasing].
+
+## License
+
+[MIT][license]
+
+[metadata]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.1.0/pyproject.toml
+[license]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.1.0/LICENSE
+[compatibility]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.1.0/docs/compatibility.md
+[errors]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.1.0/docs/errors.md
+[stream-example]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.1.0/examples/stream.py
+[constructor-options]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.1.0/docs/api.md#constructor-options
+[extensions]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.1.0/docs/usage.md#using-your-own-extensions
+[ui-example]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.1.0/examples/ui.py
+[rpc]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.1.0/docs/rpc.md
+[commands]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.1.0/docs/api.md#all-33-rpc-commands
+[usage]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.1.0/docs/usage.md
+[api]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.1.0/docs/api.md
+[examples]: https://github.com/cheenulabs/pi-agent-python-sdk/tree/v0.1.0/examples
+[contributing]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.1.0/CONTRIBUTING.md
+[discovery]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.1.0/docs/discovery.md
+[maintenance]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.1.0/docs/maintenance.md
+[releasing]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.1.0/docs/releasing.md

pi_agent_python_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,69 @@
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[project]
+name = "pi-agent-python-sdk"
+version = "0.1.0"
+description = "Typed async and synchronous Python clients for Pi's agent RPC runtime"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{name = "cheenulabs"}]
+keywords = ["pi", "agent", "rpc", "asyncio"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Typing :: Typed",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/cheenulabs/pi-agent-python-sdk"
+Documentation = "https://github.com/cheenulabs/pi-agent-python-sdk/tree/v0.1.0/docs"
+Issues = "https://github.com/cheenulabs/pi-agent-python-sdk/issues"
+Changelog = "https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.1.0/CHANGELOG.md"
+
+[dependency-groups]
+dev = [
+  "build>=1.2.2",
+  "mypy>=1.15",
+  "pytest>=8.3",
+  "pytest-asyncio>=0.25",
+  "ruff>=0.11",
+  "twine>=6.1",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/pi_agent"]
+
+[tool.hatch.build.targets.sdist]
+only-include = ["src/pi_agent", "pyproject.toml", "README.md", "LICENSE", "CHANGELOG.md"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+testpaths = ["tests"]
+markers = [
+  "integration: real local Pi runtime with a synthetic provider",
+  "live: explicit opt-in model-backed smoke tests",
+]
+
+[tool.ruff]
+target-version = "py311"
+line-length = 100
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "ASYNC"]
+ignore = ["ASYNC109"] # Public per-operation deadlines are part of the client interface.
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+files = ["src"]

pi_agent_python_sdk-0.1.0/src/pi_agent/__init__.py

@@ -0,0 +1,47 @@
+"""Python access to an existing Pi agent runtime.
+
+Importing this package never launches Pi or changes its configuration.
+"""
+
+from .client import AsyncPiClient
+from .errors import (
+    PiBusyError,
+    PiCommandError,
+    PiError,
+    PiProcessError,
+    PiProtocolError,
+    PiResultOverflow,
+    PiRunError,
+    PiRunOwnershipError,
+    PiRunStartTimeout,
+    PiSubscriptionOverflow,
+    PiTimeoutError,
+    PiUIHandlerError,
+    PiVersionError,
+)
+from .sync import PiClient
+from .types import Event, ImageContent, Limits, RunResult, SessionInfo, UsageSummary
+
+__all__ = [
+    "AsyncPiClient",
+    "Event",
+    "ImageContent",
+    "Limits",
+    "PiBusyError",
+    "PiCommandError",
+    "PiClient",
+    "PiError",
+    "PiProcessError",
+    "PiProtocolError",
+    "PiResultOverflow",
+    "PiRunError",
+    "PiRunOwnershipError",
+    "PiRunStartTimeout",
+    "PiSubscriptionOverflow",
+    "PiTimeoutError",
+    "PiUIHandlerError",
+    "PiVersionError",
+    "RunResult",
+    "SessionInfo",
+    "UsageSummary",
+]