genalpha_test_cli 0.1.0__py3-none-any.whl

genalpha_test_cli/cli.py

@@ -0,0 +1,756 @@
+"""Auto-generated CLI for genalpha_test_cli. Generated by genalphacli."""
+
+from __future__ import annotations
+
+import json
+from typing import Any
+
+import typer
+
+from genalpha_test_cli.client import ApiError, api_call
+
+app = typer.Typer(name="genalpha_test_cli", help="CLI for genalpha_test_cli")
+
+
+def _output(data: Any, pretty: bool = False) -> None:
+    """Format and print API response."""
+    if pretty:
+        from rich import print_json
+
+        print_json(data=data)
+    else:
+        typer.echo(json.dumps(data, indent=2))
+
+
+
+@app.command(name="health")
+def health(
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """GET /health"""
+    try:
+        result = api_call("GET", f"/health")
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="login")
+def login(
+    body_val: str = typer.Option(..., "--body", help="body"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """Login and get a token."""
+    try:
+        try:
+            data = json.loads(body_val)
+        except json.JSONDecodeError as e:
+            typer.echo(f"Error: Invalid JSON in --body: {e}", err=True)
+            raise typer.Exit(1)
+        result = api_call("POST", f"/auth/login", json_data=data)
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="get-me")
+def get_me(
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """Get current user from token."""
+    try:
+        result = api_call("GET", f"/auth/me")
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="list-users")
+def list_users(
+    limit: int | None = typer.Option(None, "--limit", help="limit"),
+    offset: int | None = typer.Option(None, "--offset", help="offset"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """List all users."""
+    try:
+        params: dict[str, Any] = {}
+        if limit is not None:
+            params["limit"] = limit
+        if offset is not None:
+            params["offset"] = offset
+        result = api_call("GET", f"/api/v1/users", params=params)
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="get-user")
+def get_user(
+    user_id: str = typer.Argument(help="user_id"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """Get a user by ID."""
+    try:
+        result = api_call("GET", f"/api/v1/users/{user_id}")
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="create-user")
+def create_user(
+    body_val: str = typer.Option(..., "--body", help="body"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """Create a new user."""
+    try:
+        try:
+            data = json.loads(body_val)
+        except json.JSONDecodeError as e:
+            typer.echo(f"Error: Invalid JSON in --body: {e}", err=True)
+            raise typer.Exit(1)
+        result = api_call("POST", f"/api/v1/users", json_data=data)
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="delete-user")
+def delete_user(
+    user_id: str = typer.Argument(help="user_id"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """Delete a user."""
+    try:
+        result = api_call("DELETE", f"/api/v1/users/{user_id}")
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="list-projects")
+def list_projects(
+    limit: int | None = typer.Option(None, "--limit", help="limit"),
+    offset: int | None = typer.Option(None, "--offset", help="offset"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """List all projects."""
+    try:
+        params: dict[str, Any] = {}
+        if limit is not None:
+            params["limit"] = limit
+        if offset is not None:
+            params["offset"] = offset
+        result = api_call("GET", f"/api/v1/projects", params=params)
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="get-project")
+def get_project(
+    project_id: str = typer.Argument(help="project_id"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """Get a project by ID."""
+    try:
+        result = api_call("GET", f"/api/v1/projects/{project_id}")
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="create-project")
+def create_project(
+    body_val: str = typer.Option(..., "--body", help="body"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """Create a new project."""
+    try:
+        try:
+            data = json.loads(body_val)
+        except json.JSONDecodeError as e:
+            typer.echo(f"Error: Invalid JSON in --body: {e}", err=True)
+            raise typer.Exit(1)
+        result = api_call("POST", f"/api/v1/projects", json_data=data)
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="get-root")
+def get_root(
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """Root endpoint."""
+    try:
+        result = api_call("GET", f"/")
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="list-users")
+def list_users(
+    limit: int | None = typer.Option(None, "--limit", help="limit"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """GET /users/"""
+    try:
+        params: dict[str, Any] = {}
+        if limit is not None:
+            params["limit"] = limit
+        result = api_call("GET", f"/users/", params=params)
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="get-user")
+def get_user(
+    user_id: int = typer.Argument(help="user_id"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """GET /users/{user_id}"""
+    try:
+        result = api_call("GET", f"/users/{user_id}")
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="create-user")
+def create_user(
+    name: str = typer.Option(..., "--name", help="name"),
+    email: str = typer.Option(..., "--email", help="email"),
+    raw_body: str | None = typer.Option(None, "--body", help="Raw JSON body (overrides flags)"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """POST /users/"""
+    try:
+        if raw_body:
+            try:
+                data = json.loads(raw_body)
+            except json.JSONDecodeError as e:
+                typer.echo(f"Error: Invalid JSON in --body: {e}", err=True)
+                raise typer.Exit(1)
+        else:
+            data = { "name": name, "email": email, }
+        result = api_call("POST", f"/users/", json_data=data)
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="delete-user")
+def delete_user(
+    user_id: int = typer.Argument(help="user_id"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """DELETE /users/{user_id}"""
+    try:
+        result = api_call("DELETE", f"/users/{user_id}")
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="request-magic-link")
+def request_magic_link(
+    body_val: str = typer.Option(..., "--body", help="body"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """Send a magic link to the user's email.  Always returns 200 regardless of whether the email exists (prevents enumeration). Uses Resend for email delivery. Falls back to console logging if no API key."""
+    try:
+        try:
+            data = json.loads(body_val)
+        except json.JSONDecodeError as e:
+            typer.echo(f"Error: Invalid JSON in --body: {e}", err=True)
+            raise typer.Exit(1)
+        result = api_call("POST", f"/auth/magic-link", json_data=data)
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="verify-magic-link")
+def verify_magic_link(
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """Verify a magic link token, create/find user, set session cookie."""
+    try:
+        result = api_call("GET", f"/auth/verify")
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="get-session")
+def get_session(
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """Get the current user's session info including workspace."""
+    try:
+        result = api_call("GET", f"/auth/session")
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="logout")
+def logout(
+    session_id: str | None = typer.Option(None, "--session-id", help="session_id"),
+    raw_body: str | None = typer.Option(None, "--body", help="Raw JSON body (overrides flags)"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """Log out by deleting the session."""
+    try:
+        if raw_body:
+            try:
+                data = json.loads(raw_body)
+            except json.JSONDecodeError as e:
+                typer.echo(f"Error: Invalid JSON in --body: {e}", err=True)
+                raise typer.Exit(1)
+        else:
+            data = { "session_id": session_id, }
+        result = api_call("POST", f"/auth/logout", json_data=data)
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="list-all-services")
+def list_all_services(
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """List all services across all projects for the current workspace."""
+    try:
+        result = api_call("GET", f"/services")
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="list-services-by-project")
+def list_services_by_project(
+    project_id: str = typer.Argument(help="project_id"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """List all services for a project (excludes route_graph for performance)."""
+    try:
+        result = api_call("GET", f"/services/by-project/{project_id}")
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="get-service")
+def get_service(
+    service_id: str = typer.Argument(help="service_id"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """Get a service with ownership check."""
+    try:
+        result = api_call("GET", f"/services/{service_id}")
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="delete-service")
+def delete_service(
+    service_id: str = typer.Argument(help="service_id"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """Delete a service with ownership check."""
+    try:
+        result = api_call("DELETE", f"/services/{service_id}")
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="download-service")
+def download_service(
+    service_id: str = typer.Argument(help="service_id"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """Download the generated zip for a service (redirects to artifact)."""
+    try:
+        result = api_call("GET", f"/services/{service_id}/download")
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="start-generate")
+def start_generate(
+    body_val: str = typer.Option(..., "--body", help="body"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """Start generation workflow for a parsed service."""
+    try:
+        try:
+            data = json.loads(body_val)
+        except json.JSONDecodeError as e:
+            typer.echo(f"Error: Invalid JSON in --body: {e}", err=True)
+            raise typer.Exit(1)
+        result = api_call("POST", f"/generate", json_data=data)
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="oauth-callback")
+def oauth_callback(
+    code: str | None = typer.Option(None, "--code", help="code"),
+    state: str | None = typer.Option(None, "--state", help="state"),
+    error: str | None = typer.Option(None, "--error", help="error"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """Public OAuth callback — no auth required. Context is in the encrypted state."""
+    try:
+        params: dict[str, Any] = {}
+        if code is not None:
+            params["code"] = code
+        if state is not None:
+            params["state"] = state
+        if error is not None:
+            params["error"] = error
+        result = api_call("GET", f"/oauth/callback", params=params)
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="upload-artifact")
+def upload_artifact(
+    service_id: str = typer.Argument(help="service_id"),
+    file: str | None = typer.Option(None, "--file", help="file"),
+    artifact_type: str | None = typer.Option(None, "--artifact-type", help="artifact_type"),
+    raw_body: str | None = typer.Option(None, "--body", help="Raw JSON body (overrides flags)"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """Upload a generated artifact (ZIP) for a service. Called by the worker."""
+    try:
+        if raw_body:
+            try:
+                data = json.loads(raw_body)
+            except json.JSONDecodeError as e:
+                typer.echo(f"Error: Invalid JSON in --body: {e}", err=True)
+                raise typer.Exit(1)
+        else:
+            data = { "file": file, "artifact_type": artifact_type, }
+        result = api_call("POST", f"/services/{service_id}/artifacts", json_data=data)
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="download-artifact")
+def download_artifact(
+    artifact_id: str = typer.Argument(help="artifact_id"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """Download a generated artifact ZIP."""
+    try:
+        result = api_call("GET", f"/artifacts/{artifact_id}/download")
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="start-parse")
+def start_parse(
+    body_val: str = typer.Option(..., "--body", help="body"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """Validate GitHub URL, check limits, create service record, start parse workflow."""
+    try:
+        try:
+            data = json.loads(body_val)
+        except json.JSONDecodeError as e:
+            typer.echo(f"Error: Invalid JSON in --body: {e}", err=True)
+            raise typer.Exit(1)
+        result = api_call("POST", f"/parse", json_data=data)
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="update-service-status")
+def update_service_status(
+    service_id: str = typer.Argument(help="service_id"),
+    body_val: str = typer.Option(..., "--body", help="body"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """Update service status — called by Temporal worker activities."""
+    try:
+        try:
+            data = json.loads(body_val)
+        except json.JSONDecodeError as e:
+            typer.echo(f"Error: Invalid JSON in --body: {e}", err=True)
+            raise typer.Exit(1)
+        result = api_call("POST", f"/services/{service_id}/status", json_data=data)
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="list-projects")
+def list_projects(
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """List all projects in the current workspace."""
+    try:
+        result = api_call("GET", f"/projects")
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="create-project")
+def create_project(
+    body_val: str = typer.Option(..., "--body", help="body"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """Create a new project in the current workspace."""
+    try:
+        try:
+            data = json.loads(body_val)
+        except json.JSONDecodeError as e:
+            typer.echo(f"Error: Invalid JSON in --body: {e}", err=True)
+            raise typer.Exit(1)
+        result = api_call("POST", f"/projects", json_data=data)
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="update-project")
+def update_project(
+    project_id: str = typer.Argument(help="project_id"),
+    body_val: str = typer.Option(..., "--body", help="body"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """Update a project's name or description."""
+    try:
+        try:
+            data = json.loads(body_val)
+        except json.JSONDecodeError as e:
+            typer.echo(f"Error: Invalid JSON in --body: {e}", err=True)
+            raise typer.Exit(1)
+        result = api_call("PATCH", f"/projects/{project_id}", json_data=data)
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="delete-project")
+def delete_project(
+    project_id: str = typer.Argument(help="project_id"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """Delete a project (cascade deletes services)."""
+    try:
+        result = api_call("DELETE", f"/projects/{project_id}")
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="list-apps")
+def list_apps(
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """GET /integrations/apps"""
+    try:
+        result = api_call("GET", f"/integrations/apps")
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="get-app")
+def get_app(
+    identifier: str = typer.Argument(help="identifier"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """GET /integrations/apps/{identifier}"""
+    try:
+        result = api_call("GET", f"/integrations/apps/{identifier}")
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="list-integrations")
+def list_integrations(
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """GET /integrations"""
+    try:
+        result = api_call("GET", f"/integrations")
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="get-integration")
+def get_integration(
+    identifier: str = typer.Argument(help="identifier"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """GET /integrations/{identifier}"""
+    try:
+        result = api_call("GET", f"/integrations/{identifier}")
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="install-app")
+def install_app(
+    app_name: str = typer.Argument(help="app_name"),
+    body_val: str = typer.Option(..., "--body", help="body"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """Build OAuth authorize URL. TPS is stateless — just plugs state into URL."""
+    try:
+        try:
+            data = json.loads(body_val)
+        except json.JSONDecodeError as e:
+            typer.echo(f"Error: Invalid JSON in --body: {e}", err=True)
+            raise typer.Exit(1)
+        result = api_call("POST", f"/integrations/{app_name}/install", json_data=data)
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="connect-app")
+def connect_app(
+    app_name: str = typer.Argument(help="app_name"),
+    body_val: str = typer.Option(..., "--body", help="body"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """Connect a credential-based app. Validates fields, stores encrypted."""
+    try:
+        try:
+            data = json.loads(body_val)
+        except json.JSONDecodeError as e:
+            typer.echo(f"Error: Invalid JSON in --body: {e}", err=True)
+            raise typer.Exit(1)
+        result = api_call("POST", f"/integrations/{app_name}/connect", json_data=data)
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="remove-integration")
+def remove_integration(
+    integration_id: str = typer.Argument(help="integration_id"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """DELETE /integrations/{integration_id}"""
+    try:
+        result = api_call("DELETE", f"/integrations/{integration_id}")
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="list-apps")
+def list_apps(
+    category: str | None = typer.Option(None, "--category", help="category"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """GET /apps — list all active apps, optionally filtered by category."""
+    try:
+        params: dict[str, Any] = {}
+        if category is not None:
+            params["category"] = category
+        result = api_call("GET", f"/apps", params=params)
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="get-app")
+def get_app(
+    identifier: str = typer.Argument(help="identifier"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """GET /apps/{identifier} — polymorphic lookup by app_name or app_code."""
+    try:
+        result = api_call("GET", f"/apps/{identifier}")
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+@app.command(name="exchange-oauth-code")
+def exchange_oauth_code(
+    app_name: str = typer.Argument(help="app_name"),
+    body_val: str = typer.Option(..., "--body", help="body"),
+    pretty: bool = typer.Option(False, "--pretty", help="Rich-formatted output"),
+) -> None:
+    """Exchange OAuth code for token. No state validation — Core already did that."""
+    try:
+        try:
+            data = json.loads(body_val)
+        except json.JSONDecodeError as e:
+            typer.echo(f"Error: Invalid JSON in --body: {e}", err=True)
+            raise typer.Exit(1)
+        result = api_call("POST", f"/integrations/{app_name}/exchange", json_data=data)
+        _output(result, pretty)
+    except ApiError as e:
+        typer.echo(f"Error: {e.message}", err=True)
+        raise typer.Exit(1)
+
+
+if __name__ == "__main__":
+    app()