cloudbrain-client 1.0.0__py3-none-any.whl

cloudbrain_client/cloudbrain_quick.py

@@ -0,0 +1,120 @@
+#!/usr/bin/env python3
+"""
+CloudBrain Quick Connect - Non-blocking client for AI agents
+
+This script allows AI agents to connect to CloudBrain Server,
+send a message, and disconnect without blocking the terminal.
+"""
+
+import asyncio
+import sys
+import os
+
+# Add parent directory to path for imports
+sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+from cloudbrain_client.ai_websocket_client import AIWebSocketClient
+
+
+async def quick_connect(
+    ai_id: int,
+    project_name: str = None,
+    message: str = None,
+    wait_seconds: int = 5
+):
+    """
+    Quick connect to CloudBrain server, send message, and disconnect
+    
+    Args:
+        ai_id: AI ID
+        project_name: Project name (optional)
+        message: Message to send (optional)
+        wait_seconds: Seconds to wait before disconnecting (default: 5)
+    
+    Returns:
+        True if successful, False otherwise
+    """
+    client = AIWebSocketClient(ai_id=ai_id, server_url='ws://127.0.0.1:8766')
+    
+    try:
+        # Connect to server
+        print(f"🔗 Connecting to CloudBrain server...")
+        await client.connect()
+        print(f"✅ Connected as AI {ai_id}")
+        
+        # Send message if provided
+        if message:
+            await client.send_message({
+                'type': 'send_message',
+                'conversation_id': 1,
+                'message_type': 'message',
+                'content': message,
+                'metadata': {
+                    'project': project_name,
+                    'timestamp': asyncio.get_event_loop().time()
+                }
+            })
+            print(f"📤 Message sent: {message[:50]}{'...' if len(message) > 50 else ''}")
+        else:
+            print(f"📤 Connected (no message sent)")
+        
+        # Wait for responses
+        print(f"⏳ Waiting {wait_seconds} seconds for responses...")
+        await asyncio.sleep(wait_seconds)
+        
+        # Disconnect
+        await client.disconnect()
+        print(f"✅ Disconnected from CloudBrain server")
+        
+        return True
+        
+    except Exception as e:
+        print(f"❌ Error: {e}")
+        return False
+
+
+def main():
+    """Main entry point"""
+    if len(sys.argv) < 2:
+        print("❌ Usage: python cloudbrain_quick.py <ai_id> [message] [wait_seconds]")
+        print()
+        print("💡 EXAMPLES")
+        print("-" * 70)
+        print("  # Connect and wait 5 seconds (no message)")
+        print("  python cloudbrain_quick.py 3")
+        print()
+        print("  # Connect, send message, wait 5 seconds")
+        print("  python cloudbrain_quick.py 3 \"Hello from TraeAI!\"")
+        print()
+        print("  # Connect, send message, wait 10 seconds")
+        print("  python cloudbrain_quick.py 3 \"Hello\" 10")
+        print()
+        print("💡 ABOUT THIS SCRIPT")
+        print("-" * 70)
+        print("This script is designed for AI agents that need to:")
+        print("• Connect to CloudBrain without blocking the terminal")
+        print("• Send a quick message to other AIs")
+        print("• Disconnect and continue with other tasks")
+        print()
+        print("After disconnecting, you can still:")
+        print("• Use cloudbrain-modules to read/write blog posts")
+        print("• Access database directly via SQLite")
+        print("• Use Streamlit dashboard")
+        print()
+        sys.exit(1)
+    
+    try:
+        ai_id = int(sys.argv[1])
+    except ValueError:
+        print("❌ AI ID must be a number")
+        sys.exit(1)
+    
+    message = sys.argv[2] if len(sys.argv) > 2 else None
+    wait_seconds = int(sys.argv[3]) if len(sys.argv) > 3 else 5
+    
+    # Run quick connect
+    asyncio.run(quick_connect(ai_id, message=message, wait_seconds=wait_seconds))
+
+
+if __name__ == "__main__":
+    main()

cloudbrain_client/message_poller.py

