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

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

@@ -1,23 +1,32 @@
 # Changelog
 
-## [0.0.41](https://github.com/langchain-ai/deepagents/compare/deepagents-cli==0.0.40...deepagents-cli==0.0.41) (2026-04-21)
-
+## [0.0.42](https://github.com/langchain-ai/deepagents/compare/deepagents-cli==0.0.41...deepagents-cli==0.0.42) (2026-04-29)
 
 ### 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))
+* `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
 
-* **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))
+* 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)
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepagents-cli
-Version: 0.0.41
+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.41 → deepagents_cli-0.0.42}/deepagents_cli/_env_vars.py

@@ -52,6 +52,9 @@ real PyPI release. Any non-empty value enables the flag (including `"0"` or
 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/_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.41 → deepagents_cli-0.0.42}/deepagents_cli/_version.py

@@ -1,6 +1,6 @@
 """Version information and lightweight constants for `deepagents-cli`."""
 
-__version__ = "0.0.41"  # 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."""

{deepagents_cli-0.0.41 → 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,
             )
         )
 

{deepagents_cli-0.0.41 → deepagents_cli-0.0.42}/deepagents_cli/app.py

@@ -33,7 +33,11 @@ from textual.widgets._toast import (
     Toast as _Toast,  # noqa: PLC2701  # for Toast click routing
 )
 
-from deepagents_cli import theme
+# Applied as an import-time side effect; must come before any App is created.
+from deepagents_cli import (
+    _textual_patches,  # noqa: F401
+    theme,
+)
 from deepagents_cli._cli_context import CLIContext
 from deepagents_cli._git import (
     read_git_branch_from_filesystem,
@@ -6370,6 +6374,24 @@ class DeepAgentsApp(App):
             model_spec = model_spec.removeprefix(":")
 
             if not self._remote_agent():
+                if self._connecting:
+                    from functools import partial
+
+                    self._defer_action(
+                        DeferredAction(
+                            kind="model_switch",
+                            execute=partial(
+                                self._switch_model,
+                                model_spec,
+                                extra_kwargs=extra_kwargs,
+                            ),
+                        )
+                    )
+                    self.notify(
+                        "Model will switch once the session is ready.",
+                        timeout=3,
+                    )
+                    return
                 await self._mount_message(
                     ErrorMessage("Model switching requires a server-backed session.")
                 )

{deepagents_cli-0.0.41 → deepagents_cli-0.0.42}/deepagents_cli/config.py

@@ -496,14 +496,22 @@ def is_ascii_mode() -> bool:
 
 
 def newline_shortcut() -> str:
-    """Return the platform-native label for the newline keyboard shortcut.
+    """Return the terminal-appropriate label for the newline keyboard shortcut.
 
-    macOS labels the modifier "Option" while other platforms use Ctrl+J
-    as the most reliable cross-terminal shortcut.
+    Prefers `Shift+Enter` when the terminal is known to support the kitty
+    keyboard protocol, either via conservative terminal-identity heuristics
+    or the `DEEPAGENTS_CLI_KITTY_KEYBOARD` override. Falls back to
+    `Option+Enter` on macOS and `Ctrl+J` elsewhere — both survive legacy
+    terminals that strip the shift modifier from `Enter`.
 
     Returns:
-        A human-readable shortcut string, e.g. `'Option+Enter'` or `'Ctrl+J'`.
+        A human-readable shortcut string,
+            e.g. `'Shift+Enter'`, `'Option+Enter'`, or `'Ctrl+J'`.
     """
+    from deepagents_cli.terminal_capabilities import supports_kitty_keyboard_protocol
+
+    if supports_kitty_keyboard_protocol():
+        return "Shift+Enter"
     return "Option+Enter" if sys.platform == "darwin" else "Ctrl+J"
 
 
@@ -1854,36 +1862,52 @@ _OPENROUTER_APP_TITLE = "Deep Agents CLI"
 _OPENROUTER_APP_CATEGORIES: list[str] = ["cli-agent"]
 """Default `app_categories` (maps to `X-OpenRouter-Categories`) for OpenRouter."""
 
+_cli_openrouter_profile_registered = False
+"""Process-wide guard so the CLI OpenRouter profile is registered exactly once."""
 
-def _apply_openrouter_defaults(kwargs: dict[str, Any]) -> None:
-    """Inject default OpenRouter attribution kwargs.
 
-    Sets `app_url`, `app_title`, and `app_categories` via `setdefault` so
-    that user-supplied values in config take precedence. These map to the
-    `HTTP-Referer`, `X-Title`, and `X-OpenRouter-Categories` headers that
-    `ChatOpenRouter` sends for app attribution
-    (see https://openrouter.ai/docs/app-attribution).
+def _cli_openrouter_attribution_kwargs() -> dict[str, Any]:
+    """CLI-specific OpenRouter attribution kwargs.
 
-    Users can override either value provider-wide or per-model in
-    `~/.deepagents/config.toml`:
+    Layered on top of the SDK's built-in factory via profile stacking; these
+    values override the SDK defaults but still sit beneath any caller-supplied
+    `kwargs` (i.e. `config.toml`-resolved values), preserving the precedence
+    documented on `apply_provider_profile`.
 
-    ```toml
-    # Provider-wide
-    [models.providers.openrouter.params]
-    app_url = "https://myapp.com"
-    app_title = "My App"
+    Returns:
+        Mapping of `app_url` and `app_title` to spread into `init_chat_model`.
+    """
+    return {
+        "app_url": _OPENROUTER_APP_URL,
+        "app_title": _OPENROUTER_APP_TITLE,
+    }
 
-    # Per-model (shallow-merges on top of provider-wide)
-    [models.providers.openrouter.params."openai/gpt-oss-120b"]
-    app_title = "My App (GPT)"
-    ```
 
-    Args:
-        kwargs: Mutable kwargs dict to update in place.
+def _ensure_cli_openrouter_profile_registered() -> None:
+    """Stack the CLI OpenRouter attribution onto the SDK's built-in profile.
+
+    Stacking (vs. duplicating the inline `_get_provider_kwargs` path) means the
+    SDK's `pre_init` version check fires exactly once and the CLI's app-
+    attribution defaults are composed via the same `apply_provider_profile`
+    path used for every other provider. `register_provider_profile` merges on
+    top of the existing built-in registration: the CLI's `init_kwargs` and
+    factory output win on shared keys, while the built-in's `pre_init` and
+    factory still chain.
     """
-    kwargs.setdefault("app_url", _OPENROUTER_APP_URL)
-    kwargs.setdefault("app_title", _OPENROUTER_APP_TITLE)
-    kwargs.setdefault("app_categories", _OPENROUTER_APP_CATEGORIES)
+    global _cli_openrouter_profile_registered  # noqa: PLW0603
+    if _cli_openrouter_profile_registered:
+        return
+
+    from deepagents.profiles.provider import ProviderProfile, register_provider_profile
+
+    register_provider_profile(
+        "openrouter",
+        ProviderProfile(
+            init_kwargs={"app_categories": _OPENROUTER_APP_CATEGORIES},
+            init_kwargs_factory=_cli_openrouter_attribution_kwargs,
+        ),
+    )
+    _cli_openrouter_profile_registered = True
 
 
 def _get_provider_kwargs(
@@ -1927,14 +1951,6 @@ def _get_provider_kwargs(
         if api_key:
             result["api_key"] = api_key
 
-    if provider == "openrouter":
-        from deepagents.profiles._openrouter import (
-            check_openrouter_version,  # noqa: PLC2701
-        )
-
-        check_openrouter_version()
-        _apply_openrouter_defaults(result)
-
     return result
 
 
@@ -2242,6 +2258,37 @@ def create_model(
     # Provider-specific kwargs (with per-model overrides)
     kwargs = _get_provider_kwargs(provider, model_name=model_name)
 
+    # Compose under existing kwargs: profile < config.toml < --model-params
+    # (applied below). The CLI's OpenRouter profile is stacked on top of the
+    # built-in SDK profile so its `pre_init` (version check) and factory
+    # (app attribution) compose into a single `apply_provider_profile` call.
+    if provider:
+        from deepagents.profiles.provider import apply_provider_profile
+
+        if provider == "openrouter":
+            _ensure_cli_openrouter_profile_registered()
+
+        spec = f"{provider}:{model_name}" if model_name else provider
+        try:
+            kwargs = apply_provider_profile(spec, kwargs)
+        except ModelConfigError:
+            raise
+        except Exception as exc:
+            # `pre_init` and `init_kwargs_factory` callables registered on a
+            # `ProviderProfile` may raise arbitrary exceptions (e.g. an
+            # `ImportError` from the OpenRouter min-version check). Surface
+            # them as `ModelConfigError` so the CLI's error path renders an
+            # actionable message instead of a raw stack trace.
+            logger.debug(
+                "ProviderProfile resolution for %r failed.", spec, exc_info=True
+            )
+            msg = (
+                f"Failed to apply provider profile for '{spec}': {exc}. "
+                f"Check that the provider package is installed and up to date, "
+                f"or set explicit kwargs via `--model-params`."
+            )
+            raise ModelConfigError(msg) from exc
+
     # CLI --model-params take highest priority
     if extra_kwargs:
         kwargs.update(extra_kwargs)

{deepagents_cli-0.0.41 → deepagents_cli-0.0.42}/deepagents_cli/local_context.py

@@ -224,7 +224,7 @@ if command -v node >/dev/null 2>&1; then
   NV="$(node --version 2>/dev/null | sed 's/^v//')"
   [ -n "$NV" ] && RT="${RT:+${RT}, }Node ${NV}"
 fi
-[ -n "$RT" ] && echo "**Runtimes**: ${RT}" && echo ""
+[ -n "$RT" ] && echo "**Detected Runtimes**: ${RT}" && echo ""
 """
 
 
