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

{deepagents_cli-0.0.40 → deepagents_cli-0.0.42}/.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.42}/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## [0.0.42](https://github.com/langchain-ai/deepagents/compare/deepagents-cli==0.0.41...deepagents-cli==0.0.42) (2026-04-29)
+
+### Features
+
+* `shift+enter` newline on kitty-capable terminals ([#2869](https://github.com/langchain-ai/deepagents/issues/2869)) ([34e6614](https://github.com/langchain-ai/deepagents/commit/34e6614a2c6e6a7e33f763ac5b527c13b324a690))
+* Hint `Enter` behavior in `/model` empty state ([#2933](https://github.com/langchain-ai/deepagents/issues/2933)) ([7cffa16](https://github.com/langchain-ai/deepagents/commit/7cffa16a072bc77def78e4cda09c2e5a2cf8ca39))
+
+### Bug Fixes
+
+* Queue `/model` switches during server startup ([#2895](https://github.com/langchain-ai/deepagents/issues/2895)) ([6ed7b65](https://github.com/langchain-ai/deepagents/commit/6ed7b65a40ac5bd926e94edd944bd552e8d6b5b4))
+
+## [0.0.41](https://github.com/langchain-ai/deepagents/compare/deepagents-cli==0.0.40...deepagents-cli==0.0.41) (2026-04-21)
+
+### Features
+
+* `--startup-cmd` flag ([#2841](https://github.com/langchain-ai/deepagents/issues/2841)) ([8adcc2c](https://github.com/langchain-ai/deepagents/commit/8adcc2c2e612346c263d02d1ec5c33e0d63da5a3))
+* Actionable notifications, update modal ([#2855](https://github.com/langchain-ai/deepagents/issues/2855)) ([5fcd368](https://github.com/langchain-ai/deepagents/commit/5fcd368088079a84f151e0a3f5e4b9ac29c360c1))
+* Custom auth via `[auth]` in `deepagents deploy` ([#2734](https://github.com/langchain-ai/deepagents/issues/2734)) ([417ddaa](https://github.com/langchain-ai/deepagents/commit/417ddaab4804a54a8f83721bb8577d65cfa3659f))
+* 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))
+* 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
+
+* 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))
+* 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))
+* 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))
+* 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.42}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepagents-cli
-Version: 0.0.40
+Version: 0.0.42
 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/
@@ -27,9 +27,9 @@ Classifier: Topic :: Terminals
 Requires-Python: <4.0,>=3.11
 Requires-Dist: aiosqlite<1.0.0,>=0.19.0
 Requires-Dist: deepagents-acp>=0.0.4
-Requires-Dist: deepagents==0.5.3
+Requires-Dist: deepagents==0.5.4
 Requires-Dist: httpx<1.0.0,>=0.28.1
-Requires-Dist: langchain-anthropic<2.0.0,>=1.4.0
+Requires-Dist: langchain-anthropic<2.0.0,>=1.4.2
 Requires-Dist: langchain-google-genai<5.0.0,>=4.2.1
 Requires-Dist: langchain-mcp-adapters<1.0.0,>=0.2.0
 Requires-Dist: langchain-openai<2.0.0,>=1.1.12
@@ -57,7 +57,7 @@ Requires-Dist: uuid-utils<1.0.0,>=0.10.0
 Provides-Extra: agentcore
 Requires-Dist: langchain-agentcore-codeinterpreter>=0.0.1; extra == 'agentcore'
 Provides-Extra: all-providers
-Requires-Dist: langchain-anthropic<2.0.0,>=1.4.0; extra == 'all-providers'
+Requires-Dist: langchain-anthropic<2.0.0,>=1.4.2; extra == 'all-providers'
 Requires-Dist: langchain-aws<2.0.0,>=1.0.0; extra == 'all-providers'
 Requires-Dist: langchain-baseten<1.0.0,>=0.1.9; extra == 'all-providers'
 Requires-Dist: langchain-cohere<1.0.0,>=0.5.0; extra == 'all-providers'
@@ -82,7 +82,7 @@ Requires-Dist: langchain-daytona>=0.0.4; extra == 'all-sandboxes'
 Requires-Dist: langchain-modal>=0.0.2; extra == 'all-sandboxes'
 Requires-Dist: langchain-runloop>=0.0.3; extra == 'all-sandboxes'
 Provides-Extra: anthropic
-Requires-Dist: langchain-anthropic<2.0.0,>=1.4.0; extra == 'anthropic'
+Requires-Dist: langchain-anthropic<2.0.0,>=1.4.2; extra == 'anthropic'
 Provides-Extra: baseten
 Requires-Dist: langchain-baseten<1.0.0,>=0.1.9; extra == 'baseten'
 Provides-Extra: bedrock

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

@@ -37,9 +37,24 @@ 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."""
 
+KITTY_KEYBOARD = "DEEPAGENTS_CLI_KITTY_KEYBOARD"
+"""Override kitty-keyboard detection (`1` forces on, `0` forces off)."""
+
 LANGSMITH_PROJECT = "DEEPAGENTS_CLI_LANGSMITH_PROJECT"
 """Override LangSmith project name for agent traces."""
 

deepagents_cli-0.0.42/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.42/deepagents_cli/_textual_patches.py

@@ -0,0 +1,66 @@
+r"""Preserve the `alt` modifier on legacy `ESC + <byte>` sequences.
+
+Upstream `XTermParser._sequence_to_key_events` drops the `alt` flag on
+the tuple-branch fast path, so VSCode's `sendSequence` shift+enter
+binding (which writes `\x1b\r` to the PTY) arrives as bare `enter`
+instead of `alt+enter`. Tracked in Textualize/textual#6378. Remove this
+file and the Textual pin comment in `pyproject.toml` when that lands.
+
+Imported for side effect from `app.py` before any `App()` is created.
+"""
+
+from __future__ import annotations
+
+import logging
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from collections.abc import Iterable
+
+logger = logging.getLogger(__name__)
+
+_ESC_PREFIX_LEN = 2
+
+try:
+    from textual import events
+    from textual._ansi_sequences import (
+        ANSI_SEQUENCES_KEYS,  # noqa: PLC2701
+        IGNORE_SEQUENCE,  # noqa: PLC2701
+    )
+    from textual._xterm_parser import XTermParser  # noqa: PLC2701
+
+    _original = XTermParser._sequence_to_key_events
+except (ImportError, AttributeError) as exc:  # pragma: no cover - defensive
+    logger.warning("Textual keyboard parser patch skipped: %s", exc)
+else:
+
+    def _emit_alt(keys: tuple, character: str | None) -> Iterable[events.Key]:
+        for key in keys:
+            yield events.Key(f"alt+{key.value}", character)
+
+    def _sequence_to_key_events_with_alt(
+        self: XTermParser, sequence: str, alt: bool = False
+    ) -> Iterable[events.Key]:
+        # Fast path: \x1b<byte> on first pass. Short-circuits the ~100 ms
+        # escape-delay wait when both bytes arrive together. Semantic side
+        # effect: \x1b\x1b dispatches as `alt+escape` with no delay, matching
+        # crossterm and Node TTY.
+        if not alt and len(sequence) == _ESC_PREFIX_LEN and sequence[0] == "\x1b":
+            inner = ANSI_SEQUENCES_KEYS.get(sequence[1])
+            if inner is not IGNORE_SEQUENCE and isinstance(inner, tuple):
+                yield from _emit_alt(inner, None)
+                return
+        # Correctness fix (Textualize/textual#6378): preserve `alt` on the
+        # reissue path for single-byte tuple mappings.
+        if alt:
+            keys = ANSI_SEQUENCES_KEYS.get(sequence)
+            if keys is not IGNORE_SEQUENCE and isinstance(keys, tuple):
+                character = sequence if len(sequence) == 1 else None
+                yield from _emit_alt(keys, character)
+                return
+        yield from _original(self, sequence, alt=alt)
+
+    try:
+        XTermParser._sequence_to_key_events = _sequence_to_key_events_with_alt  # ty: ignore[invalid-assignment]
+    except (AttributeError, TypeError) as exc:  # pragma: no cover - defensive
+        logger.warning("Textual keyboard parser patch assignment rejected: %s", exc)

{deepagents_cli-0.0.40 → deepagents_cli-0.0.42}/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.42"  # 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"
 )

{deepagents_cli-0.0.40 → deepagents_cli-0.0.42}/deepagents_cli/agent.py

@@ -16,6 +16,18 @@ from deepagents.backends import CompositeBackend, LocalShellBackend
 from deepagents.backends.filesystem import FilesystemBackend
 from deepagents.middleware import MemoryMiddleware, SkillsMiddleware
 
+# Backwards-compat flag: SDKs before 0.5.4 accept only `list[str]` for
+# `SkillsMiddleware.sources`; newer SDKs expose the `SkillSource` alias
+# that permits `(path, label)` tuples. The `skills` module is already
+# loaded by the `SkillsMiddleware` import above, so the extra lookup
+# here adds no startup cost.
+try:
+    from deepagents.middleware.skills import SkillSource as _SkillSource  # noqa: F401
+except ImportError:
+    _SUPPORTS_SKILL_SOURCE_TUPLES = False
+else:
+    _SUPPORTS_SKILL_SOURCE_TUPLES = True
+
 if TYPE_CHECKING:
     from collections.abc import Awaitable, Callable, Sequence
 
@@ -1116,25 +1128,40 @@ def create_cli_agent(
         # built-in -> user .deepagents -> user .agents
         # -> project .deepagents -> project .agents
         # -> user .claude (experimental) -> project .claude (experimental)
-        sources = [str(settings.get_built_in_skills_dir())]
-        sources.extend([str(skills_dir), str(user_agent_skills_dir)])
+        # Labels disambiguate user- vs project-scoped sources that share a
+        # `.../skills` leaf; the middleware would otherwise derive identical
+        # labels from the parent directory name.
+        sources: list[tuple[str, str]] = [
+            (str(settings.get_built_in_skills_dir()), "Built-in"),
+            (str(skills_dir), "User Deepagents"),
+            (str(user_agent_skills_dir), "User Agents"),
+        ]
         if project_skills_dir:
-            sources.append(str(project_skills_dir))
+            sources.append((str(project_skills_dir), "Project Deepagents"))
         if project_agent_skills_dir:
-            sources.append(str(project_agent_skills_dir))
+            sources.append((str(project_agent_skills_dir), "Project Agents"))
 
         # Experimental: Claude Code skill directories
         user_claude_skills_dir = settings.get_user_claude_skills_dir()
         if user_claude_skills_dir.exists():
-            sources.append(str(user_claude_skills_dir))
+            sources.append((str(user_claude_skills_dir), "User Claude"))
         project_claude_skills_dir = settings.get_project_claude_skills_dir()
         if project_claude_skills_dir:
-            sources.append(str(project_claude_skills_dir))
+            sources.append((str(project_claude_skills_dir), "Project Claude"))
+
+        # Backwards-compat: strip labels when the installed SDK is too old
+        # to accept `(path, label)` tuples. Label-based disambiguation
+        # regresses to the pre-alias behavior (user- and project-scoped
+        # `.claude/skills` collapse to the same label), but functionality
+        # is preserved.
+        middleware_sources: Sequence[str | tuple[str, str]] = (
+            sources if _SUPPORTS_SKILL_SOURCE_TUPLES else [path for path, _ in sources]
+        )
 
         agent_middleware.append(
             SkillsMiddleware(
                 backend=FilesystemBackend(),
-                sources=sources,
+                sources=middleware_sources,
             )
         )