Files
picoclaw/docs/architecture
Hoshina 8caf9aeb2b feat(events): publish runtime service events
Migrate hook observation to runtime events and update the process hook notification protocol. Add runtime event publication for message bus failures, channel lifecycle/outbound flow, gateway reloads, MCP server state, and MCP tool calls.

Validation: go test ./pkg/events/... ./pkg/bus ./pkg/agent ./pkg/channels ./pkg/mcp ./pkg/tools/integration ./pkg/gateway; make lint
2026-04-26 16:05:10 +08:00
..

Architecture

Internal architecture notes for major runtime mechanisms and subsystem design.

  • Steering: injecting messages into a running agent loop between tool calls.
  • SubTurn Mechanism: sub-agent coordination, concurrency control, and lifecycle handling.
  • Session System: session scope allocation, JSONL persistence, alias compatibility, and migration. (ZH)
  • Routing System: agent dispatch, session policy selection, and light/heavy model routing. (ZH)
  • Hook System Guide: current hook architecture and protocol details.
  • Agent Refactor: notes and checkpoints for the agent refactor work.

For proposal-style or exploratory docs, also see ../design/.