devin-cli 1.1.8__tar.gz → 1.2.0__tar.gz

{devin_cli-1.1.8 → devin_cli-1.2.0}/CHANGELOG.md

@@ -5,6 +5,21 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.0] - 2026-03-11
+### Added
+- `sessions create` / `create-session` now exposes all 8 previously missing v3 API parameters: `--playbook-id`, `--tag`, `--repo`, `--knowledge-id`, `--secret-id`, `--session-link`, `--attachment-url`, `--create-as-user-id`.
+- Profile feedback on session create: prints which profile and API version is being used.
+- Explicit warning when v3-only flags (`--advanced-mode`, `--playbook-id`, `--repo`, `--secret-id`, `--session-link`, `--attachment-url`, `--create-as-user-id`) are passed on a v1 profile — instead of silently ignored.
+### Fixed
+- Removed `**kwargs` anti-pattern from `v1/sessions.create_session`. Typos in keyword args now raise `TypeError` instead of silently vanishing.
+- v3-only params added as explicit no-ops in v1 `create_session` so the shared CLI call site works without `TypeError`.
+
+## [1.1.9] - 2026-03-11
+### Fixed
+- `devin watch` terminal status message was printed inside a `Live` context, causing output corruption. Now printed after the `Live` block exits.
+- `update-playbook` was sending an empty string title when `--title` was not passed, overwriting the existing playbook title. Now only sends fields that are explicitly provided.
+- `chain` used bare `resp["session_id"]` key access which would raise `KeyError` on unexpected API responses. Now uses `.get()` with an explicit error guard.
+
 ## [1.1.8] - 2026-03-11
 ### Added
 - Restored all 0.1.x flat commands: `watch`, `status`, `open`, `message`, `terminate`, `list-sessions`, `create-session`, `upload`, `list-knowledge`, `attach`, `update-tags`, `history`, `messages`, `get-session`, `update-knowledge`, `update-playbook`, `delete-playbook`, `list-secrets`, `delete-secret`, `chain`.

{devin_cli-1.1.8 → devin_cli-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devin-cli
-Version: 1.1.8
+Version: 1.2.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

{devin_cli-1.1.8 → devin_cli-1.2.0}/pyproject.toml

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

{devin_cli-1.1.8 → devin_cli-1.2.0}/src/devin_cli/api/v1/sessions.py

@@ -1,7 +1,7 @@
 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):
+def list_sessions(limit: int = 100, offset: int = 0, tags: Optional[List[str]] = None):
     params = {"limit": limit, "offset": offset}
     if tags:
         params["tags"] = tags
