pi-agent-python-sdk 0.2.3__tar.gz → 0.2.5__tar.gz

{pi_agent_python_sdk-0.2.3 → pi_agent_python_sdk-0.2.5}/CHANGELOG.md

@@ -2,6 +2,37 @@
 
 ## Unreleased
 
+## 0.2.5
+
+### Changed
+
+- Advance the reviewed Pi baseline from 1.0.0 to 1.3.0; keep the 0.85.1 minimum.
+  Strict-version users must align their separately installed runtime with 1.3.0.
+- Annotate Pi timing, malformed tool arguments, per-thinking-level sampling,
+  and settlement abort metadata. `AgentSettledEvent` now represents settlement
+  separately from `EmptySessionEvent`.
+- Resolve and validate the upstream version tag when npm omits `gitHead`, and
+  fingerprint the extracted model/provider schemas without approving source drift.
+- Recognize Pi's `--no-mcp` flag and document its changed tool-filtering and
+  Azure provider behavior.
+
+## 0.2.4
+
+### Added
+
+- Describe Pi 1.0.0 input dispositions, assistant thinking levels, nested tool
+  call records, parent tool-call IDs and model type in the typed wire annotations.
+  New fields remain optional where older supported runtimes omit them.
+
+### Changed
+
+- Update the tested Pi runtime from 0.87.0 to 1.0.0, retaining 0.85.1 as the minimum.
+  Python `prompt`, `steer` and `follow_up` still return `None`; use `request()`
+  for the response envelope and `data.disposition`.
+- Refresh the TypeScript behavior contract and extend parity coverage for
+  prompt streaming behavior and Pi 1.0.0 metadata.
+- Update development tools and pinned CI actions.
+
 ## 0.2.3
 
 ### Added

{pi_agent_python_sdk-0.2.3 → pi_agent_python_sdk-0.2.5}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.5
 Name: pi-agent-python-sdk
-Version: 0.2.3
+Version: 0.2.5
 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.3/docs
+Project-URL: Documentation, https://github.com/cheenulabs/pi-agent-python-sdk/tree/v0.2.5/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.3/CHANGELOG.md
+Project-URL: Changelog, https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.5/CHANGELOG.md
 Author: cheenulabs
 License-Expression: MIT
 License-File: LICENSE
@@ -29,7 +29,7 @@ Description-Content-Type: text/markdown
 
 <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.3/docs/logo.svg" width="160">
+    <img alt="Pi Agent Python SDK" src="https://raw.githubusercontent.com/cheenulabs/pi-agent-python-sdk/v0.2.5/docs/logo.svg" width="160">
   </a>
 </p>
 
@@ -59,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
@@ -77,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.87.0 |
-| Pi **0.85.1+** | Minimum accepted version; **0.87.0** is the tested baseline |
+| Node.js **22.19.0+** | Required by Pi 1.3.0 |
+| Pi **0.85.1+** | Minimum accepted version; **1.3.0** is the tested baseline |
 | Model provider | Required; configure with the Pi CLI (see Quick start) |
 
 ## Quick start
