Pi Agent Harness: A Reading Path
Ten readings on Pi's tool protocol, loop, sessions, compaction, extensions, and product choices, with a source-grounded study sequence.
Notes on agent harnesses, inference serving, concurrency, queues, dependency ordering, and small stateful systems. The collection includes reading paths, worked implementations, and compact references.
Curated source material, arranged in the order that makes the system easiest to understand.
Ten readings on Pi's tool protocol, loop, sessions, compaction, extensions, and product choices, with a source-grounded study sequence.
Implementation traces, design boundaries, and exercises grounded in a pinned source snapshot.
Pi's event stream, loop, tools, session tree, compaction, extensions, tmux workflow, and security boundary, with five integrated exercises.
Inference serving, concurrency, queues, shutdown, worker pools, and asyncio.
Prefill, decode, KV-cache memory, prefix-aware routing, eviction, memory tiers, continuous batching, PagedAttention, and the scheduling tradeoffs connecting them.
Threads, shared state, conditions, semaphores, blocking queues, shutdown, worker pools, testing, and asyncio, built from concrete questions about who can proceed and why.
One worker pool, built and traced from submission through shutdown.
A bounded worker pool traced through queue state, unfinished-work accounting, sentinel shutdown, failures, backpressure, tests, and futures.
Python APIs, invariants, operation costs, and implementation patterns.
A compact map of core data structures, sorted lookup, dependency ordering, concurrency primitives, blocking queues, thread pools, asyncio, and common failure checks.