II.
AgentRuntimeImpl overview
Reference · liveagent-runtime-impl:pi.runtime@current
Pi Runtime (current) overview
Inspect the raw attributes, linked wiki pages, and inbound or outbound graph edges for agent-runtime-impl:pi.runtime@current.
Attributes
displayName
Pi Runtime (current)
agentVersionId
agentVersion:pi:ge-0-75-5
subagentDispatchMechanism
none
packageRef
builtInTools
toolRegistryDiscovery
static-bundled
hookSockets
[]
internalSessionStateLocation
~/.pi/agent/sessions/
sessionFileFormat
jsonl-tree
sessionFilePathConvention
~/.pi/agent/sessions/<session-id>.jsonl
approvalGatingPrimitive
per-call
subprocessSandboxStrategy
none
runtimeIdentity
api-key
rpcToolOptions
bash
excludeFromContext
supported
true
introducedIn
0.76.0
notes
RPC clients can suppress bash command output from the next prompt context.
supportedMCPTransports
supportsStreaming
true
harnessFeatures
skillInvocation
Skills are invoked via formatSkillInvocation in the harness layer.
The harness formats skill calls into the agent loop and dispatches
them as structured tool-use interactions.
promptTemplates
Pi's harness includes a prompt-template system for composing system
prompts, tool descriptions, and context injection. Templates are
parameterized and resolved at session start.
compaction
The AgentHarness implements branch-summarization compaction. When
context window usage exceeds a configurable threshold, older
conversation branches are summarized and replaced with condensed
representations. Settings include threshold percentage and
summarization strategy.
sessionManagement
Session state is managed by the harness with JSONL-tree persistence.
Sessions support resume, fork, and branch operations. The harness
tracks conversation structure as a tree of turns.
Pi 0.76.0 adds `--session-id <id>` so callers can create or resume
an exact project-local session instead of relying only on env state.
executionEnvironment
The harness provides an execution-env abstraction layer that
normalizes OS, shell, and filesystem access across platforms.
Tool implementations (bash, read, write, edit) are dispatched
through this abstraction.
rpcBashContextControl
Pi 0.76.0 RPC mode accepts `excludeFromContext` on `bash`.
When true, command output is returned to the RPC caller but omitted
from context sent with the next model prompt.
Outgoing edges
bundles4
- tool-descriptor:read·ToolDescriptorRead
- tool-descriptor:write·ToolDescriptorWrite
- tool-descriptor:edit·ToolDescriptorEdit
- tool-descriptor:bash·ToolDescriptorBash
compaction_policy_applied_by1
- compaction-policy:pi-coding-agent·CompactionPolicypi-mono coding-agent branch + cumulative summarization
composes1
- agent:pi·AgentProductPi
connects1
- mcp-transport:stdio·MCPTransportstdio
output_guard_applied_by1
- output-guard:pi-coding-agent·OutputGuardpi-mono coding-agent output guard
realizes1
- layer:5-agent-runtime·LayerAgent-Runtime
speaks1
- mcp-transport:stdio·MCPTransportstdio
supports1
- capability:supports-mcp·CapabilitySupports MCP
Incoming edges
composed_of3
- agentVersion:pi:ge-0-75-5·AgentVersionPi CLI (>=0.77.0)
- agentVersion:pi:ge-0-75-5·AgentVersionPi CLI (>=0.77.0)
- agent-version:pi-sdk@current·AgentVersion
spoken_by1
- mcp-transport:stdio·MCPTransportstdio