@@ -246,7 +246,7 @@ if $IN_GIT; then
       master) MAINS="${MAINS:+${MAINS}, }\`master\`" ;;
     esac
   done
-  [ -n "$MAINS" ] && GT="${GT}, main branch available: ${MAINS}"
+  [ -n "$MAINS" ] && GT="${GT}, ${MAINS} available"
 
   DC=$(git status --porcelain 2>/dev/null | wc -l | tr -d ' ')
   if [ "$DC" -gt 0 ]; then
@@ -301,13 +301,18 @@ if [ -n "$FILES" ]; then
   TOTAL=$(echo "$FILES" | wc -l | tr -d ' ')
   SHOWN_FILES=$(echo "$FILES" | head -20)
   SHOWN=$(echo "$SHOWN_FILES" | wc -l | tr -d ' ')
-  echo "**Files** (${SHOWN} shown):"
+  TOTAL=${TOTAL:-0}
+  SHOWN=${SHOWN:-0}
+  if [ "$SHOWN" -lt "$TOTAL" ]; then
+    echo "**Files** (showing ${SHOWN} of ${TOTAL}):"
+  else
+    echo "**Files** (${TOTAL}):"
+  fi
   echo "$SHOWN_FILES" | while IFS= read -r f; do
     if [ -d "$f" ]; then echo "- ${f}/"
     else echo "- ${f}"
     fi
   done
-  [ "$SHOWN" -lt "$TOTAL" ] && echo "... ($((TOTAL - SHOWN)) more files)"
   echo ""
 fi"""
 
@@ -323,12 +328,21 @@ if command -v tree >/dev/null 2>&1; then
   TREE_EXCL='node_modules|.venv|__pycache__|.pytest_cache'
   TREE_EXCL="${TREE_EXCL}|.git|.mypy_cache|.ruff_cache"
   TREE_EXCL="${TREE_EXCL}|.tox|.coverage|.eggs|dist|build"
-  T=$(tree -L 3 --noreport --dirsfirst \
-    -I "$TREE_EXCL" 2>/dev/null | head -22)
-  if [ -n "$T" ]; then
+  T_PREVIEW=$(tree -L 3 --noreport --dirsfirst \
+    -I "$TREE_EXCL" 2>/dev/null | sed -n '1,22p;23{p;q;}')
+  if [ -n "$T_PREVIEW" ]; then
+    PREVIEW_LINES=$(echo "$T_PREVIEW" | wc -l | tr -d ' ')
+    PREVIEW_LINES=${PREVIEW_LINES:-0}
+    T="$T_PREVIEW"
+    TREE_TRUNCATED=false
+    if [ "$PREVIEW_LINES" -gt 22 ]; then
+      T=$(echo "$T_PREVIEW" | head -22)
+      TREE_TRUNCATED=true
+    fi
     echo "**Tree** (3 levels):"
     echo '```text'
     echo "$T"
+    $TREE_TRUNCATED && echo "... (more lines truncated)"
     echo '```'
     echo ""
   fi

{deepagents_cli-0.0.41 → deepagents_cli-0.0.42}/deepagents_cli/system_prompt.md

@@ -1,6 +1,6 @@
 # Deep Agents CLI
 
-You are a Deep Agent, an AI assistant running in {mode_description}. You help with tasks like coding, debugging, research, analysis, and more.
+You are a deep agent, an AI assistant running in {mode_description}. You help with tasks like coding, debugging, research, analysis, and more.
 
 {interactive_preamble}
 

deepagents_cli-0.0.42/deepagents_cli/terminal_capabilities.py

@@ -0,0 +1,115 @@
+"""Terminal capability detection.
+
+Detect optional terminal features without reading from `stdin`.
+
+The CLI only uses kitty-keyboard-protocol support to choose a user-facing
+newline shortcut label. To keep startup safe on remote or high-latency PTYs,
+detection is conservative and relies on side-effect-free terminal identity
+signals plus an explicit environment-variable override.
+"""
+
+from __future__ import annotations
+
+import logging
+import os
+import sys
+from functools import cache
+from typing import TYPE_CHECKING
+
+from deepagents_cli._env_vars import KITTY_KEYBOARD
+
+if TYPE_CHECKING:
+    from collections.abc import Mapping
+
+logger = logging.getLogger(__name__)
+
+_TRUE_VALUES = frozenset({"1", "true", "yes", "on"})
+_FALSE_VALUES = frozenset({"0", "false", "no", "off"})
+_KNOWN_KITTY_KEYBOARD_TERMS = frozenset({"xterm-ghostty", "xterm-kitty"})
+
+
+def _override_supports_kitty_keyboard_protocol(
+    env: Mapping[str, str],
+) -> bool | None:
+    """Return an explicit kitty-keyboard override from `env`, if present.
+
+    Accepted truthy values are `'1'`, `'true'`, `'yes'`, and `'on'`.
+    Accepted falsy values are `'0'`, `'false'`, `'no'`, and `'off'`.
+    `'auto'`, the empty string, and invalid values fall back to heuristic
+    detection.
+    """
+    raw = env.get(KITTY_KEYBOARD)
+    if raw is None:
+        return None
+
+    normalized = raw.strip().lower()
+    if normalized in {"", "auto"}:
+        return None
+    if normalized in _TRUE_VALUES:
+        return True
+    if normalized in _FALSE_VALUES:
+        return False
+
+    logger.warning(
+        "%s=%r ignored; expected one of: %s, or 'auto' to defer to detection.",
+        KITTY_KEYBOARD,
+        raw,
+        ", ".join(sorted(_TRUE_VALUES | _FALSE_VALUES)),
+    )
+    return None
+
+
+def _terminal_identity_supports_kitty_keyboard_protocol(
+    env: Mapping[str, str],
+) -> bool:
+    """Return whether `env` identifies a terminal with built-in kitty support.
+
+    This intentionally only recognizes terminals whose environment markers
+    imply kitty-keyboard support is part of the terminal's default identity.
+    Configurable terminals such as iTerm2 and WezTerm are intentionally not
+    auto-detected because protocol support can be disabled in user settings.
+    """
+    if env.get("KITTY_WINDOW_ID"):
+        return True
+
+    term = env.get("TERM", "")
+    return term in _KNOWN_KITTY_KEYBOARD_TERMS
+
+
+@cache
+def supports_kitty_keyboard_protocol() -> bool:
+    """Return whether the attached terminal should be treated as kitty-aware.
+
+    Detection is side-effect free: it never writes escape sequences or reads
+    queued input bytes. That means it may under-detect some configurable
+    terminals, but it will not interfere with Textual's input stream.
+
+    Set `DEEPAGENTS_CLI_KITTY_KEYBOARD` to an accepted truthy value (`1`,
+    `true`, `yes`, `on`) to force-enable the label, a falsy value (`0`,
+    `false`, `no`, `off`) to force-disable it, or `auto`/unset to use
+    heuristic detection.
+
+    Returns:
+        `True` when the terminal is known to support the kitty keyboard
+        protocol, `False` otherwise.
+    """
+    if sys.platform == "win32":
+        logger.debug("kitty kbd detection: False (win32 unsupported)")
+        return False
+    if not (sys.stdin.isatty() and sys.stdout.isatty()):
+        logger.debug("kitty kbd detection: False (stdin/stdout not a tty)")
+        return False
+
+    override = _override_supports_kitty_keyboard_protocol(os.environ)
+    if override is not None:
+        logger.debug("kitty kbd detection: %s (explicit override)", override)
+        return override
+
+    detected = _terminal_identity_supports_kitty_keyboard_protocol(os.environ)
+    logger.debug(
+        "kitty kbd detection: %s (terminal identity TERM=%r KITTY_WINDOW_ID=%r)",
+        detected,
+        os.environ.get("TERM", ""),
+        os.environ.get("KITTY_WINDOW_ID"),
+    )
+    return detected

{deepagents_cli-0.0.41 → deepagents_cli-0.0.42}/deepagents_cli/widgets/model_selector.py

@@ -471,8 +471,29 @@ class ModelSelectorScreen(ModalScreen[tuple[str, str] | None]):
         self._option_widgets = []
 
         if not self._filtered_models:
-            msg = "Loading models…" if not self._loaded else "No matching models"
-            await self._options_container.mount(Static(Content.styled(msg, "dim")))
+            if not self._loaded:
+                empty_content: Content = Content.styled("Loading models…", "dim")
+            else:
+                typed = self._filter_text.strip()
+                if typed and ":" in typed:
+                    empty_content = Content.assemble(
+                        ("No matching models — press ", "dim"),
+                        ("Enter", "bold"),
+                        (" to use ", "dim"),
+                        (typed, "bold"),
+                        (" as a custom provider:model spec", "dim"),
+                    )
+                elif typed:
+                    empty_content = Content.assemble(
+                        ("No matching models — press ", "dim"),
+                        ("Enter", "bold"),
+                        (" to use ", "dim"),
+                        (typed, "bold"),
+                        (" as a custom model spec (no provider prefix)", "dim"),
+                    )
+                else:
+                    empty_content = Content.styled("No matching models", "dim")
+            await self._options_container.mount(Static(empty_content))
             self._update_footer()
             return