trinity-cli 0.1.0__tar.gz

trinity_cli-0.1.0/PKG-INFO

@@ -0,0 +1,119 @@
+Metadata-Version: 2.4
+Name: trinity-cli
+Version: 0.1.0
+Summary: CLI for the Trinity Autonomous Agent Orchestration Platform
+Author-email: Ability AI <hello@ability.ai>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/abilityai/trinity
+Project-URL: Documentation, https://github.com/abilityai/trinity/blob/main/docs/CLI.md
+Project-URL: Repository, https://github.com/abilityai/trinity
+Project-URL: Issues, https://github.com/abilityai/trinity/issues
+Keywords: trinity,ai,agents,orchestration,cli
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.0
+Requires-Dist: httpx>=0.24
+Requires-Dist: rich>=13.0
+
+# Trinity CLI
+
+Command-line interface for the [Trinity](https://github.com/abilityai/trinity) Autonomous Agent Orchestration Platform.
+
+## Install
+
+```bash
+# With pip
+pip install trinity-cli
+
+# With pipx (recommended — isolated environment)
+pipx install trinity-cli
+```
+
+## Quick Start
+
+```bash
+# Connect to your Trinity instance
+trinity init
+
+# List your agents
+trinity agents list
+
+# Chat with an agent
+trinity chat my-agent "Hello, what can you do?"
+
+# Check fleet health
+trinity health fleet
+```
+
+## Multi-Instance Profiles
+
+Manage multiple Trinity instances (local dev, staging, production):
+
+```bash
+# First instance (created during init)
+trinity init
+
+# Add another instance
+trinity init --profile production
+
+# Switch between instances
+trinity profile use production
+trinity profile list
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `trinity init` | Connect to a Trinity instance |
+| `trinity login` | Re-authenticate with stored instance |
+| `trinity agents list` | List all agents |
+| `trinity agents create <name>` | Create a new agent |
+| `trinity agents start <name>` | Start an agent |
+| `trinity agents stop <name>` | Stop an agent |
+| `trinity chat <agent> "msg"` | Chat with an agent |
+| `trinity history <agent>` | View chat history |
+| `trinity logs <agent>` | View agent logs |
+| `trinity health fleet` | Fleet health overview |
+| `trinity health agent <name>` | Single agent health |
+| `trinity skills list` | Browse skill library |
+| `trinity schedules list <agent>` | View agent schedules |
+| `trinity profile list` | List configured profiles |
+| `trinity profile use <name>` | Switch active profile |
+
+## Output Formats
+
+```bash
+# JSON (default)
+trinity agents list
+
+# Table
+trinity agents list --format table
+```
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `TRINITY_URL` | Override instance URL |
+| `TRINITY_API_KEY` | Override auth token |
+| `TRINITY_PROFILE` | Override active profile |
+
+## Documentation
+
+- [Full CLI docs](https://github.com/abilityai/trinity/blob/main/docs/CLI.md)
+- [Trinity Platform](https://github.com/abilityai/trinity)
+
+## License
+
+MIT

trinity_cli-0.1.0/README.md

@@ -0,0 +1,92 @@
+# Trinity CLI
+
+Command-line interface for the [Trinity](https://github.com/abilityai/trinity) Autonomous Agent Orchestration Platform.
+
+## Install
+
+```bash
+# With pip
+pip install trinity-cli
+
+# With pipx (recommended — isolated environment)
+pipx install trinity-cli
+```
+
+## Quick Start
+
+```bash
+# Connect to your Trinity instance
+trinity init
+
+# List your agents
+trinity agents list
+
+# Chat with an agent
+trinity chat my-agent "Hello, what can you do?"
+
+# Check fleet health
+trinity health fleet
+```
+
+## Multi-Instance Profiles
+
+Manage multiple Trinity instances (local dev, staging, production):
+
+```bash
+# First instance (created during init)
+trinity init
+
+# Add another instance
+trinity init --profile production
+
+# Switch between instances
+trinity profile use production
+trinity profile list
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `trinity init` | Connect to a Trinity instance |
+| `trinity login` | Re-authenticate with stored instance |
+| `trinity agents list` | List all agents |
+| `trinity agents create <name>` | Create a new agent |
+| `trinity agents start <name>` | Start an agent |
+| `trinity agents stop <name>` | Stop an agent |
+| `trinity chat <agent> "msg"` | Chat with an agent |
+| `trinity history <agent>` | View chat history |
+| `trinity logs <agent>` | View agent logs |
+| `trinity health fleet` | Fleet health overview |
+| `trinity health agent <name>` | Single agent health |
+| `trinity skills list` | Browse skill library |
+| `trinity schedules list <agent>` | View agent schedules |
+| `trinity profile list` | List configured profiles |
+| `trinity profile use <name>` | Switch active profile |
+
+## Output Formats
+
+```bash
+# JSON (default)
+trinity agents list
+
+# Table
+trinity agents list --format table
+```
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `TRINITY_URL` | Override instance URL |
+| `TRINITY_API_KEY` | Override auth token |
+| `TRINITY_PROFILE` | Override active profile |
+
+## Documentation
+
+- [Full CLI docs](https://github.com/abilityai/trinity/blob/main/docs/CLI.md)
+- [Trinity Platform](https://github.com/abilityai/trinity)
+
+## License
+
+MIT

trinity_cli-0.1.0/pyproject.toml

@@ -0,0 +1,47 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "trinity-cli"
+version = "0.1.0"
+description = "CLI for the Trinity Autonomous Agent Orchestration Platform"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [
+    {name = "Ability AI", email = "hello@ability.ai"},
+]
+keywords = ["trinity", "ai", "agents", "orchestration", "cli"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: System :: Systems Administration",
+]
+dependencies = [
+    "click>=8.0",
+    "httpx>=0.24",
+    "rich>=13.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/abilityai/trinity"
+Documentation = "https://github.com/abilityai/trinity/blob/main/docs/CLI.md"
+Repository = "https://github.com/abilityai/trinity"
+Issues = "https://github.com/abilityai/trinity/issues"
+
+[project.scripts]
+trinity = "trinity_cli.main:cli"
+
+[tool.setuptools.packages.find]
+include = ["trinity_cli*"]
+
+[tool.setuptools.package-data]
+trinity_cli = ["py.typed"]

trinity_cli-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

trinity_cli-0.1.0/trinity_cli/__init__.py

@@ -0,0 +1,3 @@
+"""Trinity CLI — command-line interface for the Trinity Agent Platform."""
+
+__version__ = "0.1.0"

trinity_cli-0.1.0/trinity_cli/client.py

@@ -0,0 +1,107 @@
+"""HTTP client for the Trinity Backend API."""
+
+import sys
+from typing import Any, Optional
+
+import click
+import httpx
+
+from .config import get_api_key, get_instance_url
+
+
+def _profile_from_context() -> Optional[str]:
+    """Try to get the --profile value from the current Click context."""
+    try:
+        ctx = click.get_current_context(silent=True)
+        if ctx:
+            root = ctx.find_root()
+            if root.obj and "profile" in root.obj:
+                return root.obj["profile"]
+    except RuntimeError:
+        pass
+    return None
+
+
+class TrinityAPIError(Exception):
+    def __init__(self, status_code: int, detail: str):
+        self.status_code = status_code
+        self.detail = detail
+        super().__init__(f"HTTP {status_code}: {detail}")
+
+
+class TrinityClient:
+    """Thin HTTP wrapper around the Trinity FastAPI backend."""
+
+    def __init__(self, base_url: Optional[str] = None, token: Optional[str] = None,
+                 profile: Optional[str] = None):
+        resolved_profile = profile or _profile_from_context()
+        self.base_url = base_url or get_instance_url(resolved_profile)
+        self.token = token or get_api_key(resolved_profile)
+        if not self.base_url:
+            print("Error: No Trinity instance configured. Run 'trinity init' or 'trinity login' first.", file=sys.stderr)
+            sys.exit(1)
+
+    def _headers(self) -> dict:
+        h = {"Content-Type": "application/json"}
+        if self.token:
+            h["Authorization"] = f"Bearer {self.token}"
+        return h
+
+    def _handle_response(self, resp: httpx.Response) -> Any:
+        if resp.status_code == 401:
+            print("Error: Authentication failed. Run 'trinity login' to re-authenticate.", file=sys.stderr)
+            sys.exit(1)
+        if resp.status_code >= 400:
+            try:
+                detail = resp.json().get("detail", resp.text)
+            except Exception:
+                detail = resp.text
+            raise TrinityAPIError(resp.status_code, str(detail))
+        if resp.status_code == 204:
+            return None
+        return resp.json()
+
+    def get(self, path: str, params: Optional[dict] = None) -> Any:
+        with httpx.Client(timeout=30) as c:
+            resp = c.get(f"{self.base_url}{path}", headers=self._headers(), params=params)
+            return self._handle_response(resp)
+
+    def post(self, path: str, json: Optional[dict] = None) -> Any:
+        with httpx.Client(timeout=60) as c:
+            resp = c.post(f"{self.base_url}{path}", headers=self._headers(), json=json)
+            return self._handle_response(resp)
+
+    def put(self, path: str, json: Optional[dict] = None) -> Any:
+        with httpx.Client(timeout=30) as c:
+            resp = c.put(f"{self.base_url}{path}", headers=self._headers(), json=json)
+            return self._handle_response(resp)
+
+    def delete(self, path: str) -> Any:
+        with httpx.Client(timeout=30) as c:
+            resp = c.delete(f"{self.base_url}{path}", headers=self._headers())
+            return self._handle_response(resp)
+
+    def post_form(self, path: str, data: dict) -> Any:
+        """POST with form-encoded body (for OAuth2 token endpoint)."""
+        with httpx.Client(timeout=30) as c:
+            headers = {}
+            if self.token:
+                headers["Authorization"] = f"Bearer {self.token}"
+            resp = c.post(f"{self.base_url}{path}", data=data, headers=headers)
+            return self._handle_response(resp)
+
+    def post_unauthenticated(self, path: str, json: Optional[dict] = None) -> Any:
+        """POST without auth header (for login/registration flows)."""
+        with httpx.Client(timeout=30) as c:
+            resp = c.post(
+                f"{self.base_url}{path}",
+                headers={"Content-Type": "application/json"},
+                json=json,
+            )
+            return self._handle_response(resp)
+
+    def get_unauthenticated(self, path: str) -> Any:
+        """GET without auth header."""
+        with httpx.Client(timeout=30) as c:
+            resp = c.get(f"{self.base_url}{path}")
+            return self._handle_response(resp)

trinity_cli-0.1.0/trinity_cli/commands/agents.py

@@ -0,0 +1,96 @@
+"""Agent management commands."""
+
+import click
+
+from ..client import TrinityClient, TrinityAPIError
+from ..output import format_output
+
+
+@click.group()
+def agents():
+    """Manage agents."""
+    pass
+
+
+@agents.command("list")
+@click.option("--format", "fmt", type=click.Choice(["json", "table"]), default="json", help="Output format")
+def list_agents(fmt):
+    """List all agents."""
+    client = TrinityClient()
+    data = client.get("/api/agents")
+    if fmt == "table" and isinstance(data, list):
+        # Slim down for table view
+        rows = [
+            {
+                "name": a.get("name", ""),
+                "status": a.get("status", ""),
+                "template": a.get("template", ""),
+                "type": a.get("type", ""),
+            }
+            for a in data
+        ]
+        format_output(rows, fmt)
+    else:
+        format_output(data, fmt)
+
+
+@agents.command("get")
+@click.argument("name")
+@click.option("--format", "fmt", type=click.Choice(["json", "table"]), default="json", help="Output format")
+def get_agent(name, fmt):
+    """Get agent details."""
+    client = TrinityClient()
+    data = client.get(f"/api/agents/{name}")
+    format_output(data, fmt)
+
+
+@agents.command("create")
+@click.argument("name")
+@click.option("--template", default=None, help="Template (e.g. github:Org/repo)")
+@click.option("--format", "fmt", type=click.Choice(["json", "table"]), default="json", help="Output format")
+def create_agent(name, template, fmt):
+    """Create a new agent."""
+    client = TrinityClient()
+    payload = {"name": name}
+    if template:
+        payload["template"] = template
+    data = client.post("/api/agents", json=payload)
+    format_output(data, fmt)
+
+
+@agents.command("delete")
+@click.argument("name")
+@click.confirmation_option(prompt="Are you sure you want to delete this agent?")
+def delete_agent(name):
+    """Delete an agent."""
+    client = TrinityClient()
+    client.delete(f"/api/agents/{name}")
+    click.echo(f"Deleted agent '{name}'")
+
+
+@agents.command("start")
+@click.argument("name")
+def start_agent(name):
+    """Start an agent container."""
+    client = TrinityClient()
+    client.post(f"/api/agents/{name}/start")
+    click.echo(f"Started agent '{name}'")
+
+
+@agents.command("stop")
+@click.argument("name")
+def stop_agent(name):
+    """Stop an agent container."""
+    client = TrinityClient()
+    client.post(f"/api/agents/{name}/stop")
+    click.echo(f"Stopped agent '{name}'")
+
+
+@agents.command("rename")
+@click.argument("name")
+@click.argument("new_name")
+def rename_agent(name, new_name):
+    """Rename an agent."""
+    client = TrinityClient()
+    client.put(f"/api/agents/{name}/rename", json={"new_name": new_name})
+    click.echo(f"Renamed '{name}' -> '{new_name}'")

trinity_cli-0.1.0/trinity_cli/commands/auth.py

@@ -0,0 +1,177 @@
+"""Authentication commands: login, logout, status, init."""
+
+import click
+
+from ..client import TrinityClient, TrinityAPIError
+from ..config import (
+    clear_auth, get_instance_url, get_user, load_config,
+    profile_name_from_url, set_auth, _resolve_profile_name,
+)
+
+
+def _get_profile_name(ctx: click.Context) -> str | None:
+    """Extract the --profile value from the root context."""
+    root = ctx.find_root()
+    return root.obj.get("profile") if root.obj else None
+
+
+@click.command()
+@click.option("--instance", help="Trinity instance URL (e.g. https://trinity.example.com)")
+@click.option("--profile", "profile_opt", default=None,
+              help="Profile name to store credentials under (default: hostname)")
+@click.pass_context
+def login(ctx, instance, profile_opt):
+    """Log in to a Trinity instance with email verification."""
+    profile_name = profile_opt or _get_profile_name(ctx)
+    url = instance or get_instance_url(profile_name)
+    if not url:
+        url = click.prompt("Trinity instance URL")
+    url = url.rstrip("/")
+
+    client = TrinityClient(base_url=url, token="none")
+
+    email = click.prompt("Email")
+
+    # Request verification code
+    try:
+        client.post_unauthenticated("/api/auth/email/request", {"email": email})
+    except TrinityAPIError as e:
+        click.echo(f"Error requesting code: {e.detail}", err=True)
+        raise SystemExit(1)
+
+    click.echo(f"Verification code sent to {email}")
+    code = click.prompt("Enter 6-digit code")
+
+    # Verify code and get token
+    try:
+        result = client.post_unauthenticated("/api/auth/email/verify", {
+            "email": email,
+            "code": code,
+        })
+    except TrinityAPIError as e:
+        click.echo(f"Verification failed: {e.detail}", err=True)
+        raise SystemExit(1)
+
+    token = result["access_token"]
+    user = result.get("user")
+
+    # Determine profile name: explicit > global flag > derive from URL
+    target_profile = profile_name or profile_name_from_url(url)
+    set_auth(url, token, user, profile_name=target_profile)
+    name = user.get("name") or user.get("email") or user.get("username") if user else email
+    click.echo(f"Logged in as {name} [profile: {target_profile}]")
+
+
+@click.command()
+@click.pass_context
+def logout(ctx):
+    """Clear stored credentials for the current profile."""
+    profile_name = _get_profile_name(ctx)
+    clear_auth(profile_name)
+    resolved = _resolve_profile_name(profile_name)
+    click.echo(f"Logged out [profile: {resolved}]")
+
+
+@click.command()
+@click.pass_context
+def status(ctx):
+    """Show current login status and instance info."""
+    profile_name = _get_profile_name(ctx)
+    resolved = _resolve_profile_name(profile_name)
+    url = get_instance_url(profile_name)
+
+    click.echo(f"Profile:  {resolved}")
+
+    if not url:
+        click.echo("Instance: Not configured. Run 'trinity init' or 'trinity login'.")
+        return
+
+    user = get_user(profile_name)
+    config = load_config()
+    profile_data = config.get("profiles", {}).get(resolved, {})
+
+    click.echo(f"Instance: {url}")
+    if user:
+        click.echo(f"User:     {user.get('email') or user.get('username')}")
+        click.echo(f"Role:     {user.get('role', 'unknown')}")
+    elif profile_data.get("token"):
+        click.echo("User:     (API key auth)")
+    else:
+        click.echo("User:     Not logged in")
+
+    # Check connectivity
+    try:
+        client = TrinityClient(base_url=url, token=profile_data.get("token", "none"))
+        client.get_unauthenticated("/api/auth/mode")
+        click.echo("Status:   Connected")
+    except Exception:
+        click.echo("Status:   Unreachable")
+
+
+@click.command()
+@click.option("--profile", "profile_opt", default=None,
+              help="Profile name (default: derived from instance hostname)")
+@click.pass_context
+def init(ctx, profile_opt):
+    """Set up Trinity CLI: configure instance, request access, and log in.
+
+    One command to go from zero to authenticated. Creates a named profile
+    for the instance (defaults to hostname).
+    """
+    url = click.prompt("Trinity instance URL", default="http://localhost:8000")
+    url = url.rstrip("/")
+
+    client = TrinityClient(base_url=url, token="none")
+
+    # Verify instance is reachable
+    try:
+        client.get_unauthenticated("/api/auth/mode")
+    except Exception:
+        click.echo(f"Cannot reach {url}. Check the URL and try again.", err=True)
+        raise SystemExit(1)
+
+    click.echo(f"Connected to {url}")
+
+    # Determine profile name
+    profile_name = profile_opt or _get_profile_name(ctx) or profile_name_from_url(url)
+
+    email = click.prompt("Email")
+
+    # Request access (auto-approve endpoint)
+    try:
+        client.post_unauthenticated("/api/access/request", {"email": email})
+        click.echo("Access granted")
+    except TrinityAPIError as e:
+        if e.status_code == 409:
+            click.echo("Already registered")
+        else:
+            click.echo(f"Access request failed: {e.detail}", err=True)
+            raise SystemExit(1)
+
+    # Send verification code
+    try:
+        client.post_unauthenticated("/api/auth/email/request", {"email": email})
+    except TrinityAPIError as e:
+        click.echo(f"Error requesting code: {e.detail}", err=True)
+        raise SystemExit(1)
+
+    click.echo(f"Verification code sent to {email}")
+    code = click.prompt("Enter 6-digit code")
+
+    # Verify and get token
+    try:
+        result = client.post_unauthenticated("/api/auth/email/verify", {
+            "email": email,
+            "code": code,
+        })
+    except TrinityAPIError as e:
+        click.echo(f"Verification failed: {e.detail}", err=True)
+        raise SystemExit(1)
+
+    token = result["access_token"]
+    user = result.get("user")
+
+    set_auth(url, token, user, profile_name=profile_name)
+    name = user.get("name") or user.get("email") or user.get("username") if user else email
+    click.echo(f"Logged in as {name} [profile: {profile_name}]")
+    click.echo(f"\nTrinity CLI is ready. Try 'trinity agents list'.")