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

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.86.1"
+TESTED_PI_VERSION = "1.0.0"
 
 # The client owns these options. In particular --print consumes an initial prompt.
 _RESERVED = {

pi_agent/client.py

@@ -759,7 +759,8 @@ class AsyncPiClient:
     ) -> None:
         """Return None after checked acceptance; handled commands may never start a run.
 
-        Raises PiCommandError on rejection. Use request() for the raw envelope.
+        Raises PiCommandError on rejection. Use request() for the raw envelope,
+        including data.disposition when Pi provides it.
         """
         fields: dict[str, Any] = {"message": message}
         if images is not None:

pi_agent/types.py

@@ -1,4 +1,4 @@
-"""Pi 0.86.1 wire annotations and small Python conveniences.
+"""Pi 1.0.0 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
@@ -20,6 +20,8 @@ RawRecord: TypeAlias = dict[str, Any]
 ThinkingLevel: TypeAlias = Literal["off", "minimal", "low", "medium", "high", "xhigh", "max"]
 QueueMode: TypeAlias = Literal["all", "one-at-a-time"]
 StreamingBehavior: TypeAlias = Literal["steer", "followUp"]
+QueuedInputDisposition: TypeAlias = Literal["handled", "queued"]
+PromptDisposition: TypeAlias = Literal["handled", "queued", "started"]
 CompactionReason: TypeAlias = Literal["manual", "threshold", "overflow"]
 StopReason: TypeAlias = Literal[
     "pending", "stop", "length", "toolUse", "error", "aborted", "deferred"
@@ -131,6 +133,7 @@ class AssistantMessage(TypedDict):
     model: str
     responseModel: NotRequired[str]
     responseId: NotRequired[str]
+    thinkingLevel: NotRequired[ThinkingLevel]
     providerThinkingLevel: NotRequired[str]
     diagnostics: NotRequired[list[AssistantMessageDiagnostic]]
     usage: Usage
@@ -142,6 +145,21 @@ class AssistantMessage(TypedDict):
     timestamp: float
 
 
+class NestedToolCallRecord(TypedDict):
+    id: str
+    name: str
+    arguments: NotRequired[JSONObject]
+    argumentsBytes: NotRequired[float]
+    status: Literal["ok", "error", "unfinished"]
+    durationMs: NotRequired[float]
+    error: NotRequired[str]
+
+
+class NestedToolCalls(TypedDict):
+    calls: list[NestedToolCallRecord]
+    complete: bool
+
+
 class ToolResultMessage(TypedDict):
     role: Literal["toolResult"]
     toolCallId: str
@@ -149,6 +167,7 @@ class ToolResultMessage(TypedDict):
     content: list[TextContent | ImageContent]
     details: NotRequired[JSONValue]
     usage: NotRequired[Usage]
+    nestedCalls: NotRequired[NestedToolCalls]
     addedToolNames: NotRequired[list[str]]  # Legacy Pi 0.85.1 field.
     isError: bool
     timestamp: float
@@ -221,7 +240,26 @@ class ModelPromptCache(TypedDict, total=False):
     long: float
 
 
+class ModelImageResizeOptions(TypedDict, total=False):
+    maxWidth: float
+    maxHeight: float
+    maxBytes: float
+    jpegQuality: float
+
+
+class ModelImageInputLimits(TypedDict, total=False):
+    resize: ModelImageResizeOptions
+    maxPerMessage: float
+    maxPerRequest: float
+
+
+class ModelInputLimits(TypedDict, total=False):
+    maxRequestBytes: float
+    images: ModelImageInputLimits
+
+
 class Model(TypedDict):
+    type: NotRequired[Literal["chat"]]
     id: str
     name: str
     api: str
@@ -230,6 +268,7 @@ class Model(TypedDict):
     reasoning: bool
     thinkingLevelMap: NotRequired[dict[ThinkingLevel, str | None]]
     input: list[Literal["text", "image"]]
+    inputLimits: NotRequired[ModelInputLimits]
     cost: ModelCost
     contextWindow: float
     maxTokens: float
@@ -378,6 +417,22 @@ class CustomMessageEntry(_EntryBase):
     display: bool
 
 
+# Keep the list arms separate so typing rejects mixed ToolCall and ImageContent lists.
+ContextEditableContent: TypeAlias = (
+    str | list[TextContent | ImageContent] | list[TextContent | ThinkingContent | ToolCall]
+)
+
+
+class ContextEditReplacement(TypedDict):
+    content: ContextEditableContent
+
+
+class ContextEditEntry(_EntryBase):
+    type: Literal["context_edit"]
+    targetId: str
+    replacement: ContextEditReplacement | None
+
+
 class LabelEntry(_EntryBase):
     type: Literal["label"]
     targetId: str
@@ -398,6 +453,7 @@ SessionEntry: TypeAlias = (
     | BranchSummaryEntry
     | CustomEntry
     | CustomMessageEntry
+    | ContextEditEntry
     | LabelEntry
     | SessionInfoEntry
 )
@@ -415,6 +471,14 @@ class QueueState(TypedDict):
     followUp: list[str]
 
 
+class PromptDispositionData(TypedDict):
+    disposition: PromptDisposition
+
+
+class QueuedInputDispositionData(TypedDict):
+    disposition: QueuedInputDisposition
+
+
 class SessionChangeResult(TypedDict):
     cancelled: bool
 
@@ -685,6 +749,7 @@ class ToolExecutionStartEvent(TypedDict):
     toolCallId: str
     toolName: str
     args: JSONValue
+    parentToolCallId: NotRequired[str]
 
 
 class ToolExecutionUpdateEvent(TypedDict):
@@ -693,6 +758,7 @@ class ToolExecutionUpdateEvent(TypedDict):
     toolName: str
     args: JSONValue
     partialResult: JSONValue
+    parentToolCallId: NotRequired[str]
 
 
 class ToolExecutionEndEvent(TypedDict):
@@ -701,6 +767,7 @@ class ToolExecutionEndEvent(TypedDict):
     toolName: str
     result: JSONValue
     isError: bool
+    parentToolCallId: NotRequired[str]
 
 
 class QueueUpdateEvent(QueueState):

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

@@ -1,11 +1,11 @@
 Metadata-Version: 2.5
 Name: pi-agent-python-sdk
-Version: 0.2.2
+Version: 0.2.4
 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.2/docs
+Project-URL: Documentation, https://github.com/cheenulabs/pi-agent-python-sdk/tree/v0.2.4/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.2/CHANGELOG.md
+Project-URL: Changelog, https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.4/CHANGELOG.md
 Author: cheenulabs
 License-Expression: MIT
 License-File: LICENSE
@@ -23,17 +23,28 @@ Description-Content-Type: text/markdown
 
 # Pi Agent Python SDK
 
+<p align="center">
+  <strong>Your terminal agent. Your Python API.</strong>
+</p>
+
+<p align="center">
+  <a href="https://github.com/cheenulabs/pi-agent-python-sdk">
+    <img alt="Pi Agent Python SDK" src="https://raw.githubusercontent.com/cheenulabs/pi-agent-python-sdk/v0.2.4/docs/logo.svg" width="160">
+  </a>
+</p>
+
 [![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]
 
-**Use your installed Pi coding agent as a Python API. Stream responses,
-continue conversations, and control sessions from Python.**
+[Pi](https://github.com/earendil-works/pi) is the coding agent that runs in your
+terminal. This unofficial community SDK puts *your* Pi behind a typed sync and
+async Python API — run prompts, stream events, and keep sessions going without
+leaving Python.
 
-[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.
+<!-- Inline player: GitHub only auto-embeds bare user-attachments URLs
+     (repo-relative / raw / release URLs are stripped or become download links). -->
+https://github.com/user-attachments/assets/c64dde3a-e812-42d4-a005-aa60df861e92
 
 ```python
 from pi_agent import PiClient
@@ -48,6 +59,7 @@ Requires an installed, configured Pi CLI — see [Prerequisites](#prerequisites)
 [Streaming](#streaming) · [Async](#async-usage) ·
 [Configuration](#configuration) · [Thinking](#models-and-thinking) ·
 [RPC](#rpc-access) · [Documentation](#documentation) ·
+[Further reading](#further-reading) ·
 [Troubleshooting](#troubleshooting) · [Support](#support)
 
 ## What you can do
@@ -66,8 +78,8 @@ Requires an installed, configured Pi CLI — see [Prerequisites](#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 |
+| Node.js **22.19.0+** | Required by Pi 1.0.0 |
+| Pi **0.85.1+** | Minimum accepted version; **1.0.0** is the tested baseline |
 | Model provider | Required; configure with the Pi CLI (see Quick start) |
 
 ## Quick start
@@ -75,7 +87,7 @@ Requires an installed, configured Pi CLI — see [Prerequisites](#prerequisites)
 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.86.1
+npm install -g @earendil-works/pi-coding-agent@1.0.0
 pi --version
 ```
 
@@ -304,18 +316,23 @@ 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.2 |
+| [Release notes][release] | Changes included in 0.2.4 |
 
 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.
 
+## Further reading
+
+- [Pi Unchained](https://hasc.substack.com/p/pi-unchained) — why this SDK exists
+  and how Pi fits into Python workflows.
+
 ## 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** |
+| Version rejected | Upgrade to Pi **0.85.1+**; prefer the tested baseline **1.0.0** |
 | No model / auth errors | Run `pi` once and complete provider setup |
 | Unexpected file or command changes | Review Pi tool/extension settings before automation |
 
@@ -330,20 +347,20 @@ setup and validation commands.
 [MIT][license]
 
 [pypi]: https://pypi.org/project/pi-agent-python-sdk/
-[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
+[release]: https://github.com/cheenulabs/pi-agent-python-sdk/releases/tag/v0.2.4
+[metadata]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.4/pyproject.toml
+[license]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.4/LICENSE
+[compatibility]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.4/docs/compatibility.md
+[errors]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.4/docs/errors.md
+[stream-example]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.4/examples/stream.py
+[constructor-options]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.4/docs/api.md#constructor-options
+[extensions]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.4/docs/usage.md#using-your-own-extensions
+[ui-example]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.4/examples/ui.py
+[rpc]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.4/docs/rpc.md
+[commands]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.4/docs/api.md#all-33-rpc-commands
+[usage]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.4/docs/usage.md
+[api]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.4/docs/api.md
+[examples]: https://github.com/cheenulabs/pi-agent-python-sdk/tree/v0.2.4/examples
+[contributing]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.4/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 → pi_agent_python_sdk-0.2.4.dist-info}/RECORD

@@ -1,17 +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/_launch.py,sha256=c1MYnRsOG0ynrpADhUldTG7pgr4K3ytiqTbSFoFKBg8,6964
 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/client.py,sha256=_Rw595kc0fu6cSFq7vEzfrIOF3U17vSgANuW8OtJKaM,43923
 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/types.py,sha256=o50d-8kAQBhXYwK1zZgnRepZeP2g6i3u3rqgGW-FfV0,25186
+pi_agent_python_sdk-0.2.4.dist-info/METADATA,sha256=LvORz9bYZSeWGo_dRCi1krLCMaxXu32cAZWGKjOLGEE,13257
+pi_agent_python_sdk-0.2.4.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+pi_agent_python_sdk-0.2.4.dist-info/licenses/LICENSE,sha256=VVC0d0PIT1GtbRUJluzmcIv-UYtsqsBfvWLFu5Qrbco,1067
+pi_agent_python_sdk-0.2.4.dist-info/RECORD,,