opencode/picoclaw
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
picoclaw/docs/architecture
History
Hoshina e613258fa5 feat(gateway): publish lifecycle runtime events 
Emit gateway.start, gateway.ready, and gateway.shutdown on the shared runtime event bus, while keeping reload events on the same helper path.

Update subturn architecture docs to refer to runtime event kinds instead of the removed agent EventBus names.

Validation: GOCACHE=/tmp/picoclaw-go-cache go test ./pkg/gateway ./pkg/events; GOCACHE=/tmp/picoclaw-go-cache go test ./pkg/bus ./pkg/channels ./pkg/mcp ./pkg/tools/integration ./pkg/events ./pkg/gateway; make lint
2026-04-26 17:02:48 +08:00
..
agent-refactor refactor(agent): Agent Looper refactor phase2, restructure pipeline and rename loop files to agent (#2585) 2026-04-21 10:55:50 +08:00
hooks refactor(events): emit agent runtime events directly 2026-04-26 16:55:02 +08:00
README.md docs: add session and routing documentation (#2571) 2026-04-17 21:25:18 +08:00
routing-system.md refactor(agent): Agent Looper refactor phase2, restructure pipeline and rename loop files to agent (#2585) 2026-04-21 10:55:50 +08:00
routing-system.zh.md docs: add session and routing documentation (#2571) 2026-04-17 21:25:18 +08:00
session-system.md refactor(agent): Agent Looper refactor phase2, restructure pipeline and rename loop files to agent (#2585) 2026-04-21 10:55:50 +08:00
session-system.zh.md docs: add session and routing documentation (#2571) 2026-04-17 21:25:18 +08:00
steering.md refactor(docs): reorganize docs by type and locale 2026-04-17 14:00:45 +08:00
subturn.md feat(gateway): publish lifecycle runtime events 2026-04-26 17:02:48 +08:00

README.md

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/.