pagentv4

语言：中文 | English

pagentv4 is the newer typed API in this repository.

Use these pages if you want:

• Provider instead of LLM
• Message / Messages instead of Session
• Runner for thread-based orchestration, persistence, and sandbox workspaces
• A sandbox (companion computer) with file and command tools
• Optional Thread and Skill support for long-lived REPL-style apps

Module layout

core/       AgentCore, Message, Provider, Tool, Event
ithread/    IThread Protocol + ThreadSpec
runtime/    loop_core, LoopAdapter, BaseRunner, Runner, VanillaRunner, Thread
conversation/ ConversationStore implementations used through Thread
sandbox/    Backend, Sandbox, built-in file/command tools
tools/      reusable tool functions
adapters/   ACP encode/decode
skills/     SKILL.md discovery and on-demand loading

There are several layers inside runtime/:

• loop_core defines the shared run / turn / tool loop semantics
• LoopAdapter carries the shared loop skeleton, and each runner layers on capabilities:
  • VanillaRunner(LoopAdapter) — minimal in-memory environment
  • BaseRunner(LoopAdapter) — adds thread, conversation store, sandbox, skills
  • Runner(BaseRunner) — adds inbound control (steer/cancel/permit) and tool hooks

Pages

• Quick start
• Core types
• Messages
• Tools
• Events
• Sandbox

Status

New work should use pagentv4 and app (terminal REPL). The top-level pagent package still documents the older Session + LLM API for now.