epsimo-agent 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 EpsimoAI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/SKILL.md

@@ -0,0 +1,85 @@
+---
+name: epsimo-agent
+description: Comprehensive framework for building AI applications using EpsimoAI. Manage agents, projects, threads, and persistent state (Virtual Database). Includes CLI tools, Python SDK for automation, and React components for frontend integration.
+---
+
+# Epsimo Agent Framework (Beta)
+
+> [!NOTE]
+> This is a **Beta** version of the Epsimo Agent Framework. Features and APIs may be subject to change.
+
+The Epsimo Agent Framework allows you to build sophisticated AI-powered applications with agents, persistent threads, and a "Virtual Database" state layer. It provides a unified **CLI**, a **Python SDK**, and a **React UI Kit**.
+
+**Base URL:** `https://api.epsimoagents.com`
+**Frontend URL:** `https://app.epsimoagents.com`
+
+## 🛠️ Unified CLI (`epsimo`)
+
+The `epsimo` CLI is the main tool for managing your agents and data.
+
+### Authentication
+```bash
+python3 -m epsimo.cli auth login
+python3 -m epsimo.cli whoami
+```
+
+### Project Scaffolding
+- `python3 -m epsimo.cli create <name>`: Scaffolds a full Next.js application with Epsimo integrated.
+- `python3 -m epsimo.cli init`: Links a local directory to an Epsimo project.
+- `python3 -m epsimo.cli deploy`: Syncs your `epsimo.yaml` configuration to the platform.
+
+### Virtual Database
+Threads can serve as a persistent structured storage layer.
+- `python3 -m epsimo.cli db query --project-id <P_ID> --thread-id <T_ID>`: View structured thread state.
+- `python3 -m epsimo.cli db set --project-id <P_ID> --thread-id <T_ID> --key <K> --value <V>`: Seed state.
+
+### Credits
+- `python3 -m epsimo.cli credits balance`: Check current token balance.
+- `python3 -m epsimo.cli credits buy --quantity <N>`: Generate a Stripe checkout URL.
+
+## 📦 Python SDK
+
+The framework includes a powerful Python SDK for automation or backend services.
+
+```python
+from epsimo import EpsimoClient
+
+c = EpsimoClient(api_key="your-token")
+
+# Virtual DB Access
+user_pref = c.db.get(project_id, thread_id, "user_preferences")
+
+# Conversation Streaming
+for chunk in c.threads.run_stream(project_id, thread_id, assistant_id, "Hello!"):
+    print(chunk)
+```
+
+## 🎨 React UI Kit
+
+The UI Kit provides high-level components for immediate integration. Found in `.agent/skills/epsimo-agent/epsimo/templates/components`.
+
+- **`ThreadChat`**: A modern, dark-themed chat interface with streaming and tool support.
+- **`useChat`**: A headless hook for managing conversation state.
+
+### Implementation Patterns
+See `references/api_reference.md` for detailed frontend implementation patterns and API schemas.
+
+## 🧪 Verification
+Ensure your environment is correctly configured:
+```bash
+python3 .agent/skills/epsimo-agent/scripts/verify_skill.py
+```
+
+## 📚 Bundled Resources
+
+### Scripts (`scripts/`)
+- `auth.py`: Interactive and environment-based login.
+- `project.py`, `assistant.py`, `thread.py`, `run.py`: Low-level API interaction scripts.
+- `credits.py`: Balance check and credit purchasing.
+
+### Templates (`epsimo/templates/`)
+- `components/`: Ready-to-use React components (ThreadChat, AuthModal, BuyCredits).
+
+### References (`references/`)
+- `api_reference.md`: Detailed API documentation and schemas.
+- `virtual_db_guide.md`: Comprehensive guide for managing persistent state.

package/assets/example_asset.txt

@@ -0,0 +1,24 @@
+# Example Asset File
+
+This placeholder represents where asset files would be stored.
+Replace with actual asset files (templates, images, fonts, etc.) or delete if not needed.
+
+Asset files are NOT intended to be loaded into context, but rather used within
+the output Claude produces.
+
+Example asset files from other skills:
+- Brand guidelines: logo.png, slides_template.pptx
+- Frontend builder: hello-world/ directory with HTML/React boilerplate
+- Typography: custom-font.ttf, font-family.woff2
+- Data: sample_data.csv, test_dataset.json
+
+## Common Asset Types
+
+- Templates: .pptx, .docx, boilerplate directories
+- Images: .png, .jpg, .svg, .gif
+- Fonts: .ttf, .otf, .woff, .woff2
+- Boilerplate code: Project directories, starter files
+- Icons: .ico, .svg
+- Data files: .csv, .json, .xml, .yaml
+
+Note: This is a text placeholder. Actual assets can be any file type.

package/epsimo/__init__.py

@@ -0,0 +1,3 @@
+from .client import EpsimoClient
+
+__all__ = ["EpsimoClient"]

