cite-agent 1.0.4__py3-none-any.whl → 1.2.3__py3-none-any.whl

cite_agent-1.2.3.dist-info/METADATA

@@ -0,0 +1,442 @@
+Metadata-Version: 2.4
+Name: cite-agent
+Version: 1.2.3
+Summary: Terminal AI assistant for academic research with citation verification
+Home-page: https://github.com/Spectating101/cite-agent
+Author: Cite-Agent Team
+Author-email: contact@citeagent.dev
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.9.0
+Requires-Dist: groq>=0.4.0
+Requires-Dist: openai>=1.0.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: pydantic>=2.5.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: keyring>=24.3.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Cite-Agent: AI Research Assistant
+
+[![Version](https://img.shields.io/badge/version-1.2.0-blue.svg)](https://pypi.org/project/cite-agent/)
+[![Python](https://img.shields.io/badge/python-3.8+-green.svg)](https://python.org)
+[![License](https://img.shields.io/badge/license-MIT-orange.svg)](LICENSE)
+
+**Cite-Agent** is a sophisticated AI research assistant that combines academic research, financial data, and truth-seeking capabilities in one powerful tool. Built for researchers, academics, and professionals who need accurate, cited information.
+
+## 🌟 Features
+
+### 🔬 **Academic Research**
+- Search academic papers across multiple databases
+- Citation verification and quality scoring
+- DOI resolution and metadata extraction
+- Multi-source verification (Semantic Scholar, OpenAlex, PubMed)
+
+### 💰 **Financial Data**
+- Real-time stock market data via FinSight API
+- SEC filings and financial reports
+- Company metrics and KPIs
+- Historical financial analysis
+
+### 🎯 **Truth-Seeking AI**
+- Fact-checking with source verification
+- Confidence scoring for responses
+- Multi-language support (English, Chinese)
+- Temperature-controlled responses (0.2 for accuracy)
+
+### 📊 **Analytics & Tracking**
+- User activity tracking
+- Download analytics
+- Usage statistics
+- Citation quality metrics
+
+### 🔄 **Workflow Integration** (NEW!)
+- Local paper library management
+- BibTeX export for citation managers
+- Clipboard integration for instant citations
+- Markdown export for Obsidian/Notion
+- Session history and query replay
+- **Zero context switching** - stay in your flow
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+pip install cite-agent
+```
+
+### Basic Usage
+
+```bash
+# Interactive mode
+cite-agent
+
+# Single query
+cite-agent "Find research papers on machine learning in healthcare"
+
+# Workflow integration (NEW!)
+cite-agent "Find BERT paper" --save --format bibtex --copy
+cite-agent --library              # View saved papers
+cite-agent --export-bibtex        # Export to .bib file
+cite-agent --history              # See recent queries
+
+# Get help
+cite-agent --help
+```
+
+### Python API
+
+```python
+import asyncio
+from cite_agent import EnhancedNocturnalAgent, ChatRequest
+
+async def main():
+    agent = EnhancedNocturnalAgent()
+    await agent.initialize()
+    
+    request = ChatRequest(
+        question="What is the current state of AI in healthcare?",
+        user_id="user123",
+        conversation_id="conv456"
+    )
+    
+    response = await agent.process_request(request)
+    print(response.response)
+    print(f"Confidence: {response.confidence_score}")
+    print(f"Tools used: {response.tools_used}")
+    
+    await agent.close()
+
+asyncio.run(main())
+```
+
+## 📖 Documentation
+
+### Command Line Interface
+
+#### Basic Commands
+
+```bash
+# Show version
+cite-agent --version
+
+# Interactive setup
+cite-agent --setup
+
+# Show tips
+cite-agent --tips
+
+# Check for updates
+cite-agent --check-updates
+```
+
+#### Query Examples
+
+```bash
+# Academic research
+cite-agent "Find papers on transformer architecture"
+cite-agent "Verify this citation: Smith, J. (2023). AI in Medicine. Nature, 45(2), 123-145."
+
+# Financial data
+cite-agent "What is Apple's current revenue?"
+cite-agent "Get Tesla's financial metrics for Q3 2024"
+
+# Fact-checking
+cite-agent "Is water's boiling point 100°C at standard pressure?"
+cite-agent "Did Shakespeare write Harry Potter?"
+
+# Multi-language
+cite-agent "我的p值是0.05，這顯著嗎？"
+cite-agent "天空是藍色的嗎？"
+```
+
+### Python API Reference
+
+#### EnhancedNocturnalAgent
+
+The main agent class for programmatic access.
+
+```python
+class EnhancedNocturnalAgent:
+    async def initialize(self, force_reload: bool = False)
+    async def process_request(self, request: ChatRequest) -> ChatResponse
+    async def process_request_streaming(self, request: ChatRequest)
+    async def search_academic_papers(self, query: str, limit: int = 10) -> Dict[str, Any]
+    async def get_financial_data(self, ticker: str, metric: str, limit: int = 12) -> Dict[str, Any]
+    async def synthesize_research(self, paper_ids: List[str], max_words: int = 500) -> Dict[str, Any]
+    async def close(self)
+```
+
+#### Data Models
+
+```python
+@dataclass
+class ChatRequest:
+    question: str
+    user_id: str = "default"
+    conversation_id: str = "default"
+    context: Dict[str, Any] = field(default_factory=dict)
+
+@dataclass
+class ChatResponse:
+    response: str
+    tools_used: List[str] = field(default_factory=list)
+    reasoning_steps: List[str] = field(default_factory=list)
+    model: str = "enhanced-nocturnal-agent"
+    timestamp: str = field(default_factory=lambda: datetime.now().isoformat())
+    tokens_used: int = 0
+    confidence_score: float = 0.0
+    execution_results: Dict[str, Any] = field(default_factory=dict)
+    api_results: Dict[str, Any] = field(default_factory=dict)
+    error_message: Optional[str] = None
+```
+
+### API Endpoints
+
+#### Authentication
+- `POST /api/auth/register` - Register new user
+- `POST /api/auth/login` - User login
+- `POST /api/auth/refresh` - Refresh token
+- `GET /api/auth/me` - Get current user info
+- `POST /api/auth/logout` - Logout user
+
+#### Research
+- `POST /api/search` - Search academic papers
+- `POST /api/synthesize` - Synthesize research papers
+- `POST /api/format` - Format citations
+
+#### Financial Data
+- `GET /v1/finance/calc/{ticker}/{metric}` - Get financial metrics
+- `GET /v1/finance/kpis/{ticker}` - Get company KPIs
+- `GET /v1/finance/reports/{ticker}` - Get financial reports
+
+#### Analytics
+- `GET /api/download/stats/summary` - Download statistics
+- `GET /api/analytics/overview` - Usage overview
+- `GET /api/analytics/users` - User statistics
+
+#### Download Tracking
+- `GET /api/download/windows` - Track Windows downloads
+- `GET /api/download/macos` - Track macOS downloads
+- `GET /api/download/linux` - Track Linux downloads
+
+## 🔧 Configuration
+
+### Environment Variables
+
+```bash
+# Authentication
+NOCTURNAL_ACCOUNT_EMAIL=your@email.edu
+NOCTURNAL_ACCOUNT_PASSWORD=your_password
+
+# API Configuration
+NOCTURNAL_API_URL=https://cite-agent-api-720dfadd602c.herokuapp.com
+ARCHIVE_API_URL=https://cite-agent-api-720dfadd602c.herokuapp.com/api
+FINSIGHT_API_URL=https://cite-agent-api-720dfadd602c.herokuapp.com/v1/finance
+
+# Optional
+NOCTURNAL_DEBUG=1  # Enable debug logging
+NOCTURNAL_QUERY_LIMIT=25  # Default query limit
+```
+
+### Session Management
+
+Sessions are automatically managed and stored in:
+- **Linux/macOS**: `~/.nocturnal_archive/session.json`
+- **Windows**: `%USERPROFILE%\.nocturnal_archive\session.json`
+
+## 📊 Analytics & Monitoring
+
+### User Tracking
+
+The system automatically tracks:
+- User registrations and logins
+- Query history and usage patterns
+- Token consumption and costs
+- Response quality and citation accuracy
+
+### Download Analytics
+
+Track installer downloads across platforms:
+- Windows, macOS, Linux downloads
+- Geographic distribution (IP-based)
+- Referrer tracking
+- Download trends and patterns
+
+### Dashboard Access
+
+Access the analytics dashboard at:
+```
+https://cite-agent-api-720dfadd602c.herokuapp.com/dashboard
+```
+
+## 💰 Monetization & Pricing
+
+### Current Pricing Tiers
+
+| Tier | Price | Queries/Month | Rate Limit | Features |
+|------|-------|---------------|------------|----------|
+| **Free** | $0 | 100 | 100/hour | Basic research, limited finance |
+| **Pro** | $9/month | 1,000 | 1,000/hour | Full features, priority support |
+| **Academic** | $5/month | 500 | 500/hour | Student discount, same features |
+| **Enterprise** | $99/month | Unlimited | 5,000/hour | API access, custom integrations |
+
+### Revenue Model
+
+- **Subscription-based**: Monthly recurring revenue
+- **Usage-based**: Pay-per-query options available
+- **API licensing**: Enterprise customers
+- **White-label**: Custom deployments
+
+## 🛠️ Development
+
+### Local Development
+
+```bash
+# Clone repository
+git clone https://github.com/yourusername/cite-agent.git
+cd cite-agent
+
+# Install dependencies
+pip install -r requirements.txt
+pip install -r requirements-dev.txt
+
+# Run tests
+pytest
+
+# Start development server
+python -m cite_agent.dashboard
+```
+
+### Building from Source
+
+```bash
+# Build wheel
+python setup.py bdist_wheel
+
+# Install locally
+pip install dist/cite_agent-1.0.5-py3-none-any.whl
+```
+
+### Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests
+5. Submit a pull request
+
+## 🔒 Security & Privacy
+
+### Data Protection
+- All user data encrypted in transit and at rest
+- JWT-based authentication with 30-day expiration
+- No storage of sensitive personal information
+- GDPR compliant data handling
+
+### API Security
+- Rate limiting per user tier
+- Input validation and sanitization
+- SQL injection prevention
+- CORS protection
+
+## 📈 Performance
+
+### Benchmarks
+- **Average response time**: 2-5 seconds
+- **Citation verification**: 95%+ accuracy
+- **Uptime**: 99.9% SLA
+- **Concurrent users**: 1000+ supported
+
+### Optimization
+- Async/await architecture
+- Connection pooling
+- Response caching
+- CDN distribution
+
+## 🐛 Troubleshooting
+
+### Common Issues
+
+#### CLI Hangs on Startup
+```bash
+# Clear session and reconfigure
+rm -rf ~/.nocturnal_archive
+cite-agent --setup
+```
+
+#### Authentication Errors
+```bash
+# Check credentials
+cite-agent --setup
+
+# Verify email format (must be academic)
+# Valid: user@university.edu, student@ac.uk
+# Invalid: user@gmail.com, user@company.com
+```
+
+#### API Connection Issues
+```bash
+# Check network connectivity
+curl https://cite-agent-api-720dfadd602c.herokuapp.com/api/health
+
+# Verify API keys
+echo $NOCTURNAL_ACCOUNT_EMAIL
+```
+
+### Debug Mode
+
+```bash
+# Enable debug logging
+export NOCTURNAL_DEBUG=1
+cite-agent "your query"
+```
+
+### Support
+
+- **Documentation**: [Full docs](https://docs.cite-agent.com)
+- **Issues**: [GitHub Issues](https://github.com/yourusername/cite-agent/issues)
+- **Email**: support@cite-agent.com
+- **Discord**: [Community Server](https://discord.gg/cite-agent)
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🙏 Acknowledgments
+
+- **OpenAlex** for academic data
+- **Semantic Scholar** for research papers
+- **FinSight** for financial data
+- **Groq** for LLM processing
+- **FastAPI** for the backend framework
+
+## 📞 Contact
+
+- **Website**: https://cite-agent.com
+- **Email**: contact@cite-agent.com
+- **Twitter**: [@cite_agent](https://twitter.com/cite_agent)
+- **LinkedIn**: [Cite-Agent](https://linkedin.com/company/cite-agent)
+
+---
+
+**Made with ❤️ for the research community**

cite_agent-1.2.3.dist-info/RECORD

@@ -0,0 +1,54 @@
+cite_agent/__init__.py,sha256=wAXV2v8nNOmIAd0rh8196ItBl9hHWBVOBl5Re4VB77I,1645
+cite_agent/account_client.py,sha256=yLuzhIJoIZuXHXGbaVMzDxRATQwcy-wiaLnUrDuwUhI,5725
+cite_agent/agent_backend_only.py,sha256=H4DH4hmKhT0T3rQLAb2xnnJVjxl3pOZaljL9r6JndFY,6314
+cite_agent/ascii_plotting.py,sha256=lk8BaECs6fmjtp4iH12G09-frlRehAN7HLhHt2crers,8570
+cite_agent/auth.py,sha256=CYBNv8r1_wfdhsx-YcWOiXCiKvPBymaMca6w7JV__FQ,9809
+cite_agent/backend_only_client.py,sha256=WqLF8x7aXTro2Q3ehqKMsdCg53s6fNk9Hy86bGxqmmw,2561
+cite_agent/cli.py,sha256=P2tZ7g3qD65N1FGlBnEll8jgC_L3UiPNdU05plpNkV0,31858
+cite_agent/cli_conversational.py,sha256=RAmgRNRyB8gQ8QLvWU-Tt23j2lmA34rQNT5F3_7SOq0,11141
+cite_agent/cli_enhanced.py,sha256=EAaSw9qtiYRWUXF6_05T19GCXlz9cCSz6n41ASnXIPc,7407
+cite_agent/cli_workflow.py,sha256=4oS_jW9D8ylovXbEFdsyLQONt4o0xxR4Xatfcc4tnBs,11641
+cite_agent/dashboard.py,sha256=VGV5XQU1PnqvTsxfKMcue3j2ri_nvm9Be6O5aVays_w,10502
+cite_agent/enhanced_ai_agent.py,sha256=hNpKUOfu7_C2-A0vQS8jPmrSO_UympdAQ9MGYhwU_fY,146938
+cite_agent/rate_limiter.py,sha256=-0fXx8Tl4zVB4O28n9ojU2weRo-FBF1cJo9Z5jC2LxQ,10908
+cite_agent/session_manager.py,sha256=jD2v_owu7m0tS_Qly0g2XGnqupfE8Dv9sqkeoAeidj0,7999
+cite_agent/setup_config.py,sha256=kNZNr5cZmCXr43rGWNenNJXZ1Kfz7PrdLXpAqxM7WgM,16404
+cite_agent/streaming_ui.py,sha256=N6TWOo7GVQ_Ynfw73JCfrdGcLIU-PwbS3GbsHQHegmg,7810
+cite_agent/telemetry.py,sha256=55kXdHvI24ZsEkbFtihcjIfJt2oiSXcEpLzTxQ3KCdQ,2916
+cite_agent/ui.py,sha256=r1OAeY3NSeqhAjJYmEBH9CaennBuibFAz1Mur6YF80E,6134
+cite_agent/updater.py,sha256=BLNF2zsd-uxXx5qh3uuBcbeAsGeb6Ad2dQbyrHqISKU,8478
+cite_agent/web_search.py,sha256=j-BRhT8EBC6BEPgACQPeVwB1SVGKDz4XLM7sowacvSc,6587
+cite_agent/workflow.py,sha256=a0YC0Mzz4or1C5t2gZcuJBQ0uMOZrooaI8eLu2kkI0k,15086
+cite_agent/workflow_integration.py,sha256=A9ua0DN5pRtuU0cAwrUTGvqt2SXKhEHQbrHx16EGnDM,10910
+cite_agent-1.2.3.dist-info/licenses/LICENSE,sha256=XJkyO4IymhSUniN1ENY6lLrL2729gn_rbRlFK6_Hi9M,1074
+src/__init__.py,sha256=0eEpjRfjRjOTilP66y-AbGNslBsVYr_clE-bZUzsX7s,40
+src/services/__init__.py,sha256=pTGLCH_84mz4nGtYMwQES5w-LzoSulUtx_uuNM6r-LA,4257
+src/services/simple_enhanced_main.py,sha256=IJoOplCqcVUg3GvN_BRyAhpGrLm_WEPy2jmHcNCY6R0,9257
+src/services/auth_service/__init__.py,sha256=VVFfBUr_GMJuxVH_553D2PZmZ9vhHeab9_qiJEf-g6Q,38
+src/services/auth_service/auth_manager.py,sha256=MJdWFE36R_htoyBbjgGSTSx2Py61sTM3lhBjXBZ4Bog,873
+src/services/graph/__init__.py,sha256=jheRQ-x652RZ68fKyUqUNGXmTAJsp5URVMhlOauFRO0,29
+src/services/graph/knowledge_graph.py,sha256=ips2IpVpxDFkdPku4XKgZNRnoR2NjZqZk3xbIArJaaM,7348
+src/services/llm_service/__init__.py,sha256=eNAsQpJtVXpJENb-gHtpKzWpncnHHAMB05EI48wrugQ,122
+src/services/llm_service/llm_manager.py,sha256=6o5KN-3wJ0hT8PS9hPMpTGS6G9SlleSzYsXZQRjj_vI,21027
+src/services/paper_service/__init__.py,sha256=0ONhTf_3H81l5y6EqHMRZd5dCXLAXDa-gbYwge84zKA,142
+src/services/paper_service/openalex.py,sha256=pPhPcHMK2gQJCUVPB4ujE8xya0UqUvfcN95cy5ooP68,8801
+src/services/performance_service/__init__.py,sha256=48bYfW4pzf-FG9644kTnNwGyD1tJJ7tVn3cD3r_ZAbk,65
+src/services/performance_service/rust_performance.py,sha256=n-FzJ98XslmpUAkmmuaunYDTPz-9ZY-qL4oWAoBAaoA,15558
+src/services/research_service/__init__.py,sha256=ZCBzSUdstHqwMmJ1x0kJK4PkRlv9OrSOEFeQFoVM-7M,813
+src/services/research_service/chatbot.py,sha256=12pVAoe_fd2RXi6_cP-fxfRnWyJStsyn8znVu5cy9qo,91153
+src/services/research_service/citation_manager.py,sha256=vzyVivBS0_9IiFE-wOH9hiLiC-fpHmiaZpR1084DenE,16586
+src/services/research_service/context_manager.py,sha256=FGbeylLWKvgoA5fElyiqg5IhnMBIZ-t3w0oDHN4Zy1E,61332
+src/services/research_service/conversation_manager.py,sha256=-rdzURzu-SiqozyeQLid5a5lS-KzIqGDozdE8BG-DTs,22854
+src/services/research_service/critical_paper_detector.py,sha256=gc3oZHB8RqDhxFqJx21NoKLcHmmqHXRo0eXY-AL5KSc,21941
+src/services/research_service/enhanced_research.py,sha256=5B8zZjJ2iSLEgnjfyDKow5x_MLRANLJdMbLmmPR5Lc0,4268
+src/services/research_service/enhanced_synthesizer.py,sha256=puJg2C10KXryCMPkec-chC4rxbIJdFFswo7w4rbaXkc,16603
+src/services/research_service/query_generator.py,sha256=LcFTGsewE6l2LRgUI2E6fXAcpy4vaYaUFFfZhI_WlYU,30707
+src/services/research_service/synthesizer.py,sha256=lCcu37PWhWVNphHKaJJDIC-JQ5OINAN7OJ7iV9BWAvM,52557
+src/services/search_service/__init__.py,sha256=UZFXdd7r6wietQ2kESXEyGffdfBbpghquecQde7auF4,137
+src/services/search_service/indexer.py,sha256=u3-uwdAfmahWWsdebDF9i8XIyp7YtUMIHzlmBLBnPPM,7252
+src/services/search_service/search_engine.py,sha256=S9HqQ_mk-8W4d4MUOgBbEGQGV29-eSuceSFvVb4Xk-k,12500
+cite_agent-1.2.3.dist-info/METADATA,sha256=0Yb0ily4Ko8QT4Zf5M5ztx8EasqOl-axwEHzhR4iiUM,11657
+cite_agent-1.2.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+cite_agent-1.2.3.dist-info/entry_points.txt,sha256=bJ0u28nFIxQKH1PWQ2ak4PV-FAjhoxTC7YADEdDenFw,83
+cite_agent-1.2.3.dist-info/top_level.txt,sha256=TgOFqJTIy8vDZuOoYA2QgagkqZtfhM5Acvt_IsWzAKo,15
+cite_agent-1.2.3.dist-info/RECORD,,

{cite_agent-1.0.4.dist-info → cite_agent-1.2.3.dist-info}/top_level.txt

@@ -1 +1,2 @@
 cite_agent
+src

src/__init__.py

@@ -0,0 +1 @@
+"""Project root package initializer."""

src/services/__init__.py

@@ -0,0 +1,132 @@
+"""
+Main services package for AI services layer
+Provides unified access to all service components
+"""
+
+# Import all major service classes for easy access
+from .llm_service.llm_manager import LLMManager
+from .research_service.enhanced_research import EnhancedResearchService  
+from .context_manager.advanced_context import AdvancedContextManager
+from .tool_framework.tool_manager import ToolManager
+from .auth_service.auth_manager import auth_manager
+
+# Service registry for dependency injection
+SERVICE_REGISTRY = {}
+
+def register_service(name: str, service_instance):
+    """Register a service instance in the global registry"""
+    SERVICE_REGISTRY[name] = service_instance
+
+def get_service(name: str):
+    """Get a service instance from the registry"""
+    return SERVICE_REGISTRY.get(name)
+
+def initialize_services(config: dict = None):
+    """Initialize all core services with configuration"""
+    config = config or {}
+    
+    # Initialize services (with minimal config for testing)
+    services = {}
+    
+    try:
+        # LLM Manager (needs redis_url but we'll handle gracefully)
+        redis_url = config.get('redis_url', 'redis://localhost:6379')
+        llm_manager = LLMManager(redis_url=redis_url)
+        services['llm_manager'] = llm_manager
+        register_service('llm_manager', llm_manager)
+    except Exception as e:
+        # Graceful fallback for testing
+        print(f"LLM Manager initialization skipped: {e}")
+    
+    try:
+        # Research Service
+        research_service = EnhancedResearchService()
+        services['research_service'] = research_service
+        register_service('research_service', research_service)
+    except Exception as e:
+        print(f"Research Service initialization skipped: {e}")
+    
+    try:
+        # Context Manager  
+        context_manager = AdvancedContextManager()
+        services['context_manager'] = context_manager
+        register_service('context_manager', context_manager)
+    except Exception as e:
+        print(f"Context Manager initialization skipped: {e}")
+    
+    try:
+        # Tool Manager
+        tool_manager = ToolManager()
+        services['tool_manager'] = tool_manager
+        register_service('tool_manager', tool_manager)
+    except Exception as e:
+        print(f"Tool Manager initialization skipped: {e}")
+    
+    return services
+
+class ServiceLayer:
+    """Unified service layer for easy access to all AI services"""
+    
+    def __init__(self, config: dict = None):
+        self.config = config or {}
+        self.services = {}
+        self._initialized = False
+    
+    def initialize(self):
+        """Initialize all services"""
+        if self._initialized:
+            return
+            
+        self.services = initialize_services(self.config)
+        self._initialized = True
+    
+    @property
+    def llm_manager(self) -> LLMManager:
+        """Get LLM Manager service"""
+        return self.services.get('llm_manager')
+    
+    @property 
+    def research_service(self) -> EnhancedResearchService:
+        """Get Research service"""
+        return self.services.get('research_service')
+    
+    @property
+    def context_manager(self) -> AdvancedContextManager:
+        """Get Context Manager service"""
+        return self.services.get('context_manager')
+    
+    @property
+    def tool_manager(self) -> ToolManager:
+        """Get Tool Manager service"""
+        return self.services.get('tool_manager')
+    
+    def get_health_status(self) -> dict:
+        """Get health status of all services"""
+        status = {
+            "services_initialized": self._initialized,
+            "total_services": len(self.services),
+            "available_services": list(self.services.keys())
+        }
+        return status
+
+# Global service layer instance
+_service_layer = None
+
+def get_service_layer(config: dict = None) -> ServiceLayer:
+    """Get the global service layer instance"""
+    global _service_layer
+    if _service_layer is None:
+        _service_layer = ServiceLayer(config)
+    return _service_layer
+
+# Export key classes and functions
+__all__ = [
+    'LLMManager',
+    'EnhancedResearchService', 
+    'AdvancedContextManager',
+    'ToolManager',
+    'ServiceLayer',
+    'get_service_layer',
+    'initialize_services',
+    'auth_manager'
+]

src/services/auth_service/__init__.py

@@ -0,0 +1,3 @@
+"""
+Authentication service package
+"""

src/services/auth_service/auth_manager.py

@@ -0,0 +1,33 @@
+"""
+Basic authentication manager for testing
+"""
+from typing import Dict, Any, Optional
+
+
+class AuthManager:
+    """Basic auth manager for testing purposes"""
+    
+    def __init__(self):
+        self.test_user = {
+            "id": "test_user_123",
+            "username": "test_user",
+            "email": "test@example.com"
+        }
+    
+    async def get_current_user(self) -> Dict[str, Any]:
+        """Return test user for testing"""
+        return self.test_user
+    
+    def verify_token(self, token: str) -> Optional[Dict[str, Any]]:
+        """Verify token (test implementation)"""
+        if token == "test_token":
+            return self.test_user
+        return None
+    
+    def create_token(self, user_data: Dict[str, Any]) -> str:
+        """Create token (test implementation)"""
+        return "test_token"
+
+
+# Global instance
+auth_manager = AuthManager()

src/services/graph/__init__.py

@@ -0,0 +1 @@
+"""Graph service package."""