deepagents-cli 0.0.48__tar.gz → 0.0.50__tar.gz

{deepagents_cli-0.0.48 → deepagents_cli-0.0.50}/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## [0.0.50](https://github.com/langchain-ai/deepagents/compare/deepagents-cli==0.0.49...deepagents-cli==0.0.50) (2026-05-04)
+
+### Bug Fixes
+
+* Show detached HEAD commit in local context ([#3144](https://github.com/langchain-ai/deepagents/issues/3144)) ([569d4f0](https://github.com/langchain-ai/deepagents/commit/569d4f0d7d699bace7820eb171a6bd605b2a1a18))
+
+## [0.0.49](https://github.com/langchain-ai/deepagents/compare/deepagents-cli==0.0.48...deepagents-cli==0.0.49) (2026-05-04)
+
+### Features
+
+* First-run onboarding flow ([#3102](https://github.com/langchain-ai/deepagents/issues/3102)) ([a71f852](https://github.com/langchain-ai/deepagents/commit/a71f852df3e491326b8eaa03ee7cb7b3b94fe73d))
+* In-TUI API key entry via `/auth` ([#3123](https://github.com/langchain-ai/deepagents/issues/3123)) ([eedbc3a](https://github.com/langchain-ai/deepagents/commit/eedbc3a8b5f88059636e497f72c7cec5a420f998))
+* Richer provider auth states, hosted Ollama auth ([#3111](https://github.com/langchain-ai/deepagents/issues/3111)) ([eeaeb76](https://github.com/langchain-ai/deepagents/commit/eeaeb7663515eb0cfa8f0389e7f8446e95e84911))
+* Set-as-default in `/agents` picker, harden persistence ([#3126](https://github.com/langchain-ai/deepagents/issues/3126)) ([4751e33](https://github.com/langchain-ai/deepagents/commit/4751e33fbad5945a740cae03bda758223201433b))
+
+### Bug Fixes
+
+* Gate async task tools by actual names ([#3094](https://github.com/langchain-ai/deepagents/issues/3094)) ([aae8dfe](https://github.com/langchain-ai/deepagents/commit/aae8dfebab184586322129ec162e083ebfd372cc))
+* Hide approval menu on selection ([#3097](https://github.com/langchain-ai/deepagents/issues/3097)) ([7dafd30](https://github.com/langchain-ai/deepagents/commit/7dafd3049ad7725353bbf12bf80f476b52916208))
+* Move internal state under hidden directory ([#3106](https://github.com/langchain-ai/deepagents/issues/3106)) ([ef4c717](https://github.com/langchain-ai/deepagents/commit/ef4c71763086a4e4899ba7ced6f9eb478d38069e))
+* Preserve recent agent across thread resume ([#3108](https://github.com/langchain-ai/deepagents/issues/3108)) ([442a0d4](https://github.com/langchain-ai/deepagents/commit/442a0d474aa1e767d542cb01f6e338431c18e5a8))
+
 ## [0.0.48](https://github.com/langchain-ai/deepagents/compare/deepagents-cli==0.0.47...deepagents-cli==0.0.48) (2026-05-01)
 
 ### Bug Fixes

{deepagents_cli-0.0.48 → deepagents_cli-0.0.50}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepagents-cli
-Version: 0.0.48
+Version: 0.0.50
 Summary: Terminal interface for Deep Agents - interactive AI agent with file operations, shell access, and sub-agent capabilities.
 Project-URL: Homepage, https://docs.langchain.com/oss/python/deepagents/overview
 Project-URL: Documentation, https://reference.langchain.com/python/deepagents/
@@ -36,6 +36,7 @@ Requires-Dist: langchain-openai<2.0.0,>=1.2.1
 Requires-Dist: langchain<2.0.0,>=1.2.15
 Requires-Dist: langgraph-checkpoint-sqlite<4.0.0,>=3.0.0
 Requires-Dist: langgraph-cli[inmem]<1.0.0,>=0.4.15
+Requires-Dist: langgraph-prebuilt<2.0.0,>=1.0.13
 Requires-Dist: langgraph-sdk<1.0.0,>=0.3.11
 Requires-Dist: langgraph<2.0.0,>=1.1.6
 Requires-Dist: langsmith[sandbox]>=0.7.32

deepagents_cli-0.0.50/deepagents_cli/_constants.py

@@ -0,0 +1,14 @@
+"""Lightweight shared constants for the CLI.
+
+This module is intentionally dependency-free (no third-party imports, no
+sibling-module imports) so any other module — including the startup-critical
+`main.py` and the heavy `agent.py` — can import from it without triggering a
+chain of expensive imports.
+"""
+
+from __future__ import annotations
+
+from typing import Final
+
+DEFAULT_AGENT_NAME: Final[str] = "agent"
+"""Default agent / assistant identifier when no `-a` flag is given."""

{deepagents_cli-0.0.48 → deepagents_cli-0.0.50}/deepagents_cli/_env_vars.py

@@ -48,6 +48,11 @@ center UI can be exercised without waiting for real conditions. Does not
 auto-open the update modal (use `DEEPAGENTS_CLI_DEBUG_UPDATE` for that). Any
 non-empty value enables the flag (including `"0"` or `"false"`)."""
 
+DEBUG_ONBOARDING = "DEEPAGENTS_CLI_DEBUG_ONBOARDING"
+"""Force the onboarding flow to open on every interactive startup.
+
+Parsed by `is_env_truthy`: accepts `1`, `true`, `yes`, `on` as enabled."""
+
 DEBUG_UPDATE = "DEEPAGENTS_CLI_DEBUG_UPDATE"
 """Inject a sample update-available notification and auto-open the update modal
 at launch so the update-available flow can be exercised without waiting for a

{deepagents_cli-0.0.48 → deepagents_cli-0.0.50}/deepagents_cli/_server_config.py

@@ -18,6 +18,7 @@ from dataclasses import dataclass
 from pathlib import Path
 from typing import TYPE_CHECKING, Any
 
+from deepagents_cli._constants import DEFAULT_AGENT_NAME as DEFAULT_ASSISTANT_ID
 from deepagents_cli._env_vars import SERVER_ENV_PREFIX
 
 if TYPE_CHECKING:
@@ -25,8 +26,6 @@ if TYPE_CHECKING:
 
 logger = logging.getLogger(__name__)
 
-_DEFAULT_ASSISTANT_ID = "agent"
-
 
 def _read_env_bool(suffix: str, *, default: bool = False) -> bool:
     """Read a `DEEPAGENTS_CLI_SERVER_*` boolean from the environment.
@@ -114,7 +113,7 @@ class ServerConfig:
 
     model: str | None = None
     model_params: dict[str, Any] | None = None
-    assistant_id: str = _DEFAULT_ASSISTANT_ID
+    assistant_id: str = DEFAULT_ASSISTANT_ID
     system_prompt: str | None = None
     auto_approve: bool = False
     interrupt_shell_only: bool = False
@@ -206,7 +205,7 @@ class ServerConfig:
         return cls(
             model=_read_env_str("MODEL"),
             model_params=_read_env_json("MODEL_PARAMS"),
-            assistant_id=_read_env_str("ASSISTANT_ID") or _DEFAULT_ASSISTANT_ID,
+            assistant_id=_read_env_str("ASSISTANT_ID") or DEFAULT_ASSISTANT_ID,
             system_prompt=_read_env_str("SYSTEM_PROMPT"),
             auto_approve=_read_env_bool("AUTO_APPROVE"),
             interrupt_shell_only=_read_env_bool("INTERRUPT_SHELL_ONLY"),

{deepagents_cli-0.0.48 → deepagents_cli-0.0.50}/deepagents_cli/_version.py

@@ -1,6 +1,6 @@
 """Version information and lightweight constants for `deepagents-cli`."""
 
-__version__ = "0.0.48"  # x-release-please-version
+__version__ = "0.0.50"  # x-release-please-version
 
 DOCS_URL = "https://docs.langchain.com/oss/python/deepagents/cli"
 """URL for `deepagents-cli` documentation."""

{deepagents_cli-0.0.48 → deepagents_cli-0.0.50}/deepagents_cli/agent.py

@@ -52,6 +52,7 @@ if TYPE_CHECKING:
 from langchain.agents.middleware.types import AgentMiddleware
 
 from deepagents_cli import theme
+from deepagents_cli._constants import DEFAULT_AGENT_NAME
 from deepagents_cli.config import (
     _ShellAllowAll,
     config,
@@ -80,9 +81,6 @@ from deepagents_cli.unicode_security import (
 
 logger = logging.getLogger(__name__)
 
-DEFAULT_AGENT_NAME = "agent"
-"""The default agent name used when no `-a` flag is provided."""
-
 REQUIRE_COMPACT_TOOL_APPROVAL: bool = True
 """When `True`, `compact_conversation` requires HITL approval like other gated tools."""
 
@@ -269,12 +267,28 @@ def load_async_subagents(config_path: Path | None = None) -> list[AsyncSubAgent]
     return agents
 
 
+def _is_agent_dir_entry(entry: Path) -> bool:
+    """Return whether a `~/.deepagents/` entry should be listed as an agent.
+
+    Filters out symlinks (so dangling links don't masquerade as agents)
+    and dot-prefixed names — `.state/` (CLI internal state) plus any
+    other hidden directory the user may have placed there.
+
+    `OSError` from `is_dir`/`is_symlink` propagates so callers can log
+    with the failing entry's name as context.
+    """
+    if entry.name.startswith("."):
+        return False
+    return entry.is_dir() and not entry.is_symlink()
+
+
 def get_available_agent_names() -> list[str]:
     """Return a sorted list of available agent names from `~/.deepagents/`.
 
     Scans the user's `.deepagents` directory and returns each real
     subdirectory found there. Symlinks excluded so a dangling link does not
-    masquerade as an agent.
+    masquerade as an agent. Dot-prefixed entries (e.g., `.state/`) are
+    skipped so CLI internal state never appears as an agent.
 
     Filesystem errors (missing parent, permission denied, broken entries) are
     logged and surfaced as an empty list rather than raised — the caller shows
@@ -296,7 +310,7 @@ def get_available_agent_names() -> list[str]:
     names: list[str] = []
     for entry in entries:
         try:
-            if entry.is_dir() and not entry.is_symlink():
+            if _is_agent_dir_entry(entry):
                 names.append(entry.name)
         except OSError:
             logger.debug(
@@ -315,8 +329,9 @@ def list_agents(*, output_format: OutputFormat = "text") -> None:
         output_format: Output format — `'text'` (Rich) or `'json'`.
     """
     agents_dir = settings.user_deepagents_dir
+    names = get_available_agent_names()
 
-    if not agents_dir.exists() or not any(agents_dir.iterdir()):
+    if not names:
         if output_format == "json":
             from deepagents_cli.output import write_json
 
@@ -334,17 +349,16 @@ def list_agents(*, output_format: OutputFormat = "text") -> None:
         from deepagents_cli.output import write_json
 
         agents = []
-        for agent_path in sorted(agents_dir.iterdir()):
-            if agent_path.is_dir():
-                agent_name = agent_path.name
-                agents.append(
-                    {
-                        "name": agent_name,
-                        "path": str(agent_path),
-                        "has_agents_md": (agent_path / "AGENTS.md").exists(),
-                        "is_default": agent_name == DEFAULT_AGENT_NAME,
-                    }
-                )
+        for name in names:
+            agent_path = agents_dir / name
+            agents.append(
+                {
+                    "name": name,
+                    "path": str(agent_path),
+                    "has_agents_md": (agent_path / "AGENTS.md").exists(),
+                    "is_default": name == DEFAULT_AGENT_NAME,
+                }
+            )
         write_json("list", agents)
         return
 
@@ -352,33 +366,28 @@ def list_agents(*, output_format: OutputFormat = "text") -> None:
 
     console.print("\n[bold]Available Agents:[/bold]\n", style=theme.PRIMARY)
 
-    for agent_path in sorted(agents_dir.iterdir()):
-        if agent_path.is_dir():
-            agent_name = escape_markup(agent_path.name)
-            agent_md = agent_path / "AGENTS.md"
-            is_default = agent_path.name == DEFAULT_AGENT_NAME
-            default_label = " [dim](default)[/dim]" if is_default else ""
-
-            bullet = get_glyphs().bullet
-            if agent_md.exists():
-                console.print(
-                    f"  {bullet} [bold]{agent_name}[/bold]{default_label}",
-                    style=theme.PRIMARY,
-                )
-                console.print(
-                    f"    {escape_markup(str(agent_path))}",
-                    style=theme.MUTED,
-                )
-            else:
-                console.print(
-                    f"  {bullet} [bold]{agent_name}[/bold]{default_label}"
-                    " [dim](incomplete)[/dim]",
-                    style=theme.WARNING,
-                )
-                console.print(
-                    f"    {escape_markup(str(agent_path))}",
-                    style=theme.MUTED,
-                )
+    bullet = get_glyphs().bullet
+    for name in names:
+        agent_path = agents_dir / name
+        agent_name = escape_markup(name)
+        is_default = name == DEFAULT_AGENT_NAME
+        default_label = " [dim](default)[/dim]" if is_default else ""
+
+        if (agent_path / "AGENTS.md").exists():
+            console.print(
+                f"  {bullet} [bold]{agent_name}[/bold]{default_label}",
+                style=theme.PRIMARY,
+            )
+        else:
+            console.print(
+                f"  {bullet} [bold]{agent_name}[/bold]{default_label}"
+                " [dim](incomplete)[/dim]",
+                style=theme.WARNING,
+            )
+        console.print(
+            f"    {escape_markup(str(agent_path))}",
+            style=theme.MUTED,
+        )
 
     console.print()
 
@@ -881,9 +890,9 @@ def _add_interrupt_on() -> dict[str, InterruptOnConfig]:
         "web_search": web_search_interrupt_config,
         "fetch_url": fetch_url_interrupt_config,
         "task": task_interrupt_config,
-        "launch_async_subagent": async_subagent_interrupt_config,
-        "update_async_subagent": async_subagent_interrupt_config,
-        "cancel_async_subagent": async_subagent_interrupt_config,
+        "start_async_task": async_subagent_interrupt_config,
+        "update_async_task": async_subagent_interrupt_config,
+        "cancel_async_task": async_subagent_interrupt_config,
     }
 
     if REQUIRE_COMPACT_TOOL_APPROVAL: