deepagents-code 0.1.75__tar.gz → 0.1.77__tar.gz

{deepagents_code-0.1.75 → deepagents_code-0.1.77}/CHANGELOG.md

@@ -2,6 +2,27 @@
 
 # Deep Agents Code Changelog
 
+## [0.1.77](https://github.com/langchain-ai/deepagents/compare/deepagents-code==0.1.76...deepagents-code==0.1.77) (2026-09-24)
+
+### Bug Fixes
+
+- Preview remote plugin contents before installation.
+- Report mis-encoded `config.toml` files created by older config writers.
+- Show how to cancel MCP browser login and handle Escape.
+- Make workspace configuration warnings actionable.
+- Hide prompt search hints when search is unavailable.
+
+## [0.1.76](https://github.com/langchain-ai/deepagents/compare/deepagents-code==0.1.75...deepagents-code==0.1.76) (2026-09-24)
+
+### Features
+
+- Label plugin servers in the MCP viewer ([#6539](https://github.com/langchain-ai/deepagents/pull/6539)).
+
+### Bug Fixes
+
+- Resolve plugin MCP servers during login ([#6524](https://github.com/langchain-ai/deepagents/pull/6524)).
+- Keep empty MCP servers searchable and include descriptions in search results ([#6540](https://github.com/langchain-ai/deepagents/pull/6540)).
+
 ## [0.1.75](https://github.com/langchain-ai/deepagents/compare/deepagents-code==0.1.74...deepagents-code==0.1.75) (2026-09-23)
 
 ### Bug Fixes

{deepagents_code-0.1.75 → deepagents_code-0.1.77}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: deepagents-code
-Version: 0.1.75
+Version: 0.1.77
 Summary: Terminal coding agent built on the Deep Agents SDK - works with any model, with persistent memory, customizable skills, subagents, and approval controls.
 Project-URL: Homepage, https://www.langchain.com/dcode
 Project-URL: Documentation, https://docs.langchain.com/oss/deepagents/code/overview
@@ -30,18 +30,18 @@ Requires-Python: <4.0,>=3.12
 Requires-Dist: aiosqlite<1.0.0,>=0.22.1
 Requires-Dist: anyio<5.0.0,>=4.14.2
 Requires-Dist: deepagents-acp<1.0.0,>=0.0.10
-Requires-Dist: deepagents==0.7.18
+Requires-Dist: deepagents==0.7.19
 Requires-Dist: fastmcp<5.0.0,>=4.0.0b4
 Requires-Dist: filelock<3.30,>=3.29.7
 Requires-Dist: genai-prices<0.2.0,>=0.1.8
 Requires-Dist: httpx<1.0.0,>=0.28.1
-Requires-Dist: langchain-anthropic<2.0.0,>=1.7.3
+Requires-Dist: langchain-anthropic<2.0.0,>=1.7.4
 Requires-Dist: langchain-google-genai<5.0.0,>=4.4.0
-Requires-Dist: langchain-openai<2.0.0,>=1.6.4
+Requires-Dist: langchain-openai<2.0.0,>=1.6.5
 Requires-Dist: langchain-quickjs<0.4.0,>=0.3.4
 Requires-Dist: langchain<2.0.0,>=1.4.2
 Requires-Dist: langgraph-checkpoint-sqlite<4.0.0,>=3.1.1
-Requires-Dist: langgraph-cli[inmem]<1.0.0,>=0.4.31
+Requires-Dist: langgraph-cli[inmem]<1.0.0,>=0.4.32
 Requires-Dist: langgraph-runtime-inmem<1.0.0,>=0.34.1
 Requires-Dist: langgraph-sdk<1.0.0,>=0.4.5
 Requires-Dist: langsmith[sandbox]>=0.14.0
@@ -66,7 +66,7 @@ Provides-Extra: agentcore
 Requires-Dist: langchain-agentcore-codeinterpreter<1.0.0,>=0.0.5; extra == 'agentcore'
 Provides-Extra: all-providers
 Requires-Dist: aiohttp<3.15.0,>=3.14.3; extra == 'all-providers'
-Requires-Dist: langchain-anthropic<2.0.0,>=1.7.3; extra == 'all-providers'
+Requires-Dist: langchain-anthropic<2.0.0,>=1.7.4; extra == 'all-providers'
 Requires-Dist: langchain-aws<2.0.0,>=1.7.9; extra == 'all-providers'
 Requires-Dist: langchain-baseten<1.0.0,>=0.2.4; extra == 'all-providers'
 Requires-Dist: langchain-cohere<1.0.0,>=0.6.0; extra == 'all-providers'
@@ -82,7 +82,7 @@ Requires-Dist: langchain-meta<2.0.0,>=0.5.0; extra == 'all-providers'
 Requires-Dist: langchain-mistralai<2.0.0,>=1.1.6; extra == 'all-providers'
 Requires-Dist: langchain-nvidia-ai-endpoints<2.0.0,>=1.4.3; extra == 'all-providers'
 Requires-Dist: langchain-ollama<2.0.0,>=1.1.0; extra == 'all-providers'
-Requires-Dist: langchain-openai<2.0.0,>=1.6.4; extra == 'all-providers'
+Requires-Dist: langchain-openai<2.0.0,>=1.6.5; extra == 'all-providers'
 Requires-Dist: langchain-openrouter<2.0.0,>=0.2.9; extra == 'all-providers'
 Requires-Dist: langchain-perplexity<2.0.0,>=1.4.1; extra == 'all-providers'
 Requires-Dist: langchain-together<2.0.0,>=0.4.0; extra == 'all-providers'
@@ -94,7 +94,7 @@ Requires-Dist: langchain-modal>=0.0.5; extra == 'all-sandboxes'
 Requires-Dist: langchain-runloop>=0.0.6; extra == 'all-sandboxes'
 Requires-Dist: langchain-vercel-sandbox>=0.0.1; extra == 'all-sandboxes'
 Provides-Extra: anthropic
-Requires-Dist: langchain-anthropic<2.0.0,>=1.7.3; extra == 'anthropic'
+Requires-Dist: langchain-anthropic<2.0.0,>=1.7.4; extra == 'anthropic'
 Provides-Extra: baseten
 Requires-Dist: langchain-baseten<1.0.0,>=0.2.4; extra == 'baseten'
 Provides-Extra: bedrock
@@ -132,7 +132,7 @@ Requires-Dist: langchain-nvidia-ai-endpoints<2.0.0,>=1.4.3; extra == 'nvidia'
 Provides-Extra: ollama
 Requires-Dist: langchain-ollama<2.0.0,>=1.1.0; extra == 'ollama'
 Provides-Extra: openai
-Requires-Dist: langchain-openai<2.0.0,>=1.6.4; extra == 'openai'
+Requires-Dist: langchain-openai<2.0.0,>=1.6.5; extra == 'openai'
 Provides-Extra: openrouter
 Requires-Dist: langchain-openrouter<2.0.0,>=0.2.9; extra == 'openrouter'
 Provides-Extra: perplexity

{deepagents_code-0.1.75 → deepagents_code-0.1.77}/deepagents_code/_build_info.py

@@ -1,3 +1,3 @@
 """Generated at build time. Do not edit or commit."""
 
-BUILD_COMMIT = "c526854"
+BUILD_COMMIT = "dcf4feb"

{deepagents_code-0.1.75 → deepagents_code-0.1.77}/deepagents_code/_version.py

@@ -2,7 +2,7 @@
 
 # Keep the `x-release-please-version` annotation — release-please uses it to
 # bump `__version__` in sync with `pyproject.toml` on every release PR.
-__version__ = "0.1.75"  # x-release-please-version
+__version__ = "0.1.77"  # x-release-please-version
 
 DOCS_URL = "https://docs.langchain.com/oss/python/deepagents/code"
 """URL for `deepagents-code` documentation."""

{deepagents_code-0.1.75 → deepagents_code-0.1.77}/deepagents_code/mcp_auth.py

@@ -1218,6 +1218,7 @@ def _make_loopback_handlers(
     extras = dict(extra_auth_params or {})
     interaction = ui if ui is not None else _default_ui()
     last_authorize_url: str | None = None
+    browser_opened = False
     _paste_redirect, paste_callback = _make_paste_back_handlers(
         extra_auth_params=extra_auth_params,
         ui=interaction,
@@ -1227,7 +1228,8 @@ def _make_loopback_handlers(
         import asyncio
         import webbrowser
 
-        nonlocal last_authorize_url
+        nonlocal last_authorize_url, browser_opened
+        browser_opened = False
         final_url = _append_query_params(auth_url, extras) if extras else auth_url
         last_authorize_url = final_url
 
@@ -1268,10 +1270,18 @@ def _make_loopback_handlers(
             )
             await interaction.show_authorize_url(final_url, opened_in_browser=False)
             return
+        browser_opened = True
         await interaction.show_authorize_url(final_url, opened_in_browser=True)
 
     async def callback() -> AuthorizationCodeResult:
+        from deepagents_code.mcp_oauth_ui import (
+            CliOAuthInteraction,
+            _wait_for_browser_authorization,
+        )
+
         try:
+            if browser_opened and isinstance(interaction, CliOAuthInteraction):
+                return await _wait_for_browser_authorization(callback_server.wait)
             return await callback_server.wait()
         except (
             _LoopbackCallbackTimeoutError,
@@ -1998,6 +2008,7 @@ def format_login_failure(exc: BaseException) -> str:
     if reauth is not None:
         return str(reauth)
 
+    from deepagents_code.mcp_oauth_ui import MCPLoginAbortedError
     from deepagents_code.mcp_tools import MCPConfigError
 
     if isinstance(exc, MCPConfigError):
@@ -2018,8 +2029,12 @@ def format_login_failure(exc: BaseException) -> str:
     visited: set[int] = set()
     while current is not None and id(current) not in visited:
         visited.add(id(current))
+        if isinstance(current, MCPLoginAbortedError):
+            return "MCP login aborted."
         parts.append(type(current).__name__)
         if isinstance(current, BaseExceptionGroup):
+            if current.subgroup(MCPLoginAbortedError) is not None:
+                return "MCP login aborted."
             parts.append(
                 "[" + ", ".join(type(e).__name__ for e in current.exceptions[:5]) + "]"
             )

{deepagents_code-0.1.75 → deepagents_code-0.1.77}/deepagents_code/mcp_disabled.py

@@ -74,7 +74,7 @@ def _load_config(config_path: Path) -> dict[str, Any]:
     try:
         with config_path.open("rb") as f:
             return tomllib.load(f)
-    except (OSError, tomllib.TOMLDecodeError) as exc:
+    except (OSError, UnicodeDecodeError, tomllib.TOMLDecodeError) as exc:
         logger.warning(
             "Could not read MCP disabled config at %s: %s",
             config_path,

{deepagents_code-0.1.75 → deepagents_code-0.1.77}/deepagents_code/mcp_login_service.py

@@ -15,7 +15,7 @@ functions that need them.
 
 from __future__ import annotations
 
-from dataclasses import dataclass
+from dataclasses import dataclass, field
 from enum import StrEnum
 from pathlib import Path
 from typing import TYPE_CHECKING, Any
@@ -148,20 +148,26 @@ class ConfigResolution:
     the reason is already embedded in `message`, so the field lives only here.
     See `format_load_errors_notice`."""
 
+    includes_plugins: bool = field(default=False, kw_only=True)
+    """Whether enabled plugins contributed to the merged configuration."""
+
     def __post_init__(self) -> None:
-        """Enforce the non-empty `used_paths` invariant.
+        """Require at least one file or plugin configuration source.
 
         Raises:
-            ValueError: If `used_paths` is empty.
+            ValueError: If neither files nor plugins contributed configuration.
         """
-        if not self.used_paths:
-            msg = "ConfigResolution must have at least one used path"
+        if not self.used_paths and not self.includes_plugins:
+            msg = "ConfigResolution must have at least one file or plugin source"
             raise ValueError(msg)
 
     @property
     def search_label(self) -> str:
-        """Human-readable join of the paths backing this resolution."""
-        return ", ".join(str(path) for path in self.used_paths)
+        """Human-readable join of the sources backing this resolution."""
+        labels = [str(path) for path in self.used_paths]
+        if self.includes_plugins:
+            labels.append("enabled plugins")
+        return ", ".join(labels)
 
 
 @dataclass(frozen=True)
@@ -209,6 +215,7 @@ def resolve_mcp_config(
         _drop_invalid_mcp_config_servers,
         _load_mcp_config_top_level_with_error,
         _merge_mcp_configs_with_sources,
+        _resolve_project_config_base,
         discover_mcp_config_sources,
         filter_trusted_project_servers,
         load_mcp_config,
@@ -229,8 +236,12 @@ def resolve_mcp_config(
             used_paths=(Path(config_path),),
         )
 
+    from deepagents_code.plugins.adapters.mcp import discover_plugin_mcp_configs
+
     found = discover_mcp_config_sources()
-    if not found:
+    plugin_project_root = _resolve_project_config_base(None)
+    plugin_configs = discover_plugin_mcp_configs(project_dir=plugin_project_root)
+    if not found and not plugin_configs:
         return ConfigResolutionError(
             kind=ConfigErrorKind.NO_CONFIG_FOUND,
             message=(
@@ -264,7 +275,8 @@ def resolve_mcp_config(
         elif error is not None:
             load_errors.append((path, error))
 
-    if project_paths:
+    includes_plugins = False
+    if plugin_configs or project_paths:
         from deepagents_code.model_config import load_mcp_server_trust_lists
 
         trust_lists = load_mcp_server_trust_lists()
@@ -277,6 +289,20 @@ def resolve_mcp_config(
             # trust-list loader has already discarded scoped approvals while
             # retaining names explicitly enabled through the readable env var.
             policy_error = trust_lists.read_error
+        for plugin_config in plugin_configs:
+            plugin_servers = plugin_config.get("mcpServers")
+            if not isinstance(plugin_servers, dict):
+                continue
+            plugin_kept = filter_trusted_project_servers(
+                plugin_servers,
+                trust_lists,
+                project_root=plugin_project_root,
+                config_trusted=not trust_lists.load_failed,
+            )
+            if plugin_kept:
+                configs.append({**plugin_config, "mcpServers": plugin_kept})
+                includes_plugins = True
+
         config_trusted = trust_project_mcp is True and not trust_lists.load_failed
         loaded_projects: list[tuple[Path, dict[str, Any]]] = []
         for path in project_paths:
@@ -334,8 +360,10 @@ def resolve_mcp_config(
             detail = "; ".join(f"{path}: {error}" for path, error in load_errors)
             message = f"No usable MCP config found (load errors: {detail})"
         else:
-            found_paths = ", ".join(str(source.path) for source in found)
-            message = f"No usable MCP config found in: {found_paths}"
+            found_labels = [str(source.path) for source in found]
+            if plugin_configs:
+                found_labels.append("enabled plugins")
+            message = f"No usable MCP config found in: {', '.join(found_labels)}"
         return ConfigResolutionError(
             kind=ConfigErrorKind.NO_USABLE_CONFIG,
             message=message,
@@ -349,6 +377,7 @@ def resolve_mcp_config(
     return ConfigResolution(
         config=merge_mcp_configs(configs),
         used_paths=tuple(used_paths),
+        includes_plugins=includes_plugins,
         untrusted_project_paths=untrusted,
         legacy_ignored=legacy_ignored,
         policy_error=policy_error,

{deepagents_code-0.1.75 → deepagents_code-0.1.77}/deepagents_code/mcp_oauth_ui.py

@@ -17,7 +17,71 @@ so leaks come from misuse, not from this interface's shape.
 
 from __future__ import annotations
 
-from typing import Protocol
+from typing import TYPE_CHECKING, Protocol
+
+if TYPE_CHECKING:
+    from collections.abc import Callable, Coroutine
+
+
+class MCPLoginAbortedError(RuntimeError):
+    """The user aborted browser authorization from the terminal."""
+
+
+async def _wait_for_browser_authorization[T](
+    wait: Callable[[], Coroutine[object, object, T]],
+) -> T:
+    """Wait for a browser callback with terminal-only Esc cancellation.
+
+    Returns:
+        The browser callback result.
+
+    Raises:
+        MCPLoginAbortedError: If the user aborts authorization.
+    """
+    import asyncio
+    import sys
+
+    if not (sys.stdin.isatty() and sys.stderr.isatty()):
+        return await wait()
+
+    from prompt_toolkit.application import Application
+    from prompt_toolkit.key_binding import KeyBindings, KeyPressEvent
+    from prompt_toolkit.layout import Layout, Window
+    from prompt_toolkit.layout.controls import FormattedTextControl
+    from prompt_toolkit.output.defaults import create_output
+
+    bindings = KeyBindings()
+
+    @bindings.add("escape")
+    @bindings.add("c-c")
+    @bindings.add("c-d")
+    def abort(event: KeyPressEvent) -> None:
+        event.app.exit(exception=MCPLoginAbortedError())
+
+    app: Application[None] = Application(
+        layout=Layout(Window(FormattedTextControl("esc to abort"), height=1)),
+        key_bindings=bindings,
+        output=create_output(stdout=sys.stderr),
+        full_screen=False,
+        erase_when_done=True,
+    )
+    callback = asyncio.create_task(wait())
+    keyboard = asyncio.create_task(app.run_async(handle_sigint=False))
+    try:
+        done, _ = await asyncio.wait(
+            (callback, keyboard), return_when=asyncio.FIRST_COMPLETED
+        )
+        if callback in done:
+            return await callback
+        try:
+            await keyboard
+        except EOFError as exc:
+            raise MCPLoginAbortedError from exc
+        raise MCPLoginAbortedError
+    finally:
+        callback.cancel()
+        keyboard.cancel()
+        await asyncio.gather(callback, keyboard, return_exceptions=True)
 
 
 class OAuthInteraction(Protocol):

{deepagents_code-0.1.75 → deepagents_code-0.1.77}/deepagents_code/model_config.py

@@ -4639,6 +4639,11 @@ def suppress_warning_reason(key: str, config_path: Path | None = None) -> str |
     except tomllib.TOMLDecodeError:
         logger.exception("Could not save warning suppression for '%s'", key)
         return f"{config_path} is not valid TOML"
+    except UnicodeDecodeError:
+        # `tomllib` decodes the bytes itself, so a file that is not UTF-8
+        # raises `UnicodeDecodeError` rather than `TOMLDecodeError`.
+        logger.exception("Could not save warning suppression for '%s'", key)
+        return f"{config_path} is not UTF-8 encoded"
     except OSError:
         logger.exception("Could not save warning suppression for '%s'", key)
         return f"{config_path} could not be written"
@@ -4705,7 +4710,7 @@ def unsuppress_warning(key: str, config_path: Path | None = None) -> bool:
                 with contextlib.suppress(OSError):
                     Path(tmp_path).unlink()
                 raise
-    except (OSError, tomllib.TOMLDecodeError):
+    except (OSError, UnicodeDecodeError, tomllib.TOMLDecodeError):
         logger.exception("Could not remove warning suppression for '%s'", key)
         return False
     _invalidate_config_caches(config_path)
@@ -6156,7 +6161,7 @@ def save_thread_columns(
                 with contextlib.suppress(OSError):
                     Path(tmp_path).unlink()
                 raise
-    except (OSError, tomllib.TOMLDecodeError):
+    except (OSError, UnicodeDecodeError, tomllib.TOMLDecodeError):
         logger.exception("Could not save thread column preferences")
         return False
     invalidate_thread_config_cache()
@@ -6220,7 +6225,7 @@ def save_thread_relative_time(enabled: bool, config_path: Path | None = None) ->
                 with contextlib.suppress(OSError):
                     Path(tmp_path).unlink()
                 raise
-    except (OSError, tomllib.TOMLDecodeError):
+    except (OSError, UnicodeDecodeError, tomllib.TOMLDecodeError):
         logger.exception("Could not save thread relative_time preference")
         return False
     invalidate_thread_config_cache()
@@ -6449,7 +6454,7 @@ def save_thread_sort_order(sort_order: str, config_path: Path | None = None) ->
                 with contextlib.suppress(OSError):
                     Path(tmp_path).unlink()
                 raise
-    except (OSError, tomllib.TOMLDecodeError):
+    except (OSError, UnicodeDecodeError, tomllib.TOMLDecodeError):
         logger.exception("Could not save thread sort_order preference")
         return False
     invalidate_thread_config_cache()

{deepagents_code-0.1.75 → deepagents_code-0.1.77}/deepagents_code/tui/modals/plugin_manager/__init__.py

@@ -34,6 +34,7 @@ if TYPE_CHECKING:
     )
 
 from deepagents_code import theme
+from deepagents_code._env_vars import OFFLINE, is_env_truthy
 from deepagents_code.config import get_glyphs, is_ascii_mode
 from deepagents_code.model_config import _save_toml_field
 from deepagents_code.plugins import (
@@ -44,7 +45,7 @@ from deepagents_code.plugins import (
     uninstall_plugin,
 )
 from deepagents_code.plugins.discovery import plugin_auto_update_setting
-from deepagents_code.plugins.marketplace import MarketplaceError
+from deepagents_code.plugins.marketplace import MarketplaceError, redact_urls_in_text
 from deepagents_code.tui.modals.plugin_manager.content import (
     _confirm_marketplace_removal_options,
     _install_details_options,
@@ -62,7 +63,10 @@ from deepagents_code.tui.modals.plugin_manager.models import (
     PluginTab,
     _ManagerState,
 )
-from deepagents_code.tui.modals.plugin_manager.state import _load_manager_state
+from deepagents_code.tui.modals.plugin_manager.state import (
+    _inspect_plugin,
+    _load_manager_state,
+)
 from deepagents_code.tui.modals.plugin_manager.tabs import (
     TAB_LABELS,
     PluginTabLabel,
@@ -166,6 +170,8 @@ class PluginManagerScreen(ModalScreen[PluginManagerResult]):  # noqa: RUF067
         self._status: str | None = None
         self._error: str | None = None
         self._selected_plugin: _PluginRow | None = None
+        self._previews: dict[str, _PluginRow] = {}
+        self._inspecting: set[str] = set()
         self._selected_marketplace: _MarketplaceRow | None = None
         self._adding_marketplace = False
         self._marketplace_spinner = Spinner()
@@ -454,7 +460,12 @@ class PluginManagerScreen(ModalScreen[PluginManagerResult]):  # noqa: RUF067
         self._update_tab_labels()
         status_widget = self.query_one("#plugin-manager-status", Static)
         if self._mode == "plugin_details" and self._selected_plugin is not None:
-            status_widget.update(_plugin_details_content(self._selected_plugin))
+            status_widget.update(
+                _plugin_details_content(
+                    self._selected_plugin,
+                    inspecting=self._selected_plugin.plugin_id in self._inspecting,
+                )
+            )
         elif self._mode == "installed_details" and self._selected_plugin is not None:
             status_widget.update(
                 _installed_plugin_details_content(self._selected_plugin)
@@ -583,7 +594,11 @@ class PluginManagerScreen(ModalScreen[PluginManagerResult]):  # noqa: RUF067
 
     def _active_details_options(self) -> list[Option]:
         if self._mode == "plugin_details":
-            return _install_details_options()
+            row = self._selected_plugin
+            return _install_details_options(
+                uninspected=row is not None and row.skill_count is None,
+                inspecting=row is not None and row.plugin_id in self._inspecting,
+            )
         if self._mode == "installed_details" and self._selected_plugin is not None:
             return _installed_details_options(
                 self._selected_plugin, divider_width=self._divider_width()
@@ -688,6 +703,7 @@ class PluginManagerScreen(ModalScreen[PluginManagerResult]):  # noqa: RUF067
             # must retain the user's active filter.
             if clear_search:
                 self._search_query = ""
+                self._previews.clear()
 
             # Take the snapshot only after acquiring the lock. A settled
             # connection update queued behind the initial load therefore uses
@@ -1050,6 +1066,8 @@ class PluginManagerScreen(ModalScreen[PluginManagerResult]):  # noqa: RUF067
             self._selected_plugin = row
             self._mode = "plugin_details"
             self._error = None
+            if row.skill_count is None and not is_env_truthy(OFFLINE):
+                self._start_plugin_inspection(row)
             self._refresh_view()
             return
         if option_id.startswith("installed:"):
@@ -1066,6 +1084,11 @@ class PluginManagerScreen(ModalScreen[PluginManagerResult]):  # noqa: RUF067
         if option_id == "action:toggle-auto-update":
             await self._toggle_auto_update()
             return
+        if option_id == "action:inspect":
+            row = self._selected_plugin
+            if row is not None:
+                self._start_plugin_inspection(row)
+            return
         if option_id == "action:install":
             await self._install_selected_plugin()
             return
@@ -1097,7 +1120,7 @@ class PluginManagerScreen(ModalScreen[PluginManagerResult]):  # noqa: RUF067
     def _find_available_plugin(self, plugin_id: str) -> _PluginRow | None:
         return next(
             (
-                row
+                self._previews.get(plugin_id, row)
                 for row in self._state.available_plugins
                 if row.plugin_id == plugin_id
             ),
@@ -1137,9 +1160,40 @@ class PluginManagerScreen(ModalScreen[PluginManagerResult]):  # noqa: RUF067
         if enabled and self._on_auto_update_enabled is not None:
             self._on_auto_update_enabled()
 
+    def _start_plugin_inspection(self, row: _PluginRow) -> None:
+        if row.plugin_id in self._inspecting:
+            return
+        self._inspecting.add(row.plugin_id)
+        self._error = None
+        self._refresh_view()
+        self.call_after_refresh(self._inspect_selected_plugin, row)
+
+    @work(exit_on_error=False)
+    async def _inspect_selected_plugin(self, row: _PluginRow) -> None:
+        error: str | None = None
+        try:
+            self._previews[row.plugin_id] = await asyncio.to_thread(
+                _inspect_plugin, row
+            )
+        except (MarketplaceError, OSError, ValueError, RuntimeError, TypeError) as exc:
+            error = f"Could not inspect contents: {redact_urls_in_text(str(exc))}"
+            logger.debug("%s", error)
+        finally:
+            self._inspecting.discard(row.plugin_id)
+        if (
+            not self._dismissed
+            and self._close_phase == "browsing"
+            and self._mode == "plugin_details"
+            and self._selected_plugin is not None
+            and self._selected_plugin.plugin_id == row.plugin_id
+        ):
+            self._selected_plugin = self._previews.get(row.plugin_id, row)
+            self._error = error
+            self._refresh_view()
+
     async def _install_selected_plugin(self) -> None:
         row = self._selected_plugin
-        if row is None:
+        if row is None or row.plugin_id in self._inspecting:
             return
         try:
             instance = await asyncio.to_thread(install_plugin, row.plugin_id)

{deepagents_code-0.1.75 → deepagents_code-0.1.77}/deepagents_code/tui/modals/plugin_manager/content.py

@@ -74,9 +74,22 @@ def _plugin_prompt(row: _PluginRow, *, status: str | None) -> Content:
     )
 
 
-def _install_details_options() -> list[Option]:
+def _install_details_options(
+    *, uninspected: bool = False, inspecting: bool = False
+) -> list[Option]:
+    options = (
+        [
+            Option(
+                "Inspect contents (downloads source)",
+                id="action:inspect",
+            )
+        ]
+        if uninspected and not inspecting
+        else []
+    )
     return [
-        Option("Install", id="action:install"),
+        *options,
+        Option("Install", id="action:install", disabled=inspecting),
         Option("Back to plugin list", id="details-back"),
     ]
 
@@ -128,12 +141,7 @@ def _will_install_lines(row: _PluginRow) -> list[str]:
             _unsupported_summary(row.unsupported_components),
         ]
     if row.skill_count is None:
-        return [
-            (
-                "Skills, MCP servers, and hooks if present "
-                "(agents/ and commands/ are not loaded)."
-            )
-        ]
+        return ["Contents not inspected. Choose Inspect contents to preview."]
     return [
         "No supported components (skills/MCP/hooks).",
         "agents/ and commands/ are not loaded by deepagents-code.",
@@ -194,7 +202,7 @@ def _status_lines(row: _PluginRow) -> list[Content]:
     return lines
 
 
-def _plugin_details_content(row: _PluginRow) -> Content:
+def _plugin_details_content(row: _PluginRow, *, inspecting: bool = False) -> Content:
     _, _, marketplace = row.plugin_id.partition("@")
     parts: list[Content | str] = [
         Content.styled("Plugin details", "bold"),
@@ -210,7 +218,12 @@ def _plugin_details_content(row: _PluginRow) -> Content:
     if row.author:
         parts.extend(["\n\n", Content.styled(f"By: {row.author}", "dim")])
     parts.extend(["\n\n", Content.styled("Will install:", "bold")])
-    for line in _will_install_lines(row):
+    lines = (
+        ["Downloading and inspecting contents..."]
+        if inspecting
+        else _will_install_lines(row)
+    )
+    for line in lines:
         parts.extend(["\n  ", Content.styled(line, "dim")])
     parts.extend(
         [