proxima-cli 1.0.0__py3-none-any.whl

prox/commands/team.py

@@ -0,0 +1,82 @@
+"""prox team — manage agent hierarchy and relationships."""
+
+from typing import Optional
+import typer
+from rich.console import Console
+from rich.table import Table
+from ..api import gateway_get, gateway_post, gateway_delete, APIError
+
+app = typer.Typer(help="Manage agent teams and relationships.")
+console = Console()
+
+
+@app.command("show")
+def show_team():
+    """Show agent hierarchy and relationships."""
+    try:
+        data = gateway_get("/team")
+    except APIError as e:
+        console.print(f"[red]Error:[/red] {e.detail}")
+        raise typer.Exit(1)
+
+    agents = data.get("agents", [])
+    relationships = data.get("relationships", [])
+    teams = data.get("teams", [])
+
+    if not agents:
+        console.print("[dim]No agents deployed.[/dim]")
+        return
+
+    # Show agents by domain
+    domains: dict[str, list] = {}
+    for a in agents:
+        d = a.get("domain", "unknown")
+        domains.setdefault(d, []).append(a)
+
+    console.print(f"\n[bold]AI Workforce[/bold] — {len(agents)} agents, {len(relationships)} relationships\n")
+    for domain, domain_agents in sorted(domains.items()):
+        console.print(f"  [bold]{domain}[/bold]")
+        for a in domain_agents:
+            role = a.get("role", "agent")
+            status = a.get("status", "planned")
+            st_style = "green" if status == "active" else "dim"
+            prefix = "  ★" if role == "orchestrator" else "   "
+            console.print(f"  {prefix} {a.get('codename', '')} ({a.get('name', a['id'])}) [{st_style}]{status}[/{st_style}]")
+        console.print()
+
+    if relationships:
+        console.print(f"  [bold]Relationships:[/bold]")
+        for r in relationships[:15]:
+            console.print(f"    {r.get('from', '?')} → {r.get('to', '?')}: {r.get('description', '')}")
+        if len(relationships) > 15:
+            console.print(f"    ... +{len(relationships) - 15} more")
+    console.print()
+
+
+@app.command("add")
+def add_relationship(
+    from_agent: str = typer.Option(..., "--from", help="Source agent ID"),
+    to_agent: str = typer.Option(..., "--to", help="Target agent ID"),
+    description: str = typer.Option(..., "--desc", help="Relationship description"),
+):
+    """Add a relationship between two agents."""
+    try:
+        gateway_post("/team/relationships", {"from": from_agent, "to": to_agent, "description": description})
+        console.print(f"[green]✓[/green] Relationship added: {from_agent} → {to_agent}")
+    except APIError as e:
+        console.print(f"[red]Error:[/red] {e.detail}")
+        raise typer.Exit(1)
+
+
+@app.command("remove")
+def remove_relationship(
+    from_agent: str = typer.Option(..., "--from", help="Source agent ID"),
+    to_agent: str = typer.Option(..., "--to", help="Target agent ID"),
+):
+    """Remove a relationship between two agents."""
+    try:
+        gateway_delete("/team/relationships")  # This needs body — use post with delete semantic
+        console.print(f"[green]✓[/green] Relationship removed: {from_agent} → {to_agent}")
+    except APIError as e:
+        console.print(f"[red]Error:[/red] {e.detail}")
+        raise typer.Exit(1)

prox/commands/toolbox.py