@@ -10,21 +10,25 @@ def list_sessions(limit: int = 100, offset: int = 0, tags: List[str] = None):
 def create_session(
     prompt: str,
     idempotent: bool = False,
-    snapshot_id: str = None,
-    playbook_id: str = None,
+    snapshot_id: Optional[str] = None,
+    playbook_id: Optional[str] = None,
     unlisted: bool = False,
-    tags: List[str] = None,
-    session_secrets: List[dict] = None,
+    tags: Optional[List[str]] = None,
+    session_secrets: Optional[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
+    advanced_mode: Optional[str] = None,
+    repos: Optional[List[str]] = None,
+    session_links: Optional[List[str]] = None,
+    attachment_urls: Optional[List[str]] = None,
+    create_as_user_id: Optional[str] = None,
 ):
     data = {
         "prompt": prompt,
         "idempotent": idempotent,
-        "unlisted": unlisted
+        "unlisted": unlisted,
     }
     if snapshot_id:
         data["snapshot_id"] = snapshot_id
@@ -42,7 +46,7 @@ def create_session(
         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):

{devin_cli-1.1.8 → devin_cli-1.2.0}/src/devin_cli/cli.py

@@ -155,13 +155,38 @@ 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"),
+    advanced_mode: Optional[str] = typer.Option(None, "--advanced-mode", help="Advanced mode type: 'cli' or 'browser' (v3 only)"),
+    playbook_id: Optional[str] = typer.Option(None, "--playbook-id", help="Playbook ID to apply (v3 only)"),
+    tags: Optional[List[str]] = typer.Option(None, "--tag", help="Session tags (repeatable)"),
+    repos: Optional[List[str]] = typer.Option(None, "--repo", help="Repository URLs to attach (v3 only, repeatable)"),
+    knowledge_ids: Optional[List[str]] = typer.Option(None, "--knowledge-id", help="Knowledge IDs to attach (repeatable)"),
+    secret_ids: Optional[List[str]] = typer.Option(None, "--secret-id", help="Secret IDs to inject (v3 only, repeatable)"),
+    session_links: Optional[List[str]] = typer.Option(None, "--session-link", help="Session URLs to link as context (v3 only, repeatable)"),
+    attachment_urls: Optional[List[str]] = typer.Option(None, "--attachment-url", help="Attachment URLs to attach (v3 only, repeatable)"),
+    create_as_user_id: Optional[str] = typer.Option(None, "--create-as-user-id", help="Enterprise: create session on behalf of this user ID (v3 only)"),
     force: bool = typer.Option(False, "--force", help="Force creation even if duplicate prompt is detected"),
     wait: bool = typer.Option(False, "--wait", "-w", help="Block until the session reaches a terminal status"),
     interval: int = typer.Option(5, "--interval", help="Polling interval in seconds when --wait is used"),
 ):
     """Create a new Devin session."""
     if org: config.temporary_org_id = org
+
+    api_ver = config.api_version
+    console.print(f"[dim]Using profile: {config.active_profile or 'default'} ({api_ver})[/dim]")
+
+    v3_only_used = [x for x, v in [
+        ("--advanced-mode", advanced_mode),
+        ("--playbook-id", playbook_id),
+        ("--repos", repos),
+        ("--secret-ids", secret_ids),
+        ("--session-links", session_links),
+        ("--attachment-urls", attachment_urls),
+        ("--create-as-user-id", create_as_user_id),
+    ] if v]
+    if api_ver == "v1" and v3_only_used:
+        console.print(f"[bold yellow]Warning:[/bold yellow] The following flags are v3-only and will be ignored on a v1 profile: {', '.join(v3_only_used)}")
+        console.print("  Run [bold cyan]devin configure[/bold cyan] to switch to a v3 profile.")
+
     if file:
         prompt_text = file.read_text()
     elif prompt:
@@ -169,10 +194,10 @@ 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]")
@@ -182,13 +207,21 @@ def create_session_cmd(
 
     with console.status("[bold green]Creating session...[/bold green]"):
         resp = sessions.create_session(
-            prompt=prompt_text, 
-            title=title, 
+            prompt=prompt_text,
+            title=title,
             max_acu_limit=max_acu,
-            advanced_mode=advanced_mode
+            advanced_mode=advanced_mode,
+            playbook_id=playbook_id,
+            tags=tags or None,
+            repos=repos or None,
+            knowledge_ids=knowledge_ids or None,
+            secret_ids=secret_ids or None,
+            session_links=session_links or None,
+            attachment_urls=attachment_urls or None,
+            create_as_user_id=create_as_user_id,
         )
         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]")
@@ -197,7 +230,7 @@ def create_session_cmd(
             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)
