deepagents-code 0.1.13__tar.gz → 0.1.14__tar.gz

{deepagents_code-0.1.13 → deepagents_code-0.1.14}/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 # Deep Agents Code Changelog
 
+## [0.1.14](https://github.com/langchain-ai/deepagents/compare/deepagents-code==0.1.13...deepagents-code==0.1.14) (2026-06-12)
+
+### Features
+
+* Surface editable mode and core deps in `/version` ([#3898](https://github.com/langchain-ai/deepagents/issues/3898)) ([d4f5a12](https://github.com/langchain-ai/deepagents/commit/d4f5a12cc6d73dc19d24d5748242705d79fa65bf))
+
+### Bug Fixes
+
+* Don't move cursor on click that re-focuses terminal ([#3893](https://github.com/langchain-ai/deepagents/issues/3893)) ([b76788b](https://github.com/langchain-ai/deepagents/commit/b76788b7850e910fe2882cb1a62ffff6ff5085b0))
+* Label `-r` resume as `"Resuming..."` in the status bar ([#3892](https://github.com/langchain-ai/deepagents/issues/3892)) ([70cd286](https://github.com/langchain-ai/deepagents/commit/70cd28643bc2ca7da5a61a7b7203c6de2266ca4e))
+* Scope `@` file completion to current cwd ([#3874](https://github.com/langchain-ai/deepagents/issues/3874)) ([dd237ac](https://github.com/langchain-ai/deepagents/commit/dd237acd21a39e98e37bb9d98dfae09bc44d5457))
+* Set dcode agent names in trace metadata ([#3901](https://github.com/langchain-ai/deepagents/issues/3901)) ([ac94dd6](https://github.com/langchain-ai/deepagents/commit/ac94dd6b139211187cad8685c1152f02c51ba086))
+* Surface untracked files in `@` completion ([#3872](https://github.com/langchain-ai/deepagents/issues/3872)) ([2bdf6ea](https://github.com/langchain-ai/deepagents/commit/2bdf6ea329c6b4c8be5f0075528e00c7ce2c1e6a))
+* Warn on misconfigured subagent files ([#3873](https://github.com/langchain-ai/deepagents/issues/3873)) ([f1614d6](https://github.com/langchain-ai/deepagents/commit/f1614d67827c3d4d3bd01a784f57f83a50ec3410))
+
+### Performance Improvements
+
+* Cache theme colors/charset, fix `O(n^2)` tool-call streaming ([#3881](https://github.com/langchain-ai/deepagents/issues/3881)) ([9d463f5](https://github.com/langchain-ai/deepagents/commit/9d463f52fb3a4d458477982963f3d278d5362b48))
+
 ## [0.1.13](https://github.com/langchain-ai/deepagents/compare/deepagents-code==0.1.12...deepagents-code==0.1.13) (2026-06-11)
 
 ### Features

{deepagents_code-0.1.13 → deepagents_code-0.1.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepagents-code
-Version: 0.1.13
+Version: 0.1.14
 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/
@@ -29,16 +29,16 @@ Requires-Dist: aiosqlite<1.0.0,>=0.22.1
 Requires-Dist: deepagents-acp<1.0.0,>=0.0.8
 Requires-Dist: deepagents==0.6.8
 Requires-Dist: httpx<1.0.0,>=0.28.1
-Requires-Dist: langchain-anthropic<2.0.0,>=1.4.4
-Requires-Dist: langchain-google-genai<5.0.0,>=4.2.4
+Requires-Dist: langchain-anthropic<2.0.0,>=1.4.5
+Requires-Dist: langchain-google-genai<5.0.0,>=4.2.5
 Requires-Dist: langchain-mcp-adapters<1.0.0,>=0.3.0
-Requires-Dist: langchain-openai<2.0.0,>=1.2.2
-Requires-Dist: langchain<2.0.0,>=1.3.4
+Requires-Dist: langchain-openai<2.0.0,>=1.3.0
+Requires-Dist: langchain<2.0.0,>=1.3.8
 Requires-Dist: langgraph-checkpoint-sqlite<4.0.0,>=3.1.0
-Requires-Dist: langgraph-cli[inmem]<1.0.0,>=0.4.27
-Requires-Dist: langgraph-runtime-inmem<1.0.0,>=0.29.0
+Requires-Dist: langgraph-cli[inmem]<1.0.0,>=0.4.29
+Requires-Dist: langgraph-runtime-inmem<1.0.0,>=0.30.0
 Requires-Dist: langgraph-sdk<1.0.0,>=0.4.2
-Requires-Dist: langsmith[sandbox]>=0.8.11
+Requires-Dist: langsmith[sandbox]>=0.8.15
 Requires-Dist: markdownify<2.0.0,>=1.2.2
 Requires-Dist: packaging>=26.2
 Requires-Dist: pillow<13.0.0,>=12.2.0
@@ -48,7 +48,7 @@ Requires-Dist: python-dotenv<2.0.0,>=1.2.2
 Requires-Dist: pyyaml>=6.0.3
 Requires-Dist: requests<3.0.0,>=2.34.2
 Requires-Dist: rich<16.0.0,>=15.0.0
-Requires-Dist: tavily-python<1.0.0,>=0.7.25
+Requires-Dist: tavily-python<1.0.0,>=0.7.26
 Requires-Dist: textual-autocomplete<5.0.0,>=4.0.6
 Requires-Dist: textual-speedups<1.0.0,>=0.2.1
 Requires-Dist: textual<9.0.0,>=8.2.7
@@ -57,24 +57,24 @@ Requires-Dist: uuid-utils<1.0.0,>=0.16.0
 Provides-Extra: agentcore
 Requires-Dist: langchain-agentcore-codeinterpreter<1.0.0,>=0.0.4; extra == 'agentcore'
 Provides-Extra: all-providers
-Requires-Dist: langchain-anthropic<2.0.0,>=1.4.4; extra == 'all-providers'
+Requires-Dist: langchain-anthropic<2.0.0,>=1.4.5; extra == 'all-providers'
 Requires-Dist: langchain-aws<2.0.0,>=1.5.1; extra == 'all-providers'
 Requires-Dist: langchain-baseten<1.0.0,>=0.2.0; extra == 'all-providers'
 Requires-Dist: langchain-cohere<1.0.0,>=0.6.0; extra == 'all-providers'
 Requires-Dist: langchain-deepseek<2.0.0,>=1.1.0; extra == 'all-providers'
 Requires-Dist: langchain-fireworks<2.0.0,>=1.4.2; extra == 'all-providers'
-Requires-Dist: langchain-google-genai<5.0.0,>=4.2.4; extra == 'all-providers'
-Requires-Dist: langchain-google-vertexai<4.0.0,>=3.2.3; extra == 'all-providers'
-Requires-Dist: langchain-groq<2.0.0,>=1.1.2; extra == 'all-providers'
+Requires-Dist: langchain-google-genai<5.0.0,>=4.2.5; extra == 'all-providers'
+Requires-Dist: langchain-google-vertexai<4.0.0,>=3.2.4; extra == 'all-providers'
+Requires-Dist: langchain-groq<2.0.0,>=1.1.3; extra == 'all-providers'
 Requires-Dist: langchain-huggingface<2.0.0,>=1.2.2; extra == 'all-providers'
 Requires-Dist: langchain-ibm<2.0.0,>=1.1.0; extra == 'all-providers'
 Requires-Dist: langchain-litellm<2.0.0,>=0.6.6; extra == 'all-providers'
-Requires-Dist: langchain-mistralai<2.0.0,>=1.1.4; extra == 'all-providers'
+Requires-Dist: langchain-mistralai<2.0.0,>=1.1.5; extra == 'all-providers'
 Requires-Dist: langchain-nvidia-ai-endpoints<2.0.0,>=1.4.1; extra == 'all-providers'
 Requires-Dist: langchain-ollama<2.0.0,>=1.1.0; extra == 'all-providers'
-Requires-Dist: langchain-openai<2.0.0,>=1.2.2; extra == 'all-providers'
+Requires-Dist: langchain-openai<2.0.0,>=1.3.0; extra == 'all-providers'
 Requires-Dist: langchain-openrouter<2.0.0,>=0.2.3; extra == 'all-providers'
-Requires-Dist: langchain-perplexity<2.0.0,>=1.3.2; extra == 'all-providers'
+Requires-Dist: langchain-perplexity<2.0.0,>=1.4.0; extra == 'all-providers'
 Requires-Dist: langchain-together<2.0.0,>=0.4.0; extra == 'all-providers'
 Requires-Dist: langchain-xai<2.0.0,>=1.2.2; extra == 'all-providers'
 Provides-Extra: all-sandboxes
@@ -83,7 +83,7 @@ Requires-Dist: langchain-daytona>=0.0.7; extra == 'all-sandboxes'
 Requires-Dist: langchain-modal>=0.0.5; extra == 'all-sandboxes'
 Requires-Dist: langchain-runloop>=0.0.6; extra == 'all-sandboxes'
 Provides-Extra: anthropic
-Requires-Dist: langchain-anthropic<2.0.0,>=1.4.4; extra == 'anthropic'
+Requires-Dist: langchain-anthropic<2.0.0,>=1.4.5; extra == 'anthropic'
 Provides-Extra: baseten
 Requires-Dist: langchain-baseten<1.0.0,>=0.2.0; extra == 'baseten'
 Provides-Extra: bedrock
@@ -97,9 +97,9 @@ Requires-Dist: langchain-deepseek<2.0.0,>=1.1.0; extra == 'deepseek'
 Provides-Extra: fireworks
 Requires-Dist: langchain-fireworks<2.0.0,>=1.4.2; extra == 'fireworks'
 Provides-Extra: google-genai
-Requires-Dist: langchain-google-genai<5.0.0,>=4.2.4; extra == 'google-genai'
+Requires-Dist: langchain-google-genai<5.0.0,>=4.2.5; extra == 'google-genai'
 Provides-Extra: groq
-Requires-Dist: langchain-groq<2.0.0,>=1.1.2; extra == 'groq'
+Requires-Dist: langchain-groq<2.0.0,>=1.1.3; extra == 'groq'
 Provides-Extra: huggingface
 Requires-Dist: langchain-huggingface<2.0.0,>=1.2.2; extra == 'huggingface'
 Provides-Extra: ibm
@@ -107,7 +107,7 @@ Requires-Dist: langchain-ibm<2.0.0,>=1.1.0; extra == 'ibm'
 Provides-Extra: litellm
 Requires-Dist: langchain-litellm<2.0.0,>=0.6.6; extra == 'litellm'
 Provides-Extra: mistralai
-Requires-Dist: langchain-mistralai<2.0.0,>=1.1.4; extra == 'mistralai'
+Requires-Dist: langchain-mistralai<2.0.0,>=1.1.5; extra == 'mistralai'
 Provides-Extra: modal
 Requires-Dist: langchain-modal>=0.0.5; extra == 'modal'
 Provides-Extra: nvidia
@@ -115,11 +115,11 @@ Requires-Dist: langchain-nvidia-ai-endpoints<2.0.0,>=1.4.1; 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.2.2; extra == 'openai'
+Requires-Dist: langchain-openai<2.0.0,>=1.3.0; extra == 'openai'
 Provides-Extra: openrouter
 Requires-Dist: langchain-openrouter<2.0.0,>=0.2.3; extra == 'openrouter'
 Provides-Extra: perplexity
-Requires-Dist: langchain-perplexity<2.0.0,>=1.3.2; extra == 'perplexity'
+Requires-Dist: langchain-perplexity<2.0.0,>=1.4.0; extra == 'perplexity'
 Provides-Extra: quickjs
 Requires-Dist: langchain-quickjs<0.2.0,>=0.1.4; extra == 'quickjs'
 Provides-Extra: runloop
@@ -127,7 +127,7 @@ Requires-Dist: langchain-runloop>=0.0.6; extra == 'runloop'
 Provides-Extra: together
 Requires-Dist: langchain-together<2.0.0,>=0.4.0; extra == 'together'
 Provides-Extra: vertex
-Requires-Dist: langchain-google-vertexai<4.0.0,>=3.2.3; extra == 'vertex'
+Requires-Dist: langchain-google-vertexai<4.0.0,>=3.2.4; extra == 'vertex'
 Provides-Extra: xai
 Requires-Dist: langchain-xai<2.0.0,>=1.2.2; extra == 'xai'
 Description-Content-Type: text/markdown

{deepagents_code-0.1.13 → deepagents_code-0.1.14}/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.13"  # x-release-please-version
+__version__ = "0.1.14"  # x-release-please-version
 
 DOCS_URL = "https://docs.langchain.com/oss/python/deepagents/code"
 """URL for `deepagents-code` documentation."""

{deepagents_code-0.1.13 → deepagents_code-0.1.14}/deepagents_code/agent.py

@@ -88,6 +88,19 @@ REQUIRE_COMPACT_TOOL_APPROVAL: bool = True
 """When `True`, `compact_conversation` requires HITL approval like other gated tools."""
 
 
+def _sanitize_agent_message_name(agent_name: str) -> str:
+    """Return a provider-safe message name for a user-facing agent name.
+
+    Args:
+        agent_name: Display/storage name for the selected agent.
+
+    Returns:
+        Name containing only alphanumerics, underscores, and hyphens.
+    """
+    sanitized = re.sub(r"[^a-zA-Z0-9_-]+", "_", agent_name).strip("_")
+    return sanitized or DEFAULT_AGENT_NAME
+
+
 class ShellAllowListMiddleware(AgentMiddleware):
     """Validate shell commands against an allow-list without HITL interrupts.
 
@@ -1567,5 +1580,6 @@ def create_cli_agent(
         interrupt_on=interrupt_on,
         checkpointer=checkpointer,
         subagents=all_subagents or None,
+        name=_sanitize_agent_message_name(assistant_id),
     ).with_config(config)
     return agent, composite_backend

{deepagents_code-0.1.13 → deepagents_code-0.1.14}/deepagents_code/app.py

@@ -1941,6 +1941,19 @@ class DeepAgentsApp(App):
         the meaningless `(_connecting=False, _reconnecting=True)` state.
         """
 
+        self._resuming = self._connecting and self._resume_thread_intent is not None
+        """True while the initial connect is resuming a thread (`-r`).
+
+        Lets the status bar label the spinner "Resuming" instead of the generic
+        "Connecting" during `-r` startup. Only meaningful while `_connecting` is
+        `True`; `_sync_status_connection` resets it to `False` whenever it
+        observes `_connecting` cleared.
+
+        Set once at init and never re-armed, since `_resume_thread_intent` is
+        consumed on the first connect — so unlike `_reconnecting` it needs no
+        caller-side reset discipline.
+        """
+
         self._server_startup_error: str | None = None
         """Set when the background server fails to start; persists for the
         session lifetime (server failure is terminal).
@@ -4158,6 +4171,10 @@ class DeepAgentsApp(App):
         then persists the result so subsequent calls stay local. The
         update-available hint reads `self._update_available`, which
         reflects the last completed background check.
+
+        Editable installs additionally surface the source path and the
+        resolved versions of the core LangChain-ecosystem dependencies, which
+        helps diagnose local checkouts.
         """
         from importlib.metadata import (
             PackageNotFoundError,
@@ -4191,6 +4208,22 @@ class DeepAgentsApp(App):
             logger.warning("Unexpected error looking up SDK version", exc_info=True)
             lines.append("deepagents (SDK) version: unknown")
 
+        editable = False
+        try:
+            from deepagents_code.config import (
+                _get_editable_install_path,
+                _is_editable_install,
+            )
+
+            editable = await asyncio.to_thread(_is_editable_install)
+            if editable:
+                path = _get_editable_install_path()
+                lines.append(
+                    f"Editable install: {path}" if path else "Editable install"
+                )
+        except Exception:
+            logger.warning("Unexpected error detecting editable install", exc_info=True)
+
         available, latest = self._update_available
         if available and latest:
             try:
@@ -4210,6 +4243,19 @@ class DeepAgentsApp(App):
 
         await self._mount_message(AppMessage("\n".join(lines)))
 
+        if editable:
+            try:
+                from deepagents_code.extras_info import format_core_dependencies
+
+                core_markdown = format_core_dependencies()
+            except Exception:
+                logger.warning(
+                    "Failed to collect core dependency versions", exc_info=True
+                )
+                core_markdown = ""
+            if core_markdown:
+                await self._mount_message(AppMessage(core_markdown, markdown=True))
+
         try:
             from deepagents_code.extras_info import (
                 format_extras_status,
@@ -4292,6 +4338,7 @@ class DeepAgentsApp(App):
             self._reconnecting = False
         if not self._connecting:
             self._defer_connection_status_display = False
+            self._resuming = False
             self._cancel_connection_status_reveal_timer()
             self._status_bar.set_connection("")
         elif self._defer_connection_status_display:
@@ -4299,6 +4346,8 @@ class DeepAgentsApp(App):
             self._schedule_connection_status_reveal_timer()
         elif self._reconnecting:
             self._status_bar.set_connection("reconnecting")
+        elif self._resuming:
+            self._status_bar.set_connection("resuming")
         else:
             self._status_bar.set_connection("connecting")
 
@@ -8612,6 +8661,7 @@ class DeepAgentsApp(App):
         """
         if self._chat_input is None:
             return
+        self._chat_input._notify_app_focus()
         self._chat_input.set_cursor_blink(blink=self._cursor_blink_enabled)
         if isinstance(self.screen, ModalScreen):
             return
@@ -8628,6 +8678,7 @@ class DeepAgentsApp(App):
         """
         if self._chat_input is None:
             return
+        self._chat_input._notify_app_blur()
         self._chat_input.set_cursor_blink(blink=False)
 
     def on_click(self, event: Click) -> None:

{deepagents_code-0.1.13 → deepagents_code-0.1.14}/deepagents_code/config.py

@@ -552,6 +552,9 @@ ASCII_GLYPHS = Glyphs(
 _glyphs_cache: Glyphs | None = None
 """Module-level cache for detected glyphs."""
 
+_charset_mode_cache: CharsetMode | None = None
+"""Module-level cache for the detected charset mode."""
+
 _editable_cache: tuple[bool, str | None] | None = None
 """Module-level cache for editable install info: (is_editable, source_path)."""
 
@@ -624,7 +627,20 @@ def _get_editable_install_path() -> str | None:
 
 
 def _detect_charset_mode() -> CharsetMode:
-    """Auto-detect terminal charset capabilities.
+    """Auto-detect terminal charset capabilities (cached for the process).
+
+    Returns:
+        The detected CharsetMode based on environment and terminal encoding.
+    """
+    global _charset_mode_cache  # noqa: PLW0603  # Module-level cache requires global statement
+    if _charset_mode_cache is not None:
+        return _charset_mode_cache
+    _charset_mode_cache = _compute_charset_mode()
+    return _charset_mode_cache
+
+
+def _compute_charset_mode() -> CharsetMode:
+    """Compute terminal charset capabilities from environment and encoding.
 
     Returns:
         The detected CharsetMode based on environment and terminal encoding.
@@ -663,9 +679,10 @@ def get_glyphs() -> Glyphs:
 
 
 def reset_glyphs_cache() -> None:
-    """Reset the glyphs cache (for testing)."""
-    global _glyphs_cache  # noqa: PLW0603  # Module-level cache requires global statement
+    """Reset the glyphs and charset-mode caches (for testing)."""
+    global _glyphs_cache, _charset_mode_cache  # noqa: PLW0603  # Module-level caches require global statement
     _glyphs_cache = None
+    _charset_mode_cache = None
 
 
 def is_ascii_mode() -> bool:
@@ -809,34 +826,25 @@ def build_stream_config(
 ) -> RunnableConfig:
     """Build the LangGraph stream config dict.
 
-    Injects dcode and SDK versions into `metadata["versions"]` so LangSmith traces
-    can be correlated with specific releases.
-
-    Why dcode sets *both* versions:
-
-    * `create_deep_agent` bakes `versions: {"deepagents": "X.Y.Z"}` into the
-        compiled graph via `with_config`. At stream time, LangGraph merges
-        the graph config with the runtime config passed here. Because the
-        metadata merge is shallow (effectively `{**graph_meta, **runtime_meta}`
-        for top-level keys), both configs containing a `versions` key means
-        the runtime dict **replaces** the graph dict entirely — the SDK
-        version would be lost.
-    * Including the SDK version here ensures it survives the merge.
+    Injects the dcode version into `metadata["versions"]` so LangSmith traces
+    can be correlated with specific releases. `create_deep_agent` supplies the
+    SDK version through the compiled graph config, and LangChain merges nested
+    metadata dictionaries so both versions survive at stream time.
 
     Includes `ls_integration` metadata so LangSmith traces originating from
     the app are distinguishable from bare SDK usage.
 
     Args:
         thread_id: The app session thread identifier.
-        assistant_id: The agent/assistant identifier, if any.
+        assistant_id: The dcode agent identifier, if any. When set, it is
+            surfaced in trace metadata under `dcode_agent_name` and
+            `agent_name`.
         sandbox_type: Sandbox provider name for trace metadata, or `None` if no
             sandbox is active.
 
     Returns:
         Config dict with `configurable` and `metadata` keys.
     """
-    import contextlib
-    import importlib.metadata as importlib_metadata
     from datetime import UTC, datetime
 
     try:
@@ -845,13 +853,8 @@ def build_stream_config(
         logger.warning("Could not determine working directory", exc_info=True)
         cwd = ""
 
-    # Include SDK version alongside dcode version — see docstring for why.
-    versions: dict[str, str] = {"deepagents-code": __version__}
-    with contextlib.suppress(importlib_metadata.PackageNotFoundError):
-        versions["deepagents"] = importlib_metadata.version("deepagents")
-
     metadata: dict[str, Any] = {
-        "versions": versions,
+        "versions": {"deepagents-code": __version__},
         "ls_integration": "deepagents-code",
     }
     from deepagents_code._env_vars import USER_ID
@@ -864,7 +867,7 @@ def build_stream_config(
     if assistant_id:
         metadata.update(
             {
-                "assistant_id": assistant_id,
+                "dcode_agent_name": assistant_id,
                 "agent_name": assistant_id,
                 "updated_at": datetime.now(UTC).isoformat(),
             }

{deepagents_code-0.1.13 → deepagents_code-0.1.14}/deepagents_code/extras_info.py

@@ -409,6 +409,85 @@ def format_extras_status_plain(status: ExtrasStatus) -> str:
     return "\n".join(lines)
 
 
+CORE_DEPENDENCIES: tuple[str, ...] = (
+    "langchain",
+    "langchain-core",
+    "langgraph",
+    "langgraph-checkpoint",
+    "langgraph-prebuilt",
+    "langgraph-sdk",
+    "langsmith",
+)
+"""Core LangChain-ecosystem packages surfaced for editable installs.
+
+The deepagents SDK is reported separately by `/version`, so it is omitted
+here. These are the packages a local checkout is most likely to pin or
+override, so their resolved versions help diagnose editable environments.
+"""
+
+
+def get_core_dependency_versions() -> list[tuple[str, str | None]]:
+    """Return `(package, version)` pairs for the core ecosystem dependencies.
+
+    Returns:
+        One entry per package in `CORE_DEPENDENCIES`, in declaration order.
+            The version is `None` when the package is not installed.
+    """
+    versions: list[tuple[str, str | None]] = []
+    for name in CORE_DEPENDENCIES:
+        try:
+            versions.append((name, pkg_version(name)))
+        except PackageNotFoundError:
+            versions.append((name, None))
+    return versions
+
+
+def format_core_dependencies_plain() -> str:
+    """Render core ecosystem dependency versions as column-aligned plain text.
+
+    Suitable for stdout in non-interactive contexts (e.g. the `--version`
+    CLI flag) where a markdown renderer is unavailable.
+
+    Returns:
+        Multi-line string with a heading and one `package  version` row per
+            core dependency. Missing packages are reported as `not installed`.
+    """
+    rows = [
+        (name, version or "not installed")
+        for name, version in get_core_dependency_versions()
+    ]
+    package_width = max(len(name) for name, _ in rows)
+    lines = ["Core dependencies:"]
+    lines.extend(f"  {name.ljust(package_width)}  {version}" for name, version in rows)
+    return "\n".join(lines)
+
+
+def format_core_dependencies() -> str:
+    """Render core ecosystem dependency versions as a markdown fragment.
+
+    Returns:
+        Multi-line markdown string with a heading and a pipe table listing
+            each core package and its resolved version (or `not installed`).
+    """
+    rows = [
+        (name, version or "not installed")
+        for name, version in get_core_dependency_versions()
+    ]
+    headers = ("Package", "Version")
+
+    def _row(cells: tuple[str, str]) -> str:
+        return "| " + " | ".join(cells) + " |"
+
+    lines = [
+        "### Core dependencies",
+        "",
+        _row(headers),
+        "| " + " | ".join("---" for _ in headers) + " |",
+        *(_row(row) for row in rows),
+    ]
+    return "\n".join(lines)
+
+
 def format_extras_status(status: ExtrasStatus) -> str:
     """Render an `ExtrasStatus` mapping as a markdown fragment.
 

{deepagents_code-0.1.13 → deepagents_code-0.1.14}/deepagents_code/local_context.py

@@ -602,9 +602,13 @@ DETECT_CONTEXT_SCRIPT = build_detect_script()
 class LocalContextState(AgentState):
     """State for local context middleware."""
 
-    local_context: NotRequired[str]
-    """Formatted local context: cwd, project, package managers,
-    runtimes, git, test command, files, tree, Makefile.
+    _local_context: NotRequired[Annotated[str, PrivateStateAttr]]
+    """Private formatted local context cached for prompt injection.
+
+    The context is intentionally stored in private state rather than recomputed
+    before every model call: volatile sections such as git status, file lists,
+    and directory trees would otherwise churn the system prompt and reduce
+    provider prompt-cache hits across a conversation.
     """
 
     _local_context_refreshed_at_cutoff: NotRequired[Annotated[int, PrivateStateAttr]]
@@ -742,9 +746,9 @@ class LocalContextMiddleware(AgentMiddleware):
             runtime: Runtime context.
 
         Returns:
-            State update with `local_context` populated on success. On a
+            State update with `_local_context` populated on success. On a
                 post-summarization refresh failure, returns a state update
-                recording the cutoff (without `local_context`) to prevent
+                recording the cutoff (without `_local_context`) to prevent
                 retry loops.
 
                 Returns `None` if context is already set and no refresh is
@@ -764,20 +768,20 @@ class LocalContextMiddleware(AgentMiddleware):
                 output = self._run_detect_script()
                 if output:
                     return {
-                        "local_context": output,
+                        "_local_context": output,
                         "_local_context_refreshed_at_cutoff": cutoff,
                     }
                 # Script failed — record cutoff to avoid retry loop,
-                # keep existing local_context.
+                # keep existing `_local_context`.
                 return {"_local_context_refreshed_at_cutoff": cutoff}
 
         # --- Initial detection (first invocation) ---
-        if state.get("local_context"):
+        if state.get("_local_context"):
             return None
 
         output = self._run_detect_script()
         if output:
-            return {"local_context": output}
+            return {"_local_context": output}
         return None
 
     async def _arun_detect_script(self) -> str | None:
@@ -832,9 +836,9 @@ class LocalContextMiddleware(AgentMiddleware):
             runtime: Runtime context.
 
         Returns:
-            State update with `local_context` populated on success. On a
+            State update with `_local_context` populated on success. On a
                 post-summarization refresh failure, returns a state update
-                recording the cutoff (without `local_context`) to prevent
+                recording the cutoff (without `_local_context`) to prevent
                 retry loops.
 
                 Returns `None` if context is already set and no refresh is
@@ -849,17 +853,17 @@ class LocalContextMiddleware(AgentMiddleware):
                 output = await self._arun_detect_script()
                 if output:
                     return {
-                        "local_context": output,
+                        "_local_context": output,
                         "_local_context_refreshed_at_cutoff": cutoff,
                     }
                 return {"_local_context_refreshed_at_cutoff": cutoff}
 
-        if state.get("local_context"):
+        if state.get("_local_context"):
             return None
 
         output = await self._arun_detect_script()
         if output:
-            return {"local_context": output}
+            return {"_local_context": output}
         return None
 
     def _get_modified_request(self, request: ModelRequest) -> ModelRequest | None:
@@ -872,7 +876,7 @@ class LocalContextMiddleware(AgentMiddleware):
             Modified request with context appended, or `None`.
         """
         state = cast("LocalContextState", request.state)
-        local_context = state.get("local_context", "")
+        local_context = state.get("_local_context", "")
 
         parts = [
             p for p in (local_context, self._tracing_context, self._mcp_context) if p