proxima-cli 1.0.0__tar.gz

proxima_cli-1.0.0/.gitignore

@@ -0,0 +1,35 @@
+# Synthetic data (generated, ~1.3GB)
+agents/supply-chain/demand-forecasting/data/synthetic/
+
+# Python
+__pycache__/
+*.pyc
+*.pyo
+.venv/
+venv/
+env/
+*.egg-info/
+
+# Environment
+.env
+.env.local
+
+# IDE
+.vscode/
+.idea/
+*.swp
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Original reference docs (large PDFs, keep .md conversions only)
+docs/reference/daimler/*.pdf
+docs/reference/daimler/*.pptx
+docs/reference/daimler/*.docx
+docs/reference/daimler/*.msg
+docs/reference/daimler/*.xlsx
+docs/reference/daimler/*.zip
+docs/reference/daimler/SAP Proposal - Supply Chain RFP/*.pdf
+docs/reference/daimler/SAP Proposal - Supply Chain RFP/*.xlsx
+platform/data/secrets.json

proxima_cli-1.0.0/PKG-INFO

@@ -0,0 +1,115 @@
+Metadata-Version: 2.4
+Name: proxima-cli
+Version: 1.0.0
+Summary: Proxima AIP CLI — manage your Proxima Intelligence platform
+Project-URL: Homepage, https://proximaintel.com/aip
+Project-URL: Documentation, https://docs.proximaintel.com/cli
+Project-URL: Repository, https://github.com/proximaintel/proxima-cli
+Author-email: Proxima Intelligence <hello@proximaintel.com>
+License-Expression: MIT
+Keywords: agents,ai,cli,platform,proxima
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27
+Requires-Dist: pyyaml>=6
+Requires-Dist: rich>=13
+Requires-Dist: typer[all]>=0.12
+Description-Content-Type: text/markdown
+
+# Proxima CLI
+
+The official command-line interface for **Proxima AIP** — manage your AI agent platform from the terminal.
+
+## Install
+
+```bash
+pipx install proxima-cli
+# or
+pip install proxima-cli
+```
+
+## Quick Start
+
+```bash
+# Login (opens browser for SSO)
+prox login
+
+# Check connection
+prox whoami
+
+# List agents
+prox agent list
+
+# Create a domain
+prox domain create --id finance --name "Finance"
+
+# Deploy an agent from a package
+prox agent deploy --from ./my-agent/
+```
+
+## Configuration
+
+```bash
+# Set your platform gateway URL
+prox config set gateway https://gateway.your-platform.com
+
+# Set catalog (for pulling pre-built agents)
+prox config set catalog https://catalog.proximaintel.com
+
+# View config
+prox config list
+```
+
+## Commands
+
+| Command Group | Description |
+|---|---|
+| `prox login / logout / whoami` | Authentication |
+| `prox config` | Environment configuration |
+| `prox catalog` | Browse and pull agents from Proxima Catalog |
+| `prox agent` | Create, configure, deploy, publish agents |
+| `prox toolbox` | Build and register toolboxes |
+| `prox knowledge` | Manage data sources and knowledge bases |
+| `prox secret` | Manage credentials |
+| `prox model` | Register LLM providers |
+| `prox ontology` | Manage entity models |
+| `prox routine` | Schedule autonomous agent execution |
+| `prox workflow` | Multi-agent orchestration pipelines |
+| `prox governance` | Audit logs and usage stats |
+| `prox platform` | Health checks and service management |
+
+## Agent Deployment
+
+```bash
+prox agent deploy --from ./my-agent/
+```
+
+Expects:
+```
+my-agent/
+├── agent.yaml           # Agent config
+├── toolbox/             # Optional: custom tools
+│   ├── tools.py
+│   ├── Dockerfile
+│   └── requirements.txt
+├── knowledge.yaml       # Data source requirements
+└── workspace.json       # Dashboard layout
+```
+
+One command. Full agent. Production-ready.
+
+## CI/CD
+
+```bash
+prox login --api-key $PLATFORM_API_KEY
+prox config set gateway $GATEWAY_URL
+prox agent deploy --from ./agents/my-agent/
+```
+
+## Documentation
+
+Full docs at [docs.proximaintel.com/cli](https://docs.proximaintel.com/cli)

proxima_cli-1.0.0/README.md

@@ -0,0 +1,93 @@
+# Proxima CLI
+
+The official command-line interface for **Proxima AIP** — manage your AI agent platform from the terminal.
+
+## Install
+
+```bash
+pipx install proxima-cli
+# or
+pip install proxima-cli
+```
+
+## Quick Start
+
+```bash
+# Login (opens browser for SSO)
+prox login
+
+# Check connection
+prox whoami
+
+# List agents
+prox agent list
+
+# Create a domain
+prox domain create --id finance --name "Finance"
+
+# Deploy an agent from a package
+prox agent deploy --from ./my-agent/
+```
+
+## Configuration
+
+```bash
+# Set your platform gateway URL
+prox config set gateway https://gateway.your-platform.com
+
+# Set catalog (for pulling pre-built agents)
+prox config set catalog https://catalog.proximaintel.com
+
+# View config
+prox config list
+```
+
+## Commands
+
+| Command Group | Description |
+|---|---|
+| `prox login / logout / whoami` | Authentication |
+| `prox config` | Environment configuration |
+| `prox catalog` | Browse and pull agents from Proxima Catalog |
+| `prox agent` | Create, configure, deploy, publish agents |
+| `prox toolbox` | Build and register toolboxes |
+| `prox knowledge` | Manage data sources and knowledge bases |
+| `prox secret` | Manage credentials |
+| `prox model` | Register LLM providers |
+| `prox ontology` | Manage entity models |
+| `prox routine` | Schedule autonomous agent execution |
+| `prox workflow` | Multi-agent orchestration pipelines |
+| `prox governance` | Audit logs and usage stats |
+| `prox platform` | Health checks and service management |
+
+## Agent Deployment
+
+```bash
+prox agent deploy --from ./my-agent/
+```
+
+Expects:
+```
+my-agent/
+├── agent.yaml           # Agent config
+├── toolbox/             # Optional: custom tools
+│   ├── tools.py
+│   ├── Dockerfile
+│   └── requirements.txt
+├── knowledge.yaml       # Data source requirements
+└── workspace.json       # Dashboard layout
+```
+
+One command. Full agent. Production-ready.
+
+## CI/CD
+
+```bash
+prox login --api-key $PLATFORM_API_KEY
+prox config set gateway $GATEWAY_URL
+prox agent deploy --from ./agents/my-agent/
+```
+
+## Documentation
+
+Full docs at [docs.proximaintel.com/cli](https://docs.proximaintel.com/cli)

proxima_cli-1.0.0/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "proxima-cli"
+version = "1.0.0"
+description = "Proxima AIP CLI — manage your Proxima Intelligence platform"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.11"
+authors = [
+    { name = "Proxima Intelligence", email = "hello@proximaintel.com" },
+]
+keywords = ["ai", "agents", "platform", "cli", "proxima"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+dependencies = [
+    "typer[all]>=0.12",
+    "httpx>=0.27",
+    "rich>=13",
+    "pyyaml>=6",
+]
+
+[project.scripts]
+prox = "prox.cli:app"
+
+[project.urls]
+Homepage = "https://proximaintel.com/aip"
+Documentation = "https://docs.proximaintel.com/cli"
+Repository = "https://github.com/proximaintel/proxima-cli"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/prox"]

proxima_cli-1.0.0/src/prox/__init__.py

@@ -0,0 +1,3 @@
+"""Proxima Intelligence Platform CLI."""
+
+__version__ = "0.1.0"

proxima_cli-1.0.0/src/prox/api.py

@@ -0,0 +1,107 @@
+"""HTTP client for gateway and catalog APIs."""
+
+import httpx
+from typing import Optional
+from . import config
+
+
+class APIError(Exception):
+    def __init__(self, status: int, detail: str):
+        self.status = status
+        self.detail = detail
+        super().__init__(f"[{status}] {detail}")
+
+
+def _gateway_url() -> str:
+    url = config.get_value("gateway")
+    if not url:
+        raise APIError(0, "Gateway URL not configured. Run: prox config set gateway <url>")
+    return url.rstrip("/")
+
+
+def _catalog_url() -> str:
+    url = config.get_value("catalog") or "https://catalog.proximaintel.com"
+    return url.rstrip("/")
+
+
+def _headers() -> dict:
+    headers = {"Content-Type": "application/json"}
+    token = config.get_token()
+    if token:
+        headers["Authorization"] = f"Bearer {token}"
+    return headers
+
+
+def _catalog_headers() -> dict:
+    headers = {"Content-Type": "application/json"}
+    master = config.get_master_key()
+    if master:
+        headers["X-Master-Key"] = master
+    else:
+        lic = config.get_license_key()
+        if lic:
+            headers["X-License-Key"] = lic
+    return headers
+
+
+# --- Gateway calls ---
+
+def gateway_get(path: str, params: Optional[dict] = None) -> dict:
+    url = f"{_gateway_url()}{path}"
+    r = httpx.get(url, headers=_headers(), params=params, timeout=30, verify=False)
+    if r.status_code >= 400:
+        raise APIError(r.status_code, r.text[:500])
+    return r.json()
+
+
+def gateway_post(path: str, data: Optional[dict] = None) -> dict:
+    url = f"{_gateway_url()}{path}"
+    r = httpx.post(url, headers=_headers(), json=data, timeout=60, verify=False)
+    if r.status_code >= 400:
+        raise APIError(r.status_code, r.text[:500])
+    return r.json()
+
+
+def gateway_put(path: str, data: Optional[dict] = None) -> dict:
+    url = f"{_gateway_url()}{path}"
+    r = httpx.put(url, headers=_headers(), json=data, timeout=60, verify=False)
+    if r.status_code >= 400:
+        raise APIError(r.status_code, r.text[:500])
+    return r.json()
+
+
+def gateway_delete(path: str) -> dict:
+    url = f"{_gateway_url()}{path}"
+    r = httpx.delete(url, headers=_headers(), timeout=30, verify=False)
+    if r.status_code >= 400:
+        raise APIError(r.status_code, r.text[:500])
+    return r.json()
+
+
+# --- Catalog calls ---
+
+def catalog_get(path: str, params: Optional[dict] = None) -> dict:
+    url = f"{_catalog_url()}{path}"
+    r = httpx.get(url, headers=_catalog_headers(), params=params, timeout=30)
+    if r.status_code >= 400:
+        raise APIError(r.status_code, r.text[:500])
+    return r.json()
+
+
+def catalog_post(path: str, data: Optional[dict] = None) -> dict:
+    url = f"{_catalog_url()}{path}"
+    r = httpx.post(url, headers=_catalog_headers(), json=data, timeout=60)
+    if r.status_code >= 400:
+        raise APIError(r.status_code, r.text[:500])
+    return r.json()
+
+
+def catalog_download(path: str, dest: str):
+    """Download a file from the catalog to a local path."""
+    url = f"{_catalog_url()}{path}"
+    with httpx.stream("GET", url, headers=_catalog_headers(), timeout=120) as r:
+        if r.status_code >= 400:
+            raise APIError(r.status_code, f"Download failed: {r.status_code}")
+        with open(dest, "wb") as f:
+            for chunk in r.iter_bytes(chunk_size=8192):
+                f.write(chunk)

proxima_cli-1.0.0/src/prox/auth.py

@@ -0,0 +1,157 @@
+"""Authentication — login, logout, token management."""
+
+import http.server
+import json
+import threading
+import time
+import urllib.parse
+import webbrowser
+from typing import Optional
+
+from . import config
+from .api import gateway_get
+
+
+def login_sso():
+    """Open browser for SSO login, capture token via local callback server."""
+    # Get auth config from gateway
+    gateway = config.get_value("gateway")
+    if not gateway:
+        raise RuntimeError("Gateway not configured. Run: prox config set gateway <url>")
+
+    try:
+        auth_config = gateway_get("/auth/config")
+    except Exception as e:
+        raise RuntimeError(f"Cannot reach gateway: {e}")
+
+    if not auth_config.get("enabled"):
+        raise RuntimeError("SSO not enabled on this gateway (dev mode). Use --api-key instead.")
+
+    authority = auth_config.get("authority", "")
+    client_id = auth_config.get("client_id", "")
+    scopes = auth_config.get("scopes", "openid profile email")
+
+    if not authority or not client_id:
+        raise RuntimeError("Gateway auth config missing authority or client_id")
+
+    # Start local server to receive the callback
+    token_result = {"token": None}
+    port = 8399
+    redirect_uri = f"http://localhost:{port}/callback"
+
+    class CallbackHandler(http.server.BaseHTTPRequestHandler):
+        def do_GET(self):
+            parsed = urllib.parse.urlparse(self.path)
+            if parsed.path == "/callback":
+                # Token comes in fragment (implicit) — serve a page that sends it back
+                self.send_response(200)
+                self.send_header("Content-Type", "text/html; charset=utf-8")
+                self.end_headers()
+                html = """
+                <html><head><meta charset="utf-8"></head><body><script>
+                const hash = window.location.hash.substring(1);
+                const params = new URLSearchParams(hash);
+                const token = params.get('access_token');
+                if (token) {
+                    fetch('/token?t=' + token).then(() => {
+                        document.body.innerHTML = '<h2>Authenticated. You can close this tab.</h2>';
+                    });
+                } else {
+                    document.body.innerHTML = '<h2>No token received.</h2>';
+                }
+                </script><p>Authenticating...</p></body></html>
+                """
+                self.wfile.write(html.encode("utf-8"))
+            elif parsed.path == "/token":
+                qs = urllib.parse.parse_qs(parsed.query)
+                token_result["token"] = qs.get("t", [None])[0]
+                self.send_response(200)
+                self.end_headers()
+                self.wfile.write(b"ok")
+            else:
+                self.send_response(404)
+                self.end_headers()
+
+        def log_message(self, format, *args):
+            pass  # Suppress server logs
+
+    server = http.server.HTTPServer(("localhost", port), CallbackHandler)
+    thread = threading.Thread(target=server.handle_request)  # Handle callback page
+    thread.daemon = True
+    thread.start()
+
+    # Also need to handle the /token request
+    thread2 = threading.Thread(target=server.handle_request)
+    thread2.daemon = True
+    thread2.start()
+
+    # Build auth URL (implicit grant)
+    auth_url = (
+        f"{authority}/oauth2/v2.0/authorize?"
+        f"client_id={client_id}"
+        f"&response_type=token"
+        f"&redirect_uri={urllib.parse.quote(redirect_uri)}"
+        f"&scope={urllib.parse.quote(scopes)}"
+        f"&response_mode=fragment"
+    )
+
+    webbrowser.open(auth_url)
+
+    # Wait for token (timeout 120s)
+    deadline = time.time() + 120
+    while not token_result["token"] and time.time() < deadline:
+        time.sleep(0.5)
+
+    server.server_close()
+
+    if not token_result["token"]:
+        raise RuntimeError("Login timed out. No token received within 120 seconds.")
+
+    # Store token
+    creds = config.load_credentials()
+    creds["token"] = token_result["token"]
+    creds["method"] = "sso"
+    creds["authenticated_at"] = time.time()
+    config.save_credentials(creds)
+    return token_result["token"]
+
+
+def login_api_key(api_key: str):
+    """Login with a platform API key."""
+    creds = config.load_credentials()
+    creds["token"] = api_key
+    creds["method"] = "api_key"
+    config.save_credentials(creds)
+
+
+def login_license_key(license_key: str):
+    """Store catalog license key."""
+    creds = config.load_credentials()
+    creds["license_key"] = license_key
+    config.save_credentials(creds)
+
+
+def login_master_key(master_key: str):
+    """Store catalog master key (Proxima team only)."""
+    creds = config.load_credentials()
+    creds["master_key"] = master_key
+    config.save_credentials(creds)
+
+
+def logout():
+    """Clear all stored credentials."""
+    config.save_credentials({})
+
+
+def whoami() -> dict:
+    """Get current auth state."""
+    creds = config.load_credentials()
+    return {
+        "authenticated": bool(creds.get("token") or creds.get("master_key")),
+        "method": creds.get("method", "none"),
+        "has_license_key": bool(creds.get("license_key")),
+        "has_master_key": bool(creds.get("master_key")),
+        "environment": config.current_environment(),
+        "gateway": config.get_value("gateway"),
+        "catalog": config.get_value("catalog"),
+    }

proxima_cli-1.0.0/src/prox/cli.py

@@ -0,0 +1,121 @@
+"""Proxima Platform CLI — entry point."""
+
+import typer
+from rich.console import Console
+
+from . import __version__, auth, config
+from .commands import catalog, agent, toolbox, knowledge, secret, model, routine, workflow, governance, platform, ontology, team
+
+app = typer.Typer(
+    name="prox",
+    help="Proxima Intelligence Platform CLI",
+    no_args_is_help=True,
+    pretty_exceptions_enable=False,
+)
+console = Console()
+
+# --- Command groups ---
+app.add_typer(catalog.app, name="catalog")
+app.add_typer(agent.app, name="agent")
+app.add_typer(toolbox.app, name="toolbox")
+app.add_typer(knowledge.app, name="knowledge")
+app.add_typer(ontology.app, name="ontology")
+app.add_typer(secret.app, name="secret")
+app.add_typer(model.app, name="model")
+app.add_typer(routine.app, name="routine")
+app.add_typer(workflow.app, name="workflow")
+app.add_typer(governance.app, name="governance")
+app.add_typer(platform.app, name="platform")
+app.add_typer(team.app, name="team")
+
+
+# --- Top-level commands ---
+
+@app.command()
+def login(
+    api_key: str = typer.Option(None, "--api-key", help="Platform API key"),
+    license_key: str = typer.Option(None, "--license-key", help="Catalog license key"),
+    master_key: str = typer.Option(None, "--master-key", help="Catalog master key (Proxima only)"),
+):
+    """Authenticate with the platform and/or catalog.
+
+    With no flags: opens browser for SSO login.
+    """
+    if not api_key and not license_key and not master_key:
+        # SSO flow
+        console.print("Opening browser for SSO login...")
+        try:
+            auth.login_sso()
+            console.print("[green]✓[/green] Authenticated via SSO")
+        except RuntimeError as e:
+            console.print(f"[red]Error:[/red] {e}")
+            raise typer.Exit(1)
+        return
+    if api_key:
+        auth.login_api_key(api_key)
+        console.print("[green]✓[/green] Platform API key stored")
+    if license_key:
+        auth.login_license_key(license_key)
+        console.print("[green]✓[/green] Catalog license key stored")
+    if master_key:
+        auth.login_master_key(master_key)
+        console.print("[green]✓[/green] Catalog master key stored")
+
+
+@app.command()
+def logout():
+    """Clear all stored credentials."""
+    auth.logout()
+    console.print("[green]✓[/green] Logged out")
+
+
+@app.command()
+def whoami():
+    """Show current authentication state."""
+    info = auth.whoami()
+    console.print(f"\n  Environment:  [bold]{info['environment']}[/bold]")
+    console.print(f"  Gateway:      {info['gateway'] or '[dim]not set[/dim]'}")
+    console.print(f"  Catalog:      {info['catalog'] or '[dim]not set[/dim]'}")
+    console.print(f"  Auth:         {'[green]authenticated[/green]' if info['authenticated'] else '[yellow]not authenticated[/yellow]'} ({info['method']})")
+    console.print(f"  License key:  {'[green]✓[/green]' if info['has_license_key'] else '[dim]—[/dim]'}")
+    console.print(f"  Master key:   {'[green]✓[/green]' if info['has_master_key'] else '[dim]—[/dim]'}")
+    console.print()
+
+
+# --- Config commands ---
+
+config_app = typer.Typer(help="Manage CLI configuration.")
+app.add_typer(config_app, name="config")
+
+
+@config_app.command("set")
+def config_set(key: str = typer.Argument(help="Config key"), value: str = typer.Argument(help="Config value")):
+    """Set a configuration value for the current environment."""
+    config.set_value(key, value)
+    console.print(f"[green]✓[/green] {key} = {value} (env: {config.current_environment()})")
+
+
+@config_app.command("list")
+def config_list():
+    """Show current configuration."""
+    env = config.current_environment()
+    env_config = config.get_env_config()
+    console.print(f"\n  [bold]Environment:[/bold] {env}\n")
+    for k, v in env_config.items():
+        console.print(f"  {k}: {v or '[dim]not set[/dim]'}")
+    console.print()
+
+
+@config_app.command("use")
+def config_use(environment: str = typer.Argument(help="Environment name")):
+    """Switch to a different environment."""
+    config.use_environment(environment)
+    console.print(f"[green]✓[/green] Switched to: {environment}")
+
+
+# --- Version ---
+
+@app.command()
+def version():
+    """Show CLI version."""
+    console.print(f"prox {__version__}")