pi-agent-python-sdk 0.2.0__py3-none-any.whl → 0.2.2__py3-none-any.whl

pi_agent/_events.py

@@ -117,8 +117,10 @@ class _Subscription(Generic[T]):
     async def _next_batch(self) -> list[T]:
         records = [await self.__anext__()]
         # Transfer only records already buffered; never wait to fill a batch.
-        # This retains at most one queue's byte budget in the blocking facade.
-        while self._records and len(records) < 64:
+        # Drain the ready queue in one crossing so bridge latency does not leave
+        # a growing backlog. No await below: count and bytes stay within the
+        # existing queue budgets, including the first record just removed.
+        while self._records:
             record = self._next_nowait()
             assert record is not None
             records.append(record)

pi_agent/_launch.py

@@ -13,7 +13,7 @@ from ._transport import _close_process_pipes, _wait_for_exit
 from .errors import PiProcessError, PiVersionError
 
 MINIMUM_PI_VERSION = "0.85.1"
-TESTED_PI_VERSION = "0.85.1"
+TESTED_PI_VERSION = "0.86.1"
 
 # The client owns these options. In particular --print consumes an initial prompt.
 _RESERVED = {

pi_agent/_observation.py

@@ -36,6 +36,7 @@ class ObservationStatus:
     stdout_eof: bool = False
     rpc_complete: bool = True
     error: Exception | None = field(default=None, repr=False)
+    end_reason: Literal["stopped", "closed", "overflow", "process_end"] | None = None
 
 
 class ProcessObservation(_Subscription[ProcessOutput]):
@@ -56,18 +57,39 @@ class ProcessObservation(_Subscription[ProcessOutput]):
     def status(self) -> ObservationStatus:
         return self._status
 
+    async def stop(self) -> None:
+        """Unsubscribe without discarding queued output or closing the client.
+
+        Drain the iterator afterwards, then inspect status. Repeated stops retain
+        the first termination status, including overflow or process failure.
+
+        Raises:
+            RuntimeError: If the observation context has not been entered.
+        """
+        if not self._entered:
+            raise RuntimeError("Enter the observation context before stopping")
+        if not self._closed:
+            self._status = replace(self._status, end_reason="stopped")
+            self._finish()
+
     def _finish(self, error: Exception | None = None) -> None:
         if not self._closed and self._status.ended_at_ns is None:
-            self._status = ObservationStatus(
-                started_at_ns=self._status.started_at_ns,
+            overflow = isinstance(error, PiSubscriptionOverflow)
+            self._status = replace(
+                self._status,
                 ended_at_ns=time.time_ns(),
-                from_start=self._status.from_start,
-                lost=self._status.lost or isinstance(error, PiSubscriptionOverflow),
-                error=error,
+                lost=self._status.lost or overflow,
+                error=error or self._status.error,
+                end_reason="overflow" if overflow else self._status.end_reason or "closed",
             )
         super()._finish(error)
 
     def _discard(self, *, buffered: bool = False) -> None:
         if self._records or buffered:
-            self._status = replace(self._status, complete=False, lost=True)
+            self._status = replace(
+                self._status,
+                complete=False,
+                lost=True,
+                end_reason="overflow" if self._status.end_reason == "overflow" else "closed",
+            )
         super()._discard()

pi_agent/_runs.py

@@ -172,6 +172,10 @@ class RunStream:
             if error is not None:
                 self._fail(error)
 
+    def _mark_submitted(self) -> None:
+        self._submitted = True
+        self._begin = time.monotonic()
+
     async def _drive(self) -> RunResult:
         assert self._ready is not None
         failure: BaseException | None = None
@@ -183,8 +187,6 @@ class RunStream:
                 fields: dict[str, Any] = {"message": self._message}
                 if self._images is not None:
                     fields["images"] = self._images
-                self._submitted = True
-                self._begin = time.monotonic()
                 await self._client._request(
                     "prompt", fields, timeout=self._command_timeout, owner=self
                 )
@@ -300,8 +302,6 @@ class RunStream:
     def __aiter__(self) -> Self:
         if self._draining:
             raise PiBusyError("Cannot iterate while result() drains the stream")
-        if self._iterating:
-            raise PiBusyError("A stream permits one event iterator")
         self._iterating = True
         return self
 

pi_agent/_transport.py

@@ -124,6 +124,7 @@ class Transport:
         fields: dict[str, Any] | None = None,
         *,
         timeout: float | None = 30,  # noqa: ASYNC109 - per-response API, distinct from write bound
+        before_write: Callable[[], None] | None = None,
     ) -> dict[str, Any]:
         if not isinstance(command, str) or not command:
             raise ValueError("command must be a nonempty string")
@@ -136,7 +137,9 @@ class Transport:
         # A fast child can respond while drain() is still suspended.
         self._pending[request_id] = _Pending(command, future)
         try:
-            await self._write({"type": command, "id": request_id, **(fields or {})})
+            await self._write(
+                {"type": command, "id": request_id, **(fields or {})}, before_write=before_write
+            )
             try:
                 # Keep cancellation on this task: wait_for can lose cancellation
                 # when its separate waiter completes at the same time on Python 3.11.
@@ -169,7 +172,9 @@ class Transport:
         if not self.running:
             raise PiProcessError("Pi subprocess is not running")
 
-    async def _write(self, record: dict[str, Any]) -> None:
+    async def _write(
+        self, record: dict[str, Any], *, before_write: Callable[[], None] | None = None
+    ) -> None:
         # Escape lone UTF-16 surrogates, as JSON.stringify does, while keeping
         # ordinary Unicode as UTF-8. Never emit invalid UTF-8 or replace values.
         data = json.dumps(
@@ -177,6 +182,10 @@ class Transport:
         ).encode("utf-8", errors="backslashreplace")
         if len(data) > self._limits.max_record_bytes:
             raise ValueError("Outbound JSON record exceeds max_record_bytes")
+        # Local validation cannot submit work. Notify ownership before the first
+        # suspension so another run cannot race a validated, queued write.
+        if before_write is not None:
+            before_write()
         wrote = False
         try:
             # Bound lock acquisition too: a wedged pipe must not queue writers forever.

pi_agent/client.py

@@ -424,9 +424,9 @@ class AsyncPiClient:
         """Observe selected process output; enter before start for lifetime coverage.
 
         Raises ValueError if no source is selected. Slow consumers raise
-        PiSubscriptionOverflow. Close the client and drain this iterator before
-        checking status.complete and status.error; terminal process failures are
-        reported through status.error after output drains.
+        PiSubscriptionOverflow. Stop the observation or close the client, then
+        drain this iterator before checking final status. Known terminal process
+        failures remain in status.error even when stopped before cleanup ends.
         """
         sources: set[OutputSource] = set()
         if stderr:
@@ -486,6 +486,7 @@ class AsyncPiClient:
                 rpc_complete=rpc_complete,
                 complete=complete,
                 error=self._close_error if self._closed else self._terminal_error or error,
+                end_reason="process_end",
             )
             observer._finish()
 
