devin-cli 1.2.4__tar.gz → 1.3.0__tar.gz

{devin_cli-1.2.4 → devin_cli-1.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devin-cli
-Version: 1.2.4
+Version: 1.3.0
 Summary: Unofficial CLI for Devin AI - The first AI Software Engineer
 Project-URL: Homepage, https://github.com/revanthpobala/devin-cli
 Project-URL: Repository, https://github.com/revanthpobala/devin-cli.git
@@ -87,7 +87,16 @@ devin watch
 
 ---
 
-## 🔑 Multi-Profile Support
+## Authentication & Usage
+
+### AI Agent Integration (JSON Output)
+For external automation and AI agent architectures relying on the CLI, `devin-cli` supports a global `--json` flag. This will suppress all visual output/terminal colors and instead uniformly return raw JSON objects for stdout and API errors, making the CLI completely deterministic to parse.
+```bash
+devin --json sessions create "My prompt"
+# { "session_id": "...", "status": "running" }
+```
+
+### Multi-Profile Support
 
 ```bash
 devin configure --profile personal

{devin_cli-1.2.4 → devin_cli-1.3.0}/README.md

@@ -51,7 +51,16 @@ devin watch
 
 ---
 
-## 🔑 Multi-Profile Support
+## Authentication & Usage
+
+### AI Agent Integration (JSON Output)
+For external automation and AI agent architectures relying on the CLI, `devin-cli` supports a global `--json` flag. This will suppress all visual output/terminal colors and instead uniformly return raw JSON objects for stdout and API errors, making the CLI completely deterministic to parse.
+```bash
+devin --json sessions create "My prompt"
+# { "session_id": "...", "status": "running" }
+```
+
+### Multi-Profile Support
 
 ```bash
 devin configure --profile personal

devin_cli-1.3.0/patch_cli.py

@@ -0,0 +1,78 @@
+import re
+
+with open("src/devin_cli/cli.py", "r") as f:
+    lines = f.read().splitlines()
+
+# We want to find each `def ..._cmd(...)` block.
+# Then, if it contains `resp = ` and doesn't end with `return`, we insert `return resp`.
+
+new_lines = []
+i = 0
+
+in_cmd = False
+cmd_indent = ""
+cmd_has_resp = False
+cmd_lines = []
+
+def finish_cmd():
+    global cmd_lines, new_lines, cmd_has_resp
+    
+    if not cmd_lines: return
+    
+    # check if has resp
+    text = "\n".join(cmd_lines)
+    if cmd_has_resp and "return" not in cmd_lines[-1]:
+        # find the indentation of the last non-empty line
+        for l in reversed(cmd_lines):
+            if l.strip():
+                indent = len(l) - len(l.lstrip())
+                break
+        else:
+            indent = 4
+        
+        # Don't add if it's already there
+        if not cmd_lines[-1].strip().startswith("return"):
+            cmd_lines.append(" " * indent + "return resp")
+    
+    new_lines.extend(cmd_lines)
+    cmd_lines = []
+    cmd_has_resp = False
+
+while i < len(lines):
+    line = lines[i]
+    
+    if line.startswith("def ") and "_cmd(" in line:
+        finish_cmd() # finish previous if any
+        in_cmd = True
+        cmd_indent = "def"
+        cmd_lines.append(line)
+    elif in_cmd:
+        if line.startswith("def "): # another function started
+            finish_cmd()
+            in_cmd = True
+            cmd_lines.append(line)
+        elif line and not line.startswith(" ") and not line.startswith("("):
+            # top level code or decorator
+            if line.startswith("@"):
+                finish_cmd()
+                new_lines.append(line)
+                in_cmd = False
+            else:
+                finish_cmd()
+                new_lines.append(line)
+                in_cmd = False
+        else:
+            if "resp =" in line or "resp = " in line:
+                cmd_has_resp = True
+            cmd_lines.append(line)
+    else:
+        new_lines.append(line)
+        
+    i += 1
+
+finish_cmd()
+
+with open("src/devin_cli/cli.py", "w") as f:
+    f.write("\n".join(new_lines) + "\n")
+
+print("Patched src/devin_cli/cli.py")

{devin_cli-1.2.4 → devin_cli-1.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "devin-cli"
-version = "1.2.4"
+version = "1.3.0"
 description = "Unofficial CLI for Devin AI - The first AI Software Engineer"
 readme = "README.md"
 authors = [

{devin_cli-1.2.4 → devin_cli-1.3.0}/src/devin_cli/cli.py

@@ -1,6 +1,8 @@
 import typer
 import time
 import json
+import requests
+import functools
 import yaml
 import asyncio
 from pathlib import Path
@@ -80,10 +82,17 @@ def main(
     ctx: typer.Context,
     profile: Optional[str] = typer.Option(None, "--profile", "-p", help="Configuration profile to use (e.g., service, personal)"),
     version: Optional[bool] = typer.Option(None, "--version", "-v", help="Show the application's version and exit."),
+    json_format: bool = typer.Option(False, "--json", help="Output raw JSON (for AI agents & scripting)"),
 ):
     """
     Unofficial CLI for Devin AI v3.
     """
+    if json_format:
+        import os
+        import warnings
+        os.environ["DEVIN_OUTPUT_FORMAT"] = "json"
+        warnings.filterwarnings("ignore")
+        
     if version:
         console.print(f"devin CLI version: {__version__}")
         raise typer.Exit()
@@ -97,16 +106,50 @@ def handle_api_error(func):
     """Decorator to handle API errors gracefully."""
     @functools.wraps(func)
     def wrapper(*args, **kwargs):
+        import os
+        is_json = os.environ.get("DEVIN_OUTPUT_FORMAT") == "json"
+        original_print = console.print
         try:
-            return func(*args, **kwargs)
-        except APIError as e:
-            console.print(f"[bold red]Error:[/bold red] {e}")
-            if e.status_code == 401:
-                console.print("Tip: Check your API token with 'devin configure'.")
-            raise typer.Exit(1)
-        except Exception as e:
-            console.print(f"[bold red]Unexpected Error:[/bold red] {e}")
-            raise typer.Exit(1)
+            if is_json:
+                console.print = lambda *a, **k: None
+
+            result = func(*args, **kwargs)
+            
+            if is_json:
+                console.print = original_print
+                if result is not None:
+                    print(json.dumps(result, indent=2))
+                    
+            return result
+        except BaseException as e:
+            if is_json:
+                console.print = original_print
+            if isinstance(e, typer.Exit):
+                raise e
+            elif isinstance(e, requests.exceptions.RequestException):
+                if is_json:
+                    print(json.dumps({"error": "Connection error", "details": str(e)}, indent=2))
+                else:
+                    console.print(f"[bold red]Connection Error:[/bold red] Failed to connect to {config.base_url}")
+                    console.print(f"[dim]{str(e)}[/dim]")
+                raise typer.Exit(1)
+            elif hasattr(e, "response"): # Standard APIError handling
+                if is_json:
+                    try:
+                        err_json = e.response.json()
+                    except:
+                        err_json = {"error": str(e)}
+                    print(json.dumps(err_json, indent=2))
+                else:
+                    console.print(f"[bold red]API Error:[/bold red] {e}")
+                raise typer.Exit(1)
+            else:
+                if is_json:
+                    print(json.dumps({"error": str(e)}, indent=2))
+                else:
+                    console.print(f"[bold red]Error:[/bold red] {e}")
+                raise typer.Exit(1)
+            
     return wrapper
 
 def get_current_session_id():
@@ -408,6 +451,7 @@ def list_knowledge_cmd(org: Optional[str] = typer.Option(None, "--org")):
         table.add_row(item.get("id"), item.get("title") or item.get("name"))
     console.print(table)
 
+    return resp
 @knowledge_app.command("create")
 @handle_api_error
 def create_knowledge_cmd(
@@ -576,6 +620,7 @@ def list_schedules_cmd(org: Optional[str] = typer.Option(None, "--org")):
         table.add_row(item.get("id"), item.get("title"), item.get("cron"))
     console.print(table)
 
+    return resp
 @schedule_app.command("create")
 @handle_api_error
 def create_schedule_cmd(
@@ -676,6 +721,7 @@ def whoami_cmd():
     resp = members.get_self()
     console.print(Panel(json.dumps(resp, indent=2), title="Who Am I"))
 
+    return resp
 @enterprise_app.command("list-orgs")
 @handle_api_error
 def list_orgs_cmd():
@@ -683,6 +729,7 @@ def list_orgs_cmd():
     resp = organizations.list_organizations()
     console.print(Panel(json.dumps(resp, indent=2), title="Organizations"))
 
+    return resp
 # --- Global Commands ---
 @app.command("use")
 def use_session_cmd(session_id: str):
@@ -711,6 +758,7 @@ def status_cmd():
     if url:
         console.print(f"[bold]URL:[/bold]     [underline]{url}[/underline]")
 
+        return resp
 @app.command("open")
 @handle_api_error
 def open_cmd(
@@ -865,6 +913,7 @@ def upload_cmd(path: Path = typer.Argument(..., help="File to upload")):
     resp = attachments.upload_file(str(path))
     console.print(f"[green]Uploaded:[/green] {resp}")
 
+    return resp
 @app.command("list-knowledge")
 @handle_api_error
 def list_knowledge_top_cmd():
@@ -878,6 +927,7 @@ def list_knowledge_top_cmd():
         table.add_row(item.get("id"), item.get("title") or item.get("name"))
     console.print(table)
 
+    return resp
 @app.command("attach")
 @handle_api_error
 def attach_cmd(
@@ -1006,6 +1056,7 @@ def list_secrets_top_cmd():
             table.add_row(item.get("id", ""), item.get("name", ""))
     console.print(table)
 
+    return resp
 @app.command("delete-secret")
 @handle_api_error
 def delete_secret_top_cmd(secret_id: str = typer.Argument(...)):

devin_cli-1.3.0/test_json.py

@@ -0,0 +1,46 @@
+import os
+import json
+from functools import wraps
+import builtins
+
+class Console:
+    def print(self, *args, **kwargs):
+        builtins.print("RICH_PRINT:", *args)
+
+console = Console()
+
+def handle_api_error(func):
+    @wraps(func)
+    def wrapper(*args, **kwargs):
+        try:
+            is_json = os.environ.get("DEVIN_OUTPUT_FORMAT") == "json"
+            if is_json:
+                original_print = console.print
+                console.print = lambda *args, **kwargs: None
+            
+            try:
+                result = func(*args, **kwargs)
+            finally:
+                if is_json:
+                    console.print = original_print
+                    
+            if is_json and result is not None:
+                builtins.print(json.dumps(result, indent=2))
+            return result
+        except Exception as e:
+            builtins.print("ERROR:", e)
+    return wrapper
+
+@handle_api_error
+def create_session_cmd():
+    console.print("[green]Session created[/green]")
+    resp = {"session_id": "123", "status": "running"}
+    return resp
+
+print("--- NORMAL MODE ---")
+os.environ.pop("DEVIN_OUTPUT_FORMAT", None)
+create_session_cmd()
+
+print("\n--- JSON MODE ---")
+os.environ["DEVIN_OUTPUT_FORMAT"] = "json"
+create_session_cmd()

devin_cli-1.3.0/test_json_wrapper.py

@@ -0,0 +1,47 @@
+import os
+import json
+from functools import wraps
+import builtins
+
+class Console:
+    def print(self, *args, **kwargs):
+        builtins.print("RICH_PRINT:", *args)
+
+console = Console()
+
+def handle_api_error(func):
+    @wraps(func)
+    def wrapper(*args, **kwargs):
+        try:
+            is_json = os.environ.get("DEVIN_OUTPUT_FORMAT") == "json"
+            if is_json:
+                original_print = console.print
+                console.print = lambda *args, **kwargs: None
+            
+            try:
+                result = func(*args, **kwargs)
+            finally:
+                if is_json:
+                    console.print = original_print
+                    
+            if is_json and result is not None:
+                builtins.print(json.dumps(result, indent=2))
+            return result
+        except Exception as e:
+            builtins.print("ERROR:", e)
+    return wrapper
+
+@handle_api_error
+def create_session_cmd():
+    console.print("[green]Session created[/green]")
+    resp = {"session_id": "123", "status": "running"}
+    return resp
+
+print("--- NORMAL MODE ---")
+if "DEVIN_OUTPUT_FORMAT" in os.environ:
+    del os.environ["DEVIN_OUTPUT_FORMAT"]
+create_session_cmd()
+
+print("\n--- JSON MODE ---")
+os.environ["DEVIN_OUTPUT_FORMAT"] = "json"
+create_session_cmd()

{devin_cli-1.2.4 → devin_cli-1.3.0}/tests/test_cli.py

@@ -22,6 +22,6 @@ def test_cli_handles_api_error():
         # command is now 'sessions create'
         result = runner.invoke(app, ["sessions", "create", "test prompt"])
         assert result.exit_code == 1
-        assert "Unexpected Error" in result.stdout
+        assert "Error" in result.stdout
         assert "API BOOM" in result.stdout