package/epsimo/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    main()

package/epsimo/auth.py

@@ -0,0 +1,143 @@
+
+import os
+import json
+import time
+import requests
+import getpass
+import sys
+import subprocess
+from pathlib import Path
+
+# Configuration
+API_BASE_URL = os.environ.get("EPSIMO_API_URL", "https://api.epsimoagents.com")
+TOKEN_FILE = Path.home() / "code/epsimo-frontend/.epsimo_token" # Keeping the same path for compatibility for now
+
+def get_token():
+    """Retrieve a valid JWT token, refreshing if necessary."""
+    
+    # Check if token file exists
+    if TOKEN_FILE.exists():
+        try:
+            with open(TOKEN_FILE, 'r') as f:
+                data = json.load(f)
+                return data.get('access_token') or data.get('token') or data.get('jwt_token')
+        except json.JSONDecodeError:
+            pass
+            
+    # Try logging in with env vars if file doesn't exist/is invalid
+    if os.environ.get("EPSIMO_EMAIL") and os.environ.get("EPSIMO_PASSWORD"):
+        return perform_login(os.environ.get("EPSIMO_EMAIL"), os.environ.get("EPSIMO_PASSWORD"))
+
+    # Return None instead of raising Error to let caller handle it (e.g. prompt login)
+    return None
+
+def perform_signup(email, password):
+    """Register a new user."""
+    print(f"Attempting to register new user: {email}")
+    url = f"{API_BASE_URL}/auth/signup"
+    payload = {
+        "email": email,
+        "password": password
+    }
+    
+    try:
+        response = requests.post(url, json=payload)
+        response.raise_for_status()
+        print("✅ Signup successful! Logging in...")
+        return perform_login(email, password)
+    except requests.exceptions.HTTPError as e:
+        if e.response.status_code == 400: # Usually "User already exists" or validation error
+             print(f"⚠️ Signup failed: {e.response.text}")
+        else:
+             print(f"❌ Signup failed: {e}")
+        raise
+
+def get_input_via_applescript(prompt, hidden=False):
+    """Get input using macOS native dialog."""
+    try:
+        script = f'display dialog "{prompt}" default answer ""'
+        if hidden:
+            script += ' with hidden answer'
+        script += ' buttons {"Cancel", "OK"} default button "OK"'
+        
+        cmd = ['osascript', '-e', script]
+        result = subprocess.run(cmd, capture_output=True, text=True, check=True)
+        # Parse result: button returned:OK, text returned:foobar
+        output = result.stdout.strip()
+        if "text returned:" in output:
+            return output.split("text returned:")[-1]
+        return ""
+    except subprocess.CalledProcessError:
+        return None
+
+def login_interactive():
+    """Interactive login flow."""
+    use_modal = os.environ.get("USE_GUI_PROMPT") == "1"
+    
+    email = None
+    if use_modal and sys.platform == 'darwin':
+        email = get_input_via_applescript("Enter your Epsimo Email:")
+    else:
+        email = input("Email: ")
+
+    if not email:
+        print("Email is required.")
+        return
+
+    password = None
+    if 'EPSIMO_PASSWORD' in os.environ:
+        password = os.environ['EPSIMO_PASSWORD']
+    elif use_modal and sys.platform == 'darwin':
+        password = get_input_via_applescript("Enter your Epsimo Password:", hidden=True)
+    else:
+        password = getpass.getpass("Password: ")
+
+    if not password:
+         print("Password is required.")
+         return
+
+    try:
+        perform_login(email, password, attempt_signup_on_fail=True)
+    except Exception:
+        pass
+
+def perform_login(email, password, attempt_signup_on_fail=False):
+    """Login logic."""
+    if not email or not password:
+        raise ValueError("Email and password are required.")
+
+    url = f"{API_BASE_URL}/auth/login"
+    payload = {
+        "email": email,
+        "password": password
+    }
+    
+    try:
+        response = requests.post(url, json=payload)
+        response.raise_for_status()
+        
+        data = response.json()
+        token = data.get('access_token') or data.get('token') or data.get('jwt_token')
+        
+        if not token:
+            raise ValueError("Failed to obtain access token from login response.")
+
+        # Save token
+        # Create dir if not exists?
+        # TOKEN_FILE.parent.mkdir(parents=True, exist_ok=True) 
+        # For now assume path exists as per user setup
+        
+        with open(TOKEN_FILE, 'w') as f:
+            json.dump(data, f)
+            
+        print(f"✅ Successfully logged in as {email}")
+        return token
+
+    except requests.exceptions.HTTPError as e:
+        print(f"❌ Login failed: {e}")
+        if attempt_signup_on_fail:
+             print("\nUser might not exist or password is wrong.")
+             choice = input("Do you want to create a new account with these credentials? (y/n): ")
+             if choice.lower() == 'y':
+                 return perform_signup(email, password)
+        raise