@@ -0,0 +1,136 @@
+"""prox toolbox — manage toolboxes (tool containers)."""
+
+import subprocess
+from pathlib import Path
+from typing import Optional
+
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from ..api import gateway_get, gateway_post, gateway_delete, APIError
+from ..config import get_value
+
+app = typer.Typer(help="Manage toolboxes.")
+console = Console()
+
+
+@app.command("list")
+def list_toolboxes():
+    """List registered toolboxes."""
+    try:
+        data = gateway_get("/build/toolboxes")
+    except APIError as e:
+        console.print(f"[red]Error:[/red] {e.detail}")
+        raise typer.Exit(1)
+
+    toolboxes = data.get("toolboxes", [])
+    if not toolboxes:
+        console.print("[dim]No toolboxes registered.[/dim]")
+        return
+
+    table = Table(title=f"Toolboxes ({len(toolboxes)})")
+    table.add_column("ID", style="bold")
+    table.add_column("Name")
+    table.add_column("Tools", justify="right")
+    table.add_column("Endpoint", style="dim")
+
+    for t in toolboxes:
+        table.add_row(t.get("id"), t.get("name", ""), str(len(t.get("tools", []))), t.get("endpoint", ""))
+
+    console.print(table)
+
+
+@app.command("register")
+def register_toolbox(
+    id: str = typer.Option(..., "--id", help="Toolbox ID"),
+    endpoint: str = typer.Option(..., "--endpoint", help="Toolbox HTTP endpoint"),
+    name: Optional[str] = typer.Option(None, "--name", help="Display name"),
+    discover: bool = typer.Option(False, "--discover", help="Auto-discover tools from OpenAPI"),
+):
+    """Register an existing toolbox endpoint."""
+    try:
+        gateway_post("/build/toolboxes", {
+            "id": id,
+            "name": name or id,
+            "endpoint": endpoint,
+            "type": "openapi",
+        })
+        if discover:
+            gateway_post("/build/toolboxes/discover", {"toolbox_id": id})
+            console.print(f"[green]✓[/green] Registered + discovered tools: {id}")
+        else:
+            console.print(f"[green]✓[/green] Registered: {id}")
+    except APIError as e:
+        console.print(f"[red]Error:[/red] {e.detail}")
+        raise typer.Exit(1)
+
+
+@app.command("discover")
+def discover_tools(
+    endpoint: str = typer.Option(None, "--endpoint", help="Discover from URL"),
+    toolbox_id: str = typer.Option(None, "--id", help="Re-discover existing toolbox"),
+):
+    """Discover tools from an OpenAPI endpoint."""
+    try:
+        payload = {}
+        if toolbox_id:
+            payload["toolbox_id"] = toolbox_id
+        if endpoint:
+            payload["endpoint"] = endpoint
+        data = gateway_post("/build/toolboxes/discover", payload)
+        tools = data.get("tools", [])
+        console.print(f"[green]✓[/green] Discovered {len(tools)} tools")
+        for t in tools:
+            console.print(f"  • {t.get('name', t)}")
+    except APIError as e:
+        console.print(f"[red]Error:[/red] {e.detail}")
+        raise typer.Exit(1)
+
+
+@app.command("deploy")
+def deploy_toolbox(
+    from_path: Path = typer.Option(..., "--from", help="Path to toolbox directory"),
+    name: str = typer.Option(..., "--name", help="Toolbox name/ID"),
+):
+    """Build, push, and register a toolbox from source."""
+    registry = get_value("registry")
+    if not registry:
+        console.print("[red]Error:[/red] No registry configured. Run: prox config set registry <acr>")
+        raise typer.Exit(1)
+
+    if not (from_path / "Dockerfile").exists():
+        console.print(f"[red]Error:[/red] No Dockerfile in {from_path}")
+        raise typer.Exit(1)
+
+    image = f"{registry}/{name}:latest"
+    console.print(f"Building {image}...")
+
+    r = subprocess.run(["docker", "build", "--platform", "linux/amd64", "-t", image, "."], cwd=from_path, capture_output=True, text=True)
+    if r.returncode != 0:
+        console.print(f"[red]Build failed:[/red]\n{r.stderr[:500]}")
+        raise typer.Exit(1)
+
+    console.print("Pushing...")
+    r = subprocess.run(["docker", "push", image], capture_output=True, text=True)
+    if r.returncode != 0:
+        console.print(f"[red]Push failed:[/red]\n{r.stderr[:500]}")
+        raise typer.Exit(1)
+
+    console.print(f"[green]✓[/green] Deployed: {image}")
+
+
+@app.command("delete")
+def delete_toolbox(
+    toolbox_id: str = typer.Argument(help="Toolbox ID"),
+    confirm: bool = typer.Option(False, "--yes", "-y"),
+):
+    """Delete a toolbox."""
+    if not confirm:
+        typer.confirm(f"Delete toolbox '{toolbox_id}'?", abort=True)
+    try:
+        gateway_delete(f"/build/toolboxes/{toolbox_id}")
+        console.print(f"[green]✓[/green] Deleted: {toolbox_id}")
+    except APIError as e:
+        console.print(f"[red]Error:[/red] {e.detail}")
+        raise typer.Exit(1)

