deepagents-cli 0.0.40__tar.gz → 0.0.41__tar.gz

{deepagents_cli-0.0.40 → deepagents_cli-0.0.41}/.gitignore

@@ -226,3 +226,4 @@ libs/cli/TEXTUAL_PROGRESS.md
 */tmp/.DS_Store
 
 CLAUDE.md
+.worktrees/

{deepagents_cli-0.0.40 → deepagents_cli-0.0.41}/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [0.0.41](https://github.com/langchain-ai/deepagents/compare/deepagents-cli==0.0.40...deepagents-cli==0.0.41) (2026-04-21)
+
+
+### Features
+
+* **cli:** `--startup-cmd` flag ([#2841](https://github.com/langchain-ai/deepagents/issues/2841)) ([8adcc2c](https://github.com/langchain-ai/deepagents/commit/8adcc2c2e612346c263d02d1ec5c33e0d63da5a3))
+* **cli:** actionable notifications, update modal ([#2855](https://github.com/langchain-ai/deepagents/issues/2855)) ([5fcd368](https://github.com/langchain-ai/deepagents/commit/5fcd368088079a84f151e0a3f5e4b9ac29c360c1))
+* **cli:** custom auth via `[auth]` ([#2734](https://github.com/langchain-ai/deepagents/issues/2734)) ([417ddaa](https://github.com/langchain-ai/deepagents/commit/417ddaab4804a54a8f83721bb8577d65cfa3659f))
+* **cli:** refresh footer git branch after shell commands ([#2851](https://github.com/langchain-ai/deepagents/issues/2851)) ([ee4fddd](https://github.com/langchain-ai/deepagents/commit/ee4fddde9454ee8f7ede98ee9a346da6c5ccd3d9))
+* **cli:** rework `/version`, add release-age and editable-install guard ([#2854](https://github.com/langchain-ai/deepagents/issues/2854)) ([1ae053f](https://github.com/langchain-ai/deepagents/commit/1ae053f347679e58562d2b81eb6d6e6e9bbf0b07))
+
+
+### Bug Fixes
+
+* **cli:** gate agent-swap resume hint on server checkpoint ([#2862](https://github.com/langchain-ai/deepagents/issues/2862)) ([f14b9cd](https://github.com/langchain-ai/deepagents/commit/f14b9cd3cc41f92ddb089d4294cba8496d517807))
+* **cli:** keep thinking spinner visible during text streaming ([#2849](https://github.com/langchain-ai/deepagents/issues/2849)) ([2cb2244](https://github.com/langchain-ai/deepagents/commit/2cb22446bc1351d20e8bbfa9f23b5d668947351f))
+* **cli:** re-show thinking spinner on hitl/`ask_user` resume ([#2847](https://github.com/langchain-ai/deepagents/issues/2847)) ([34a6167](https://github.com/langchain-ai/deepagents/commit/34a6167b0c275c7e4da067ef276a837f60da2f8a))
+* **cli:** restore ctrl+j newline keybinding ([#2827](https://github.com/langchain-ai/deepagents/issues/2827)) ([2e1a3f4](https://github.com/langchain-ai/deepagents/commit/2e1a3f45a9ff56390e294ea5b0f6a837200874ec))
+
 ## [0.0.40](https://github.com/langchain-ai/deepagents/compare/deepagents-cli==0.0.39...deepagents-cli==0.0.40) (2026-04-20)
 
 ### Features

{deepagents_cli-0.0.40 → deepagents_cli-0.0.41}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepagents-cli
-Version: 0.0.40
+Version: 0.0.41
 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/

{deepagents_cli-0.0.40 → deepagents_cli-0.0.41}/deepagents_cli/_env_vars.py

@@ -37,6 +37,18 @@ DEBUG = "DEEPAGENTS_CLI_DEBUG"
 DEBUG_FILE = "DEEPAGENTS_CLI_DEBUG_FILE"
 """Path for the debug log file (default: `/tmp/deepagents_debug.log`)."""
 
+DEBUG_NOTIFICATIONS = "DEEPAGENTS_CLI_DEBUG_NOTIFICATIONS"
+"""Inject sample missing-dependency notifications at launch so the notification
+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_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
+real PyPI release. Any non-empty value enables the flag (including `"0"` or
+`"false"`)."""
+
 EXTRA_SKILLS_DIRS = "DEEPAGENTS_CLI_EXTRA_SKILLS_DIRS"
 """Colon-separated paths added to the skill containment allowlist."""
 

deepagents_cli-0.0.41/deepagents_cli/_git.py

@@ -0,0 +1,236 @@
+"""Lightweight git metadata helpers for CLI state detection."""
+
+from __future__ import annotations
+
+import logging
+from pathlib import Path
+
+logger = logging.getLogger(__name__)
+
+_GIT_DIR_POINTER_PREFIX = "gitdir: "
+"""Prefix used by worktree-style `.git` files to point at the real git dir."""
+
+_GIT_HEAD_REF_PREFIX = "ref: "
+"""Prefix used by `HEAD` when it points at a named ref instead of a commit."""
+
+_GIT_REF_PREFIXES = ("refs/heads/", "refs/remotes/", "refs/tags/", "refs/")
+"""Known git ref prefixes stripped when formatting a branch-like display name."""
+
+_git_dir_cache: dict[str, Path] = {}
+"""Positive-only cache of resolved git metadata directories keyed by lookup path."""
+
+
+def _abbreviate_git_ref(ref: str) -> str:
+    """Convert a full git ref into a short display name.
+
+    Args:
+        ref: Full git ref name from repository metadata.
+
+    Returns:
+        The abbreviated ref name suitable for display.
+    """
+    for prefix in _GIT_REF_PREFIXES:
+        if ref.startswith(prefix):
+            return ref.removeprefix(prefix)
+    return ref
+
+
+def _parse_git_dir_pointer(git_entry: Path) -> Path | None:
+    """Resolve a `.git` file containing a `gitdir:` pointer.
+
+    Args:
+        git_entry: `.git` file to parse.
+
+    Returns:
+        The resolved git directory path, or `None` if the file is not a valid
+        gitdir pointer.
+    """
+    try:
+        raw = git_entry.read_text(encoding="utf-8").strip()
+    except OSError:
+        logger.debug("Failed to read gitdir pointer from %s", git_entry, exc_info=True)
+        return None
+
+    if not raw.startswith(_GIT_DIR_POINTER_PREFIX):
+        return None
+
+    pointer = raw.removeprefix(_GIT_DIR_POINTER_PREFIX).strip()
+    if not pointer:
+        return None
+
+    git_dir = Path(pointer)
+    if not git_dir.is_absolute():
+        git_dir = git_entry.parent / git_dir
+    return git_dir.resolve(strict=False)
+
+
+def _normalize_lookup_path(path: str | Path) -> Path:
+    """Normalize a lookup path for git metadata discovery.
+
+    Args:
+        path: Directory or file path inside a repository.
+
+    Returns:
+        A normalized absolute path when possible, or the expanded path if full
+        resolution fails.
+    """
+    try:
+        return Path(path).expanduser().resolve(strict=False)
+    except OSError:
+        return Path(path).expanduser()
+
+
+def _find_git_dir_uncached(path: Path) -> Path | None:
+    """Locate the effective git metadata directory without using caches.
+
+    Args:
+        path: Normalized directory or file path inside a repository.
+
+    Returns:
+        The git metadata directory for the repository containing `path`, or
+        `None` when no repository can be identified.
+    """
+    current = path
+    if not current.is_dir():
+        current = current.parent
+
+    for directory in (current, *current.parents):
+        git_entry = directory / ".git"
+        if git_entry.is_dir():
+            return git_entry
+        if git_entry.is_file():
+            git_dir = _parse_git_dir_pointer(git_entry)
+            if git_dir is not None and git_dir.is_dir():
+                return git_dir
+            return None
+
+    return None
+
+
+def find_git_dir(path: str | Path) -> Path | None:
+    """Locate the effective git metadata directory for a path.
+
+    Args:
+        path: Directory or file path inside a repository.
+
+    Returns:
+        The git metadata directory for the repository containing `path`, or
+        `None` when no repository can be identified.
+    """
+    current = _normalize_lookup_path(path)
+    key = str(current)
+    cached = _git_dir_cache.get(key)
+    if cached is not None:
+        return cached
+
+    git_dir = _find_git_dir_uncached(current)
+    if git_dir is not None:
+        _git_dir_cache[key] = git_dir
+    return git_dir
+
+
+def find_git_root(path: str | Path) -> Path | None:
+    """Locate the repository root for a path.
+
+    Args:
+        path: Directory or file path inside a repository.
+
+    Returns:
+        The repository root containing `path`, or `None` when no repository can
+        be identified.
+    """
+    current = _normalize_lookup_path(path)
+    if not current.is_dir():
+        current = current.parent
+
+    for directory in (current, *current.parents):
+        git_entry = directory / ".git"
+        if git_entry.is_dir():
+            return directory
+        if git_entry.is_file():
+            git_dir = _parse_git_dir_pointer(git_entry)
+            if git_dir is not None and git_dir.is_dir():
+                return directory
+            return None
+
+    return None
+
+
+def read_git_branch_from_filesystem(path: str | Path) -> str | None:
+    """Read the current git branch from repository metadata.
+
+    Args:
+        path: Directory or file path inside a repository.
+
+    Returns:
+        The abbreviated branch name, `HEAD` for detached HEAD, an empty string
+        when `path` is not inside a git repository, or `None` when metadata
+        exists but cannot be parsed confidently.
+    """
+    git_dir = find_git_dir(path)
+    if git_dir is None:
+        return ""
+
+    head_path = git_dir / "HEAD"
+    try:
+        head = head_path.read_text(encoding="utf-8").strip()
+    except FileNotFoundError:
+        logger.debug("Git HEAD file not found in %s", git_dir)
+        return None
+    except OSError:
+        logger.debug("Failed to read git HEAD from %s", git_dir, exc_info=True)
+        return None
+
+    if not head:
+        return ""
+    if head.startswith(_GIT_HEAD_REF_PREFIX):
+        ref = head.removeprefix(_GIT_HEAD_REF_PREFIX).strip()
+        return _abbreviate_git_ref(ref) if ref else None
+    return "HEAD"
+
+
+def read_git_branch_via_subprocess(path: str | Path) -> str:
+    """Fall back to `git rev-parse` for unusual repository layouts.
+
+    Args:
+        path: Directory or file path inside a repository.
+
+    Returns:
+        The branch name reported by git, or an empty string on failure.
+    """
+    import subprocess  # noqa: S404  # stdlib subprocess fallback
+
+    try:
+        result = subprocess.run(
+            ["git", "rev-parse", "--abbrev-ref", "HEAD"],  # noqa: S607
+            capture_output=True,
+            text=True,
+            timeout=2,
+            check=False,
+            cwd=path,
+        )
+        if result.returncode == 0:
+            return result.stdout.strip()
+    except FileNotFoundError:
+        pass  # git not installed
+    except subprocess.TimeoutExpired:
+        logger.debug("Git branch detection timed out")
+    except OSError:
+        logger.debug("Git branch detection failed", exc_info=True)
+    return ""
+
+
+def resolve_git_branch(path: str | Path) -> str:
+    """Resolve the current git branch with a filesystem-first strategy.
+
+    Args:
+        path: Directory or file path inside a repository.
+
+    Returns:
+        The current branch name, `HEAD` for detached HEAD, or an empty string
+        when no branch can be determined.
+    """
+    branch = read_git_branch_from_filesystem(path)
+    if branch is not None:
+        return branch
+    return read_git_branch_via_subprocess(path)

{deepagents_cli-0.0.40 → deepagents_cli-0.0.41}/deepagents_cli/_version.py

@@ -1,6 +1,6 @@
 """Version information and lightweight constants for `deepagents-cli`."""
 
-__version__ = "0.0.40"  # x-release-please-version
+__version__ = "0.0.41"  # x-release-please-version
 
 DOCS_URL = "https://docs.langchain.com/oss/python/deepagents/cli"
 """URL for `deepagents-cli` documentation."""
@@ -8,6 +8,13 @@ DOCS_URL = "https://docs.langchain.com/oss/python/deepagents/cli"
 PYPI_URL = "https://pypi.org/pypi/deepagents-cli/json"
 """PyPI JSON API endpoint for version checks."""
 
+SDK_PYPI_URL = "https://pypi.org/pypi/deepagents/json"
+"""PyPI JSON API endpoint for reading `deepagents` SDK release metadata.
+
+The CLI only reads release-age metadata from this endpoint; it never
+performs SDK update checks.
+"""
+
 CHANGELOG_URL = (
     "https://github.com/langchain-ai/deepagents/blob/main/libs/cli/CHANGELOG.md"
 )