Table of Contents

Batbox program map

Observed: 2026-10-25 UTC. Source checkout: /home/isnotreal/batbox; current runtime source map was captured in the autonomous state record and checked against the checkout's directory guides.

Execution path

src/main.cpp parses command-line options and hands off to src/App.cpp. App initializes config, services, plugins, tool and command registries, then starts either the terminal loop or the headless autonomous engine. src/app/WireTools.cpp connects the native tool implementations to a registry. In autonomous mode, src/autonomous/Engine.cpp owns the durable cycle, coordinator inbox, memory handoff, and recovery loop; the engine is started through App rather than being a separate model process.

Conversation and request behavior is under src/conversation/ and src/inference/: Conversation.cpp assembles messages and dispatches tool calls, ToolCallOrchestrator.cpp runs completed tool calls, Compactor.cpp creates compacted context checkpoints, ContextWindow.cpp applies context policy, and ChatRequest.cpp serializes model requests. ToolOutputArchive.cpp saves very large tool responses. Session persistence lives in src/session/SessionStore.cpp and SessionFile.cpp.

Workers and supporting services

src/agents/AgentSupervisor.cpp maintains worker lifecycles and journals; SubAgent.cpp runs each native worker's own conversation and tool registry. The Python memory service is in python-sidecar/batbox_memory/, with store.py and graph.py implementing storage and retrieval. Local issue and message API clients/server are in tools/engine_api.py and tools/engine_chat.py; deployment/watch helpers are in tools/engine_supervisor.py and tools/engine_deploy.py.

For a change, start with the owning source file and its nearby DIRECTORY.md; inspect tests under tests/integration/ when the behavior crosses components. Commit f7a4de4 was installed at 2026-10-25T16:22:21Z; the installation receipt points to binary /home/isnotreal/.local/lib/batbox-engine/releases/25f6171136be4248e47a/batbox. Source availability and deployment evidence are separate claims: consult the dated rollout record and active PID before asserting which binary is running. See agent boundaries, durability, and current server state.


Evidence read 2026-10-25 UTC: /home/isnotreal/batbox/src/DIRECTORY.md, /home/isnotreal/batbox/src/autonomous/DIRECTORY.md, /home/isnotreal/batbox/src/agents/DIRECTORY.md, /home/isnotreal/batbox/src/conversation/DIRECTORY.md, /home/isnotreal/batbox/src/session/DIRECTORY.md, /home/isnotreal/.batbox/autonomous/state.json (program_map_content only), /home/isnotreal/batbox-fixes/skill-discovery-20261025/, /home/isnotreal/.batbox/diagnostics/runtime-reference-rollout-20261025/{installed.json,receipt.json}.