@@ -551,6 +552,13 @@ class AsyncPiClient:
         error = self._terminal_error
         self._session = SessionInfo()
         self._listeners.clear()
+        # Observers keep receiving shutdown output, but stop() must retain a
+        # failure already known before pipe drainage finishes. Normal close is
+        # not a process error for observation consumers.
+        for observer in self._observations:
+            observer._status = replace(
+                observer.status, error=self._close_error if self._closed else error
+            )
         for task in tuple(self._ui_tasks):
             if task is not asyncio.current_task() and task is not self._close_initiator:
                 task.cancel()
@@ -692,12 +700,23 @@ class AsyncPiClient:
         )
         if deadline is not None:
             _validate_timeout(deadline)
-        if self._owner is None and command in {"prompt", "steer", "follow_up"}:
-            # Set before awaiting: input handlers can start work long after acknowledgement.
-            # Even rejection/cancellation cannot prove arbitrary extension preflight is idle.
-            self._unowned_submission = True
+
+        def mark_submission() -> None:
+            if owner is not None:
+                owner._mark_submitted()
+            elif self._owner is None:
+                # Even rejection cannot prove extension preflight is idle.
+                self._unowned_submission = True
+
         try:
-            response = await self._transport.request(command, fields, timeout=deadline)
+            response = await self._transport.request(
+                command,
+                fields,
+                timeout=deadline,
+                before_write=(
+                    mark_submission if command in {"prompt", "steer", "follow_up"} else None
+                ),
+            )
             if self._ui_error is not None:
                 error, self._ui_error = self._ui_error, None
                 raise error

