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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devin-cli
-Version: 1.2.3
+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.3 → 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.3 → devin_cli-1.3.0}/pyproject.toml

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

{devin_cli-1.2.3 → devin_cli-1.3.0}/src/devin_cli/api/v1/knowledge.py

@@ -5,18 +5,19 @@ def list_knowledge():
     return client.get("knowledge")
 
 def create_knowledge(
-    name: str,
-    body: str,
-    trigger_description: str,
+    name: str = None,
+    body: str = None,
+    trigger_description: str = None,
     parent_folder_id: str = None,
     pinned_repo: str = None,
     title: str = None, # v3 fallback
+    trigger: str = None, # v3 fallback
     **kwargs
 ):
     data = {
         "name": name or title,
         "body": body,
-        "trigger_description": trigger_description or ""
+        "trigger_description": trigger_description or trigger or ""
     }
     if parent_folder_id:
         data["parent_folder_id"] = parent_folder_id
@@ -31,6 +32,7 @@ def update_knowledge(
     body: str = None,
     trigger_description: str = None,
     title: str = None, # v3 fallback
+    trigger: str = None, # v3 fallback
     **kwargs
 ):
     data = {}
@@ -38,8 +40,8 @@ def update_knowledge(
         data["name"] = name or title
     if body:
         data["body"] = body
-    if trigger_description:
-        data["trigger_description"] = trigger_description
+    if trigger_description or trigger:
+        data["trigger_description"] = trigger_description or trigger
         
     return client.put(f"knowledge/{knowledge_id}", json=data)
 

{devin_cli-1.2.3 → devin_cli-1.3.0}/src/devin_cli/api/v3/knowledge.py

@@ -5,12 +5,17 @@ def list_knowledge():
     return client.get("knowledge/notes")
 
 def create_knowledge(
-    title: str,
-    body: str,
+    title: str = None,
+    body: str = None,
+    name: str = None,
+    trigger: str = "",
+    trigger_description: str = "",
+    **kwargs
 ):
     data = {
-        "title": title,
+        "name": name or title,
         "body": body,
+        "trigger": trigger or trigger_description or ""
     }
     return client.post("knowledge/notes", json=data)
 
@@ -21,12 +26,18 @@ def update_knowledge(
     note_id: str,
     title: Optional[str] = None,
     body: Optional[str] = None,
+    trigger: Optional[str] = None,
+    name: Optional[str] = None,
+    trigger_description: Optional[str] = None,
+    **kwargs
 ):
     data = {}
-    if title:
-        data["title"] = title
+    if title or name:
+        data["name"] = title or name
     if body:
         data["body"] = body
+    if trigger or trigger_description:
+        data["trigger"] = trigger or trigger_description
         
     return client.put(f"knowledge/notes/{note_id}", json=data)
 

{devin_cli-1.2.3 → devin_cli-1.3.0}/src/devin_cli/api/v3/sessions.py

@@ -27,8 +27,9 @@ def create_session(
 ):
     data = {
         "prompt": prompt,
-        "bypass_approval": bypass_approval,
     }
+    if bypass_approval:
+        data["bypass_approval"] = bypass_approval
     if advanced_mode:
         data["advanced_mode"] = advanced_mode
     if attachment_urls:

{devin_cli-1.2.3 → 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,16 +451,18 @@ 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(
     title: str, 
     body: str, 
+    trigger: str = typer.Option("", "--trigger", help="Trigger description"),
     org: Optional[str] = typer.Option(None, "--org"),
 ):
     """Create a knowledge note."""
     if org: config.temporary_org_id = org
-    resp = knowledge.create_knowledge(title, body)
+    resp = knowledge.create_knowledge(title=title, body=body, trigger=trigger)
     console.print(f"[green]Created note:[/green] {resp.get('id')}")
 
 @knowledge_app.command("delete")
@@ -435,13 +480,21 @@ def delete_knowledge_cmd(
 # --- Playbooks ---
 @playbook_app.command("list")
 @handle_api_error
-def list_playbooks_cmd(org: Optional[str] = typer.Option(None, "--org")):
+def list_playbooks_cmd(
+    org: Optional[str] = typer.Option(None, "--org"),
+    json_output: bool = typer.Option(False, "--json", help="Output raw JSON"),
+):
     """List team playbooks."""
     if org: config.temporary_org_id = org
     resp = playbooks.list_playbooks()
     items = resp.get("items", []) if isinstance(resp, dict) else resp
+    
+    if json_output:
+        console.print(json.dumps(items, indent=2))
+        return
+
     table = Table(title="Playbooks")
-    table.add_column("ID", style="cyan")
+    table.add_column("ID", style="cyan", no_wrap=True)
     table.add_column("Title")
     for item in items:
         if isinstance(item, dict):
@@ -567,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(
@@ -667,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():
@@ -674,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):
@@ -702,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(
@@ -856,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():
@@ -869,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(
@@ -950,7 +1009,7 @@ def update_knowledge_cmd(
     trigger: Optional[str] = typer.Option(None, "--trigger"),
 ):
     """Update an existing knowledge entry."""
-    knowledge.update_knowledge(knowledge_id, title=name, body=body)
+    knowledge.update_knowledge(knowledge_id, title=name, body=body, trigger=trigger)
     console.print(f"[green]Knowledge {knowledge_id} updated.[/green]")
 
 @app.command("update-playbook")
@@ -997,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.3 → devin_cli-1.3.0}/tests/test_api/test_knowledge.py

@@ -24,19 +24,21 @@ def test_create_knowledge():
     )
     knowledge.create_knowledge(
         title="test",
-        body="content"
+        body="content",
+        trigger="my_trigger"
     )
     assert route.called
     import json
     body = json.loads(route.calls.last.request.read())
-    assert body["title"] == "test"
+    assert body["name"] == "test"
+    assert body["trigger"] == "my_trigger"
 
 @respx.mock
 def test_update_knowledge():
     route = respx.put("https://api.devin.ai/v3/organizations/test_org/knowledge/notes/k_123").mock(
         return_value=Response(200)
     )
-    knowledge.update_knowledge("k_123", title="new")
+    knowledge.update_knowledge("k_123", title="new", trigger="new_trigger")
     assert route.called
 
 @respx.mock

{devin_cli-1.2.3 → 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