How cogitave/namzu works
Namzu is an agent kernel SDK with a terminal coding-agent application built on the same runtime. Its principal workflow accepts an agent configuration and prompt, applies identity and budgets, calls a provider, schedules and executes tools under permissions, and returns a result while recording session state. The SDK also supports durable sessions, checkpoints, compaction, delegation, directory-based agents, and host-supplied sandboxing. The CLI adds interactive coding workflows and integrations. Several runtime links are documented in the README; unsampled subsystems are represented at their source-directory level.
Main entry points: src Agent runtime · App.tsx Interactive TUI · session-storage.ts Session storage · manager.ts Tool scheduler
Components 23
Agent kernel
- Agent configuration
packages/sdk/src/types/agent/base.ts - Agent runtime
packages/sdk/src - Turn budgets
packages/sdk/src/store/budget/ledger.ts - Context compaction
packages/sdk/src/compaction/manager.ts - Agent delegation
packages/sdk/src/types/agent/task.ts - Directory agents
packages/sdk/src/agents
Identity and durability
- Session identity
packages/sdk/src/types/ids/index.ts - Session storage
packages/sdk/src/runtime/query/session-storage.ts - Hash-chained log
packages/sdk/src/store/session-log/core.ts - Turn checkpoints
packages/sdk/src/store/checkpoint
Tools and confinement
- Tool scheduler
packages/sdk/src/toolsets/manager.ts - Permission gate
packages/sdk/src/types/permission - Sandbox backends
packages/sandbox/src
Model drivers
- Provider registry
packages/cli/src/integrations/providers/registry.ts - Model drivers
packages/providers - Zen driver
packages/providers/zen/src/client.ts
Terminal application
- Interactive TUI
packages/cli/src/tui/App.tsx - CLI sessions
packages/cli/src/integrations/sessions/store.ts - Resident agents
packages/cli/src/integrations/resident - Job scheduling
packages/cli/src/schedule - Browser control
packages/browser/src
Other components
- SDK host
- Terminal user
Connections 26
- SDK host → Agent configuration: configures
README.md - Agent configuration → Agent runtime: runs turn
README.md - Agent runtime → Session identity: creates identity
README.md - Agent runtime → Turn budgets: applies budget
README.md - Agent runtime → Provider registry: uses provider
- Agent runtime → Tool scheduler: schedules tools
README.md - Tool scheduler → Permission gate: checks access
README.md - Tool scheduler → Sandbox backends: confines execution
- Agent runtime → Session storage: resolves storage
packages/sdk/src/types/agent/base.ts - Session storage → Hash-chained log: opens log
packages/sdk/src/runtime/query/session-storage.ts - Session storage → Turn checkpoints: opens stores
packages/sdk/src/runtime/query/session-storage.ts - Agent runtime → Hash-chained log: records turn
README.md - Agent runtime → Turn checkpoints: writes checkpoints
README.md - Agent runtime → Context compaction: compacts context
packages/sdk/src/compaction/manager.ts - Agent runtime → Agent delegation: delegates work
README.md - Agent delegation → Session storage: inherits storage
packages/sdk/src/agents/storage.ts - Directory agents → Agent runtime: derives options
README.md - Provider registry → Model drivers: selects driver
- Model drivers → Zen driver: includes
packages/providers/zen/src/client.ts - Terminal user → Interactive TUI: starts session
README.md - Interactive TUI → Agent runtime: runs agent
README.md - Interactive TUI → Provider registry: discovers providers
packages/cli/src/tui/App.tsx - Interactive TUI → CLI sessions: opens sessions
packages/cli/src/tui/App.tsx - Interactive TUI → Resident agents: uses resident agents
- Interactive TUI → Job scheduling: creates schedule integration
packages/cli/src/tui/App.tsx - Interactive TUI → Browser control: controls browser