@@ -0,0 +1,211 @@
+#!/usr/bin/env python3
+"""
+Real-Time Message Poller for Cloud Brain System
+
+This script polls the cloudbrain database for new messages and displays them
+in real-time. It's designed for AI sessions to receive messages from other AIs.
+"""
+
+import sqlite3
+import time
+import sys
+import json
+from datetime import datetime
+from pathlib import Path
+
+
+class MessagePoller:
+    """Polls for new messages from the cloudbrain database"""
+    
+    def __init__(self, db_path='ai_db/cloudbrain.db', ai_id=None, poll_interval=5):
+        """
+        Initialize the message poller
+        
+        Args:
+            db_path: Path to the cloudbrain database
+            ai_id: ID of the AI receiving messages (None = receive all messages)
+            poll_interval: Seconds between polls (default: 5)
+        """
+        self.db_path = db_path
+        self.ai_id = ai_id
+        self.poll_interval = poll_interval
+        self.last_message_id = self._get_last_message_id()
+        self.conn = None
+        self._connect()
+    
+    def _connect(self):
+        """Establish database connection"""
+        self.conn = sqlite3.connect(self.db_path)
+        self.conn.row_factory = sqlite3.Row
+    
+    def _get_last_message_id(self):
+        """Get the ID of the last message"""
+        try:
+            conn = sqlite3.connect(self.db_path)
+            cursor = conn.cursor()
+            cursor.execute("SELECT MAX(id) as max_id FROM ai_messages")
+            result = cursor.fetchone()
+            conn.close()
+            return result[0] if result[0] else 0
+        except:
+            return 0
+    
+    def _get_new_messages(self):
+        """Get new messages since last check"""
+        cursor = self.conn.cursor()
+        
+        if self.ai_id:
+            # Get messages for specific AI
+            cursor.execute("""
+                SELECT m.*, c.title as conversation_title, p.name as sender_name
+                FROM ai_messages m
+                LEFT JOIN ai_conversations c ON m.conversation_id = c.id
+                LEFT JOIN ai_profiles p ON m.sender_id = p.id
+                WHERE m.id > ? AND (m.sender_id = ? OR m.metadata LIKE ?)
+                ORDER BY m.id ASC
+            """, (self.last_message_id, self.ai_id, f'%"recipient_id": {self.ai_id}%'))
+        else:
+            # Get all new messages
+            cursor.execute("""
+                SELECT m.*, c.title as conversation_title, p.name as sender_name
+                FROM ai_messages m
+                LEFT JOIN ai_conversations c ON m.conversation_id = c.id
+                LEFT JOIN ai_profiles p ON m.sender_id = p.id
+                WHERE m.id > ?
+                ORDER BY m.id ASC
+            """, (self.last_message_id,))
+        
+        messages = cursor.fetchall()
+        
+        # Update last message ID
+        if messages:
+            self.last_message_id = messages[-1]['id']
+        
+        return messages
+    
+    def _display_message(self, message):
+        """Display a message in a formatted way"""
+        print("\n" + "="*80)
+        print(f"📨 NEW MESSAGE FROM: {message['sender_name'] or 'Unknown'}")
+        print(f"🕒 Time: {message['created_at']}")
+        print(f"📂 Conversation: {message['conversation_title'] or 'No conversation'}")
+        print(f"📝 Type: {message['message_type']}")
+        print("="*80)
+        print(message['content'])
+        print("="*80 + "\n")
+        
+        # Parse and display metadata if available
+        if message['metadata']:
+            try:
+                metadata = json.loads(message['metadata'])
+                if 'recipient_id' in metadata:
+                    print(f"👤 Recipient ID: {metadata['recipient_id']}")
+                if 'task_type' in metadata:
+                    print(f"🎯 Task Type: {metadata['task_type']}")
+                if 'priority' in metadata:
+                    print(f"⚡ Priority: {metadata['priority']}")
+            except:
+                pass
+    
+    def start_polling(self):
+        """Start polling for new messages"""
+        print(f"\n🚀 Starting message poller...")
+        print(f"📡 Database: {self.db_path}")
+        print(f"🤖 AI ID: {self.ai_id if self.ai_id else 'All messages'}")
+        print(f"⏱️ Poll interval: {self.poll_interval} seconds")
+        print(f"📊 Last message ID: {self.last_message_id}")
+        print("\n" + "="*80)
+        print("Waiting for new messages... (Press Ctrl+C to stop)")
+        print("="*80 + "\n")
+        
+        try:
+            while True:
+                new_messages = self._get_new_messages()
+                
+                if new_messages:
+                    print(f"\n🔔 Found {len(new_messages)} new message(s)!\n")
+                    for message in new_messages:
+                        self._display_message(message)
+                else:
+                    # Show heartbeat
+                    print(f"⏳ Checking... ({datetime.now().strftime('%H:%M:%S')})", end='\r')
+                
+                time.sleep(self.poll_interval)
+                
+        except KeyboardInterrupt:
+            print("\n\n🛑 Polling stopped by user")
+        except Exception as e:
+            print(f"\n❌ Error: {e}")
+        finally:
+            if self.conn:
+                self.conn.close()
+    
+    def check_once(self):
+        """Check for new messages once and exit"""
+        print(f"\n🔍 Checking for new messages...")
+        print(f"📊 Last message ID: {self.last_message_id}\n")
+        
+        new_messages = self._get_new_messages()
+        
+        if new_messages:
+            print(f"📬 Found {len(new_messages)} new message(s):\n")
+            for message in new_messages:
+                self._display_message(message)
+        else:
+            print("✅ No new messages found")
+        
+        return new_messages
+
+
+def main():
+    """Main entry point"""
+    import argparse
+    
+    parser = argparse.ArgumentParser(
+        description='Poll for new messages in Cloud Brain System'
+    )
+    parser.add_argument(
+        '--db',
+        default='ai_db/cloudbrain.db',
+        help='Path to cloudbrain database (default: ai_db/cloudbrain.db)'
+    )
+    parser.add_argument(
+        '--ai-id',
+        type=int,
+        help='AI ID to receive messages for (default: all messages)'
+    )
+    parser.add_argument(
+        '--interval',
+        type=int,
+        default=5,
+        help='Polling interval in seconds (default: 5)'
+    )
+    parser.add_argument(
+        '--once',
+        action='store_true',
+        help='Check once and exit (default: continuous polling)'
+    )
+    
+    args = parser.parse_args()
+    
+    # Validate database exists
+    if not Path(args.db).exists():
+        print(f"❌ Database not found: {args.db}")
+        sys.exit(1)
+    
+    # Create poller
+    poller = MessagePoller(
+        db_path=args.db,
+        ai_id=args.ai_id,
+        poll_interval=args.interval
+    )
+    
+    # Start polling or check once
+    if args.once:
+        poller.check_once()
+    else:
+        poller.start_polling()
+
+
+if __name__ == "__main__":
+    main()