@@ -86,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.87.0
+npm install -g @earendil-works/pi-coding-agent@1.3.0
 pi --version
 ```
 
@@ -315,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.3 |
+| [Release notes][release] | Changes included in 0.2.5 |
 
 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.87.0** |
+| Version rejected | Upgrade to Pi **0.85.1+**; prefer the tested baseline **1.3.0** |
 | No model / auth errors | Run `pi` once and complete provider setup |
 | Unexpected file or command changes | Review Pi tool/extension settings before automation |
 
@@ -341,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.3
-[metadata]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.3/pyproject.toml
-[license]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.3/LICENSE
-[compatibility]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.3/docs/compatibility.md
-[errors]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.3/docs/errors.md
-[stream-example]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.3/examples/stream.py
-[constructor-options]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.3/docs/api.md#constructor-options
-[extensions]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.3/docs/usage.md#using-your-own-extensions
-[ui-example]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.3/examples/ui.py
-[rpc]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.3/docs/rpc.md
-[commands]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.3/docs/api.md#all-33-rpc-commands
-[usage]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.3/docs/usage.md
-[api]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.3/docs/api.md
-[examples]: https://github.com/cheenulabs/pi-agent-python-sdk/tree/v0.2.3/examples
-[contributing]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.3/CONTRIBUTING.md
+[release]: https://github.com/cheenulabs/pi-agent-python-sdk/releases/tag/v0.2.5
+[metadata]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.5/pyproject.toml
+[license]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.5/LICENSE
+[compatibility]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.5/docs/compatibility.md
+[errors]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.5/docs/errors.md
+[stream-example]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.5/examples/stream.py
+[constructor-options]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.5/docs/api.md#constructor-options
+[extensions]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.5/docs/usage.md#using-your-own-extensions
+[ui-example]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.5/examples/ui.py
+[rpc]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.5/docs/rpc.md
+[commands]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.5/docs/api.md#all-33-rpc-commands
+[usage]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.5/docs/usage.md
+[api]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.5/docs/api.md
+[examples]: https://github.com/cheenulabs/pi-agent-python-sdk/tree/v0.2.5/examples
+[contributing]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.5/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.3 → pi_agent_python_sdk-0.2.5}/README.md

@@ -6,7 +6,7 @@
 
 <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.3/docs/logo.svg" width="160">
+    <img alt="Pi Agent Python SDK" src="https://raw.githubusercontent.com/cheenulabs/pi-agent-python-sdk/v0.2.5/docs/logo.svg" width="160">
   </a>
 </p>
 
@@ -36,6 +36,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
@@ -54,8 +55,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.87.0 |
-| Pi **0.85.1+** | Minimum accepted version; **0.87.0** is the tested baseline |
+| Node.js **22.19.0+** | Required by Pi 1.3.0 |
+| Pi **0.85.1+** | Minimum accepted version; **1.3.0** is the tested baseline |
 | Model provider | Required; configure with the Pi CLI (see Quick start) |
 
 ## Quick start
@@ -63,7 +64,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.87.0
+npm install -g @earendil-works/pi-coding-agent@1.3.0
 pi --version
 ```
 
@@ -292,18 +293,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.3 |
+| [Release notes][release] | Changes included in 0.2.5 |
 
 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.87.0** |
+| Version rejected | Upgrade to Pi **0.85.1+**; prefer the tested baseline **1.3.0** |
 | No model / auth errors | Run `pi` once and complete provider setup |
 | Unexpected file or command changes | Review Pi tool/extension settings before automation |
 
@@ -318,20 +324,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.3
-[metadata]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.3/pyproject.toml
-[license]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.3/LICENSE
-[compatibility]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.3/docs/compatibility.md
-[errors]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.3/docs/errors.md
-[stream-example]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.3/examples/stream.py
-[constructor-options]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.3/docs/api.md#constructor-options
-[extensions]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.3/docs/usage.md#using-your-own-extensions
-[ui-example]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.3/examples/ui.py
-[rpc]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.3/docs/rpc.md
-[commands]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.3/docs/api.md#all-33-rpc-commands
-[usage]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.3/docs/usage.md
-[api]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.3/docs/api.md
-[examples]: https://github.com/cheenulabs/pi-agent-python-sdk/tree/v0.2.3/examples
-[contributing]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.3/CONTRIBUTING.md
+[release]: https://github.com/cheenulabs/pi-agent-python-sdk/releases/tag/v0.2.5
+[metadata]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.5/pyproject.toml
+[license]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.5/LICENSE
+[compatibility]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.5/docs/compatibility.md
+[errors]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.5/docs/errors.md
+[stream-example]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.5/examples/stream.py
+[constructor-options]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.5/docs/api.md#constructor-options
+[extensions]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.5/docs/usage.md#using-your-own-extensions
+[ui-example]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.5/examples/ui.py
+[rpc]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.5/docs/rpc.md
+[commands]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.5/docs/api.md#all-33-rpc-commands
+[usage]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.5/docs/usage.md
+[api]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.5/docs/api.md
+[examples]: https://github.com/cheenulabs/pi-agent-python-sdk/tree/v0.2.5/examples
+[contributing]: https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.5/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.3 → pi_agent_python_sdk-0.2.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pi-agent-python-sdk"
-version = "0.2.3"
+version = "0.2.5"
 description = "Typed async and synchronous Python clients for Pi's agent RPC runtime"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -26,9 +26,9 @@ dependencies = []
 
 [project.urls]
 Homepage = "https://github.com/cheenulabs/pi-agent-python-sdk"
-Documentation = "https://github.com/cheenulabs/pi-agent-python-sdk/tree/v0.2.3/docs"
+Documentation = "https://github.com/cheenulabs/pi-agent-python-sdk/tree/v0.2.5/docs"
 Issues = "https://github.com/cheenulabs/pi-agent-python-sdk/issues"
