deepagents-cli 0.0.45__tar.gz → 0.0.47__tar.gz

{deepagents_cli-0.0.45 → deepagents_cli-0.0.47}/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## [0.0.47](https://github.com/langchain-ai/deepagents/compare/deepagents-cli==0.0.46...deepagents-cli==0.0.47) (2026-05-01)
+
+### Features
+
+* Auto-discover Textual built-in themes ([#3068](https://github.com/langchain-ai/deepagents/issues/3068)) ([27894e3](https://github.com/langchain-ai/deepagents/commit/27894e336f20f270fb4bb685bf979f24b9bea0bc))
+
+### Bug Fixes
+
+* Recover from failed server startup via `/model` ([#3056](https://github.com/langchain-ai/deepagents/issues/3056)) ([6ee375e](https://github.com/langchain-ai/deepagents/commit/6ee375e979b672cd1d172669f0e5a7a665431d7c))
+
+## [0.0.46](https://github.com/langchain-ai/deepagents/compare/deepagents-cli==0.0.45...deepagents-cli==0.0.46) (2026-04-30)
+
+### Features
+
+* Rework MCP integration and add OAuth login ([#2906](https://github.com/langchain-ai/deepagents/issues/2906)) ([6b7b0be](https://github.com/langchain-ai/deepagents/commit/6b7b0bef95db673fed23fc92803abaaa398b0a6d))
+* `allowedTools` and `disabledTools` filters in MCP config ([#2835](https://github.com/langchain-ai/deepagents/issues/2835)) ([eafd691](https://github.com/langchain-ai/deepagents/commit/eafd6912db637ab59085a0b05d6e36d6cdd10e1a))
+
 ## [0.0.45](https://github.com/langchain-ai/deepagents/compare/deepagents-cli==0.0.44...deepagents-cli==0.0.45) (2026-04-30)
 
 ### Bug Fixes

deepagents_cli-0.0.47/DEV.md

@@ -0,0 +1,92 @@
+# CLI Development Guide
+
+## Live CSS development with Textual devtools
+
+Textual's devtools console enables CSS hot-reload and live `self.log()` output during development.
+
+### Prerequisites
+
+Sync the `test` dependency group (includes `textual-dev`):
+
+```bash
+cd libs/cli && uv sync --group test
+```
+
+Create the dev wrapper script (one-time):
+
+```bash
+cat > /tmp/dev_deepagents.py << 'PYEOF'
+"""Dev wrapper to run Deep Agents CLI with textual devtools."""
+import sys
+sys.argv = ["deepagents"] + sys.argv[1:]
+
+from deepagents_cli.main import cli_main
+cli_main()
+PYEOF
+```
+
+### Running
+
+**Terminal 1** — devtools console:
+
+```bash
+cd libs/cli && uv run --group test textual console
+```
+
+**Terminal 2** — CLI with live reload:
+
+```bash
+cd libs/cli && uv run --group test textual run --dev /tmp/dev_deepagents.py
+```
+
+Edit any `.tcss` file and save — changes appear immediately. Any `self.log()` calls in widget code show in the console.
+
+### Console options
+
+- `textual console -v` — verbose mode, shows all events (key presses, mouse, etc.)
+- `textual console -x EVENT` — exclude noisy event groups
+- `textual console --port 7342` — custom port (pass matching `--port` to `textual run`)
+
+### Why the wrapper script?
+
+`textual run --dev` handles the devtools connection, but it needs to run inside the project's virtualenv to import `deepagents_cli`. The wrapper script bridges the gap — `uv run --group test textual run --dev` ensures both `textual-dev` (from the `test` group) and `deepagents_cli` are available in the same environment.
+
+## Debugging
+
+The CLI runs a `langgraph dev` subprocess for every interactive session. When the subprocess crashes during startup, the TUI shows a one-line failure banner; the actual exception lives in the subprocess's stdout/stderr, which is captured to a temp file.
+
+### Environment variables
+
+| Variable | Effect |
+| --- | --- |
+| `DEEPAGENTS_CLI_DEBUG=1` | Preserves the server subprocess log on shutdown and prints its path to stderr. Without this, the log is deleted when the process stops. Also enables the CLI-process file handler below. Accepts `1`/`true`/`yes`/`on` (case-insensitive) as enabled; `0`/`false`/`no`/`off`/empty/unset as disabled. |
+| `DEEPAGENTS_CLI_DEBUG_FILE=<path>` | Overrides the default path (`/tmp/deepagents_debug.log`) for the CLI-process file handler, which attaches at `DEBUG` level to `textual_adapter` and `remote_client`. **Only takes effect when `DEEPAGENTS_CLI_DEBUG` is truthy.** Useful for diagnosing streaming/client-side issues; does **not** capture the server subprocess. |
+
+`DEEPAGENTS_CLI_DEBUG` is what you want for startup crashes (graph init, MCP config, sandbox): the preserved subprocess log contains the real traceback. The optional `DEEPAGENTS_CLI_DEBUG_FILE` override is for post-startup client-side debugging.
+
+### Finding the server subprocess log
+
+On macOS, `tempfile` resolves to `$TMPDIR` (a path under `/var/folders/.../T/`). Each `ServerProcess` writes its combined stdout+stderr to a file matching `deepagents_server_log_*.txt`:
+
+```bash
+# Newest first
+ls -lt ${TMPDIR:-/tmp}/deepagents_server_log_*.txt | head -5
+
+# Tail the latest while reproducing the crash
+tail -F "$(ls -t ${TMPDIR:-/tmp}/deepagents_server_log_*.txt | head -1)"
+```
+
+The interesting line is `Failed to initialize server graph: <exc>` followed by a traceback — everything above that is uvicorn/lifespan unwinding.
+
+### Triage flow for a startup crash
+
+1. **Rerun with `DEEPAGENTS_CLI_DEBUG=1`.** The log is preserved and a "Server log preserved at: ..." line is printed to stderr. Textual's fullscreen mode can hide that line, but the file itself is still on disk.
+2. **Locate the log** via the `ls` command above. Open it in your editor.
+3. **Search for `Failed to initialize server graph`.** The stack trace beneath names the concrete failure point (MCP config validation, sandbox init, model resolution, subagent load, etc.).
+4. **Pre-flight validators run in the CLI process** for the common failure modes (e.g., `--mcp-config` is validated in `start_server_and_get_agent` before the subprocess spawns). When the banner shows `MCPConfigError: <path>: <reason>`, the subprocess never started — fix the file and retry.
+
+### Common startup failure patterns
+
+- **`MCPConfigError: Invalid MCP config at <path>: ...`** — malformed `--mcp-config`. The pre-flight wraps the underlying `ValueError`/`TypeError` with the offending path. See `_preflight_validate_mcp_config` in `server_manager.py`.
+- **`Server 'X' missing required 'command' field`** (from a discovered project `.mcp.json`, not `--mcp-config`) — an stdio server config without `command`. For remote servers, just use `{"url": "..."}`; transport is inferred as `http` when no `type`/`transport` is present.
+- **Uncaught exception inside a bare `sys.exit(1)`** — usually means the surrounding `make_graph()` raised. Look one traceback up in the subprocess log for the real cause.

{deepagents_cli-0.0.45 → deepagents_cli-0.0.47}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepagents-cli
-Version: 0.0.45
+Version: 0.0.47
 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/
@@ -51,7 +51,7 @@ Requires-Dist: rich<15.0.0,>=14.0.0
 Requires-Dist: tavily-python<1.0.0,>=0.7.21
 Requires-Dist: textual-autocomplete<5.0.0,>=3.0.0
 Requires-Dist: textual-speedups<1.0.0,>=0.2.1
-Requires-Dist: textual<9.0.0,>=8.0.0
+Requires-Dist: textual<9.0.0,>=8.2.5
 Requires-Dist: tomli-w<2.0.0,>=1.0.0
 Requires-Dist: uuid-utils<1.0.0,>=0.10.0
 Provides-Extra: agentcore
@@ -141,13 +141,13 @@ Description-Content-Type: text/markdown
 ## Quick Install
 
 ```bash
-curl -LsSf https://raw.githubusercontent.com/langchain-ai/deepagents/main/libs/cli/scripts/install.sh | bash
+curl -LsSf https://langch.in/gh-da-cli | bash
 ```
 
 ```bash
 # With model provider extras
 # OpenAI, Anthropic, and Gemini are included by default
-DEEPAGENTS_EXTRAS="nvidia,ollama" curl -LsSf https://raw.githubusercontent.com/langchain-ai/deepagents/main/libs/cli/scripts/install.sh | bash
+DEEPAGENTS_EXTRAS="nvidia,ollama" curl -LsSf https://langch.in/gh-da-cli | bash
 ```
 
 Or install directly with `uv`:

{deepagents_cli-0.0.45 → deepagents_cli-0.0.47}/README.md

@@ -12,13 +12,13 @@
 ## Quick Install
 
 ```bash
-curl -LsSf https://raw.githubusercontent.com/langchain-ai/deepagents/main/libs/cli/scripts/install.sh | bash
+curl -LsSf https://langch.in/gh-da-cli | bash
 ```
 
 ```bash
 # With model provider extras
 # OpenAI, Anthropic, and Gemini are included by default
-DEEPAGENTS_EXTRAS="nvidia,ollama" curl -LsSf https://raw.githubusercontent.com/langchain-ai/deepagents/main/libs/cli/scripts/install.sh | bash
+DEEPAGENTS_EXTRAS="nvidia,ollama" curl -LsSf https://langch.in/gh-da-cli | bash
 ```
 
 Or install directly with `uv`:

{deepagents_cli-0.0.45 → deepagents_cli-0.0.47}/deepagents_cli/_debug.py

@@ -12,7 +12,7 @@ import logging
 import os
 from pathlib import Path
 
-from deepagents_cli._env_vars import DEBUG, DEBUG_FILE
+from deepagents_cli._env_vars import DEBUG, DEBUG_FILE, is_env_truthy
 
 
 def configure_debug_logging(target: logging.Logger) -> None:
@@ -22,12 +22,12 @@ def configure_debug_logging(target: logging.Logger) -> None:
     with `DEEPAGENTS_CLI_DEBUG_FILE`. The handler appends so that multiple
     modules share the same log file across a session.
 
-    Does nothing when `DEEPAGENTS_CLI_DEBUG` is not set.
+    Does nothing when `DEEPAGENTS_CLI_DEBUG` is not truthy (see `is_env_truthy`).
 
     Args:
         target: Logger to configure.
     """
-    if not os.environ.get(DEBUG):
+    if not is_env_truthy(DEBUG):
         return
 
     debug_path = Path(

{deepagents_cli-0.0.45 → deepagents_cli-0.0.47}/deepagents_cli/_env_vars.py

@@ -23,6 +23,8 @@ ever renamed, only the value here changes.
 
 from __future__ import annotations
 
+import os
+
 # ---------------------------------------------------------------------------
 # Constants — import these instead of bare string literals.
 # Keep alphabetically sorted by constant name.
@@ -32,7 +34,10 @@ AUTO_UPDATE = "DEEPAGENTS_CLI_AUTO_UPDATE"
 """Enable automatic CLI updates ('1', 'true', or 'yes')."""
 
 DEBUG = "DEEPAGENTS_CLI_DEBUG"
-"""Enable verbose debug logging to a file."""
+"""Enable verbose debug logging and preserve the server subprocess log.
+
+Parsed by `is_env_truthy`: accepts `1`, `true`, `yes`, `on` (case-insensitive)
+as enabled, and `0`, `false`, `no`, `off`, empty string, or unset as disabled."""
 
 DEBUG_FILE = "DEEPAGENTS_CLI_DEBUG_FILE"
 """Path for the debug log file (default: `/tmp/deepagents_debug.log`)."""
@@ -69,3 +74,35 @@ SHELL_ALLOW_LIST = "DEEPAGENTS_CLI_SHELL_ALLOW_LIST"
 
 USER_ID = "DEEPAGENTS_CLI_USER_ID"
 """Attach a user identifier to LangSmith trace metadata."""
+
+
+_TRUTHY_VALUES = frozenset({"1", "true", "yes", "on"})
+_FALSY_VALUES = frozenset({"0", "false", "no", "off", ""})
+
+
+def is_env_truthy(name: str, *, default: bool = False) -> bool:
+    """Return whether env var *name* is set to a recognizably truthy value.
+
+    Unlike `bool(os.environ.get(name))`, this does not treat `"0"` or
+    `"false"` as enabled. Use this for on/off flags where the user would
+    reasonably expect `VAR=0` to mean "disabled".
+
+    Args:
+        name: Environment variable name (typically a `DEEPAGENTS_CLI_*`
+            constant from this module).
+        default: Value returned when the variable is unset OR set to a
+            value that is neither recognizably truthy nor falsy.
+
+    Returns:
+        `True` for `1`/`true`/`yes`/`on` (case-insensitive), `False` for
+        `0`/`false`/`no`/`off`/empty string, or `default` otherwise.
+    """
+    raw = os.environ.get(name)
+    if raw is None:
+        return default
+    lowered = raw.strip().lower()
+    if lowered in _TRUTHY_VALUES:
+        return True
+    if lowered in _FALSY_VALUES:
+        return False
+    return default

{deepagents_cli-0.0.45 → deepagents_cli-0.0.47}/deepagents_cli/_version.py

@@ -1,6 +1,6 @@
 """Version information and lightweight constants for `deepagents-cli`."""
 
-__version__ = "0.0.45"  # x-release-please-version
+__version__ = "0.0.47"  # x-release-please-version
 
 DOCS_URL = "https://docs.langchain.com/oss/python/deepagents/cli"
 """URL for `deepagents-cli` documentation."""