pi_agent/sync.py

@@ -756,6 +756,16 @@ class SyncProcessObservation(_SyncSubscription[ProcessOutput]):
         subscription = client._client.observe(stderr=stderr, stdout=stdout, rpc=rpc)
         super().__init__(client, lambda: subscription)
 
+    def stop(self) -> None:
+        """Unsubscribe and preserve buffered output for iteration; keep Pi running.
+
+        Raises:
+            RuntimeError: If the observation context has not been entered.
+        """
+        if self._subscription is None:
+            raise RuntimeError("Enter the observation context before stopping")
+        self._client._close_context(cast(ProcessObservation, self._subscription).stop)
+
     @property
     def status(self) -> ObservationStatus:
         if self._subscription is None:

pi_agent/types.py

@@ -1,4 +1,4 @@
-"""Pi 0.85.1 wire annotations and small Python conveniences.
+"""Pi 0.86.1 wire annotations and small Python conveniences.
 
 Wire fields retain Pi's spelling and remain ordinary dictionaries. These
 annotations describe known shapes, not a recursive runtime validator: extensions
@@ -97,6 +97,26 @@ class AssistantMessageDiagnostic(TypedDict):
     details: NotRequired[JSONObject]
 
 
+class ToolDefinition(TypedDict):
+    name: str
+    description: str
+    parameters: JSONObject
+    constrainedSampling: NotRequired[Literal[False] | JSONObject]
+
+
+class ToolReference(TypedDict):
+    name: str
+
+
+class SystemMessage(TypedDict):
+    role: Literal["system"]
+    content: str | list[TextContent]
+    sections: NotRequired[dict[str, str | None]]
+    toolsAdded: NotRequired[list[ToolDefinition]]
+    toolsRemoved: NotRequired[list[ToolReference]]
+    timestamp: float
+
+
 class UserMessage(TypedDict):
     role: Literal["user"]
     content: str | list[TextContent | ImageContent]
@@ -129,7 +149,7 @@ class ToolResultMessage(TypedDict):
     content: list[TextContent | ImageContent]
     details: NotRequired[JSONValue]
     usage: NotRequired[Usage]
-    addedToolNames: NotRequired[list[str]]
+    addedToolNames: NotRequired[list[str]]  # Legacy Pi 0.85.1 field.
     isError: bool
     timestamp: float
 
