How zalweny26/ts-cat works
Main Components
a) Core Components:
• Looking Glass (AI/LLM Integration Layer)
• CheshireCat (Main AI interaction handler)
• WhiteRabbit (Message processing)
• StrayCat (Auxiliary AI functions)
• AgentManager (AI agent management)
b) Plugin System:
• Mad Hatter (Plugin Management)
• Core Plugin Handler
• Forms Manager
• Hooks System
• Tools Manager
c) Memory System:
• Vector Memory
• Vector Memory Collections
• Database Integration (Qdrant)
d) API Layer:
• REST Endpoints
• WebSocket Server
• Rate Limiter
e) External Integrations:
• LLM Providers (OpenAI, Google, Ollama, HuggingFace)
• Embeddings Services
• Custom Services
Component Relationships
• Client Applications → API Layer (REST/WebSocket)
• API Layer → Looking Glass
• Looking Glass ↔ Mad Hatter (bidirectional for plugin interactions)
• Looking Glass ↔ Memory System
• Mad Hatter → Plugins
• Memory System ↔ Vector Database (Qdrant)
• Looking Glass ↔ External LLM Services
Specific Implementation Details
Technical annotations for:
• Docker container boundaries
• WebSocket streaming capabilities
• Cache layers for LLM and Embedder
• Rate limiting mechanism
• Plugin hook points
• Memory recall pathways
Data Flow Indicators
Specific flows for:
• User message processing
• Memory retrieval/storage
• Plugin execution
• LLM interactions
• Embedding processes
Architecture Patterns
Following patterns:
• Microservice architecture (Docker-based)
• Event-driven system (hooks and callbacks)
• Plugin-based extensibility
• Cache strategy
• API-first design
Technical Details to Note
• Built with TypeScript/Bun
• Docker-based deployment
• Qdrant vector database integration
• Multiple LLM provider support
• Real-time streaming capabilities
• Cache implementation
• Rate limiting
External service integration layer
This will create a comprehensive yet understandable representation of the system's architecture while maintaining the necessary level of detail for a principal software engineer to understand the complete system flow and component interactions.