devin-cli 1.0.0__tar.gz → 1.1.0__tar.gz

{devin_cli-1.0.0 → devin_cli-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devin-cli
-Version: 1.0.0
+Version: 1.1.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
@@ -46,7 +46,7 @@ Description-Content-Type: text/markdown
   <a href="https://github.com/revanthpobala/devin-cli/actions/workflows/pypi-publish.yml"><img src="https://github.com/revanthpobala/devin-cli/actions/workflows/pypi-publish.yml/badge.svg" alt="Build Status"></a>
 </p>
 
-> **The first unofficial CLI for the world's first AI Software Engineer. Now fully upgraded to Devin API v3.**
+> **The first unofficial CLI for the world's first AI Software Engineer. Now upgraded to v1.1.0 with Multi-Profile support and legacy v1 backward-compatibility.**
 
 Devin CLI is designed for high-velocity engineering teams. It strips away the friction of the web UI, allowing you to orchestrate autonomous agents, manage complex contexts, and automate multi-step development workflows through a robust, terminal-first interface. Built for performance, SEO, and developer productivity.
 
@@ -84,6 +84,15 @@ devin configure
 devin sessions create -t "Identify and fix the race condition in our Redis cache layer"
 ```
 
+## 🌟 What's New in v1.1.0
+
+- **Dual-Token Profiles:** Seamlessly switch between personal (`apk_user_`) and Service Account (`cog_`) tokens on the fly using `--profile`.
+  - `devin configure --profile service`
+  - `devin --profile service sessions list`
+- **Legacy v1 Backward Compatibility:** Need to run an older integration that depends on the original Devin API shapes? The CLI now acts as a dynamic proxy. Simply configure a profile to use `api_version: v1`, and the CLI will route authentic payloads directly to the deprecated v1 endpoints without breaking your v3 integrations.
+- **Session Deduplication (Anti-Spam):** Avoid burning ACUs on accidental retries. The CLI now actively caches a SHA-256 hash of your last 50 prompts per profile, immediately halting and alerting you if you attempt to launch a duplicate session.
+- **Advanced Mode Auth:** Automatically traps `advanced_mode_url` requirements and securely prompts you to finish the connection handshake directly in your web browser.
+
 ---
 
 ## 🛠 Command Cheat Sheet (v3 Architecture)

{devin_cli-1.0.0 → devin_cli-1.1.0}/README.md

@@ -10,7 +10,7 @@
   <a href="https://github.com/revanthpobala/devin-cli/actions/workflows/pypi-publish.yml"><img src="https://github.com/revanthpobala/devin-cli/actions/workflows/pypi-publish.yml/badge.svg" alt="Build Status"></a>
 </p>
 
-> **The first unofficial CLI for the world's first AI Software Engineer. Now fully upgraded to Devin API v3.**
+> **The first unofficial CLI for the world's first AI Software Engineer. Now upgraded to v1.1.0 with Multi-Profile support and legacy v1 backward-compatibility.**
 
 Devin CLI is designed for high-velocity engineering teams. It strips away the friction of the web UI, allowing you to orchestrate autonomous agents, manage complex contexts, and automate multi-step development workflows through a robust, terminal-first interface. Built for performance, SEO, and developer productivity.
 
@@ -48,6 +48,15 @@ devin configure
 devin sessions create -t "Identify and fix the race condition in our Redis cache layer"
 ```
 
+## 🌟 What's New in v1.1.0
+
+- **Dual-Token Profiles:** Seamlessly switch between personal (`apk_user_`) and Service Account (`cog_`) tokens on the fly using `--profile`.
+  - `devin configure --profile service`
+  - `devin --profile service sessions list`
+- **Legacy v1 Backward Compatibility:** Need to run an older integration that depends on the original Devin API shapes? The CLI now acts as a dynamic proxy. Simply configure a profile to use `api_version: v1`, and the CLI will route authentic payloads directly to the deprecated v1 endpoints without breaking your v3 integrations.
+- **Session Deduplication (Anti-Spam):** Avoid burning ACUs on accidental retries. The CLI now actively caches a SHA-256 hash of your last 50 prompts per profile, immediately halting and alerting you if you attempt to launch a duplicate session.
+- **Advanced Mode Auth:** Automatically traps `advanced_mode_url` requirements and securely prompts you to finish the connection handshake directly in your web browser.
+
 ---
 
 ## 🛠 Command Cheat Sheet (v3 Architecture)

devin_cli-1.1.0/generate_facades.py

@@ -0,0 +1,21 @@
+import os
+
+modules = ["attachments", "consumption", "knowledge", "members", "organizations", "playbooks", "repositories", "schedules", "secrets", "sessions"]
+
+for mod in modules:
+    content = f"""from devin_cli.config import config
+import importlib
+
+def _get_impl():
+    if config.api_version == "v1":
+        try:
+            return importlib.import_module(f"devin_cli.api.v1.{mod}")
+        except ImportError:
+            raise NotImplementedError(f"'{mod}' feature is only available in Devin API v3, or is not implemented for v1. Run 'devin configure' to switch your API version to v3.")
+    return importlib.import_module(f"devin_cli.api.v3.{mod}")
+
+def __getattr__(name):
+    return getattr(_get_impl(), name)
+"""
+    with open(f"src/devin_cli/api/{mod}.py", "w") as f:
+        f.write(content)

{devin_cli-1.0.0 → devin_cli-1.1.0}/pyproject.toml

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

devin_cli-1.1.0/src/devin_cli/api/attachments.py

@@ -0,0 +1,13 @@
+from devin_cli.config import config
+import importlib
+
+def _get_impl():
+    if config.api_version == "v1":
+        try:
+            return importlib.import_module(f"devin_cli.api.v1.attachments")
+        except ImportError:
+            raise NotImplementedError(f"'attachments' feature is only available in Devin API v3, or is not implemented for v1. Run 'devin configure' to switch your API version to v3.")
+    return importlib.import_module(f"devin_cli.api.v3.attachments")
+
+def __getattr__(name):
+    return getattr(_get_impl(), name)

{devin_cli-1.0.0 → devin_cli-1.1.0}/src/devin_cli/api/client.py

@@ -11,7 +11,7 @@ class APIError(Exception):
         super().__init__(message)
         self.status_code = status_code
 
-class APIClient:
+class BaseClient:
     def __init__(self):
         pass
 
@@ -43,19 +43,33 @@ class APIClient:
             response.raise_for_status()
         except httpx.HTTPStatusError as e:
             status = e.response.status_code
+            path = str(e.request.url.path)
+            
+            error_detail = ""
+            try:
+                error_body = e.response.json()
+                error_detail = error_body.get("detail") or error_body.get("message") or error_body.get("error") or str(error_body)
+            except Exception:
+                error_detail = e.response.text.strip()
+                
+            msg_suffix = f"\n  Path:   {path}"
+            if error_detail:
+                msg_suffix += f"\n  Detail: {error_detail}"
+
             if status == 401:
-                raise APIError("Invalid or expired API token (401). Run 'devin configure'.", status)
+                raise APIError(f"Invalid or expired API token (401).{msg_suffix}", status)
             elif status == 403:
-                raise APIError("Insufficient permissions (403).", status)
+                raise APIError(f"Insufficient permissions (403).{msg_suffix}", status)
             elif status == 404:
-                raise APIError("Resource not found (404).", status)
+                raise APIError(f"Resource not found (404).{msg_suffix}", status)
+            elif status == 422:
+                raise APIError(f"Validation Error (422).{msg_suffix}", status)
             elif status == 429:
-                raise APIError("Rate limit exceeded (429). Please try again later.", status)
+                raise APIError(f"Rate limit exceeded (429). Please try again later.", status)
             elif status >= 500:
-                raise APIError(f"Server error ({status}).", status)
+                raise APIError(f"Server error ({status}).{msg_suffix}", status)
             else:
-                raise APIError(f"HTTP Error {status}: {e}", status)
-        
+                raise APIError(f"HTTP Error {status}.{msg_suffix}", status)
         if response.status_code == 204:
             return None
 
@@ -72,25 +86,12 @@ class APIClient:
             
         return response.text
 
+    def _format_url(self, endpoint: str) -> str:
+        raise NotImplementedError()
+
     def request(self, method: str, endpoint: str, **kwargs) -> Any:
         self._ensure_token()
-        
-        endpoint = endpoint.lstrip("/")
-        
-        # Determine the base URL and whether to inject organization
-        if endpoint.startswith("v3beta1/"):
-            base = config.base_url.replace("/v3", "").replace("/v2", "").replace("/v1", "").rstrip("/")
-            url = f"{base}/{endpoint}"
-            # Inject organization for v3beta1 if not present
-            if config.org_id and "/organizations/" not in url:
-                url = url.replace("v3beta1/", f"v3beta1/organizations/{config.org_id}/")
-        elif endpoint.startswith("enterprise/"):
-            url = f"{self.BASE_URL}/{endpoint}"
-        else:
-            # Standard path, inject organization if configured
-            if config.org_id and not endpoint.startswith("organizations/"):
-                endpoint = f"organizations/{config.org_id}/{endpoint}"
-            url = f"{self.BASE_URL}/{endpoint}"
+        url = self._format_url(endpoint)
         
         # Merge headers if needed, but usually self.headers is enough
         headers = self.headers.copy()
@@ -102,7 +103,7 @@ class APIClient:
             headers.pop("Content-Type", None)
 
         try:
-            with httpx.Client(follow_redirects=True) as client:
+            with httpx.Client(follow_redirects=True, verify=False, timeout=httpx.Timeout(120.0)) as client:
                 response = client.request(method, url, headers=headers, **kwargs)
                 return self._handle_response(response)
         except httpx.RequestError as e:
@@ -120,4 +121,45 @@ class APIClient:
     def delete(self, endpoint: str, **kwargs) -> Any:
         return self.request("DELETE", endpoint, **kwargs)
 
-client = APIClient()
+class V3Client(BaseClient):
+    def _format_url(self, endpoint: str) -> str:
+        endpoint = endpoint.lstrip("/")
+        if endpoint.startswith("v3beta1/"):
+            base = config.base_url.replace("/v3", "").replace("/v2", "").replace("/v1", "").rstrip("/")
+            url = f"{base}/{endpoint}"
+            if config.org_id and "/organizations/" not in url:
+                url = url.replace("v3beta1/", f"v3beta1/organizations/{config.org_id}/")
+            return url
+        elif endpoint.startswith("enterprise/"):
+            return f"{self.BASE_URL}/{endpoint}"
+        else:
+            if config.org_id and not endpoint.startswith("organizations/"):
+                endpoint = f"organizations/{config.org_id}/{endpoint}"
+            return f"{self.BASE_URL}/{endpoint}"
+
+class V1Client(BaseClient):
+    def _format_url(self, endpoint: str) -> str:
+        return f"{self.BASE_URL}/{endpoint.lstrip('/')}"
+
+class ClientProxy:
+    def __init__(self):
+        self._v1 = V1Client()
+        self._v3 = V3Client()
+        
+    @property
+    def _client(self) -> BaseClient:
+        return self._v1 if config.api_version == "v1" else self._v3
+
+    def get(self, endpoint: str, **kwargs) -> Any:
+        return self._client.get(endpoint, **kwargs)
+
+    def post(self, endpoint: str, **kwargs) -> Any:
+        return self._client.post(endpoint, **kwargs)
+
+    def put(self, endpoint: str, **kwargs) -> Any:
+        return self._client.put(endpoint, **kwargs)
+
+    def delete(self, endpoint: str, **kwargs) -> Any:
+        return self._client.delete(endpoint, **kwargs)
+
+client = ClientProxy()

devin_cli-1.1.0/src/devin_cli/api/consumption.py

@@ -0,0 +1,13 @@
+from devin_cli.config import config
+import importlib
+
+def _get_impl():
+    if config.api_version == "v1":
+        try:
+            return importlib.import_module(f"devin_cli.api.v1.consumption")
+        except ImportError:
+            raise NotImplementedError(f"'consumption' feature is only available in Devin API v3, or is not implemented for v1. Run 'devin configure' to switch your API version to v3.")
+    return importlib.import_module(f"devin_cli.api.v3.consumption")
+
+def __getattr__(name):
+    return getattr(_get_impl(), name)

devin_cli-1.1.0/src/devin_cli/api/knowledge.py

@@ -0,0 +1,13 @@
+from devin_cli.config import config
+import importlib
+
+def _get_impl():
+    if config.api_version == "v1":
+        try:
+            return importlib.import_module(f"devin_cli.api.v1.knowledge")
+        except ImportError:
+            raise NotImplementedError(f"'knowledge' feature is only available in Devin API v3, or is not implemented for v1. Run 'devin configure' to switch your API version to v3.")
+    return importlib.import_module(f"devin_cli.api.v3.knowledge")
+
+def __getattr__(name):
+    return getattr(_get_impl(), name)

devin_cli-1.1.0/src/devin_cli/api/members.py

@@ -0,0 +1,13 @@
+from devin_cli.config import config
+import importlib
+
+def _get_impl():
+    if config.api_version == "v1":
+        try:
+            return importlib.import_module(f"devin_cli.api.v1.members")
+        except ImportError:
+            raise NotImplementedError(f"'members' feature is only available in Devin API v3, or is not implemented for v1. Run 'devin configure' to switch your API version to v3.")
+    return importlib.import_module(f"devin_cli.api.v3.members")
+
+def __getattr__(name):
+    return getattr(_get_impl(), name)

devin_cli-1.1.0/src/devin_cli/api/organizations.py

@@ -0,0 +1,13 @@
+from devin_cli.config import config
+import importlib
+
+def _get_impl():
+    if config.api_version == "v1":
+        try:
+            return importlib.import_module(f"devin_cli.api.v1.organizations")
+        except ImportError:
+            raise NotImplementedError(f"'organizations' feature is only available in Devin API v3, or is not implemented for v1. Run 'devin configure' to switch your API version to v3.")
+    return importlib.import_module(f"devin_cli.api.v3.organizations")
+
+def __getattr__(name):
+    return getattr(_get_impl(), name)

devin_cli-1.1.0/src/devin_cli/api/playbooks.py

@@ -0,0 +1,13 @@
+from devin_cli.config import config
+import importlib
+
+def _get_impl():
+    if config.api_version == "v1":
+        try:
+            return importlib.import_module(f"devin_cli.api.v1.playbooks")
+        except ImportError:
+            raise NotImplementedError(f"'playbooks' feature is only available in Devin API v3, or is not implemented for v1. Run 'devin configure' to switch your API version to v3.")
+    return importlib.import_module(f"devin_cli.api.v3.playbooks")
+
+def __getattr__(name):
+    return getattr(_get_impl(), name)

devin_cli-1.1.0/src/devin_cli/api/repositories.py

@@ -0,0 +1,13 @@
+from devin_cli.config import config
+import importlib
+
+def _get_impl():
+    if config.api_version == "v1":
+        try:
+            return importlib.import_module(f"devin_cli.api.v1.repositories")
+        except ImportError:
+            raise NotImplementedError(f"'repositories' feature is only available in Devin API v3, or is not implemented for v1. Run 'devin configure' to switch your API version to v3.")
+    return importlib.import_module(f"devin_cli.api.v3.repositories")
+
+def __getattr__(name):
+    return getattr(_get_impl(), name)

devin_cli-1.1.0/src/devin_cli/api/schedules.py

@@ -0,0 +1,13 @@
+from devin_cli.config import config
+import importlib
+
+def _get_impl():
+    if config.api_version == "v1":
+        try:
+            return importlib.import_module(f"devin_cli.api.v1.schedules")
+        except ImportError:
+            raise NotImplementedError(f"'schedules' feature is only available in Devin API v3, or is not implemented for v1. Run 'devin configure' to switch your API version to v3.")
+    return importlib.import_module(f"devin_cli.api.v3.schedules")
+
+def __getattr__(name):
+    return getattr(_get_impl(), name)

devin_cli-1.1.0/src/devin_cli/api/secrets.py

@@ -0,0 +1,13 @@
+from devin_cli.config import config
+import importlib
+
+def _get_impl():
+    if config.api_version == "v1":
+        try:
+            return importlib.import_module(f"devin_cli.api.v1.secrets")
+        except ImportError:
+            raise NotImplementedError(f"'secrets' feature is only available in Devin API v3, or is not implemented for v1. Run 'devin configure' to switch your API version to v3.")
+    return importlib.import_module(f"devin_cli.api.v3.secrets")
+
+def __getattr__(name):
+    return getattr(_get_impl(), name)

devin_cli-1.1.0/src/devin_cli/api/sessions.py

@@ -0,0 +1,13 @@
+from devin_cli.config import config
+import importlib
+
+def _get_impl():
+    if config.api_version == "v1":
+        try:
+            return importlib.import_module(f"devin_cli.api.v1.sessions")
+        except ImportError:
+            raise NotImplementedError(f"'sessions' feature is only available in Devin API v3, or is not implemented for v1. Run 'devin configure' to switch your API version to v3.")
+    return importlib.import_module(f"devin_cli.api.v3.sessions")
+
+def __getattr__(name):
+    return getattr(_get_impl(), name)

devin_cli-1.1.0/src/devin_cli/api/v1/attachments.py

@@ -0,0 +1,16 @@
+import mimetypes
+from pathlib import Path
+from devin_cli.api.client import client
+
+def upload_file(file_path: str, **kwargs):
+    path = Path(file_path)
+    mime_type, _ = mimetypes.guess_type(path)
+    mime_type = mime_type or "application/octet-stream"
+    
+    with open(path, "rb") as f:
+        # V1 used multipart/form-data with 'file' argument
+        return client.post("attachments", files={"file": (path.name, f, mime_type)})
+
+def download_attachment(attachment_id: str, file_name: str, **kwargs):
+    # Depending on exactly what v1 required, it might just be the direct path or stream
+    return client.get(f"attachments/{attachment_id}")

devin_cli-1.1.0/src/devin_cli/api/v1/knowledge.py

@@ -0,0 +1,49 @@
+from typing import List, Optional
+from devin_cli.api.client import client
+
+def list_knowledge():
+    return client.get("knowledge")
+
+def create_knowledge(
+    name: str,
+    body: str,
+    trigger_description: str,
+    parent_folder_id: str = None,
+    pinned_repo: str = None,
+    title: str = None, # v3 fallback
+    **kwargs
+):
+    data = {
+        "name": name or title,
+        "body": body,
+        "trigger_description": trigger_description or ""
+    }
+    if macro:
+        data["macro"] = macro
+    if parent_folder_id:
+        data["parent_folder_id"] = parent_folder_id
+    if pinned_repo:
+        data["pinned_repo"] = pinned_repo
+        
+    return client.post("knowledge", json=data)
+
+def update_knowledge(
+    knowledge_id: str,
+    name: str = None,
+    body: str = None,
+    trigger_description: str = None,
+    title: str = None, # v3 fallback
+    **kwargs
+):
+    data = {}
+    if name or title:
+        data["name"] = name or title
+    if body:
+        data["body"] = body
+    if trigger_description:
+        data["trigger_description"] = trigger_description
+        
+    return client.put(f"knowledge/{knowledge_id}", json=data)
+
+def delete_knowledge(knowledge_id: str):
+    return client.delete(f"knowledge/{knowledge_id}")

devin_cli-1.1.0/src/devin_cli/api/v1/playbooks.py

@@ -0,0 +1,27 @@
+from typing import List, Optional
+from devin_cli.api.client import client
+
+def list_playbooks():
+    return client.get("playbooks")
+
+def create_playbook(title: str, body: str, macro: str = None, **kwargs):
+    data = {"title": title, "body": body}
+    if macro:
+        data["macro"] = macro
+    return client.post("playbooks", json=data)
+
+def get_playbook(playbook_id: str):
+    return client.get(f"playbooks/{playbook_id}")
+
+def update_playbook(playbook_id: str, title: str = None, body: str = None, macro: str = None, **kwargs):
+    data = {}
+    if title:
+        data["title"] = title
+    if body:
+        data["body"] = body
+    if macro:
+        data["macro"] = macro
+    return client.put(f"playbooks/{playbook_id}", json=data)
+
+def delete_playbook(playbook_id: str):
+    return client.delete(f"playbooks/{playbook_id}")

devin_cli-1.1.0/src/devin_cli/api/v1/secrets.py

@@ -0,0 +1,7 @@
+from devin_cli.api.client import client
+
+def list_secrets():
+    return client.get("secrets")
+
+def delete_secret(secret_id: str):
+    return client.delete(f"secrets/{secret_id}")

devin_cli-1.1.0/src/devin_cli/api/v1/sessions.py

@@ -0,0 +1,58 @@
+from typing import List, Optional
+from devin_cli.api.client import client
+
+def list_sessions(limit: int = 100, offset: int = 0, tags: List[str] = None):
+    params = {"limit": limit, "offset": offset}
+    if tags:
+        params["tags"] = tags
+    return client.get("sessions", params=params)
+
+def create_session(
+    prompt: str,
+    idempotent: bool = False,
+    snapshot_id: str = None,
+    playbook_id: str = None,
+    unlisted: bool = False,
+    tags: List[str] = None,
+    session_secrets: List[dict] = None,
+    title: Optional[str] = None,
+    knowledge_ids: Optional[List[str]] = None,
+    secret_ids: Optional[List[str]] = None,
+    max_acu_limit: Optional[int] = None,
+    **kwargs
+):
+    data = {
+        "prompt": prompt,
+        "idempotent": idempotent,
+        "unlisted": unlisted
+    }
+    if snapshot_id:
+        data["snapshot_id"] = snapshot_id
+    if playbook_id:
+        data["playbook_id"] = playbook_id
+    if tags:
+        data["tags"] = tags
+    if session_secrets:
+        data["session_secrets"] = session_secrets
+    if title:
+        data["title"] = title
+    if knowledge_ids:
+        data["knowledge_ids"] = knowledge_ids
+    if secret_ids:
+        data["secret_ids"] = secret_ids
+    if max_acu_limit:
+        data["max_acu_limit"] = max_acu_limit
+        
+    return client.post("sessions", json=data)
+
+def get_session(session_id: str):
+    return client.get(f"sessions/{session_id}")
+
+def send_message(session_id: str, message: str):
+    return client.post(f"sessions/{session_id}/message", data={"message": message})
+
+def update_session_tags(session_id: str, tags: List[str]):
+    return client.put(f"sessions/{session_id}/tags", data={"tags": tags})
+
+def terminate_session(session_id: str):
+    return client.delete(f"sessions/{session_id}")

{devin_cli-1.0.0/src/devin_cli/api → devin_cli-1.1.0/src/devin_cli/api/v3}/playbooks.py

@@ -13,10 +13,8 @@ def create_playbook(title: str, body: str, macro: Optional[str] = None):
 def get_playbook(playbook_id: str):
     return client.get(f"playbooks/{playbook_id}")
 
-def update_playbook(playbook_id: str, title: Optional[str] = None, body: Optional[str] = None, macro: Optional[str] = None):
-    data = {}
-    if title:
-        data["title"] = title
+def update_playbook(playbook_id: str, title: str, body: Optional[str] = None, macro: Optional[str] = None):
+    data = {"title": title}
     if body:
         data["body"] = body
     if macro:
@@ -39,10 +37,8 @@ def create_enterprise_playbook(title: str, body: str, macro: Optional[str] = Non
 def get_enterprise_playbook(playbook_id: str):
     return client.get(f"enterprise/playbooks/{playbook_id}")
 
-def update_enterprise_playbook(playbook_id: str, title: Optional[str] = None, body: Optional[str] = None, macro: Optional[str] = None):
-    data = {}
-    if title:
-        data["title"] = title
+def update_enterprise_playbook(playbook_id: str, title: str, body: Optional[str] = None, macro: Optional[str] = None):
+    data = {"title": title}
     if body:
         data["body"] = body
     if macro:

{devin_cli-1.0.0 → devin_cli-1.1.0}/src/devin_cli/cli.py

@@ -16,23 +16,44 @@ from devin_cli.api.client import client, APIError
 import webbrowser
 import functools
 import sys
+import hashlib
+import importlib.metadata
+
+try:
+    __version__ = importlib.metadata.version("devin-cli")
+except importlib.metadata.PackageNotFoundError:
+    __version__ = "unknown"
+
+# Early profile detection for accurate --help menus
+if "--profile" in sys.argv:
+    idx = sys.argv.index("--profile")
+    if idx + 1 < len(sys.argv):
+        config.active_profile = sys.argv[idx + 1]
+elif "-p" in sys.argv:
+    idx = sys.argv.index("-p")
+    if idx + 1 < len(sys.argv):
+        config.active_profile = sys.argv[idx + 1]
+
+IS_V1 = config.api_version == "v1"
+v1_tag = " [bold yellow](Legacy v1 API)[/bold yellow]" if IS_V1 else ""
+v3_only = " [bold red](v3 Only)[/bold red]" if IS_V1 else ""
 
 app = typer.Typer(
-    help="Unofficial CLI for Devin AI v3",
+    help=f"Unofficial CLI for Devin AI{' (V1 Legacy Mode)' if IS_V1 else ' v3'}",
     no_args_is_help=True,
     rich_markup_mode="rich"
 )
 console = Console()
 
 # --- Sub-Apps for Organization API ---
-session_app = typer.Typer(help="Manage Devin sessions", no_args_is_help=True)
-knowledge_app = typer.Typer(help="Manage knowledge notes", no_args_is_help=True)
-playbook_app = typer.Typer(help="Manage team playbooks", no_args_is_help=True)
-secret_app = typer.Typer(help="Manage organization secrets", no_args_is_help=True)
-schedule_app = typer.Typer(help="Manage session schedules", no_args_is_help=True)
-attachment_app = typer.Typer(help="Manage session attachments", no_args_is_help=True)
-repo_app = typer.Typer(help="Manage organization repositories", no_args_is_help=True)
-enterprise_app = typer.Typer(help="Enterprise-scoped operations", no_args_is_help=True)
+session_app = typer.Typer(help=f"Manage Devin sessions{v1_tag}", no_args_is_help=True)
+knowledge_app = typer.Typer(help=f"Manage knowledge notes{v1_tag}", no_args_is_help=True)
+playbook_app = typer.Typer(help=f"Manage team playbooks{v1_tag}", no_args_is_help=True)
+secret_app = typer.Typer(help=f"Manage organization secrets{v1_tag}", no_args_is_help=True)
+schedule_app = typer.Typer(help=f"Manage session schedules{v3_only}", no_args_is_help=True)
+attachment_app = typer.Typer(help=f"Manage session attachments{v1_tag}", no_args_is_help=True)
+repo_app = typer.Typer(help=f"Manage organization repositories{v3_only}", no_args_is_help=True)
+enterprise_app = typer.Typer(help=f"Enterprise-scoped operations{v3_only}", no_args_is_help=True)
 
 app.add_typer(session_app, name="sessions", help="Manage Devin sessions")
 app.add_typer(session_app, name="session", hidden=True)
@@ -53,11 +74,20 @@ ASCII_LOGO = r"""
 [/bold cyan]
 """
 
-@app.callback()
-def main(ctx: typer.Context):
+@app.callback(invoke_without_command=True)
+def main(
+    ctx: typer.Context,
+    profile: str = typer.Option("default", "--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."),
+):
     """
     Unofficial CLI for Devin AI v3.
     """
+    if version:
+        console.print(f"devin CLI version: {__version__}")
+        raise typer.Exit()
+        
+    config.active_profile = profile
     if ctx.invoked_subcommand is None:
         console.print(ASCII_LOGO)
 
@@ -89,16 +119,28 @@ def configure(
     token: str = typer.Option(..., prompt="Devin API Token (starts with apk_ or cog_)", help="Your Devin API Token"),
     base_url: str = typer.Option("https://api.devin.ai/v3", prompt="Devin API Base URL", help="Devin API Base URL"),
     org_id: Optional[str] = typer.Option(None, "--org", prompt="Organization ID (optional)", help="Default Organization ID"),
+    profile: Optional[str] = typer.Option(None, "--profile", help="Profile to configure (overrides global --profile)"),
 ):
     """
     Configure the CLI with your Devin API token and organization.
     """
+    if profile:
+        config.active_profile = profile
+        
     # Validation based on v3 requirements
     if not (token.startswith("apk_") or token.startswith("cog_")):
         console.print("[bold yellow]Warning:[/bold yellow] Token format might be outdated. v3 tokens usually start with 'apk_' or 'cog_'.")
     
+    api_version_prompt = Prompt.ask(f"API Version for profile '{config.active_profile}' (v3/v1)", default=config.api_version or "v3")
+
+    if "api.devin.ai" in base_url and "v3" in base_url and api_version_prompt == "v1":
+        base_url = base_url.replace("/v3", "/v1")
+    elif "api.devin.ai" in base_url and "v1" in base_url and api_version_prompt == "v3":
+        base_url = base_url.replace("/v1", "/v3")
+
     config.api_token = token
     config.base_url = base_url
+    config.api_version = api_version_prompt
     if org_id:
         config.org_id = org_id
     console.print(f"[green]Configuration saved to {config.config_file}[/green]")
@@ -112,6 +154,8 @@ def create_session_cmd(
     title: Optional[str] = typer.Option(None, "--title", "-t", help="Custom session title"),
     org: Optional[str] = typer.Option(None, "--org", help="Override organization ID"),
     max_acu: Optional[int] = typer.Option(None, "--max-acu", help="Maximum ACU limit"),
+    advanced_mode: Optional[str] = typer.Option(None, "--advanced-mode", help="Enable advanced mode (e.g. CLI, browser) for the session"),
+    force: bool = typer.Option(False, "--force", help="Force creation even if duplicate prompt is detected"),
 ):
     """Create a new Devin session."""
     if org: config.temporary_org_id = org
@@ -122,13 +166,44 @@ def create_session_cmd(
     else:
         console.print("[bold red]Error:[/bold red] Must provide prompt or --file")
         raise typer.Exit(1)
+        
+    prompt_hash = hashlib.sha256(prompt_text.encode('utf-8')).hexdigest()
+    existing_sid = config.get_session_by_prompt_hash(prompt_hash)
+    
+    if existing_sid and not force:
+        console.print(f"[bold yellow]Duplicate Detected:[/bold yellow] You recently created a session with this exact prompt.")
+        console.print(f"Existing Session ID: [bold cyan]{existing_sid}[/bold cyan]")
+        import typer
+        if not typer.confirm("Are you sure you want to create a duplicate session?"):
+            console.print("Session creation cancelled. Use the existing session ID above to resume.")
+            raise typer.Exit()
 
     with console.status("[bold green]Creating session...[/bold green]"):
-        resp = sessions.create_session(prompt=prompt_text, title=title, max_acu_limit=max_acu)
-        sid = resp["session_id"]
-        config.current_session_id = sid
-        console.print(f"[green]Session created:[/green] {sid}")
-        console.print(f"[bold cyan]URL:[/bold cyan] {resp.get('url')}")
+        resp = sessions.create_session(
+            prompt=prompt_text, 
+            title=title, 
+            max_acu_limit=max_acu,
+            advanced_mode=advanced_mode
+        )
+        sid = resp.get("session_id")
+        
+        if "advanced_mode_url" in resp:
+            adv_url = resp["advanced_mode_url"]
+            console.print(f"[bold yellow]Advanced Mode Authorization Required![/bold yellow]")
+            console.print(f"Please complete verify the advanced mode setup in your browser:")
+            console.print(f"[bold cyan]{adv_url}[/bold cyan]")
+            import typer
+            if typer.confirm("Open browser now?"):
+                import webbrowser
+                webbrowser.open(adv_url)
+                
+        if sid:
+            config.current_session_id = sid
+            config.save_prompt_hash(prompt_hash, sid)
+            console.print(f"[green]Session created:[/green] {sid}")
+            console.print(f"[bold cyan]URL:[/bold cyan] {resp.get('url')}")
+        else:
+            console.print("[yellow]Session created, but no ID returned immediately (awaiting advanced mode setup).[/yellow]")
 
 @session_app.command("list")
 @handle_api_error
@@ -141,6 +216,10 @@ def list_sessions_cmd(
     if org: config.temporary_org_id = org
     resp = sessions.list_sessions(limit=limit)
     sess_list = resp.get("sessions", [])
+    
+    if not sess_list and config.api_token and config.api_token.startswith("cog_"):
+        console.print("[yellow]Warning: Service tokens (cog_) may only have visibility into sessions they explicitly created, not all organization sessions.[/yellow]")
+        
     if json_output:
         console.print(json.dumps(sess_list, indent=2))
     else:
@@ -179,7 +258,7 @@ def session_insights_cmd(
 @session_app.command("cost")
 @handle_api_error
 def session_cost_cmd(
-    session_id: Optional[str] = typer.Option(None, "--id"),
+    session_id: Optional[str] = typer.Argument(None, help="Specific session ID to check cost for"),
     org: Optional[str] = typer.Option(None, "--org"),
 ):
     """View ACU consumption."""
@@ -279,13 +358,29 @@ def list_playbooks_cmd(org: Optional[str] = typer.Option(None, "--org")):
     """List team playbooks."""
     if org: config.temporary_org_id = org
     resp = playbooks.list_playbooks()
+    items = resp.get("items", []) if isinstance(resp, dict) else resp
     table = Table(title="Playbooks")
     table.add_column("ID", style="cyan")
     table.add_column("Title")
-    for item in resp:
-        table.add_row(item.get("playbook_id"), item.get("title"))
+    for item in items:
+        if isinstance(item, dict):
+            table.add_row(item.get("playbook_id", ""), item.get("title", ""))
     console.print(table)
 
+@playbook_app.command("update")
+@handle_api_error
+def update_playbook_cmd(
+    playbook_id: str,
+    title: str,
+    body: Optional[str] = typer.Option(None, "--body"),
+    macro: Optional[str] = typer.Option(None, "--macro"),
+    org: Optional[str] = typer.Option(None, "--org"),
+):
+    """Update a team playbook."""
+    if org: config.temporary_org_id = org
+    resp = playbooks.update_playbook(playbook_id, title=title, body=body, macro=macro)
+    console.print(f"[green]Playbook updated:[/green] {playbook_id}")
+
 @playbook_app.command("create")
 @handle_api_error
 def create_playbook_cmd(

devin_cli-1.1.0/src/devin_cli/config.py

@@ -0,0 +1,153 @@
+import json
+import os
+from pathlib import Path
+from typing import Optional
+
+CONFIG_DIR = Path.home() / ".config" / "devin"
+CONFIG_FILE = CONFIG_DIR / "config.json"
+
+class Config:
+    def __init__(self, config_dir: Path = None):
+        self._config_dir = config_dir or CONFIG_DIR
+        self._config_file = self._config_dir / "config.json"
+        self._ensure_config_exists()
+        self._load()
+
+    @property
+    def config_file(self) -> Path:
+        return self._config_file
+
+    def _ensure_config_exists(self):
+        if not self._config_dir.exists():
+            self._config_dir.mkdir(parents=True, mode=0o700)
+        if not self._config_file.exists():
+            with open(self._config_file, "w") as f:
+                json.dump({}, f)
+            self._config_file.chmod(0o600)
+
+    def _load(self):
+        try:
+            with open(self._config_file, "r") as f:
+                self._data = json.load(f)
+        except (json.JSONDecodeError, FileNotFoundError):
+            self._data = {}
+            
+        if "profiles" not in self._data:
+            # Migrate legacy flat config to default profile
+            legacy_keys = ["api_token", "base_url", "org_id", "api_version", "current_session_id"]
+            legacy_data = {}
+            for key in legacy_keys:
+                if key in self._data:
+                    legacy_data[key] = self._data.pop(key)
+            self._data["profiles"] = {
+                "default": legacy_data
+            }
+            if "active_profile" not in self._data:
+                self._data["active_profile"] = "default"
+            self._save()
+
+
+    def _save(self):
+        with open(self._config_file, "w") as f:
+            json.dump(self._data, f, indent=2)
+
+    @property
+    def active_profile(self) -> str:
+        return getattr(self, "_runtime_profile", None) or self._data.get("active_profile", "default")
+        
+    @active_profile.setter
+    def active_profile(self, value: str):
+        self._runtime_profile = value
+        if "profiles" not in self._data:
+            self._data["profiles"] = {}
+        if value not in self._data["profiles"]:
+            self._data["profiles"][value] = {}
+            
+    def _get_profile_data(self) -> dict:
+        return self._data.get("profiles", {}).get(self.active_profile, {})
+
+    def _set_profile_data(self, key: str, value: str):
+        profile_name = self.active_profile
+        if "profiles" not in self._data:
+            self._data["profiles"] = {}
+        if profile_name not in self._data["profiles"]:
+            self._data["profiles"][profile_name] = {}
+        self._data["profiles"][profile_name][key] = value
+        self._save()
+
+    @property
+    def api_token(self) -> Optional[str]:
+        # Env var takes precedence
+        return os.environ.get("DEVIN_API_TOKEN") or self._get_profile_data().get("api_token")
+
+    @api_token.setter
+    def api_token(self, value: str):
+        self._set_profile_data("api_token", value)
+
+    @property
+    def org_id(self) -> Optional[str]:
+        # Temporary override takes highest precedence (CLI flag)
+        # then env var, then config file
+        return getattr(self, "_temporary_org_id", None) or os.environ.get("DEVIN_ORG_ID") or self._get_profile_data().get("org_id")
+
+    @org_id.setter
+    def org_id(self, value: str):
+        self._set_profile_data("org_id", value)
+
+    @property
+    def temporary_org_id(self) -> Optional[str]:
+        return getattr(self, "_temporary_org_id", None)
+
+    @temporary_org_id.setter
+    def temporary_org_id(self, value: Optional[str]):
+        self._temporary_org_id = value
+
+    @property
+    def base_url(self) -> str:
+        return os.environ.get("DEVIN_BASE_URL") or self._get_profile_data().get("base_url", "https://api.devin.ai/v3")
+
+    @base_url.setter
+    def base_url(self, value: str):
+        self._set_profile_data("base_url", value)
+
+    @property
+    def api_version(self) -> str:
+        return os.environ.get("DEVIN_API_VERSION") or self._get_profile_data().get("api_version", "v3")
+
+    @api_version.setter
+    def api_version(self, value: str):
+        self._set_profile_data("api_version", value)
+
+    @property
+    def current_session_id(self) -> Optional[str]:
+        return self._get_profile_data().get("current_session_id")
+
+    @current_session_id.setter
+    def current_session_id(self, value: str):
+        self._set_profile_data("current_session_id", value)
+
+    def get_session_by_prompt_hash(self, prompt_hash: str) -> Optional[str]:
+        return self._get_profile_data().get("prompt_hashes", {}).get(prompt_hash)
+
+    def save_prompt_hash(self, prompt_hash: str, session_id: str):
+        profile_name = self.active_profile
+        if "profiles" not in self._data:
+            self._data["profiles"] = {}
+        if profile_name not in self._data["profiles"]:
+            self._data["profiles"][profile_name] = {}
+            
+        profile_data = self._data["profiles"][profile_name]
+        if "prompt_hashes" not in profile_data:
+            profile_data["prompt_hashes"] = {}
+            
+        profile_data["prompt_hashes"][prompt_hash] = session_id
+        
+        # Keep only the last 50 hashes to prevent config bloat
+        if len(profile_data["prompt_hashes"]) > 50:
+            keys_to_remove = list(profile_data["prompt_hashes"].keys())[:-50]
+            for k in keys_to_remove:
+                del profile_data["prompt_hashes"][k]
+                
+        self._save()
+
+config = Config()

devin_cli-1.1.0/test_duplicate.py

@@ -0,0 +1,19 @@
+import logging
+import httpx
+from devin_cli.api import sessions
+from devin_cli.config import config
+import json
+
+logging.basicConfig(level=logging.DEBUG)
+logging.getLogger("httpx").setLevel(logging.DEBUG)
+
+print("Active Token:", config.api_token[:10] if config.api_token else "None")
+print("Base URL:", config.base_url)
+
+try:
+    print("Sending request...")
+    resp = sessions.create_session(prompt="Testing duplicate bug. Ignore.", title="Duplicate Test")
+    print("Response:")
+    print(json.dumps(resp, indent=2))
+except Exception as e:
+    print("Error:", e)

devin_cli-1.1.0/tests/conftest.py

@@ -0,0 +1,8 @@
+import pytest
+import os
+from devin_cli.config import config
+
+@pytest.fixture(autouse=True)
+def ensure_v3_for_tests():
+    os.environ["DEVIN_API_VERSION"] = "v3"
+    config.api_version = "v3"

{devin_cli-1.0.0 → devin_cli-1.1.0}/tests/test_api/test_playbooks.py

@@ -42,7 +42,7 @@ def test_update_playbook():
     route = respx.put("https://api.devin.ai/v3/organizations/test_org/playbooks/pb_123").mock(
         return_value=Response(200)
     )
-    playbooks.update_playbook("pb_123", body="new body")
+    playbooks.update_playbook("pb_123", title="new title", body="new body")
     assert route.called
 
 @respx.mock

devin_cli-1.0.0/src/devin_cli/config.py

@@ -1,86 +0,0 @@
-import json
-import os
-from pathlib import Path
-from typing import Optional
-
-CONFIG_DIR = Path.home() / ".config" / "devin"
-CONFIG_FILE = CONFIG_DIR / "config.json"
-
-class Config:
-    def __init__(self, config_dir: Path = None):
-        self._config_dir = config_dir or CONFIG_DIR
-        self._config_file = self._config_dir / "config.json"
-        self._ensure_config_exists()
-        self._load()
-
-    @property
-    def config_file(self) -> Path:
-        return self._config_file
-
-    def _ensure_config_exists(self):
-        if not self._config_dir.exists():
-            self._config_dir.mkdir(parents=True, mode=0o700)
-        if not self._config_file.exists():
-            with open(self._config_file, "w") as f:
-                json.dump({}, f)
-            self._config_file.chmod(0o600)
-
-    def _load(self):
-        try:
-            with open(self._config_file, "r") as f:
-                self._data = json.load(f)
-        except (json.JSONDecodeError, FileNotFoundError):
-            self._data = {}
-
-    def _save(self):
-        with open(self._config_file, "w") as f:
-            json.dump(self._data, f, indent=2)
-
-    @property
-    def api_token(self) -> Optional[str]:
-        # Env var takes precedence
-        return os.environ.get("DEVIN_API_TOKEN") or self._data.get("api_token")
-
-    @api_token.setter
-    def api_token(self, value: str):
-        self._data["api_token"] = value
-        self._save()
-
-    @property
-    def org_id(self) -> Optional[str]:
-        # Temporary override takes highest precedence (CLI flag)
-        # then env var, then config file
-        return getattr(self, "_temporary_org_id", None) or os.environ.get("DEVIN_ORG_ID") or self._data.get("org_id")
-
-    @org_id.setter
-    def org_id(self, value: str):
-        self._data["org_id"] = value
-        self._save()
-
-    @property
-    def temporary_org_id(self) -> Optional[str]:
-        return getattr(self, "_temporary_org_id", None)
-
-    @temporary_org_id.setter
-    def temporary_org_id(self, value: Optional[str]):
-        self._temporary_org_id = value
-
-    @property
-    def base_url(self) -> str:
-        return os.environ.get("DEVIN_BASE_URL") or self._data.get("base_url", "https://api.devin.ai/v3")
-
-    @base_url.setter
-    def base_url(self, value: str):
-        self._data["base_url"] = value
-        self._save()
-
-    @property
-    def current_session_id(self) -> Optional[str]:
-        return self._data.get("current_session_id")
-
-    @current_session_id.setter
-    def current_session_id(self, value: str):
-        self._data["current_session_id"] = value
-        self._save()
-
-config = Config()