devin-cli 1.1.9__tar.gz → 1.2.1__tar.gz

{devin_cli-1.1.9 → devin_cli-1.2.1}/CHANGELOG.md

@@ -5,6 +5,15 @@ 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.

{devin_cli-1.1.9 → devin_cli-1.2.1}/PKG-INFO

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

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

{devin_cli-1.1.9 → devin_cli-1.2.1}/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,26 @@ 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,
+    child_playbook_id: Optional[str] = None,
 ):
     data = {
         "prompt": prompt,
         "idempotent": idempotent,
-        "unlisted": unlisted
+        "unlisted": unlisted,
     }
     if snapshot_id:
         data["snapshot_id"] = snapshot_id
@@ -42,7 +47,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.9 → devin_cli-1.2.1}/src/devin_cli/api/v3/sessions.py

@@ -15,6 +15,7 @@ def create_session(
     knowledge_ids: Optional[List[str]] = None,
     max_acu_limit: Optional[int] = None,
     playbook_id: Optional[str] = None,
+    child_playbook_id: Optional[str] = None,
     repos: Optional[List[str]] = None,
     secret_ids: Optional[List[str]] = None,
     session_links: Optional[List[str]] = None,
@@ -37,6 +38,8 @@ def create_session(
         data["max_acu_limit"] = max_acu_limit
     if playbook_id:
         data["playbook_id"] = playbook_id
+    if child_playbook_id:
+        data["child_playbook_id"] = child_playbook_id
     if repos:
         data["repos"] = repos
     if secret_ids:

{devin_cli-1.1.9 → devin_cli-1.2.1}/src/devin_cli/cli.py

@@ -155,13 +155,39 @@ 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: analyze | create_playbook | improve_playbook | batch | manage_knowledge"),
+    playbook_id: Optional[str] = typer.Option(None, "--playbook-id", help="Playbook ID to apply (v3 only)"),
+    child_playbook_id: Optional[str] = typer.Option(None, "--child-playbook-id", help="Playbook ID applied to each sub-session in batch mode (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 +195,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 +208,22 @@ 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,
+            child_playbook_id=child_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 +232,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 +254,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(