prox/commands/workflow.py

@@ -0,0 +1,129 @@
+"""prox workflow — manage multi-agent workflows."""
+
+from pathlib import Path
+from typing import Optional
+import typer
+import yaml
+from rich.console import Console
+from rich.table import Table
+from ..api import gateway_get, gateway_post, gateway_put, gateway_delete, APIError
+
+app = typer.Typer(help="Manage workflows.")
+console = Console()
+
+
+@app.command("list")
+def list_workflows():
+    """List workflows."""
+    try:
+        data = gateway_get("/build/workflows")
+        workflows = data.get("workflows", [])
+        if not workflows:
+            console.print("[dim]No workflows.[/dim]")
+            return
+        table = Table(title="Workflows")
+        table.add_column("ID", style="bold")
+        table.add_column("Name")
+        table.add_column("Nodes", justify="right")
+        table.add_column("Status")
+        table.add_column("Version", justify="right")
+        for w in workflows:
+            st = w.get("status", "draft")
+            st_style = "green" if st == "published" else "yellow"
+            table.add_row(w.get("id"), w.get("name", ""), str(len(w.get("nodes", []))), f"[{st_style}]{st}[/{st_style}]", str(w.get("version", 1)))
+        console.print(table)
+    except APIError as e:
+        console.print(f"[red]Error:[/red] {e.detail}")
+        raise typer.Exit(1)
+
+
+@app.command("create")
+def create_workflow(
+    from_file: Path = typer.Option(..., "--from", help="YAML workflow definition"),
+):
+    """Create a workflow from YAML file."""
+    if not from_file.exists():
+        console.print(f"[red]Error:[/red] File not found: {from_file}")
+        raise typer.Exit(1)
+    wf = yaml.safe_load(from_file.read_text())
+    try:
+        gateway_post("/build/workflows", wf)
+        console.print(f"[green]✓[/green] Workflow created: {wf.get('id', '?')}")
+    except APIError as e:
+        console.print(f"[red]Error:[/red] {e.detail}")
+        raise typer.Exit(1)
+
+
+@app.command("publish")
+def publish_workflow(workflow_id: str = typer.Argument(help="Workflow ID")):
+    """Publish a workflow."""
+    try:
+        gateway_post(f"/build/workflows/{workflow_id}/publish")
+        console.print(f"[green]✓[/green] Published: {workflow_id}")
+    except APIError as e:
+        console.print(f"[red]Error:[/red] {e.detail}")
+        raise typer.Exit(1)
+
+
+@app.command("trigger")
+def trigger_workflow(
+    workflow_id: str = typer.Argument(help="Workflow ID"),
+    input: Optional[str] = typer.Option(None, "--input", "-i", help="Input message"),
+):
+    """Trigger a workflow execution."""
+    payload = {"input": {"message": input}} if input else {"input": {}}
+    try:
+        data = gateway_post(f"/workflows/{workflow_id}/trigger", payload)
+        console.print(f"[green]✓[/green] Triggered: {workflow_id}")
+        if data.get("run_id"):
+            console.print(f"  Run ID: {data['run_id']}")
+    except APIError as e:
+        console.print(f"[red]Error:[/red] {e.detail}")
+        raise typer.Exit(1)
+
+
+@app.command("runs")
+def list_runs(
+    workflow_id: Optional[str] = typer.Option(None, "--workflow", "-w"),
+    status: Optional[str] = typer.Option(None, "--status", "-s"),
+):
+    """List workflow runs."""
+    try:
+        params = {}
+        if workflow_id:
+            params["workflow_id"] = workflow_id
+        if status:
+            params["status"] = status
+        data = gateway_get("/workflows/runs", params=params)
+        runs = data.get("runs", [])
+        if not runs:
+            console.print("[dim]No runs.[/dim]")
+            return
+        table = Table(title="Workflow Runs")
+        table.add_column("Run ID", style="bold")
+        table.add_column("Workflow")
+        table.add_column("Status")
+        table.add_column("Trigger")
+        for r in runs:
+            st = r.get("status", "?")
+            st_style = "green" if st == "completed" else "yellow" if "waiting" in st else "red" if st == "failed" else "dim"
+            trigger = r.get("trigger", {})
+            tby = trigger.get("triggered_by", "?") if isinstance(trigger, dict) else "?"
+            table.add_row(r.get("id", ""), r.get("workflow_id", ""), f"[{st_style}]{st}[/{st_style}]", tby)
+        console.print(table)
+    except APIError as e:
+        console.print(f"[red]Error:[/red] {e.detail}")
+        raise typer.Exit(1)
+
+
+@app.command("delete")
+def delete_workflow(workflow_id: str = typer.Argument(), confirm: bool = typer.Option(False, "--yes", "-y")):
+    """Delete a workflow."""
+    if not confirm:
+        typer.confirm(f"Delete workflow '{workflow_id}'?", abort=True)
+    try:
+        gateway_delete(f"/build/workflows/{workflow_id}")
+        console.print(f"[green]✓[/green] Deleted: {workflow_id}")
+    except APIError as e:
+        console.print(f"[red]Error:[/red] {e.detail}")
+        raise typer.Exit(1)

prox/config.py

@@ -0,0 +1,98 @@
+"""Configuration management — ~/.prox/ directory."""
+
+import json
+from pathlib import Path
+from typing import Optional
+
+PROX_DIR = Path.home() / ".prox"
+CONFIG_FILE = PROX_DIR / "config.json"
+CREDENTIALS_FILE = PROX_DIR / "credentials.json"
+PACKAGES_DIR = PROX_DIR / "packages"
+
+DEFAULT_CONFIG = {
+    "environment": "local",
+    "environments": {
+        "local": {
+            "gateway": "http://localhost:9000",
+            "catalog": "https://catalog.proximaintel.com",
+            "registry": "",
+        }
+    },
+}
+
+
+def ensure_dirs():
+    PROX_DIR.mkdir(exist_ok=True)
+    PACKAGES_DIR.mkdir(exist_ok=True)
+
+
+def load_config() -> dict:
+    ensure_dirs()
+    if not CONFIG_FILE.exists():
+        save_config(DEFAULT_CONFIG)
+        return DEFAULT_CONFIG
+    return json.loads(CONFIG_FILE.read_text())
+
+
+def save_config(config: dict):
+    ensure_dirs()
+    CONFIG_FILE.write_text(json.dumps(config, indent=2))
+
+
+def get_env_config() -> dict:
+    """Get the active environment's config."""
+    config = load_config()
+    env = config.get("environment", "local")
+    return config.get("environments", {}).get(env, {})
+
+
+def get_value(key: str) -> Optional[str]:
+    return get_env_config().get(key)
+
+
+def set_value(key: str, value: str):
+    config = load_config()
+    env = config.get("environment", "local")
+    if env not in config.get("environments", {}):
+        config.setdefault("environments", {})[env] = {}
+    config["environments"][env][key] = value
+    save_config(config)
+
+
+def use_environment(name: str):
+    config = load_config()
+    if name not in config.get("environments", {}):
+        config.setdefault("environments", {})[name] = {}
+    config["environment"] = name
+    save_config(config)
+
+
+def current_environment() -> str:
+    return load_config().get("environment", "local")
+
+
+# --- Credentials ---
+
+def load_credentials() -> dict:
+    ensure_dirs()
+    if not CREDENTIALS_FILE.exists():
+        return {}
+    return json.loads(CREDENTIALS_FILE.read_text())
+
+
+def save_credentials(creds: dict):
+    ensure_dirs()
+    CREDENTIALS_FILE.write_text(json.dumps(creds, indent=2))
+    CREDENTIALS_FILE.chmod(0o600)
+
+
+def get_token() -> Optional[str]:
+    return load_credentials().get("token")
+
+
+def get_license_key() -> Optional[str]:
+    return load_credentials().get("license_key")
+
+
+def get_master_key() -> Optional[str]:
+    return load_credentials().get("master_key")