-Changelog = "https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.3/CHANGELOG.md"
+Changelog = "https://github.com/cheenulabs/pi-agent-python-sdk/blob/v0.2.5/CHANGELOG.md"
 
 [dependency-groups]
 dev = [

{pi_agent_python_sdk-0.2.3 → pi_agent_python_sdk-0.2.5}/src/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.87.0"
+TESTED_PI_VERSION = "1.3.0"
 
 # The client owns these options. In particular --print consumes an initial prompt.
 _RESERVED = {
@@ -59,6 +59,7 @@ _VALUES = {
     "--tui-mode",
 }
 _FLAGS = {
+    "--no-mcp",
     "--no-tools",
     "-nt",
     "--no-builtin-tools",

{pi_agent_python_sdk-0.2.3 → pi_agent_python_sdk-0.2.5}/src/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_python_sdk-0.2.3 → pi_agent_python_sdk-0.2.5}/src/pi_agent/types.py

@@ -1,4 +1,4 @@
-"""Pi 0.87.0 wire annotations and small Python conveniences.
+"""Pi 1.3.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"
@@ -52,6 +54,7 @@ class ToolCall(TypedDict):
     arguments: JSONObject
     thoughtSignature: NotRequired[str]
     namespace: NotRequired[str]
+    argumentsError: NotRequired[str]
 
 
 class UsageCost(TypedDict):
@@ -131,6 +134,7 @@ class AssistantMessage(TypedDict):
     model: str
     responseModel: NotRequired[str]
     responseId: NotRequired[str]
+    thinkingLevel: NotRequired[ThinkingLevel]
     providerThinkingLevel: NotRequired[str]
     diagnostics: NotRequired[list[AssistantMessageDiagnostic]]
     usage: Usage
@@ -140,6 +144,22 @@ class AssistantMessage(TypedDict):
     rawStopReason: NotRequired[str]
     endTurn: NotRequired[bool]
     timestamp: float
+    durationMs: NotRequired[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):
@@ -149,9 +169,11 @@ 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
+    durationMs: NotRequired[float]
 
 
 class BashExecutionMessage(TypedDict):
@@ -240,6 +262,7 @@ class ModelInputLimits(TypedDict, total=False):
 
 
 class Model(TypedDict):
+    type: NotRequired[Literal["chat"]]
     id: str
     name: str
     api: str
@@ -253,6 +276,7 @@ class Model(TypedDict):
     contextWindow: float
     maxTokens: float
     samplingParams: NotRequired[JSONObject]
+    samplingParamsByThinkingLevel: NotRequired[dict[ThinkingLevel, JSONObject]]
     headers: NotRequired[dict[str, str]]
     compat: NotRequired[JSONObject]
     promptCache: NotRequired[ModelPromptCache]
@@ -451,6 +475,14 @@ class QueueState(TypedDict):
     followUp: list[str]
 
 
+class PromptDispositionData(TypedDict):
+    disposition: PromptDisposition
+
+
+class QueuedInputDispositionData(TypedDict):
+    disposition: QueuedInputDisposition
+
+
 class SessionChangeResult(TypedDict):
     cancelled: bool
 
@@ -688,7 +720,12 @@ AssistantMessageEvent: TypeAlias = (
 
 
 class EmptySessionEvent(TypedDict):
-    type: Literal["agent_start", "agent_settled", "turn_start", "summarization_retry_finished"]
+    type: Literal["agent_start", "turn_start", "summarization_retry_finished"]
+
+
+class AgentSettledEvent(TypedDict):
+    type: Literal["agent_settled"]
+    aborted: NotRequired[bool]  # Absent on older supported runtimes.
 
 
 class AgentEndEvent(TypedDict):
@@ -721,6 +758,7 @@ class ToolExecutionStartEvent(TypedDict):
     toolCallId: str
     toolName: str
     args: JSONValue
+    parentToolCallId: NotRequired[str]
 
 
 class ToolExecutionUpdateEvent(TypedDict):
@@ -729,6 +767,7 @@ class ToolExecutionUpdateEvent(TypedDict):
     toolName: str
     args: JSONValue
     partialResult: JSONValue
+    parentToolCallId: NotRequired[str]
 
 
 class ToolExecutionEndEvent(TypedDict):
@@ -737,6 +776,8 @@ class ToolExecutionEndEvent(TypedDict):
     toolName: str
     result: JSONValue
     isError: bool
+    durationMs: NotRequired[float]
+    parentToolCallId: NotRequired[str]
 
 
 class QueueUpdateEvent(QueueState):
@@ -806,6 +847,7 @@ class BashExecutionUpdateEvent(TypedDict):
 
 SessionEvent: TypeAlias = (
     EmptySessionEvent
+    | AgentSettledEvent
     | AgentEndEvent
     | TurnEndEvent
     | MessageBoundaryEvent