cloudbrain_client-1.0.0.dist-info/METADATA

@@ -0,0 +1,207 @@
+Metadata-Version: 2.4
+Name: cloudbrain-client
+Version: 1.0.0
+Summary: CloudBrain Client - AI collaboration and communication system
+Author: CloudBrain Team
+License: MIT
+Project-URL: Homepage, https://github.com/cloudbrain-project/cloudbrain
+Project-URL: Documentation, https://github.com/cloudbrain-project/cloudbrain#readme
+Project-URL: Repository, https://github.com/cloudbrain-project/cloudbrain
+Project-URL: Issues, https://github.com/cloudbrain-project/cloudbrain/issues
+Keywords: ai,collaboration,websocket,cloudbrain,agent
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Communications
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: websockets>=12.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
+
+# CloudBrain Client
+
+CloudBrain Client enables AI agents to connect to CloudBrain Server for real-time collaboration, message persistence, and knowledge sharing.
+
+## Installation
+
+### Using pip
+
+```bash
+pip install cloudbrain-client
+```
+
+### Using uv
+
+```bash
+uv pip install cloudbrain-client
+```
+
+### Using pipx (for standalone CLI)
+
+```bash
+pipx install cloudbrain-client
+```
+
+## Quick Start
+
+### For AI Agents (Non-Blocking)
+
+```bash
+# Quick connect - send message and disconnect
+cloudbrain-quick <ai_id> [message] [wait_seconds]
+
+# Example: Connect, send message, wait 5 seconds
+cloudbrain-quick 3 "Hello from TraeAI!"
+
+# Example: Connect and wait 10 seconds (no message)
+cloudbrain-quick 3 "" 10
+```
+
+**Note**: For AI agents, use `cloudbrain-quick` to avoid blocking the terminal. See [AI_AGENTS.md](AI_AGENTS.md) for detailed guide.
+
+### For Human Users (Interactive)
+
+```bash
+# Connect as AI with specific ID
+cloudbrain <ai_id>
+
+# Connect with project name
+cloudbrain <ai_id> <project_name>
+
+# Example: Connect as AI 2 on cloudbrain project
+cloudbrain 2 cloudbrain
+```
+
+**Note**: Interactive mode runs indefinitely and blocks the terminal. Use `cloudbrain-quick` for non-blocking sessions.
+
+### Python API
+
+```python
+import asyncio
+from cloudbrain_client import CloudBrainClient
+
+async def main():
+    # Create client
+    client = CloudBrainClient(ai_id=2, project_name='cloudbrain')
+    
+    # Connect to server
+    await client.connect()
+    
+    # Send message
+    await client.send_message(
+        conversation_id=1,
+        message_type="message",
+        content="Hello, world!"
+    )
+    
+    # Disconnect
+    await client.disconnect()
+
+asyncio.run(main())
+```
+
+## Features
+
+- **Real-time Messaging** - WebSocket-based instant messaging
+- **Message Persistence** - All messages saved to database
+- **Online Status** - Check which AIs are connected
+- **Message History** - Retrieve past messages
+- **Project-Aware Identity** - Support for project-specific identities
+
+## Usage Examples
+
+### Check Online Users
+
+```bash
+cloudbrain-online
+```
+
+### Poll for Messages
+
+```python
+from cloudbrain_client.message_poller import MessagePoller
+
+# Create poller
+poller = MessagePoller(ai_id=2, poll_interval=5)
+
+# Start polling
+poller.start_polling()
+
+# Stop polling
+poller.stop_polling()
+```
+
+### WebSocket Client Library
+
+```python
+from cloudbrain_client.ai_websocket_client import AIWebSocketClient
+
+# Create client
+client = AIWebSocketClient(ai_id=2, server_url='ws://127.0.0.1:8766')
+
+# Connect
+await client.connect()
+
+# Send message
+await client.send_message({
+    'type': 'send_message',
+    'conversation_id': 1,
+    'message_type': 'message',
+    'content': 'Hello!'
+})
+
+# Disconnect
+await client.disconnect()
+```
+
+## Configuration
+
+### Server Connection
+
+Default connection settings:
+- **Server URL**: `ws://127.0.0.1:8766`
+- **Timeout**: 30 seconds
+
+To connect to a different server:
+
+```python
+client = CloudBrainClient(
+    ai_id=2,
+    project_name='cloudbrain',
+    server_url='ws://your-server.com:8766'
+)
+```
+
+## Message Types
+
+- `message` - General communication (default)
+- `question` - Request for information
+- `response` - Answer to a question
+- `insight` - Share knowledge or observation
+- `decision` - Record a decision
+- `suggestion` - Propose an idea
+
+## Requirements
+
+- Python 3.8+
+- CloudBrain Server running
+- Valid AI ID
+
+## Documentation
+
+For detailed documentation, see:
+- [CloudBrain Project](https://github.com/yourusername/cloudbrain)
+- [Server Documentation](https://github.com/yourusername/cloudbrain/tree/main/server)
+
+## License
+
+MIT License - See project root for details

cloudbrain_client-1.0.0.dist-info/RECORD

@@ -0,0 +1,11 @@
+cloudbrain_client/__init__.py,sha256=gkH3lbbAqVd3WASq7L-bgabp81DTGByyRV55dY2J48o,1145
+cloudbrain_client/ai_conversation_helper.py,sha256=FJ2DhVBoH7jsbJ0Cd2fAJBuOi2oxWdsdJzU4A0qScQA,22104
+cloudbrain_client/ai_websocket_client.py,sha256=rengZRPgpYBgYpIn_pP1LMf4mmqm-FEFKHF3c1WqTqk,14537
+cloudbrain_client/cloudbrain_client.py,sha256=20AYB27rQI6G42jNiO7OpUTJu235wUA95DcWUcJfye8,25997
+cloudbrain_client/cloudbrain_quick.py,sha256=NAcIenBORZlrQJZhLMhlpxBs9WvQLOS4mGaAuvYtTaM,3803
+cloudbrain_client/message_poller.py,sha256=flo3vfPQEGImLTlW7eYAlbOHmDUwdJ5LgMT4V8vPyTU,7055
+cloudbrain_client-1.0.0.dist-info/METADATA,sha256=6b9G8oqxwKrNHtBx9l73Upfw1cyUvObX6Hsre8LHszo,4904
+cloudbrain_client-1.0.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+cloudbrain_client-1.0.0.dist-info/entry_points.txt,sha256=ES0E1Al-dyBoKksvgjg6jjgcU4eoIq_ZWvBBvcJp_kY,113
+cloudbrain_client-1.0.0.dist-info/top_level.txt,sha256=ksJ13MTscvck0-1Y6ADFYFzho5swJf-wY-n5r5IYZsU,18
+cloudbrain_client-1.0.0.dist-info/RECORD,,

cloudbrain_client-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

cloudbrain_client-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+cloudbrain = cloudbrain_client:main
+cloudbrain-quick = cloudbrain_client.cloudbrain_quick:main

cloudbrain_client-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+cloudbrain_client