proxima_cli-1.0.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,22 @@
+prox/__init__.py,sha256=Bcs1sfs1zo9IQ6jNNme0kaP0eD9Q26nSV70ynUkA73Y,64
+prox/api.py,sha256=m5cHzpWrgaI8ZPuSbwBbmHjhxaKTppyNNV288BGRWqc,3312
+prox/auth.py,sha256=5KzkDpbNsUiFDa24iGvtVLugBZsGnqcapFeVtVGQUq8,5327
+prox/cli.py,sha256=fhIUosETDi8ieDnsf0gY0ggA47yEgQkAx6TipJcJn4s,4231
+prox/config.py,sha256=q-UlgSQtFHQbKhhxJJJJfnegV8QzMium61ssCXQ7SeM,2397
+prox/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+prox/commands/agent.py,sha256=kdmPXzR9VAOrLWJ1pI21MBM5E1Ne3E4uTYHP8sNn774,13081
+prox/commands/catalog.py,sha256=ytcZTwL5wkykhM3QLVtHs1G0xIGKNZ23BCNZxjPlPnw,8936
+prox/commands/governance.py,sha256=PBdM30r3aEJ89jOUxWdFfkmkVLeYcJLEOghGkP0DQq4,2330
+prox/commands/knowledge.py,sha256=1bzUHa_HjR9a0wvPOzif-LcSdQRzAwRHKGOlILqKNFc,5000
+prox/commands/model.py,sha256=YVvaMni-PZ4JE40mZPQRM2ZVZmipK9iRDNtmKiMbzZk,2495
+prox/commands/ontology.py,sha256=1DLis-226EW1f03Gy09W4wr4hWUQuYcw8ZllfmdFNo0,7282
+prox/commands/platform.py,sha256=tOhZxlf_Mx8B75U_qTalLS1_fvAH9ny_bf7mchtwFHk,1601
+prox/commands/routine.py,sha256=yKv2gIPphFmuMP2MJQzINKDi3C6B0ZTAMef7MhYjkJE,3087
+prox/commands/secret.py,sha256=ZP5mYaG_vP388EpCRaZ9OP56aR-pgb8trlyWQJMEv20,1994
+prox/commands/team.py,sha256=mklup9FuvdFus11H5hOB0uxrQdX5mj9hk-Hu7EX11QE,3127
+prox/commands/toolbox.py,sha256=UanlA-Km6OsyUl4MCPPh2E9OJwPdg66akQ9dbI3Z1Qw,4671
+prox/commands/workflow.py,sha256=fRx3vkZR8kC7TWpx2vbQXhdnYY04AXrlxhaa5s6Ou_Y,4758
+proxima_cli-1.0.0.dist-info/METADATA,sha256=cRjRiqg0iub90yzIisvop7b6Lk1dyLQwAZ_Cq9f3y-w,2995
+proxima_cli-1.0.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+proxima_cli-1.0.0.dist-info/entry_points.txt,sha256=kDTz7VO9X7wf_4P-fBjPa5MPVT9L3KygYS7p15dqfJI,38
+proxima_cli-1.0.0.dist-info/RECORD,,

proxima_cli-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

proxima_cli-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+prox = prox.cli:app