How vereskdev/demonstrationbot works
assistant-bot is a personal Telegram assistant for notes, tasks, reminders, memory, and media generation. A Telegram update is polled, normalized and routed; owner commands and menu actions render deterministic views, while ordinary messages go through an agent turn that loads chat history, invokes Gemini and tools, then sends text and any queued files. A separate scheduler delivers due reminders. The README documents repository diagrams and image/card generation as tool capabilities. Some subsystem links are based on SOURCE INDEX references or README descriptions; unsampled implementation details are not inferred.
Main entry points: index.ts Assistant data · registry.ts Tool registry · handlers.ts Update routing · agent.ts Agent turn
Components 28
Telegram interface
- Application startup
src/main.ts - Long polling
src/telegram/polling.ts - Update routing
src/telegram/handlers.ts - Menu views
src/views.ts - Telegram API client
src/telegram/api.ts
Agent and models
- Agent turn
src/agent/agent.ts - Tool-call loop
src/llm/loop.ts - Gemini transport
src/llm/gemini.ts - Tool registry
src/tools/registry.ts
Assistant capabilities
- Notes
src/tools/notes.ts - Tasks
src/tools/tasks.ts - Reminder tools
src/tools/reminders.ts - Memory and settings
src/tools/memory.ts - Media tools
src/tools/media.ts - Reminder scheduler
src/scheduler/reminders.ts
Persistence and time
- Assistant data
src/db/index.ts - Time utilities
src/time.ts - Configuration
src/config.ts
External integrations
- HTTP runtime
src/runtime/http.ts - Image generation
src/images/generate.ts - Card rendering
src/images/card.ts - Graph rendering
src/diagrams/graphviz.ts - GitHub diagrams
src/diagrams/gitdiagram.ts
Other components
- Telegram owner
- Google Gemini
- Telegram Bot API
- Image providers
- GitDiagram service
Connections 40
- Telegram owner → Long polling: sends updates
README.md - Application startup → Long polling: starts
src/main.ts - Application startup → Update routing: configures
src/main.ts - Application startup → Reminder scheduler: starts
src/main.ts - Long polling → Update routing: dispatches updates
src/telegram/polling.ts - Update routing → Agent turn: routes messages
src/telegram/handlers.ts - Update routing → Menu views: renders menu views
src/telegram/handlers.ts - Update routing → Assistant data: reads chat state
src/telegram/handlers.ts - Update routing → Telegram API client: sends responses
src/telegram/handlers.ts - Agent turn → Tool-call loop: runs turn
src/agent/agent.ts - Agent turn → Assistant data: loads and saves history
src/agent/agent.ts - Agent turn → Tool registry: supplies tools
src/agent/agent.ts - Agent turn → Telegram API client: sends reply
- Tool-call loop → Gemini transport: requests model turn
src/llm/loop.ts - Tool-call loop → Tool registry: executes tool calls
src/llm/loop.ts - Gemini transport → HTTP runtime: sends requests
src/llm/gemini.ts - Gemini transport → Google Gemini: calls API
README.md - Tool registry → Notes: registers
src/tools/registry.ts - Tool registry → Tasks: registers
src/tools/registry.ts - Tool registry → Reminder tools: registers
src/tools/registry.ts - Tool registry → Memory and settings: registers
src/tools/registry.ts - Tool registry → Media tools: registers
src/tools/registry.ts - Notes → Assistant data: reads and writes
src/tools/notes.ts - Tasks → Assistant data: reads and writes
src/tools/tasks.ts - Reminder tools → Assistant data: reads and writes
src/tools/reminders.ts - Memory and settings → Assistant data: reads and writes
src/tools/memory.ts - Reminder scheduler → Assistant data: loads and updates due reminders
src/scheduler/reminders.ts - Reminder scheduler → Telegram API client: delivers reminders
- Reminder scheduler → Time utilities: calculates repeats
src/scheduler/reminders.ts - Reminder scheduler → Agent turn: records bot event
src/scheduler/reminders.ts - Menu views → Assistant data: reads data
src/views.ts - Media tools → Image generation: generates images
src/tools/media.ts - Media tools → Card rendering: renders cards
src/tools/media.ts - Media tools → Graph rendering: renders diagrams
src/tools/media.ts - Media tools → GitHub diagrams: requests repository diagrams
src/tools/media.ts - Image generation → HTTP runtime: sends requests
src/images/generate.ts - Image generation → Image providers: requests image generation
README.md - GitHub diagrams → GitDiagram service: checks generated diagrams
README.md - Telegram API client → HTTP runtime: uses HTTP client
src/telegram/api.ts - Configuration → Assistant data: configures data directory
src/db/index.ts