How kykiles/sysadmin-agents works
This is a Telegram-operated sysadmin agent: a user submits a natural-language task, the Director plans it and delegates work to temporary agents, which use dynamically loaded skills to inspect or change infrastructure; risky operations require Telegram approval. The map also preserves the documented learning and monitoring branches. Some runtime wiring and skill dispatch are unsampled, so uncertain links are dashed rather than asserted as direct calls.
Main entry points: director.py Director · handlers.py Telegram bot · tools.py Skill tools · base.py Agent runtime
Components 24
Interaction and agents
- Telegram bot
app/bot/handlers.py - Director
app/agents/director.py - Agent runtime
app/agents/base.py - Task results
app/agents/messages.py - Task progress
app/bot/progress.py - Response rendering
app/bot/render.py
Skills and operations
- LLM client
app/llm/client.py - Skill loader
app/skills/loader.py - Skill packages
skills - Skill tools
skills/db/tools.py - Read-only policy
app/skills/readonly.py - Docker tools
app/tools/docker.py - Tool framework
app/tools/base.py
Memory and learning
- Knowledge facts
agent_memory/facts.py - Task journal
agent_memory/journal.py - Memory consolidation
agent_memory/consolidate.py - Learning review
app/learning/review.py - Dialog history
app/memory/history.py
Monitoring
- Health loop
app/monitoring/loop.py - Health checks
app/monitoring/checks.py - Monitor state
app/monitoring/state.py
External systems
- Managed infrastructure
- LLM provider
Other components
- Telegram user
Connections 26
- Telegram user → Telegram bot: sends task
- Telegram bot → Director: submits task
- Director → Agent runtime: spawns agents
app/agents/director.py - Director → Skill loader: loads skills
app/agents/director.py - Skill loader → Skill packages: loads packages
- Agent runtime → LLM client: requests completion
app/agents/base.py - LLM client → LLM provider: sends prompts
app/llm/client.py - Agent runtime → Tool framework: executes tools
app/agents/base.py - Skill tools → Tool framework: builds tools
skills/db/tools.py - Skill tools → Docker tools: uses Docker API
skills/db/tools.py - Skill tools → Read-only policy: uses policy
- Docker tools → Managed infrastructure: manages containers
- Director → Knowledge facts: recalls knowledge
app/agents/director.py - Director → Task journal: records tasks
- Director → Dialog history: uses dialog history
- Learning review → Knowledge facts: reviews facts
app/learning/review.py - Learning review → Memory consolidation: requests proposals
app/learning/review.py - Memory consolidation → Task journal: reads task journal
agent_memory/consolidate.py - Telegram bot → Learning review: offers self-review
app/bot/handlers.py - Health loop → Health checks: runs checks
app/monitoring/loop.py - Health loop → Monitor state: uses state
app/monitoring/loop.py - Health checks → Managed infrastructure: checks infrastructure
- Director → Task results: returns task result
app/agents/director.py - Telegram bot → Response rendering: renders response
app/bot/handlers.py - Task results → Response rendering: formats result
app/bot/render.py - Director → Task progress: updates task plan