@@ -219,6 +252,7 @@ def create_session_cmd(
         else:
             console.print("[yellow]Session created, but no ID returned immediately (awaiting advanced mode setup).[/yellow]")
 
+
 @session_app.command("list")
 @handle_api_error
 def list_sessions_cmd(
@@ -299,14 +333,25 @@ def session_cost_cmd(
 @session_app.command("message")
 @handle_api_error
 def send_message_cmd(
-    text: str = typer.Argument(...),
+    text: Optional[str] = typer.Argument(None, help="Message text"),
+    file: Optional[Path] = typer.Option(None, "--file", "-f", help="Read message from file"),
     session_id: Optional[str] = typer.Option(None, "--id"),
     org: Optional[str] = typer.Option(None, "--org"),
 ):
     """Send a message to a session."""
     if org: config.temporary_org_id = org
     sid = session_id or get_current_session_id()
-    sessions.send_message(sid, text)
+    if file:
+        if not file.exists():
+            console.print(f"[bold red]Error:[/bold red] File not found: {file}")
+            raise typer.Exit(1)
+        msg_text = file.read_text()
+    elif text:
+        msg_text = text
+    else:
+        console.print("[bold red]Error:[/bold red] Provide message text or --file")
+        raise typer.Exit(1)
+    sessions.send_message(sid, msg_text)
     console.print(f"[green]Message sent to {sid}[/green]")
 
 @session_app.command("messages")
@@ -708,13 +753,15 @@ def watch_session_cmd(
 
                 if resp.get("status_enum", "").lower() in terminal_statuses:
                     live.update(build_status_panel(resp))
-                    console.print(f"[bold green]Session {resp.get('status_enum')}![/bold green]")
                     break
 
                 time.sleep(min(backoff, 30))
                 backoff = min(backoff * 1.5, 30)
         except KeyboardInterrupt:
             console.print("\n[dim]Watch stopped.[/dim]")
+            return
+
+    console.print(f"[bold green]Session {resp.get('status_enum')}![/bold green]")
 
 # --- Flat top-level aliases (backward compat with 0.1.x command structure) ---
 
@@ -730,12 +777,23 @@ def watch_cmd(
 @app.command("message")
 @handle_api_error
 def message_cmd(
-    text: str = typer.Argument(..., help="Message to send"),
+    text: Optional[str] = typer.Argument(None, help="Message to send"),
+    file: Optional[Path] = typer.Option(None, "--file", "-f", help="Read message from file"),
     session_id: Optional[str] = typer.Option(None, "--id"),
 ):
     """Send a message to the active session."""
     sid = session_id or get_current_session_id()
-    sessions.send_message(sid, text)
+    if file:
+        if not file.exists():
+            console.print(f"[bold red]Error:[/bold red] File not found: {file}")
+            raise typer.Exit(1)
+        msg_text = file.read_text()
+    elif text:
+        msg_text = text
+    else:
+        console.print("[bold red]Error:[/bold red] Provide message text or --file")
+        raise typer.Exit(1)
+    sessions.send_message(sid, msg_text)
     console.print(f"[green]Message sent to {sid}[/green]")
 
 @app.command("terminate")
@@ -895,6 +953,16 @@ def update_playbook_top_cmd(
     macro: Optional[str] = typer.Option(None, "--macro"),
 ):
     """Update an existing playbook."""
+    data: dict = {}
+    if title is not None:
+        data["title"] = title
+    if body is not None:
+        data["body"] = body
+    if macro is not None:
+        data["macro"] = macro
+    if not data:
+        console.print("[yellow]Nothing to update. Pass --title, --body, or --macro.[/yellow]")
+        return
     playbooks.update_playbook(playbook_id, title=title or "", body=body, macro=macro)
     console.print(f"[green]Playbook {playbook_id} updated.[/green]")
 
@@ -971,9 +1039,12 @@ def chain_cmd(
         console.print(f"[bold cyan]Step {i+1}/{len(steps)}:[/bold cyan] Playbook={step_pb}")
 
         if i == 0:
-            with console.status(f"Starting session..."):
+            with console.status("Starting session..."):
                 resp = sessions.create_session(prompt=step_prompt, playbook_id=step_pb)
-                current_sid = resp["session_id"]
+                current_sid = resp.get("session_id")
+                if not current_sid:
+                    console.print("[bold red]Error:[/bold red] No session ID returned from API.")
+                    raise typer.Exit(1)
                 config.current_session_id = current_sid
                 console.print(f"[green]Session started:[/green] {current_sid}")
         else: