deepagents-cli 0.1.0__tar.gz → 0.1.2__tar.gz

{deepagents_cli-0.1.0 → deepagents_cli-0.1.2}/.gitignore

@@ -138,6 +138,8 @@ celerybeat.pid
 # Environments
 .env
 .envrc
+env.local
+*.env.local
 .venv
 env/
 venv/

{deepagents_cli-0.1.0 → deepagents_cli-0.1.2}/CHANGELOG.md

@@ -3,6 +3,18 @@
 From 0.1.0 onward, `deepagents-cli` only contains `deploy`, `dev`, and `init`.
 The coding agent (interactive TUI & headless CLI) moved to [`deepagents-code`](https://github.com/langchain-ai/deepagents/blob/main/libs/code/CHANGELOG.md).
 
+## [0.1.2](https://github.com/langchain-ai/deepagents/compare/deepagents-cli==0.1.1...deepagents-cli==0.1.2) (2026-05-21)
+
+### Bug Fixes
+
+* Expand `${VAR}` in `mcp.json` header values ([#3523](https://github.com/langchain-ai/deepagents/issues/3523)) ([6cfc5f9](https://github.com/langchain-ai/deepagents/commit/6cfc5f9004271c23c486a0b05e8f9f0002e75e2b))
+
+## [0.1.1](https://github.com/langchain-ai/deepagents/compare/deepagents-cli==0.1.0...deepagents-cli==0.1.1) (2026-05-18)
+
+### Features
+
+* Add `--host` option to `deepagents dev` command ([#3444](https://github.com/langchain-ai/deepagents/issues/3444)) ([0bb1e74](https://github.com/langchain-ai/deepagents/commit/0bb1e74bba8097b38f204e3db6e6ebad7e0f5317))
+
 ## [0.1.0](https://github.com/langchain-ai/deepagents/compare/deepagents-cli==0.0.59...deepagents-cli==0.1.0) (2026-05-16)
 
 ### ⚠ BREAKING CHANGES

{deepagents_cli-0.1.0 → deepagents_cli-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepagents-cli
-Version: 0.1.0
+Version: 0.1.2
 Summary: Deployment tooling for Deep Agents - bundle, run, and ship agents to LangGraph Platform.
 Project-URL: Homepage, https://docs.langchain.com/oss/python/deepagents/overview
 Project-URL: Documentation, https://reference.langchain.com/python/deepagents/
@@ -55,6 +55,14 @@ Description-Content-Type: text/markdown
 [![PyPI - Downloads](https://img.shields.io/pepy/dt/deepagents-cli)](https://pypistats.org/packages/deepagents-cli)
 [![Twitter](https://img.shields.io/twitter/url/https/twitter.com/langchain_oss.svg?style=social&label=Follow%20%40LangChain)](https://x.com/langchain_oss)
 
+> [!IMPORTANT]
+> **The interactive coding agent moved.** As of `deepagents-cli==0.1.0`, this package contains only the deployment subcommands (`init`, `dev`, `deploy`). The interactive REPL — previously launched via `deepagents` — now ships as [`deepagents-code`](https://docs.langchain.com/oss/python/deepagents/code/overview) (`dcode`).
+>
+> ```bash
+> curl -LsSf https://langch.in/dcode | bash
+> dcode
+> ```
+
 ## Install
 
 ```bash

{deepagents_cli-0.1.0 → deepagents_cli-0.1.2}/README.md

@@ -5,6 +5,14 @@
 [![PyPI - Downloads](https://img.shields.io/pepy/dt/deepagents-cli)](https://pypistats.org/packages/deepagents-cli)
 [![Twitter](https://img.shields.io/twitter/url/https/twitter.com/langchain_oss.svg?style=social&label=Follow%20%40LangChain)](https://x.com/langchain_oss)
 
+> [!IMPORTANT]
+> **The interactive coding agent moved.** As of `deepagents-cli==0.1.0`, this package contains only the deployment subcommands (`init`, `dev`, `deploy`). The interactive REPL — previously launched via `deepagents` — now ships as [`deepagents-code`](https://docs.langchain.com/oss/python/deepagents/code/overview) (`dcode`).
+>
+> ```bash
+> curl -LsSf https://langch.in/dcode | bash
+> dcode
+> ```
+
 ## Install
 
 ```bash

{deepagents_cli-0.1.0 → deepagents_cli-0.1.2}/deepagents_cli/_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.0"  # x-release-please-version
+__version__ = "0.1.2"  # x-release-please-version
 
 DOCS_URL = "https://docs.langchain.com/oss/python/deepagents/cli"
 """URL for `deepagents-cli` documentation."""

{deepagents_cli-0.1.0 → deepagents_cli-0.1.2}/deepagents_cli/deploy/commands.py

@@ -84,6 +84,15 @@ def setup_deploy_parsers(
         default=True,
         help="Pass --allow-blocking to langgraph dev (default: enabled)",
     )
+    dev_parser.add_argument(
+        "--host",
+        type=str,
+        default="127.0.0.1",
+        help=(
+            "Network interface to bind the dev server "
+            "(default: 127.0.0.1; use 0.0.0.0 for all interfaces)"
+        ),
+    )
 
     # deepagents deploy
     deploy_parser = subparsers.add_parser(
@@ -138,6 +147,7 @@ def execute_dev_command(args: argparse.Namespace) -> None:
     _dev(
         config_path=args.config,
         port=args.port,
+        host=args.host,
         allow_blocking=args.allow_blocking,
     )
 
@@ -343,6 +353,7 @@ def _dev(
     *,
     config_path: str | None,
     port: int,
+    host: str = "127.0.0.1",
     allow_blocking: bool,
 ) -> None:
     """Bundle the project and run a local `langgraph dev` server.
@@ -356,6 +367,7 @@ def _dev(
     Args:
         config_path: Path to `deepagents.toml`, or `None` for default.
         port: Local port for the dev server.
+        host: Network interface to bind (default: 127.0.0.1).
         allow_blocking: Pass `--allow-blocking` to `langgraph dev` so
             sync HTTP calls inside the graph (e.g. the LangSmith sandbox
             client) don't trigger blockbuster errors.
@@ -413,13 +425,21 @@ def _dev(
             "langgraph",
             "dev",
             "--no-browser",
+            "--host",
+            host,
             "--port",
             str(port),
         ]
         if allow_blocking:
             cmd.append("--allow-blocking")
 
-        print(f"\nStarting langgraph dev on http://localhost:{port}")
+        if host == "0.0.0.0":
+            print(
+                f"\nStarting langgraph dev on http://localhost:{port} "
+                "(bound to 0.0.0.0)"
+            )
+        else:
+            print(f"\nStarting langgraph dev on http://{host}:{port}")
         print(f"Build directory: {build_dir}")
         print(f"Running: {' '.join(cmd)}\n")
 

{deepagents_cli-0.1.0 → deepagents_cli-0.1.2}/deepagents_cli/deploy/templates.py

@@ -409,10 +409,28 @@ AUTH_BLOCKS: dict[str, tuple[str, str | None]] = {
 
 MCP_TOOLS_TEMPLATE = '''\
 async def _load_mcp_tools():
-    """Load MCP tools from bundled config (http/sse only)."""
+    """Load MCP tools from bundled config (http/sse only).
+
+    The `url` and `headers` values support `${VAR}` references which are
+    expanded against `os.environ` when the deployed graph loads. This
+    mirrors the substitution behavior documented for `deepagents-code`'s
+    `.mcp.json` (https://docs.langchain.com/oss/python/deepagents/code/mcp-tools).
+    Unset variables are left as the literal `${VAR}` so the resulting auth
+    failure surfaces a recognizable token rather than an empty header.
+    """
     import json
+    import os
+    import re
     from pathlib import Path
 
+    def _expand(value):
+        """Expand `${VAR}` references in strings; pass other types through."""
+        if isinstance(value, str):
+            return os.path.expandvars(value)
+        return value
+
+    unresolved_re = re.compile(r"\\$\\{[^}]+\\}")
+
     mcp_path = Path(__file__).parent / "_mcp.json"
     if not mcp_path.exists():
         return []
@@ -428,9 +446,23 @@ async def _load_mcp_tools():
     for name, cfg in servers.items():
         transport = cfg.get("type", cfg.get("transport", "stdio"))
         if transport in ("http", "sse"):
-            conn = {"transport": transport, "url": cfg["url"]}
+            conn = {"transport": transport, "url": _expand(cfg["url"])}
             if "headers" in cfg:
-                conn["headers"] = cfg["headers"]
+                conn["headers"] = {
+                    k: _expand(v) for k, v in cfg["headers"].items()
+                }
+            unresolved = sorted({
+                match
+                for value in (conn["url"], *conn.get("headers", {}).values())
+                if isinstance(value, str)
+                for match in unresolved_re.findall(value)
+            })
+            if unresolved:
+                logger.warning(
+                    "MCP server %r has unresolved environment reference(s): %s",
+                    name,
+                    ", ".join(unresolved),
+                )
             connections[name] = conn
 
     if not connections:
@@ -441,11 +473,10 @@ async def _load_mcp_tools():
 
         client = MultiServerMCPClient(connections)
         return await client.get_tools()
-    except Exception as exc:  # noqa: BLE001
-        logger.warning(
-            "Failed to load MCP tools from %d server(s): %s",
+    except Exception:
+        logger.exception(
+            "Failed to load MCP tools from %d server(s)",
             len(connections),
-            exc,
         )
         return []
 '''

{deepagents_cli-0.1.0 → deepagents_cli-0.1.2}/frontend/package-lock.json

@@ -6091,9 +6091,9 @@
       }
     },
     "node_modules/ws": {
-      "version": "8.20.0",
-      "resolved": "https://registry.npmjs.org/ws/-/ws-8.20.0.tgz",
-      "integrity": "sha512-sAt8BhgNbzCtgGbt2OxmpuryO63ZoDk/sqaB/znQm94T4fCEsy/yV+7CdC1kJhOU9lboAEU7R3kquuycDoibVA==",
+      "version": "8.20.1",
+      "resolved": "https://registry.npmjs.org/ws/-/ws-8.20.1.tgz",
+      "integrity": "sha512-It4dO0K5v//JtTXuPkfEOaI3uUN87iYPnqo/ZzqCoG3g8uhA66QUMs/SrM0YK7/NAu+r4LMh/9dq2A7k+rHs+w==",
       "license": "MIT",
       "engines": {
         "node": ">=10.0.0"

{deepagents_cli-0.1.0 → deepagents_cli-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "deepagents-cli"
-version = "0.1.0"
+version = "0.1.2"
 description = "Deployment tooling for Deep Agents - bundle, run, and ship agents to LangGraph Platform."
 readme = "README.md"
 license = { text = "MIT" }

{deepagents_cli-0.1.0 → deepagents_cli-0.1.2}/tests/unit_tests/deploy/test_bundler.py

@@ -2,7 +2,11 @@
 
 from __future__ import annotations
 
+import asyncio
 import json
+import logging
+import sys
+import types
 from typing import TYPE_CHECKING
 
 import pytest
@@ -207,6 +211,87 @@ class TestRenderDeployGraph:
         assert "_load_mcp_tools" not in result
         assert "pass  # no MCP servers configured" in result
 
+    def test_mcp_loader_expands_env_vars(
+        self,
+        tmp_path: Path,
+        monkeypatch: pytest.MonkeyPatch,
+        caplog: pytest.LogCaptureFixture,
+    ) -> None:
+        """Emitted loader expands `${VAR}` in url + headers before MCP connect.
+
+        Mirrors the `${VAR}` substitution behavior of `deepagents-code`'s
+        `.mcp.json`. Without this, headers like
+        `Authorization: Bearer ${TOKEN}` reach MCP servers as the literal
+        string and auth fails silently.
+
+        Also verifies the documented contracts: unset references are left as
+        literal `${VAR}` so a recognizable token surfaces, non-string header
+        values pass through unchanged, and unresolved tokens emit a warning.
+        """
+        from deepagents_cli.deploy.templates import MCP_TOOLS_TEMPLATE
+
+        captured: dict[str, dict] = {}
+
+        class _FakeClient:
+            def __init__(self, connections: dict) -> None:
+                captured["connections"] = connections
+
+            async def get_tools(self) -> list:
+                return []
+
+        fake_root = types.ModuleType("langchain_mcp_adapters")
+        fake_client = types.ModuleType("langchain_mcp_adapters.client")
+        fake_client.MultiServerMCPClient = _FakeClient  # type: ignore[attr-defined]
+        monkeypatch.setitem(sys.modules, "langchain_mcp_adapters", fake_root)
+        monkeypatch.setitem(sys.modules, "langchain_mcp_adapters.client", fake_client)
+
+        (tmp_path / "_mcp.json").write_text(
+            json.dumps(
+                {
+                    "mcpServers": {
+                        "primary": {
+                            "type": "http",
+                            "url": "https://api.example.com/${ENDPOINT}",
+                            "headers": {
+                                "Authorization": "Bearer ${TOKEN}",
+                                "X-Unset": "value-${MISSING_VAR}",
+                                "X-Numeric": 42,
+                            },
+                        },
+                    },
+                },
+            ),
+            encoding="utf-8",
+        )
+
+        monkeypatch.setenv("ENDPOINT", "v1/chat")
+        monkeypatch.setenv("TOKEN", "secret-abc")
+        monkeypatch.delenv("MISSING_VAR", raising=False)
+
+        loader_logger = logging.getLogger("test_mcp_loader")
+        namespace: dict = {
+            "__file__": str(tmp_path / "graph.py"),
+            "logger": loader_logger,
+        }
+        exec(
+            compile(MCP_TOOLS_TEMPLATE, "<MCP_TOOLS_TEMPLATE>", "exec"),
+            namespace,
+        )
+
+        with caplog.at_level(logging.WARNING, logger="test_mcp_loader"):
+            asyncio.run(namespace["_load_mcp_tools"]())
+
+        conn = captured["connections"]["primary"]
+        assert conn["url"] == "https://api.example.com/v1/chat"
+        assert conn["headers"]["Authorization"] == "Bearer secret-abc"
+        assert conn["headers"]["X-Unset"] == "value-${MISSING_VAR}"
+        assert conn["headers"]["X-Numeric"] == 42
+        assert any(
+            "unresolved environment reference" in rec.getMessage()
+            and "${MISSING_VAR}" in rec.getMessage()
+            for rec in caplog.records
+        )
+
     def test_no_system_prompt_in_output(self) -> None:
         """AGENTS.md should not be baked into the deploy graph as a system prompt."""
         config = _minimal_config()

{deepagents_cli-0.1.0 → deepagents_cli-0.1.2}/tests/unit_tests/deploy/test_commands.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import argparse
 from types import SimpleNamespace
 from typing import TYPE_CHECKING, cast
 
@@ -197,3 +198,30 @@ class TestAutoWireIssuesBoard:
         _auto_wire_issues_board_if_hub(cast("DeployConfig", cfg))
 
         assert observed["context_hub_repo_handle"] == "custom-agent"
+
+
+class TestDevParserHost:
+    """Test argparse wiring for the `deepagents dev --host` flag."""
+
+    def _build_parser(self) -> argparse.ArgumentParser:
+        from deepagents_cli.deploy.commands import setup_deploy_parsers
+
+        class _NoopAction(argparse.Action):
+            def __call__(self, *_args: object, **_kwargs: object) -> None:
+                return
+
+        parser = argparse.ArgumentParser()
+        subparsers = parser.add_subparsers(dest="command")
+        setup_deploy_parsers(
+            subparsers,
+            make_help_action=lambda _printer: _NoopAction,
+        )
+        return parser
+
+    def test_host_defaults_to_loopback(self) -> None:
+        args = self._build_parser().parse_args(["dev"])
+        assert args.host == "127.0.0.1"
+
+    def test_host_accepts_all_interfaces(self) -> None:
+        args = self._build_parser().parse_args(["dev", "--host", "0.0.0.0"])
+        assert args.host == "0.0.0.0"

{deepagents_cli-0.1.0 → deepagents_cli-0.1.2}/uv.lock

@@ -792,7 +792,7 @@ wheels = [
 
 [[package]]
 name = "deepagents"
-version = "0.6.1"
+version = "0.6.3"
 source = { editable = "../deepagents" }
 dependencies = [
     { name = "langchain" },
@@ -836,7 +836,7 @@ test = [
 
 [[package]]
 name = "deepagents-cli"
-version = "0.1.0"
+version = "0.1.2"
 source = { editable = "." }
 dependencies = [
     { name = "deepagents" },
@@ -1399,11 +1399,11 @@ wheels = [
 
 [[package]]
 name = "idna"
-version = "3.11"
+version = "3.15"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/6f/6d/0703ccc57f3a7233505399edb88de3cbd678da106337b9fcde432b65ed60/idna-3.11.tar.gz", hash = "sha256:795dafcc9c04ed0c1fb032c2aa73654d8e8c5023a7df64a53f39190ada629902", size = 194582, upload-time = "2025-10-12T14:55:20.501Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/82/77/7b3966d0b9d1d31a36ddf1746926a11dface89a83409bf1483f0237aa758/idna-3.15.tar.gz", hash = "sha256:ca962446ea538f7092a95e057da437618e886f4d349216d2b1e294abfdb65fdc", size = 199245, upload-time = "2026-05-12T22:45:57.011Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/0e/61/66938bbb5fc52dbdf84594873d5b51fb1f7c7794e9c0f5bd885f30bc507b/idna-3.11-py3-none-any.whl", hash = "sha256:771a87f49d9defaf64091e6e6fe9c18d4833f140bd19464795bc32d966ca37ea", size = 71008, upload-time = "2025-10-12T14:55:18.883Z" },
+    { url = "https://files.pythonhosted.org/packages/d2/23/408243171aa9aaba178d3e2559159c24c1171a641aa83b67bdd3394ead8e/idna-3.15-py3-none-any.whl", hash = "sha256:048adeaf8c2d788c40fee287673ccaa74c24ffd8dcf09ffa555a2fbb59f10ac8", size = 72340, upload-time = "2026-05-12T22:45:55.733Z" },
 ]
 
 [[package]]