deepagents-cli 0.0.31__tar.gz → 0.0.33__tar.gz

{deepagents_cli-0.0.31 → deepagents_cli-0.0.33}/CHANGELOG.md

@@ -1,5 +1,67 @@
 # Changelog
 
+## [0.0.33](https://github.com/langchain-ai/deepagents/compare/deepagents-cli==0.0.32...deepagents-cli==0.0.33) (2026-03-16)
+
+### Highlights
+
+* **Client-server architecture:** The CLI can now connect to a remote agent backend via `langgraph dev`, decoupling the UI from the runtime and unlocking server-side execution workflows.
+* **Expanded model ecosystem:** Added LiteLLM and Baseten as built-in providers. The `/model` selector now shows live model status, supports an `enabled` flag to hide providers, and auto-discovers models for `class_path` (arbitrary) providers.
+* **CLI ergonomics:** New `-y` and `-S` short flags for `--auto-approve` and `--shell-allow-list`. The `ask_user` tool is now enabled by default, and the welcome banner rotates helpful tips.
+* **Performance:** Integrated `textual-speedups` for Rust-based layout primitives, switched the messages container to stream layout, and offloaded blocking path ops from the event loop — noticeably snappier on long conversations.
+* **Stability:** 15 bug fixes covering markup injection, scrollbar flicker during streaming, reentrant model switching, and autocomplete race conditions.
+
+### Features
+
+* Client-server architecture via `langgraph dev` ([#1759](https://github.com/langchain-ai/deepagents/issues/1759)) ([f5407e6](https://github.com/langchain-ai/deepagents/commit/f5407e6300e6ee51d8c88f1f183dd960b30a5b56))
+* Show model status in `/model` selector ([#1820](https://github.com/langchain-ai/deepagents/issues/1820)) ([92ce0cf](https://github.com/langchain-ai/deepagents/commit/92ce0cffde6f49131541b5985bc80058ae0ad46e))
+* Enable `ask_user` tool by default ([#1830](https://github.com/langchain-ai/deepagents/issues/1830)) ([ed0c745](https://github.com/langchain-ai/deepagents/commit/ed0c745eef8d8fad40aa39b0dfd4de2ba9988fe5))
+* Add `-y` and `-S` short flags for auto-approve and shell-allow-list ([#1919](https://github.com/langchain-ai/deepagents/issues/1919)) ([1036b16](https://github.com/langchain-ai/deepagents/commit/1036b16276d59d8be669d963901c91aeb8cc2236))
+* Add `enabled` flag to hide providers from `/model` switcher ([#1897](https://github.com/langchain-ai/deepagents/issues/1897)) ([72a216c](https://github.com/langchain-ai/deepagents/commit/72a216c88f661f9e53eaf92aedce40fac7b76d3c))
+* Add `litellm` optional dep ([#1818](https://github.com/langchain-ai/deepagents/issues/1818)) ([defa21b](https://github.com/langchain-ai/deepagents/commit/defa21bc6eea596bc67e70372e022d5b78049c0d))
+* Add `sessions` as hidden keyword alias for `/threads` ([#1823](https://github.com/langchain-ai/deepagents/issues/1823)) ([ffa98cc](https://github.com/langchain-ai/deepagents/commit/ffa98ccf9ebe12eadb7f0e95f278dd9bd8eca240))
+* Add Baseten as a built-in model provider/optional dep ([#1819](https://github.com/langchain-ai/deepagents/issues/1819)) ([e05ee66](https://github.com/langchain-ai/deepagents/commit/e05ee66b0d6c5cb996208d554686fc128f1094a2))
+* Add rotating tips to welcome banner ([#1898](https://github.com/langchain-ai/deepagents/issues/1898)) ([d882ca8](https://github.com/langchain-ai/deepagents/commit/d882ca81e2c9a11768a07824fd5b5ce8579bdcd7))
+* Add sandbox type to trace metadata ([#1845](https://github.com/langchain-ai/deepagents/issues/1845)) ([59ef941](https://github.com/langchain-ai/deepagents/commit/59ef94143fc0adabb5f70f308527d98aa1511e44))
+* Show versions in non-interactive header ([#1881](https://github.com/langchain-ai/deepagents/issues/1881)) ([adacc3f](https://github.com/langchain-ai/deepagents/commit/adacc3fd0a0f040373b8ef39032978019b5c8e5f))
+* Show editable install source path in help and banner ([#1916](https://github.com/langchain-ai/deepagents/issues/1916)) ([4ce1cee](https://github.com/langchain-ai/deepagents/commit/4ce1ceebdd2e4aa6db008061519d3df1e422c2db))
+
+### Bug Fixes
+
+* Replace per-chunk `scroll_end` with anchor to fix scrollbar flicker ([#1891](https://github.com/langchain-ai/deepagents/issues/1891)) ([a9be236](https://github.com/langchain-ai/deepagents/commit/a9be2368509f9f2c66537014ae2138253cf0dc39))
+* Auto-discover models for `class_path` providers ([#1816](https://github.com/langchain-ai/deepagents/issues/1816)) ([177fe0f](https://github.com/langchain-ai/deepagents/commit/177fe0f663926d6879aa2177b7988d45cd1e4055))
+* Correct model selector footer showing wrong profile after search ([#1805](https://github.com/langchain-ai/deepagents/issues/1805)) ([2f1d52f](https://github.com/langchain-ai/deepagents/commit/2f1d52f4ad65add210d6f840b1b78e62eba37195))
+* Escape dynamic strings in rich markup to prevent markup injection ([#1888](https://github.com/langchain-ai/deepagents/issues/1888)) ([d349d10](https://github.com/langchain-ai/deepagents/commit/d349d1061647325fdb4ea6322254b24555abf751))
+* Forward `DAYTONA_API_URL` to avoid deprecated `server_url` access ([#1844](https://github.com/langchain-ai/deepagents/issues/1844)) ([7d19ca8](https://github.com/langchain-ai/deepagents/commit/7d19ca8e6404a2ea98aac6a9d4cae7a2b529922c))
+* Let unknown providers through credential check ([#1815](https://github.com/langchain-ai/deepagents/issues/1815)) ([89d39de](https://github.com/langchain-ai/deepagents/commit/89d39ded171bf300e9b17972f18063e9157f298f))
+* Persist `models.recent` on every session start ([#1802](https://github.com/langchain-ai/deepagents/issues/1802)) ([32aa371](https://github.com/langchain-ai/deepagents/commit/32aa371a371208146cc093c4e5eb7a752a74b3c9))
+* Prevent reentrant model switching ([#1824](https://github.com/langchain-ai/deepagents/issues/1824)) ([09d16a8](https://github.com/langchain-ai/deepagents/commit/09d16a8151466fd2d82976d44d7b4e957255bcd9))
+* Remove double slash in skills path template ([#1808](https://github.com/langchain-ai/deepagents/issues/1808)) ([2bc9620](https://github.com/langchain-ai/deepagents/commit/2bc962075146548f2ef4c8851bd502df9d6a1fa5))
+* Show checkmark for `class_path` providers in model selector ([#1899](https://github.com/langchain-ai/deepagents/issues/1899)) ([4adb712](https://github.com/langchain-ai/deepagents/commit/4adb712c8eacbcfbc06801c31bfd74fc0705bed3))
+* Sort prefetched threads by user preference on initial render ([#1806](https://github.com/langchain-ai/deepagents/issues/1806)) ([6f71153](https://github.com/langchain-ai/deepagents/commit/6f711532976821a92e3396fe458ec7874b1237ef))
+* Use `max-height` for `tool-info-scroll` to shrink-wrap content ([#1835](https://github.com/langchain-ai/deepagents/issues/1835)) ([a4e1908](https://github.com/langchain-ai/deepagents/commit/a4e1908527c3a30a6f967dd1d989739d540ddd2a))
+* Use ASCII-safe glyphs in tool status restore path ([#1895](https://github.com/langchain-ai/deepagents/issues/1895)) ([2a9cbc8](https://github.com/langchain-ai/deepagents/commit/2a9cbc8540b2ab77362cbb00764a3533e234891f))
+* Use counter to close history-recall autocomplete race ([#1901](https://github.com/langchain-ai/deepagents/issues/1901)) ([bfd08af](https://github.com/langchain-ai/deepagents/commit/bfd08afbc0eca844e565842dff50eddb067e4750))
+* Use UUID7 for thread IDs instead of 8-char hex ([#1826](https://github.com/langchain-ai/deepagents/issues/1826)) ([821885b](https://github.com/langchain-ai/deepagents/commit/821885bab8ae2eef873a33fdaa6dc427a473d764))
+
+### Performance Improvements
+
+* Add `textual-speedups` for Rust-based layout primitives ([#1910](https://github.com/langchain-ai/deepagents/issues/1910)) ([45b58a1](https://github.com/langchain-ai/deepagents/commit/45b58a13e14abfb58ef3688cee51a5819d8ca52d))
+* Use stream layout for messages container ([#1896](https://github.com/langchain-ai/deepagents/issues/1896)) ([b35401b](https://github.com/langchain-ai/deepagents/commit/b35401b885a7651db548f1826ddb24476ecde5b7))
+* Offload blocking path ops from textual event loop ([#1894](https://github.com/langchain-ai/deepagents/issues/1894)) ([d3eedcc](https://github.com/langchain-ai/deepagents/commit/d3eedccc7edd21103ca1e586fc365d721f674099))
+* Speed up `/model` selector with cache pre-warming and async saves ([#1813](https://github.com/langchain-ai/deepagents/issues/1813)) ([2aec75c](https://github.com/langchain-ai/deepagents/commit/2aec75c8dca6c0510671cf1288a924c4ca9bce1c))
+* Speed up `/threads` modal startup ([#1811](https://github.com/langchain-ai/deepagents/issues/1811)) ([5758df1](https://github.com/langchain-ai/deepagents/commit/5758df1b663cd09726b8cd08d86897351142ed5e))
+
+## [0.0.32](https://github.com/langchain-ai/deepagents/compare/deepagents-cli==0.0.31...deepagents-cli==0.0.32) (2026-03-11)
+
+### Features
+
+* Add token breakdown to `/tokens` and simplify `/compact` messages ([#1782](https://github.com/langchain-ai/deepagents/issues/1782)) ([2f37bff](https://github.com/langchain-ai/deepagents/commit/2f37bffa9d7a9ced6945abe4ab6bc3409bfb97b1))
+* `--json` flag for machine-readable output ([#1768](https://github.com/langchain-ai/deepagents/issues/1768)) ([6f62496](https://github.com/langchain-ai/deepagents/commit/6f62496bb699dfa6086ee1850b83f38d3b1242fa))
+
+### Bug Fixes
+
+* Work around VS Code 1.110 space key regression ([#1748](https://github.com/langchain-ai/deepagents/issues/1748)) ([f5fe431](https://github.com/langchain-ai/deepagents/commit/f5fe4315143bf5b636cf42fc98cbfe3d99918cfc))
+
 ## [0.0.31](https://github.com/langchain-ai/deepagents/compare/deepagents-cli==0.0.30...deepagents-cli==0.0.31) (2026-03-09)
 
 ### Features

{deepagents_cli-0.0.31 → deepagents_cli-0.0.33}/Makefile

@@ -13,11 +13,12 @@ UV_FROZEN = true
 TEST_FILE ?= tests/unit_tests/
 integration_test integration_tests: TEST_FILE=tests/integration_tests/
 
+COV_ARGS ?= --cov=deepagents_cli --cov-report=term-missing
+
 test: ## Run unit tests
 test tests:
 	uv run --group test pytest -n auto --disable-socket --allow-unix-socket $(TEST_FILE) \
-		--cov=deepagents_cli \
-		--cov-report=term-missing
+		$(COV_ARGS)
 
 coverage: ## Run unit tests with coverage
 	uv run --group test pytest --cov \

{deepagents_cli-0.0.31 → deepagents_cli-0.0.33}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepagents-cli
-Version: 0.0.31
+Version: 0.0.33
 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/
@@ -26,11 +26,17 @@ Requires-Python: <4.0,>=3.11
 Requires-Dist: aiosqlite<1.0.0,>=0.19.0
 Requires-Dist: daytona<1.0.0,>=0.113.0
 Requires-Dist: deepagents-acp>=0.0.4
-Requires-Dist: deepagents==0.4.7
+Requires-Dist: deepagents==0.4.11
+Requires-Dist: httpx<1.0.0,>=0.28.1
+Requires-Dist: langchain-anthropic<2.0.0,>=1.3.5
+Requires-Dist: langchain-google-genai<5.0.0,>=4.2.1
 Requires-Dist: langchain-mcp-adapters<1.0.0,>=0.2.0
 Requires-Dist: langchain-openai<2.0.0,>=1.1.8
 Requires-Dist: langchain<2.0.0,>=1.2.10
 Requires-Dist: langgraph-checkpoint-sqlite<4.0.0,>=3.0.0
+Requires-Dist: langgraph-cli[inmem]<1.0.0,>=0.4.15
+Requires-Dist: langgraph-sdk<1.0.0,>=0.3.11
+Requires-Dist: langgraph<2.0.0,>=1.1.2
 Requires-Dist: langsmith[sandbox]>=0.7.7
 Requires-Dist: markdownify<2.0.0,>=0.13.0
 Requires-Dist: modal<2.0.0,>=0.65.0
@@ -44,19 +50,23 @@ Requires-Dist: rich<15.0.0,>=14.0.0
 Requires-Dist: runloop-api-client>=0.69.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: tomli-w<2.0.0,>=1.0.0
+Requires-Dist: uuid-utils<1.0.0,>=0.10.0
 Provides-Extra: all-providers
-Requires-Dist: langchain-anthropic<2.0.0,>=1.0.0; extra == 'all-providers'
+Requires-Dist: langchain-anthropic<2.0.0,>=1.3.5; extra == 'all-providers'
 Requires-Dist: langchain-aws<2.0.0,>=1.0.0; extra == 'all-providers'
+Requires-Dist: langchain-baseten<1.0.0,>=0.1.9; extra == 'all-providers'
 Requires-Dist: langchain-cohere<1.0.0,>=0.5.0; extra == 'all-providers'
 Requires-Dist: langchain-deepseek<2.0.0,>=1.0.0; extra == 'all-providers'
 Requires-Dist: langchain-fireworks<2.0.0,>=1.0.0; extra == 'all-providers'
-Requires-Dist: langchain-google-genai<5.0.0,>=4.0.0; extra == 'all-providers'
+Requires-Dist: langchain-google-genai<5.0.0,>=4.2.1; extra == 'all-providers'
 Requires-Dist: langchain-google-vertexai<4.0.0,>=3.0.0; extra == 'all-providers'
 Requires-Dist: langchain-groq<2.0.0,>=1.0.0; extra == 'all-providers'
 Requires-Dist: langchain-huggingface<2.0.0,>=1.0.0; extra == 'all-providers'
 Requires-Dist: langchain-ibm<2.0.0,>=1.0.0; extra == 'all-providers'
+Requires-Dist: langchain-litellm<2.0.0,>=0.6.1; extra == 'all-providers'
 Requires-Dist: langchain-mistralai<2.0.0,>=1.0.0; extra == 'all-providers'
 Requires-Dist: langchain-nvidia-ai-endpoints<2.0.0,>=1.0.0; extra == 'all-providers'
 Requires-Dist: langchain-ollama<2.0.0,>=1.0.0; extra == 'all-providers'
@@ -65,7 +75,9 @@ Requires-Dist: langchain-openrouter<2.0.0,>=0.1.0; extra == 'all-providers'
 Requires-Dist: langchain-perplexity<2.0.0,>=1.0.0; extra == 'all-providers'
 Requires-Dist: langchain-xai<2.0.0,>=1.0.0; extra == 'all-providers'
 Provides-Extra: anthropic
-Requires-Dist: langchain-anthropic<2.0.0,>=1.0.0; extra == 'anthropic'
+Requires-Dist: langchain-anthropic<2.0.0,>=1.3.5; extra == 'anthropic'
+Provides-Extra: baseten
+Requires-Dist: langchain-baseten<1.0.0,>=0.1.9; extra == 'baseten'
 Provides-Extra: bedrock
 Requires-Dist: langchain-aws<2.0.0,>=1.0.0; extra == 'bedrock'
 Provides-Extra: cohere
@@ -75,13 +87,15 @@ Requires-Dist: langchain-deepseek<2.0.0,>=1.0.0; extra == 'deepseek'
 Provides-Extra: fireworks
 Requires-Dist: langchain-fireworks<2.0.0,>=1.0.0; extra == 'fireworks'
 Provides-Extra: google-genai
-Requires-Dist: langchain-google-genai<5.0.0,>=4.0.0; extra == 'google-genai'
+Requires-Dist: langchain-google-genai<5.0.0,>=4.2.1; extra == 'google-genai'
 Provides-Extra: groq
 Requires-Dist: langchain-groq<2.0.0,>=1.0.0; extra == 'groq'
 Provides-Extra: huggingface
 Requires-Dist: langchain-huggingface<2.0.0,>=1.0.0; extra == 'huggingface'
 Provides-Extra: ibm
 Requires-Dist: langchain-ibm<2.0.0,>=1.0.0; extra == 'ibm'
+Provides-Extra: litellm
+Requires-Dist: langchain-litellm<2.0.0,>=0.6.1; extra == 'litellm'
 Provides-Extra: mistralai
 Requires-Dist: langchain-mistralai<2.0.0,>=1.0.0; extra == 'mistralai'
 Provides-Extra: nvidia
@@ -114,12 +128,12 @@ Description-Content-Type: text/markdown
 ## Quick Install
 
 ```bash
-curl -LsSf https://raw.githubusercontent.com/langchain-ai/deepagents/main/scripts/install.sh | bash
+curl -LsSf https://raw.githubusercontent.com/langchain-ai/deepagents/main/libs/cli/scripts/install.sh | bash
 ```
 
 ```bash
 # With model provider extras (OpenAI is included by default)
-DEEPAGENTS_EXTRAS="anthropic,groq" curl -LsSf https://raw.githubusercontent.com/langchain-ai/deepagents/main/scripts/install.sh | bash
+DEEPAGENTS_EXTRAS="anthropic,groq" curl -LsSf https://raw.githubusercontent.com/langchain-ai/deepagents/main/libs/cli/scripts/install.sh | bash
 ```
 
 Or install directly with `uv`:

{deepagents_cli-0.0.31 → deepagents_cli-0.0.33}/README.md

@@ -12,12 +12,12 @@
 ## Quick Install
 
 ```bash
-curl -LsSf https://raw.githubusercontent.com/langchain-ai/deepagents/main/scripts/install.sh | bash
+curl -LsSf https://raw.githubusercontent.com/langchain-ai/deepagents/main/libs/cli/scripts/install.sh | bash
 ```
 
 ```bash
 # With model provider extras (OpenAI is included by default)
-DEEPAGENTS_EXTRAS="anthropic,groq" curl -LsSf https://raw.githubusercontent.com/langchain-ai/deepagents/main/scripts/install.sh | bash
+DEEPAGENTS_EXTRAS="anthropic,groq" curl -LsSf https://raw.githubusercontent.com/langchain-ai/deepagents/main/libs/cli/scripts/install.sh | bash
 ```
 
 Or install directly with `uv`:

deepagents_cli-0.0.33/deepagents_cli/_debug.py

@@ -0,0 +1,50 @@
+"""Shared debug-logging configuration for verbose file-based tracing.
+
+When the `DEEPAGENTS_DEBUG` environment variable is set, modules that handle
+streaming or remote communication can enable detailed file-based logging. This
+helper centralizes the setup so the env-var name, file path, and format are
+defined in one place.
+"""
+
+from __future__ import annotations
+
+import logging
+import os
+from pathlib import Path
+
+
+def configure_debug_logging(target: logging.Logger) -> None:
+    """Attach a file handler to *target* when `DEEPAGENTS_DEBUG` is set.
+
+    The log file defaults to `'/tmp/deepagents_debug.log'` but can be overridden
+    with `DEEPAGENTS_DEBUG_FILE`. The handler appends so that multiple modules
+    share the same log file across a session.
+
+    Does nothing when `DEEPAGENTS_DEBUG` is not set.
+
+    Args:
+        target: Logger to configure.
+    """
+    if not os.environ.get("DEEPAGENTS_DEBUG"):
+        return
+
+    debug_path = Path(
+        os.environ.get(
+            "DEEPAGENTS_DEBUG_FILE",
+            "/tmp/deepagents_debug.log",  # noqa: S108
+        )
+    )
+    try:
+        handler = logging.FileHandler(str(debug_path), mode="a")
+    except OSError as exc:
+        import sys
+
+        print(  # noqa: T201
+            f"Warning: could not open debug log file {debug_path}: {exc}",
+            file=sys.stderr,
+        )
+        return
+    handler.setLevel(logging.DEBUG)
+    handler.setFormatter(logging.Formatter("%(asctime)s %(name)s %(message)s"))
+    target.addHandler(handler)
+    target.setLevel(logging.DEBUG)

deepagents_cli-0.0.33/deepagents_cli/_server_config.py

@@ -0,0 +1,320 @@
+"""Typed configuration for the CLI-to-server subprocess communication channel.
+
+The CLI spawns a `langgraph dev` subprocess and passes configuration via
+environment variables prefixed with `DA_SERVER_`. This module provides a single
+`ServerConfig` dataclass that both sides share so that the set of variables,
+their serialization format, and their default values are defined in one place.
+The CLI writes config with `to_env()` and the server graph reads it back
+with `from_env()`.
+"""
+
+from __future__ import annotations
+
+import json
+import logging
+import os
+from dataclasses import dataclass
+from pathlib import Path
+from typing import TYPE_CHECKING, Any
+
+from deepagents_cli._server_constants import ENV_PREFIX as _ENV_PREFIX
+
+if TYPE_CHECKING:
+    from deepagents_cli.project_utils import ProjectContext
+
+logger = logging.getLogger(__name__)
+
+_DEFAULT_ASSISTANT_ID = "agent"
+
+
+def _read_env_bool(suffix: str, *, default: bool = False) -> bool:
+    """Read a `DA_SERVER_*` boolean from the environment.
+
+    Boolean env vars use the `'true'` / `'false'` convention (case insensitive).
+    Missing variables fall back to *default*.
+
+    Args:
+        suffix: Variable name suffix after the `DA_SERVER_` prefix.
+        default: Value when the variable is absent.
+
+    Returns:
+        Parsed boolean.
+    """
+    raw = os.environ.get(f"{_ENV_PREFIX}{suffix}")
+    if raw is None:
+        return default
+    return raw.lower() == "true"
+
+
+def _read_env_json(suffix: str) -> Any:  # noqa: ANN401
+    """Read a JSON-encoded `DA_SERVER_*` variable.
+
+    Args:
+        suffix: Variable name suffix after the `DA_SERVER_` prefix.
+
+    Returns:
+        Parsed JSON value, or `None` if the variable is absent.
+
+    Raises:
+        ValueError: If the variable is present but not valid JSON.
+    """
+    raw = os.environ.get(f"{_ENV_PREFIX}{suffix}")
+    if raw is None:
+        return None
+    try:
+        return json.loads(raw)
+    except json.JSONDecodeError as exc:
+        msg = (
+            f"Failed to parse {_ENV_PREFIX}{suffix} as JSON: {exc}. "
+            f"Value was: {raw[:200]!r}"
+        )
+        raise ValueError(msg) from exc
+
+
+def _read_env_str(suffix: str) -> str | None:
+    """Read an optional `DA_SERVER_*` string variable.
+
+    Args:
+        suffix: Variable name suffix after the `DA_SERVER_` prefix.
+
+    Returns:
+        The string value, or `None` if absent.
+    """
+    return os.environ.get(f"{_ENV_PREFIX}{suffix}")
+
+
+def _read_env_optional_bool(suffix: str) -> bool | None:
+    """Read a tri-state `DA_SERVER_*` boolean (`True` / `False` / `None`).
+
+    Used for settings where `None` carries a distinct meaning (e.g. "not
+    specified, use default logic").
+
+    Args:
+        suffix: Variable name suffix after the `DA_SERVER_` prefix.
+
+    Returns:
+        `True`, `False`, or `None` when the variable is absent.
+    """
+    raw = os.environ.get(f"{_ENV_PREFIX}{suffix}")
+    if raw is None:
+        return None
+    return raw.lower() == "true"
+
+
+@dataclass(frozen=True)
+class ServerConfig:
+    """Full configuration payload passed from the CLI to the server subprocess.
+
+    Serialized to/from `DA_SERVER_*` environment variables so that the server
+    graph (which runs in a separate Python interpreter) can reconstruct the
+    CLI's intent without sharing memory.
+    """
+
+    model: str | None = None
+    model_params: dict[str, Any] | None = None
+    assistant_id: str = _DEFAULT_ASSISTANT_ID
+    system_prompt: str | None = None
+    auto_approve: bool = False
+    interactive: bool = True
+    enable_shell: bool = True
+    enable_ask_user: bool = False
+    enable_memory: bool = True
+    enable_skills: bool = True
+    sandbox_type: str | None = None
+    sandbox_id: str | None = None
+    sandbox_setup: str | None = None
+    cwd: str | None = None
+    project_root: str | None = None
+    mcp_config_path: str | None = None
+    no_mcp: bool = False
+    trust_project_mcp: bool | None = None
+
+    def __post_init__(self) -> None:
+        """Normalize fields that have canonical representations."""
+        if self.sandbox_type == "none":
+            object.__setattr__(self, "sandbox_type", None)
+
+    # ------------------------------------------------------------------
+    # Serialization
+    # ------------------------------------------------------------------
+
+    def to_env(self) -> dict[str, str | None]:
+        """Serialize this config to a `DA_SERVER_*` env-var mapping.
+
+        `None` values signal that the variable should be *cleared* from the
+        environment (rather than set to an empty string), so callers can
+        iterate and set or clear each variable in `os.environ`.
+
+        Returns:
+            Dict mapping env-var suffixes (without the prefix) to their
+                string values or `None`.
+        """
+        return {
+            "MODEL": self.model,
+            "MODEL_PARAMS": (
+                json.dumps(self.model_params) if self.model_params is not None else None
+            ),
+            "ASSISTANT_ID": self.assistant_id,
+            "SYSTEM_PROMPT": self.system_prompt,
+            "AUTO_APPROVE": str(self.auto_approve).lower(),
+            "INTERACTIVE": str(self.interactive).lower(),
+            "ENABLE_SHELL": str(self.enable_shell).lower(),
+            "ENABLE_ASK_USER": str(self.enable_ask_user).lower(),
+            "ENABLE_MEMORY": str(self.enable_memory).lower(),
+            "ENABLE_SKILLS": str(self.enable_skills).lower(),
+            "SANDBOX_TYPE": self.sandbox_type,
+            "SANDBOX_ID": self.sandbox_id,
+            "SANDBOX_SETUP": self.sandbox_setup,
+            "CWD": self.cwd,
+            "PROJECT_ROOT": self.project_root,
+            "MCP_CONFIG_PATH": self.mcp_config_path,
+            "NO_MCP": str(self.no_mcp).lower(),
+            "TRUST_PROJECT_MCP": (
+                str(self.trust_project_mcp).lower()
+                if self.trust_project_mcp is not None
+                else None
+            ),
+        }
+
+    @classmethod
+    def from_env(cls) -> ServerConfig:
+        """Reconstruct a `ServerConfig` from the current `DA_SERVER_*` env vars.
+
+        This is the inverse of `to_env()` and is called inside the server
+        subprocess to recover the CLI's configuration.
+
+        Returns:
+            A `ServerConfig` populated from the environment.
+        """
+        return cls(
+            model=_read_env_str("MODEL"),
+            model_params=_read_env_json("MODEL_PARAMS"),
+            assistant_id=_read_env_str("ASSISTANT_ID") or _DEFAULT_ASSISTANT_ID,
+            system_prompt=_read_env_str("SYSTEM_PROMPT"),
+            auto_approve=_read_env_bool("AUTO_APPROVE"),
+            interactive=_read_env_bool("INTERACTIVE", default=True),
+            enable_shell=_read_env_bool("ENABLE_SHELL", default=True),
+            enable_ask_user=_read_env_bool("ENABLE_ASK_USER"),
+            enable_memory=_read_env_bool("ENABLE_MEMORY", default=True),
+            enable_skills=_read_env_bool("ENABLE_SKILLS", default=True),
+            sandbox_type=_read_env_str("SANDBOX_TYPE"),
+            sandbox_id=_read_env_str("SANDBOX_ID"),
+            sandbox_setup=_read_env_str("SANDBOX_SETUP"),
+            cwd=_read_env_str("CWD"),
+            project_root=_read_env_str("PROJECT_ROOT"),
+            mcp_config_path=_read_env_str("MCP_CONFIG_PATH"),
+            no_mcp=_read_env_bool("NO_MCP"),
+            trust_project_mcp=_read_env_optional_bool("TRUST_PROJECT_MCP"),
+        )
+
+    # ------------------------------------------------------------------
+    # Factory
+    # ------------------------------------------------------------------
+
+    @classmethod
+    def from_cli_args(
+        cls,
+        *,
+        project_context: ProjectContext | None,
+        model_name: str | None,
+        model_params: dict[str, Any] | None,
+        assistant_id: str,
+        auto_approve: bool,
+        sandbox_type: str,
+        sandbox_id: str | None,
+        sandbox_setup: str | None,
+        enable_shell: bool,
+        enable_ask_user: bool,
+        mcp_config_path: str | None,
+        no_mcp: bool,
+        trust_project_mcp: bool | None,
+        interactive: bool,
+    ) -> ServerConfig:
+        """Build a `ServerConfig` from parsed CLI arguments.
+
+        Handles path normalization (e.g. resolving relative MCP config paths
+        against the user's working directory) so that the raw serialized values
+        are always absolute and unambiguous.
+
+        Args:
+            project_context: Explicit user/project path context.
+            model_name: Model spec string.
+            model_params: Extra model kwargs.
+            assistant_id: Agent identifier.
+            auto_approve: Auto-approve all tools.
+            sandbox_type: Sandbox type.
+            sandbox_id: Existing sandbox ID to reuse.
+            sandbox_setup: Path to setup script for the sandbox.
+            enable_shell: Enable shell execution tools.
+            enable_ask_user: Enable ask_user tool.
+            mcp_config_path: Path to MCP config.
+            no_mcp: Disable MCP.
+            trust_project_mcp: Trust project MCP servers.
+            interactive: Whether the agent is interactive.
+
+        Returns:
+            A fully resolved `ServerConfig`.
+        """
+        normalized_mcp = _normalize_path(mcp_config_path, project_context, "MCP config")
+
+        return cls(
+            model=model_name,
+            model_params=model_params,
+            assistant_id=assistant_id,
+            auto_approve=auto_approve,
+            interactive=interactive,
+            enable_shell=enable_shell,
+            enable_ask_user=enable_ask_user,
+            sandbox_type=sandbox_type,
+            sandbox_id=sandbox_id,
+            sandbox_setup=_normalize_path(
+                sandbox_setup, project_context, "sandbox setup"
+            ),
+            cwd=(
+                str(project_context.user_cwd) if project_context is not None else None
+            ),
+            project_root=(
+                str(project_context.project_root)
+                if project_context is not None
+                and project_context.project_root is not None
+                else None
+            ),
+            mcp_config_path=normalized_mcp,
+            no_mcp=no_mcp,
+            trust_project_mcp=trust_project_mcp,
+        )
+
+
+def _normalize_path(
+    raw_path: str | None,
+    project_context: ProjectContext | None,
+    label: str,
+) -> str | None:
+    """Resolve a possibly-relative path to absolute.
+
+    The server subprocess runs in a different working directory, so relative
+    paths must be resolved against the user's original cwd before serialization.
+
+    Args:
+        raw_path: Path from CLI arguments (may be relative).
+        project_context: User/project context for path resolution.
+        label: Human-readable label for error messages (e.g. "MCP config").
+
+    Returns:
+        Absolute path string, or `None` when *raw_path* is `None` or empty.
+
+    Raises:
+        ValueError: If the path cannot be resolved.
+    """
+    if not raw_path:
+        return None
+    try:
+        if project_context is not None:
+            return str(project_context.resolve_user_path(raw_path))
+        return str(Path(raw_path).expanduser().resolve())
+    except OSError as exc:
+        msg = (
+            f"Could not resolve {label} path {raw_path!r}: {exc}. "
+            "Ensure the path exists and is accessible."
+        )
+        raise ValueError(msg) from exc

deepagents_cli-0.0.33/deepagents_cli/_server_constants.py

@@ -0,0 +1,4 @@
+"""Shared constants for server communication between CLI and server graph."""
+
+ENV_PREFIX = "DA_SERVER_"
+"""Environment variable prefix used to pass CLI config to the server subprocess."""