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

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

@@ -1,7 +1,26 @@
+<!-- markdownlint-disable MD024 -->
+
 # Deep Agents CLI Changelog
 
-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).
+From 0.2.0 onward, `deepagents-cli` exposes `init`, `deploy`, `agents`, and `mcp-servers` against the Managed Deep Agents `/v1/deepagents/*` API. The coding agent (interactive TUI & headless CLI) moved to [`deepagents-code`](https://github.com/langchain-ai/deepagents/blob/main/libs/code/CHANGELOG.md).
+
+## [0.2.1](https://github.com/langchain-ai/deepagents/compare/deepagents-cli==0.2.0...deepagents-cli==0.2.1) (2026-06-03)
+
+* Version bumps
+
+## [0.2.0](https://github.com/langchain-ai/deepagents/compare/deepagents-cli==0.1.2...deepagents-cli==0.2.0) (2026-06-01)
+
+### ⚠ BREAKING CHANGES
+
+* `deepagents deploy` now targets the Managed Deep Agents API; `deepagents dev`, `deepagents.toml`, and the `--config`/`--dry-run` flags are removed. Run `deepagents init` to re-scaffold (`agent.json` + `tools.json`). See [PR](https://github.com/langchain-ai/deepagents/pull/3609) for the full migration guide.
+
+### Features
+
+* Migrate `deepagents deploy` to use Managed Deep Agents API ([#3609](https://github.com/langchain-ai/deepagents/issues/3609)) ([72aef52](https://github.com/langchain-ai/deepagents/commit/72aef52542a3fd4a7eebcb3dba40e28adf1aa044))
+
+### Bug Fixes
+
+* Stable `HumanMessage` IDs across resumed threads ([#3591](https://github.com/langchain-ai/deepagents/issues/3591)) ([82c3194](https://github.com/langchain-ai/deepagents/commit/82c31947f9dc938ffc71e1cea96d162a39aec3a1))
 
 ## [0.1.2](https://github.com/langchain-ai/deepagents/compare/deepagents-cli==0.1.1...deepagents-cli==0.1.2) (2026-05-21)
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepagents-cli
-Version: 0.1.2
+Version: 0.2.1
 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/
@@ -24,28 +24,13 @@ Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: <4.0,>=3.11
-Requires-Dist: deepagents>=0.6.1
+Requires-Dist: deepagents>=0.6.8
 Requires-Dist: httpx<1.0.0,>=0.28.1
-Requires-Dist: langchain<2.0.0,>=1.3.0
-Requires-Dist: langgraph-cli[inmem]<1.0.0,>=0.4.24
-Requires-Dist: langgraph-runtime-inmem<1.0.0,>=0.28.1
-Requires-Dist: langgraph-sdk<1.0.0,>=0.3.13
-Requires-Dist: langgraph<2.0.0,>=1.2.0
-Requires-Dist: langsmith>=0.8.0
+Requires-Dist: langchain<2.0.0,>=1.3.4
+Requires-Dist: langgraph-sdk<1.0.0,>=0.4.2
+Requires-Dist: langgraph<2.0.0,>=1.2.4
+Requires-Dist: langsmith>=0.8.9
 Requires-Dist: python-dotenv<2.0.0,>=1.2.2
-Provides-Extra: agentcore
-Requires-Dist: langchain-agentcore-codeinterpreter>=0.0.2; extra == 'agentcore'
-Provides-Extra: all-sandboxes
-Requires-Dist: langchain-agentcore-codeinterpreter>=0.0.2; extra == 'all-sandboxes'
-Requires-Dist: langchain-daytona>=0.0.5; extra == 'all-sandboxes'
-Requires-Dist: langchain-modal>=0.0.3; extra == 'all-sandboxes'
-Requires-Dist: langchain-runloop>=0.0.4; extra == 'all-sandboxes'
-Provides-Extra: daytona
-Requires-Dist: langchain-daytona>=0.0.5; extra == 'daytona'
-Provides-Extra: modal
-Requires-Dist: langchain-modal>=0.0.3; extra == 'modal'
-Provides-Extra: runloop
-Requires-Dist: langchain-runloop>=0.0.4; extra == 'runloop'
 Description-Content-Type: text/markdown
 
 # Deep Agents CLI — Deployment Tooling
@@ -56,7 +41,7 @@ Description-Content-Type: text/markdown
 [![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`).
+> **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/deepagents-code) (`dcode`).
 >
 > ```bash
 > curl -LsSf https://langch.in/dcode | bash
@@ -69,10 +54,13 @@ Description-Content-Type: text/markdown
 uv tool install deepagents-cli
 ```
 
-Or with optional sandbox providers:
+You'll need a LangSmith API key with access to the Managed Deep Agents private
+preview ([waitlist](https://www.langchain.com/langsmith-managed-deep-agents-waitlist)).
+Export it before running any command, or put it in a repo `.env` or
+`~/.deepagents/.env`:
 
 ```bash
-uv tool install 'deepagents-cli[all-sandboxes]'
+export LANGSMITH_API_KEY="..."
 ```
 
 ## Usage
@@ -81,13 +69,64 @@ uv tool install 'deepagents-cli[all-sandboxes]'
 # Scaffold a new project folder
 deepagents init my-agent
 
-# Run a local langgraph dev server against the project
-cd my-agent && deepagents dev
+# Register any MCP servers you intend to use (one-time, per workspace)
+deepagents mcp-servers add --url https://tools.langchain.com \
+                            --header X-Api-Key=$LANGSMITH_API_KEY \
+                            --name Fleet
 
-# Bundle and ship to LangSmith Deployment
-deepagents deploy
+# init scaffolds an empty tools.json. Add tools that reference a registered
+# MCP server's URL (otherwise the agent has no tools), e.g. the Fleet server
+# registered above:
+#   { "name": "read_url_content", "mcp_server_url": "https://tools.langchain.com",
+#     "mcp_server_name": "Fleet", "display_name": "read_url_content" }
+
+# Upsert the project as a managed agent on /v1/deepagents/*
+cd my-agent && deepagents deploy
+```
+
+`deepagents init` scaffolds an empty `tools.json`, an example skill under
+`skills/`, and an example subagent under `subagents/`; edit or remove them to
+suit your agent. `tools.json` starts empty because every tool must reference an
+MCP server that is already registered in the workspace
+(`deepagents mcp-servers add`) — so a freshly scaffolded project deploys
+without first registering a server.
+
+New agents default to the `default` backend — switch `agent.json`'s
+`backend.type` to `thread_scoped_sandbox` (or `agent_scoped_sandbox`) to opt
+into a managed sandbox. The CLI does not create or run sandboxes locally;
+sandbox lifecycle is handled by the Managed Deep Agents platform.
+
+### Project layout
+
+```text
+my-agent/
+  agent.json              # name, description, backend, runtime.model, permissions
+  AGENTS.md               # system prompt
+  tools.json              # tools the agent can call (optional)
+  skills/<name>/SKILL.md  # frontmatter-tagged skills (optional)
+  subagents/<name>/       # delegated subagent definitions (optional)
+```
+
+### Other commands
+
+```bash
+deepagents agents list                  # list workspace agents
+deepagents agents get <agent_id>        # show one agent
+deepagents agents delete <agent_id>     # delete an agent
+
+deepagents mcp-servers list                  # list workspace MCP servers
+deepagents mcp-servers add --url URL          # register a server
+deepagents mcp-servers get <id|name|url>      # show one server
+deepagents mcp-servers tools <id|name|url>    # list a server's tools
+deepagents mcp-servers update <id|name|url>   # update server URL or headers
+deepagents mcp-servers delete <id|name|url>   # remove a server
+deepagents mcp-servers connect <id|name|url>  # start OAuth for a server
 ```
 
+`get`, `update`, `delete`, and `connect` accept an MCP server's id, exact name,
+or URL — a non-id value is resolved against `mcp-servers list` (URLs are matched
+ignoring case and trailing slash).
+
 ## 📖 Resources
 
 - **[CLI Documentation](https://docs.langchain.com/oss/python/deepagents/cli/overview)**

deepagents_cli-0.2.1/README.md

@@ -0,0 +1,111 @@
+# Deep Agents CLI — Deployment Tooling
+
+[![PyPI - Version](https://img.shields.io/pypi/v/deepagents-cli?label=%20)](https://pypi.org/project/deepagents-cli/#history)
+[![PyPI - License](https://img.shields.io/pypi/l/deepagents-cli)](https://opensource.org/licenses/MIT)
+[![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/deepagents-code) (`dcode`).
+>
+> ```bash
+> curl -LsSf https://langch.in/dcode | bash
+> dcode
+> ```
+
+## Install
+
+```bash
+uv tool install deepagents-cli
+```
+
+You'll need a LangSmith API key with access to the Managed Deep Agents private
+preview ([waitlist](https://www.langchain.com/langsmith-managed-deep-agents-waitlist)).
+Export it before running any command, or put it in a repo `.env` or
+`~/.deepagents/.env`:
+
+```bash
+export LANGSMITH_API_KEY="..."
+```
+
+## Usage
+
+```bash
+# Scaffold a new project folder
+deepagents init my-agent
+
+# Register any MCP servers you intend to use (one-time, per workspace)
+deepagents mcp-servers add --url https://tools.langchain.com \
+                            --header X-Api-Key=$LANGSMITH_API_KEY \
+                            --name Fleet
+
+# init scaffolds an empty tools.json. Add tools that reference a registered
+# MCP server's URL (otherwise the agent has no tools), e.g. the Fleet server
+# registered above:
+#   { "name": "read_url_content", "mcp_server_url": "https://tools.langchain.com",
+#     "mcp_server_name": "Fleet", "display_name": "read_url_content" }
+
+# Upsert the project as a managed agent on /v1/deepagents/*
+cd my-agent && deepagents deploy
+```
+
+`deepagents init` scaffolds an empty `tools.json`, an example skill under
+`skills/`, and an example subagent under `subagents/`; edit or remove them to
+suit your agent. `tools.json` starts empty because every tool must reference an
+MCP server that is already registered in the workspace
+(`deepagents mcp-servers add`) — so a freshly scaffolded project deploys
+without first registering a server.
+
+New agents default to the `default` backend — switch `agent.json`'s
+`backend.type` to `thread_scoped_sandbox` (or `agent_scoped_sandbox`) to opt
+into a managed sandbox. The CLI does not create or run sandboxes locally;
+sandbox lifecycle is handled by the Managed Deep Agents platform.
+
+### Project layout
+
+```text
+my-agent/
+  agent.json              # name, description, backend, runtime.model, permissions
+  AGENTS.md               # system prompt
+  tools.json              # tools the agent can call (optional)
+  skills/<name>/SKILL.md  # frontmatter-tagged skills (optional)
+  subagents/<name>/       # delegated subagent definitions (optional)
+```
+
+### Other commands
+
+```bash
+deepagents agents list                  # list workspace agents
+deepagents agents get <agent_id>        # show one agent
+deepagents agents delete <agent_id>     # delete an agent
+
+deepagents mcp-servers list                  # list workspace MCP servers
+deepagents mcp-servers add --url URL          # register a server
+deepagents mcp-servers get <id|name|url>      # show one server
+deepagents mcp-servers tools <id|name|url>    # list a server's tools
+deepagents mcp-servers update <id|name|url>   # update server URL or headers
+deepagents mcp-servers delete <id|name|url>   # remove a server
+deepagents mcp-servers connect <id|name|url>  # start OAuth for a server
+```
+
+`get`, `update`, `delete`, and `connect` accept an MCP server's id, exact name,
+or URL — a non-id value is resolved against `mcp-servers list` (URLs are matched
+ignoring case and trailing slash).
+
+## 📖 Resources
+
+- **[CLI Documentation](https://docs.langchain.com/oss/python/deepagents/cli/overview)**
+- **[Changelog](https://github.com/langchain-ai/deepagents/blob/main/libs/cli/CHANGELOG.md)**
+- **[Source code](https://github.com/langchain-ai/deepagents/tree/main/libs/cli)**
+- **[Deep Agents SDK](https://github.com/langchain-ai/deepagents)** — underlying agent harness
+- **[Deep Agents Code](https://pypi.org/project/deepagents-code/)** — coding agent
+
+## 📕 Releases & Versioning
+
+See our [Releases](https://docs.langchain.com/oss/python/release-policy) and [Versioning](https://docs.langchain.com/oss/python/versioning) policies.
+
+## 💁 Contributing
+
+As an open-source project in a rapidly developing field, we are extremely open to contributions, whether it be in the form of a new feature, improved infrastructure, or better documentation.
+
+For detailed information on how to contribute, see the [Contributing Guide](https://docs.langchain.com/oss/python/contributing/overview).

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

{deepagents_cli-0.1.2 → deepagents_cli-0.2.1}/deepagents_cli/config.py

@@ -3,10 +3,25 @@
 from __future__ import annotations
 
 import logging
+import os
 import sys
 from pathlib import Path
 
 logger = logging.getLogger(__name__)
+_PROJECT_DOTENV_BLOCKED_ENV_KEYS = (
+    "LANGSMITH_ENDPOINT",
+    "LANGCHAIN_ENDPOINT",
+    "HTTP_PROXY",
+    "HTTPS_PROXY",
+    "ALL_PROXY",
+    "NO_PROXY",
+    "http_proxy",
+    "https_proxy",
+    "all_proxy",
+    "no_proxy",
+    "SSL_CERT_FILE",
+    "SSL_CERT_DIR",
+)
 
 
 def _stderr(msg: str) -> None:
@@ -40,6 +55,30 @@ def _find_dotenv_from_start_path(start_path: Path) -> Path | None:
     return None
 
 
+def _snapshot_blocked_project_env() -> dict[str, str | None]:
+    return {key: os.environ.get(key) for key in _PROJECT_DOTENV_BLOCKED_ENV_KEYS}
+
+
+def _restore_env(snapshot: dict[str, str | None]) -> None:
+    for key, value in snapshot.items():
+        if value is None:
+            os.environ.pop(key, None)
+        else:
+            os.environ[key] = value
+
+
+def _warn_if_project_blocked_env_changed(snapshot: dict[str, str | None]) -> None:
+    changed = [key for key, value in snapshot.items() if os.environ.get(key) != value]
+    if not changed:
+        return
+    keys = ", ".join(sorted(changed))
+    _stderr(
+        f"ignoring {keys} from project .env. Set endpoint overrides in your "
+        "shell environment or ~/.deepagents/.env; proxy/TLS settings are "
+        "ignored for managed API requests.",
+    )
+
+
 try:
     _GLOBAL_DOTENV_PATH = Path.home() / ".deepagents" / ".env"
 except RuntimeError:
@@ -92,10 +131,12 @@ def _load_dotenv(*, start_path: Path) -> bool:
 
     dotenv_path = _find_dotenv_from_start_path(start_path)
     if dotenv_path is not None:
+        blocked_env = _snapshot_blocked_project_env()
         try:
             loaded = (
                 dotenv.load_dotenv(dotenv_path=dotenv_path, override=False) or loaded
             )
+            _warn_if_project_blocked_env_changed(blocked_env)
         except (OSError, ValueError) as exc:
             _stderr(
                 f"could not read project .env at {dotenv_path}: {exc}. "
@@ -107,6 +148,8 @@ def _load_dotenv(*, start_path: Path) -> bool:
                 dotenv_path,
                 exc_info=True,
             )
+        finally:
+            _restore_env(blocked_env)
 
     try:
         if _GLOBAL_DOTENV_PATH.is_file() and dotenv.load_dotenv(

deepagents_cli-0.2.1/deepagents_cli/deploy/__init__.py

@@ -0,0 +1,17 @@
+"""Deploy commands for the Managed Deep Agents (`/v1/deepagents/*`) surface."""
+
+from deepagents_cli.deploy.commands import (
+    execute_agents_command,
+    execute_deploy_command,
+    execute_init_command,
+    execute_mcp_servers_command,
+    setup_deploy_parsers,
+)
+
+__all__ = [
+    "execute_agents_command",
+    "execute_deploy_command",
+    "execute_init_command",
+    "execute_mcp_servers_command",
+    "setup_deploy_parsers",
+]