@@ -170,7 +190,8 @@ class CompactionSummaryMessage(TypedDict):
 
 
 AgentMessage: TypeAlias = (
-    UserMessage
+    SystemMessage
+    | UserMessage
     | AssistantMessage
     | ToolResultMessage
     | BashExecutionMessage
@@ -195,6 +216,11 @@ class ModelCost(ModelCostRates):
     tiers: NotRequired[list[ModelCostTier]]
 
 
+class ModelPromptCache(TypedDict, total=False):
+    short: float
+    long: float
+
+
 class Model(TypedDict):
     id: str
     name: str
@@ -210,6 +236,7 @@ class Model(TypedDict):
     samplingParams: NotRequired[JSONObject]
     headers: NotRequired[dict[str, str]]
     compat: NotRequired[JSONObject]
+    promptCache: NotRequired[ModelPromptCache]
 
 
 class SessionState(TypedDict):
@@ -308,6 +335,15 @@ class ModelChangeEntry(_EntryBase):
     modelId: str
 
 
+class UsageEntry(_EntryBase):
+    type: Literal["usage"]
+    kind: str
+    provider: str
+    model: str
+    usage: Usage
+    note: NotRequired[str]
+
+
 class CompactionEntry(_EntryBase):
     type: Literal["compaction"]
     summary: str
@@ -316,6 +352,7 @@ class CompactionEntry(_EntryBase):
     details: NotRequired[JSONValue]
     usage: NotRequired[Usage]
     fromHook: NotRequired[bool]
+    systemMessage: NotRequired[SystemMessage]
 
 
 class BranchSummaryEntry(_EntryBase):
@@ -356,6 +393,7 @@ SessionEntry: TypeAlias = (
     MessageEntry
     | ThinkingLevelChangeEntry
     | ModelChangeEntry
+    | UsageEntry
     | CompactionEntry
     | BranchSummaryEntry
     | CustomEntry

{pi_agent_python_sdk-0.2.0.dist-info → pi_agent_python_sdk-0.2.2.dist-info}/METADATA

@@ -1,11 +1,11 @@
 Metadata-Version: 2.5
 Name: pi-agent-python-sdk
-Version: 0.2.0
+Version: 0.2.2
 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.2.0/docs
+Project-URL: Documentation, https://github.com/cheenulabs/pi-agent-python-sdk/tree/v0.2.2/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.2.0/CHANGELOG.md
+Project-URL: Changelog, https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.2/CHANGELOG.md
 Author: cheenulabs
 License-Expression: MIT
 License-File: LICENSE
@@ -23,40 +23,69 @@ Description-Content-Type: text/markdown
 
 # Pi Agent Python SDK
 
-[![PyPI](https://img.shields.io/pypi/v/pi-agent-python-sdk?style=flat-square)][pypi]
+[![PyPI](https://img.shields.io/pypi/v/pi-agent-python-sdk.svg?style=flat-square)][pypi]
 [![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.**
+**Use your installed Pi coding agent as a Python API. Stream responses,
+continue conversations, and control sessions from Python.**
 
-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.
+[Pi](https://github.com/earendil-works/pi) is an open-source coding agent that
+runs in your terminal. This unofficial community SDK launches the Pi CLI in RPC
+mode and exposes prompts, streaming events, and sessions through typed
+synchronous and asynchronous Python APIs.
 
-> 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.
+```python
+from pi_agent import PiClient
+
+with PiClient() as pi:
+    print(pi.run("Explain the current project without changing files.").text)
+```
+
+Requires an installed, configured Pi CLI — see [Prerequisites](#prerequisites).
+
+[Prerequisites](#prerequisites) · [Quick start](#quick-start) ·
+[Streaming](#streaming) · [Async](#async-usage) ·
+[Configuration](#configuration) · [Thinking](#models-and-thinking) ·
+[RPC](#rpc-access) · [Documentation](#documentation) ·
+[Troubleshooting](#troubleshooting) · [Support](#support)
+
+## What you can do
 
-[Quick start](#quick-start) · [Streaming](#streaming) · [Async](#async-usage) ·
-[Configuration](#configuration) · [RPC](#rpc-access) · [Documentation](#documentation)
+- **Run prompts from Python** — get a final answer, or stream text, thinking, and
+  tool events as they happen.
+- **Keep conversations going** — send follow-ups on the same client, or resume,
+  fork, and clone sessions.
+- **Control the agent** — switch models, set thinking level, steer mid-run, and
+  compact context.
+- **Reuse your Pi setup** — same configuration, tools, and extensions as the CLI,
+  with sync or async clients.
+
+## Prerequisites
+
+| Requirement | Notes |
+| --- | --- |
+| Python **3.11+** | Package metadata requires 3.11 or newer |
+| Node.js **22.19.0+** | Required by Pi 0.86.1 |
+| Pi **0.85.1+** | Minimum accepted version; **0.86.1** is the tested baseline |
+| Model provider | Required; configure with the Pi CLI (see Quick start) |
 
 ## Quick start
 
-Install Pi with Node.js **22.19.0 or newer**:
+Install Pi with Node.js **22.19.0 or newer** (pin matches the tested baseline):
 
 ```sh
-npm install -g @earendil-works/pi-coding-agent@0.85.1
+npm install -g @earendil-works/pi-coding-agent@0.86.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.
+Run `pi` once to configure your provider and model. The SDK uses that
+configuration when it starts Pi.
 
 Install the Python package from [PyPI][pypi]:
 
 ```sh
-python -m pip install pi-agent-python-sdk==0.2.0
+python -m pip install pi-agent-python-sdk
 ```
 
 The distribution is named `pi-agent-python-sdk`; import it as
@@ -71,8 +100,8 @@ with PiClient() as pi:
 ```
 
 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.
+settle. The result includes finalized messages, session identity, elapsed time,
+and observed assistant usage.
 
 Continue the conversation with another call on the same client:
 
@@ -87,15 +116,6 @@ with PiClient() as pi:
 Pi keeps the conversation context. Each result contains only the messages and
 answer from that call; a call with no assistant output has empty text.
 
-## 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
@@ -110,9 +130,15 @@ with PiClient() as pi:
     print(f"\nStop reason: {result.stop_reason}")
 ```
 
+<details>
+<summary>Streaming details</summary>
+
 `event.raw` contains the full Pi event, including fields the SDK does not yet
-recognize. Keep the stream inside its context: leaving early cleans up unfinished work. See [errors and cancellation][errors] for
-handling timeouts and partial results.
+recognize. Keep the stream inside its context: leaving early cleans up unfinished
+work. See [errors and cancellation][errors] for handling timeouts and partial
+results.
+
+</details>
 
 ## Async usage
 
@@ -135,8 +161,13 @@ 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].
+<details>
+<summary>Async streaming</summary>
+
+Use `async with pi.stream(...)`, `async for event in stream`, and
+`await stream.result()`. See the [complete streaming example][stream-example].
+
+</details>
 
 ## Configuration
 
@@ -150,14 +181,70 @@ with PiClient(cwd=".", no_session=True) as pi:
 ```
 
 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.
+`session=` to open an existing session. For model overrides, see
+[Models and thinking](#models-and-thinking).
+
+<details>
+<summary>More configuration</summary>
+
+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.
+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.
+
+</details>
+
+## Models and thinking
+
+By default the SDK uses whatever model you already configured in the Pi CLI.
+Override it when you construct the client, or switch later on the same client.
+Set the model and thinking level **before** `run()` or `stream()`.
+
+Select a model at construction:
+
+```python
+from pi_agent import PiClient
+
+with PiClient(provider="openai", model="gpt-5") as pi:
+    print(pi.run("Summarise this repo without changing files.").text)
+```
+
+Thinking levels depend on the current model. Query them, set one, then confirm
+what Pi actually applied:
+
+```python
+from pi_agent import PiClient
+
+with PiClient() as pi:
+    levels = pi.get_available_thinking_levels()
+    print("available:", levels)
+    if "high" in levels:
+        pi.set_thinking_level("high")
+    print("effective:", pi.get_state()["thinkingLevel"])
+    print(pi.run("Analyse this project's architecture without changing files.").text)
+```
+
+Replace the example provider/model ids with ones from your Pi install
+(`pi --list-models` or `get_available_models()`).
+
+<details>
+<summary>List models and switch after start</summary>
+
+```python
+from pi_agent import PiClient
+
+with PiClient() as pi:
+    for model in pi.get_available_models():
+        print(model["provider"], model["id"])
+    selected = pi.set_model("openai", "gpt-5")
+    print("using", selected["provider"], selected["id"])
+    print(pi.run("Summarise this repo without changing files.").text)
+```
+
+</details>
 
 ## RPC access
 
@@ -170,7 +257,18 @@ Your Python application
             Models · tools · extensions · sessions
 ```
 
-Choose the interface that fits the work:
+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"])
+```
+
+<details>
+<summary>Which interface to use</summary>
 
 | You need | Use |
 | --- | --- |
@@ -182,29 +280,20 @@ Choose the interface that fits the work:
 | 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.
 
-Use one client per conversation and wait for each `run()` or stream to finish
-before starting the next. After using `prompt()` for your own event handling,
-use a fresh client for `run()` or `stream()` so results cannot include delayed
-events from earlier work. The SDK launches a new process and cannot attach to an existing
-Pi terminal session.
+Each client starts its own Pi subprocess. Use one client per conversation and
+wait for each `run()` or stream to finish before starting the next. After using
+`prompt()` for your own event handling, use a fresh client for `run()` or
+`stream()` so results cannot include delayed events from earlier work.
 
 See [RPC structure][rpc] for the protocol mapping and module layout, and
 the [command reference][commands] for every method.
 
+</details>
+
 ## Documentation
 
 | Guide | Contents |
@@ -215,35 +304,46 @@ the [command reference][commands] for every method.
 | [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 |
-| [Release notes][release] | Changes included in 0.2.0 |
+| [Release notes][release] | Changes included in 0.2.2 |
 
 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].
+## Troubleshooting
+
+| Symptom | What to check |
+| --- | --- |
+| `pi` not found / launch fails | Ensure the Pi CLI is on `PATH`, or pass `executable=` to the client |
+| Version rejected | Upgrade to Pi **0.85.1+**; prefer the tested baseline **0.86.1** |
+| No model / auth errors | Run `pi` once and complete provider setup |
+| Unexpected file or command changes | Review Pi tool/extension settings before automation |
+
+## Support
+
+- [Open an issue][issues] for bugs, questions, or compatibility reports.
+- See [CONTRIBUTING.md][contributing] for local setup and pull requests.
+- For security reports, open a [private security advisory][security].
 
 ## License
 
 [MIT][license]
 
 [pypi]: https://pypi.org/project/pi-agent-python-sdk/
-[release]: https://github.com/cheenulabs/pi-agent-python-sdk/releases/tag/v0.2.0
-[metadata]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.0/pyproject.toml
-[license]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.0/LICENSE
-[compatibility]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.0/docs/compatibility.md
-[errors]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.0/docs/errors.md
-[stream-example]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.0/examples/stream.py
-[constructor-options]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.0/docs/api.md#constructor-options
-[extensions]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.0/docs/usage.md#using-your-own-extensions
-[ui-example]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.0/examples/ui.py
-[rpc]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.0/docs/rpc.md
-[commands]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.0/docs/api.md#all-33-rpc-commands
-[usage]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.0/docs/usage.md
-[api]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.0/docs/api.md
-[examples]: https://github.com/cheenulabs/pi-agent-python-sdk/tree/v0.2.0/examples
-[contributing]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.0/CONTRIBUTING.md
-[discovery]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.0/docs/discovery.md
-[maintenance]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.0/docs/maintenance.md
-[releasing]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.0/docs/releasing.md
+[release]: https://github.com/cheenulabs/pi-agent-python-sdk/releases/tag/v0.2.2
+[metadata]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.2/pyproject.toml
+[license]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.2/LICENSE
+[compatibility]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.2/docs/compatibility.md
+[errors]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.2/docs/errors.md
+[stream-example]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.2/examples/stream.py
+[constructor-options]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.2/docs/api.md#constructor-options
+[extensions]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.2/docs/usage.md#using-your-own-extensions
+[ui-example]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.2/examples/ui.py
+[rpc]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.2/docs/rpc.md
+[commands]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.2/docs/api.md#all-33-rpc-commands
+[usage]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.2/docs/usage.md
+[api]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.2/docs/api.md
+[examples]: https://github.com/cheenulabs/pi-agent-python-sdk/tree/v0.2.2/examples
+[contributing]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.2/CONTRIBUTING.md
+[issues]: https://github.com/cheenulabs/pi-agent-python-sdk/issues
+[security]: https://github.com/cheenulabs/pi-agent-python-sdk/security/advisories/new

pi_agent_python_sdk-0.2.2.dist-info/RECORD

@@ -0,0 +1,17 @@
+pi_agent/__init__.py,sha256=Tb-KJ6Ur9H0WfwGdk5DkPQtTNKsLPeqcJx3lEh67gJI,1117
+pi_agent/_collections.py,sha256=1oSSh9u2OAXlVCu5t392go3wTQ2AruYm74prVfKBbgc,2174
+pi_agent/_events.py,sha256=fkt5KAM5esgdYHxzGX6fLXrTDv4jhzhcypPYy9z3HvM,5068
+pi_agent/_launch.py,sha256=u4MGYX9IiPUfiXzeiY8UUdKnJ5IBq2s1BFhsQMgwJlU,6965
+pi_agent/_observation.py,sha256=GUe5VkoB5dFx1NY9VwAILjSRFa-th8O17OHMmcQ8q9Y,3297
+pi_agent/_runs.py,sha256=hxKhs5Oi8NLMdufJ72cdXy8tffdZ04XEb2xJzWfOiaQ,14219
+pi_agent/_transport.py,sha256=7mFkVjNSWBzvZw4zGwjtDNTe_FxF0Vxl0SD2z-58QuM,20040
+pi_agent/_usage.py,sha256=PxK0WPrnd0RKoH_J8psoTGNYaNg71gmOqQiaY6hH0aA,3051
+pi_agent/client.py,sha256=gsCV9CyDmjrUf21DpqX3TVKyHXMu5e_CXUzY4D1pcOE,43867
+pi_agent/errors.py,sha256=FJtF8jwfGITMp_MzNHbUKutYRrdx_BH8kJI7-17WbJk,2573
+pi_agent/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pi_agent/sync.py,sha256=dPyGHpJGmhg09u3QFrYdSJYGUB7_8_kupBxXCm8gu6o,33658
+pi_agent/types.py,sha256=R7LoyIyc0z7gzOL38ZOcbxOhL9ky7owL22RtELp6aMU,23389
+pi_agent_python_sdk-0.2.2.dist-info/METADATA,sha256=5GvsUBJtw2fWBUBmyx02VEWwhmpwoYATaHBTO5PXA5I,12671
+pi_agent_python_sdk-0.2.2.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+pi_agent_python_sdk-0.2.2.dist-info/licenses/LICENSE,sha256=VVC0d0PIT1GtbRUJluzmcIv-UYtsqsBfvWLFu5Qrbco,1067
+pi_agent_python_sdk-0.2.2.dist-info/RECORD,,

{pi_agent_python_sdk-0.2.0.dist-info → pi_agent_python_sdk-0.2.2.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.32.3
+Generator: hatchling 1.32.4
 Root-Is-Purelib: true
 Tag: py3-none-any

pi_agent_python_sdk-0.2.0.dist-info/RECORD

@@ -1,17 +0,0 @@
-pi_agent/__init__.py,sha256=Tb-KJ6Ur9H0WfwGdk5DkPQtTNKsLPeqcJx3lEh67gJI,1117
-pi_agent/_collections.py,sha256=1oSSh9u2OAXlVCu5t392go3wTQ2AruYm74prVfKBbgc,2174
-pi_agent/_events.py,sha256=kPZJPE_LpxXcMrhXb6KkomhmgQj3wFEVisnjunuxQYY,4936
-pi_agent/_launch.py,sha256=jXi8M0DcLkB-FvKs3Nx72FN_Sy_S2KI7bqws_P11s10,6965
-pi_agent/_observation.py,sha256=8BEMtud1tp2vG1-xFhY1Iw7KNqHX77CbbjkwIdWgpqg,2383
-pi_agent/_runs.py,sha256=cUEpFSoGhmtVrbFG9XDx_gKGw_JXiFlVVQUQBlkl7HA,14292
-pi_agent/_transport.py,sha256=0Huh6sK-_5PNYCVPgS7UPNy1_VSRt0zl2k8SHHsTO7E,19642
-pi_agent/_usage.py,sha256=PxK0WPrnd0RKoH_J8psoTGNYaNg71gmOqQiaY6hH0aA,3051
-pi_agent/client.py,sha256=9I1xR9tzXz2PGrDNpdRDA9EUrGKTRF_OwIzWRDpynqI,43240
-pi_agent/errors.py,sha256=FJtF8jwfGITMp_MzNHbUKutYRrdx_BH8kJI7-17WbJk,2573
-pi_agent/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pi_agent/sync.py,sha256=gdTOHr7-plV7azEaYtkMmCqPWmcc3E5fufPTlVybgrE,33235
-pi_agent/types.py,sha256=Oi0rixDVKeNHtfVCC6_vRgZ0c7a5M-M8Xco8fHIioJ0,22518
-pi_agent_python_sdk-0.2.0.dist-info/METADATA,sha256=9J5XiasPvpncfL16wkyviV5S2XJPqUio7jbmUcSxPB8,10216
-pi_agent_python_sdk-0.2.0.dist-info/WHEEL,sha256=THafob7ofN-NsuMN7Mg4qZyHaQI7KkD-QlcQatYhXPo,87
-pi_agent_python_sdk-0.2.0.dist-info/licenses/LICENSE,sha256=VVC0d0PIT1GtbRUJluzmcIv-UYtsqsBfvWLFu5Qrbco,1067
-pi_agent_python_sdk-0.2.0.dist-info/RECORD,,