deepagents-code 0.1.2__tar.gz → 0.1.4__tar.gz

{deepagents_code-0.1.2 → deepagents_code-0.1.4}/.gitignore

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

deepagents_code-0.1.4/AGENTS.md

@@ -0,0 +1,95 @@
+# `libs/code` agent guide
+
+`deepagents-code` is the interactive coding agent — the Textual REPL, headless `-x` mode, MCP integration, skills, sandbox bootstrap, and slash-command surface. Forked from `deepagents-cli` at the 0.1.0 split.
+
+For monorepo-wide conventions (commit titles, lint, testing, docs, CI, benchmarks), see the root `AGENTS.md`.
+
+## Textual (terminal UI framework)
+
+`deepagents-code` uses [Textual](https://textual.textualize.io/).
+
+**Key Textual resources:**
+
+- **Guide:** https://textual.textualize.io/guide/
+- **Widget gallery:** https://textual.textualize.io/widget_gallery/
+- **CSS reference:** https://textual.textualize.io/styles/
+- **API reference:** https://textual.textualize.io/api/
+
+### Styled text in widgets
+
+Prefer Textual's `Content` (`textual.content`) over Rich's `Text` for widget rendering. `Content` is immutable (like `str`) and integrates natively with Textual's rendering pipeline. Rich `Text` is still correct for code that renders via Rich's `Console.print()` (e.g., `non_interactive.py`, `main.py`).
+
+IMPORTANT: `Content` requires **Textual's** `Style` (`textual.style.Style`) for rendering, not Rich's `Style` (`rich.style.Style`). Mixing Rich `Style` objects into `Content` spans will cause `TypeError` during widget rendering. String styles (`"bold cyan"`, `"dim"`) work for non-link styling. For links, use `TStyle(link=url)`.
+
+**Never use f-string interpolation in Rich markup** (e.g., `f"[bold]{var}[/bold]"`). If `var` contains square brackets, the markup breaks or throws. Use `Content` methods instead:
+
+- `Content.from_markup("[bold]$var[/bold]", var=value)` — for inline markup templates. `$var` substitution auto-escapes dynamic content. **Use when the variable is external/user-controlled** (tool args, file paths, user messages, diff content, error messages from exceptions).
+- `Content.styled(text, "bold")` — single style applied to plain text. No markup parsing. Use for static strings or when the variable is internal/trusted (glyphs, ints, enum-like status values). Avoid `Content.styled(f"..{var}..", style)` when `var` is user-controlled — while `styled` doesn't parse markup, the f-string pattern is fragile and inconsistent with the `from_markup` convention.
+- `Content.assemble("prefix: ", (text, "bold"), " ", other_content)` — for composing pre-built `Content` objects, `(text, style)` tuples, and plain strings. Plain strings are treated as plain text (no markup parsing). Use for structural composition, especially when parts use `TStyle(link=url)`.
+- `content.join(parts)` — like `str.join()` for `Content` objects.
+
+**Decision rule:** if the value could ever come from outside the codebase (user input, tool output, API responses, file contents), use `from_markup` with `$var`. If it's a hardcoded string, glyph, or computed int, `styled` is fine.
+
+### `App.notify()` defaults to `markup=True`
+
+Textual's `App.notify(message)` parses the message string as Rich markup by default. Any dynamic content (exception messages, file paths, user input, command strings) containing brackets `[]`, ANSI escape codes, or `=` will cause a `MarkupError` crash in Textual's Toast renderer. Always pass `markup=False` when the message contains f-string interpolated variables. Hardcoded string literals are safe with the default.
+
+### Rich `console.print()` and number highlighting
+
+`console.print()` defaults to `highlight=True`, which runs `ReprHighlighter` and auto-applies bold + cyan to any detected numbers. This visually overrides subtle styles like `dim` (bold cancels dim in most terminals). Pass `highlight=False` on any `console.print()` call where the content contains numbers and consistent dim/subtle styling matters.
+
+### Textual patterns used in this codebase
+
+- **Workers** (`@work` decorator) for async operations - see [Workers guide](https://textual.textualize.io/guide/workers/)
+- **Message passing** for widget communication - see [Events guide](https://textual.textualize.io/guide/events/)
+- **Reactive attributes** for state management - see [Reactivity guide](https://textual.textualize.io/guide/reactivity/)
+
+### Testing Textual apps
+
+- Use `textual.pilot` for async UI testing - see [Testing guide](https://textual.textualize.io/guide/testing/)
+- Snapshot testing available for visual regression - see repo `notes/snapshot_testing.md`
+
+## SDK dependency pin
+
+`deepagents-code` pins an exact `deepagents==X.Y.Z` version in `pyproject.toml`. When developing features that depend on new SDK functionality, bump this pin as part of the same PR. A CI check verifies the pin matches the current SDK version at release time (unless bypassed with `dangerous-skip-sdk-pin-check`).
+
+## Startup performance
+
+`deepagents-code` must stay fast to launch. Never import heavy packages (e.g., `deepagents`, LangChain, LangGraph) at module level or in the argument-parsing path. These imports pull in large dependency trees and add seconds to every invocation, including trivial commands like `deepagents-code -v`.
+
+- Keep top-level imports in `main.py` and other entry-point modules minimal.
+- Defer heavy imports to the point where they are actually needed (inside functions/methods).
+- To read another package's version without importing it, use `importlib.metadata.version("package-name")`.
+- Feature-gate checks on the startup hot path (before background workers fire) must be lightweight — env var lookups, small file reads. Never pull in expensive modules just to decide whether to skip a feature.
+- When adding logic that already exists elsewhere (e.g., editable-install detection), import the existing cached implementation rather than duplicating it.
+- Features that run shell commands silently must be opt-in, never default-enabled. Gate behind an explicit env var or config key.
+- Background workers that spawn subprocesses must set a timeout to avoid blocking indefinitely.
+
+## CLI help screen
+
+The `deepagents-code --help` screen is hand-maintained in `ui.show_help()`, separate from the argparse definitions in `main.parse_args()`. When adding a new CLI flag, update **both** files. A drift-detection test (`test_args.TestHelpScreenDrift`) fails if a flag is registered in argparse but missing from the help screen.
+
+## Splash screen tips
+
+When adding a user-facing CLI feature (new slash command, keybinding, workflow), add a corresponding tip to the `_TIPS` list in `deepagents_code/widgets/welcome.py`. Tips are shown randomly on startup to help users discover features. Keep tips short and action-oriented (e.g., `"Press ctrl+x to compose prompts in your external editor"`).
+
+## Slash commands
+
+Slash commands are defined as `SlashCommand` entries in the `COMMANDS` tuple in `deepagents_code/command_registry.py`. Each entry declares the command name, description, `bypass_tier` (queue-bypass classification), optional `hidden_keywords` for fuzzy matching, and optional `aliases`. Bypass-tier frozensets and the `SLASH_COMMANDS` autocomplete list are derived automatically — no other file should hard-code command metadata.
+
+To add a new slash command: (1) add a `SlashCommand` entry to `COMMANDS`, (2) set the appropriate `bypass_tier`, (3) add a handler branch in `_handle_command` in `app.py`, (4) run `make lint && make test` — the drift test will catch any mismatch.
+
+## Adding a new model provider
+
+`deepagents-code` supports LangChain-based chat model providers as optional dependencies. To add a new provider, update these files (all entries alphabetically sorted):
+
+1. `deepagents_code/model_config.py` — add `"provider_name": "ENV_VAR_NAME"` to `PROVIDER_API_KEY_ENV`
+2. `pyproject.toml` — add `provider = ["langchain-provider>=X.Y.Z,<N.0.0"]` to `[project.optional-dependencies]` and include it in the `all-providers` composite extra
+3. `tests/unit_tests/test_model_config.py` — add `assert PROVIDER_API_KEY_ENV["provider_name"] == "ENV_VAR_NAME"` to `TestProviderApiKeyEnv.test_contains_major_providers`
+
+**Not required** unless the provider's models have a distinctive name prefix (like `gpt-*`, `claude*`, `gemini*`):
+
+- `detect_provider()` in `config.py` — only needed for auto-detection from bare model names
+- `Settings.has_*` property in `config.py` — only needed if referenced by `detect_provider()` fallback logic
+
+Model discovery, credential checking, and UI integration are automatic once `PROVIDER_API_KEY_ENV` is populated and the `langchain-*` package is installed.

deepagents_code-0.1.4/CHANGELOG.md

@@ -0,0 +1,62 @@
+# Deep Agents Code Changelog
+
+## [0.1.4](https://github.com/langchain-ai/deepagents/compare/deepagents-code==0.1.3...deepagents-code==0.1.4) (2026-05-23)
+
+### Features
+
+* Add `--sandbox-snapshot-name` flag ([#3538](https://github.com/langchain-ai/deepagents/issues/3538)) ([b01392e](https://github.com/langchain-ai/deepagents/commit/b01392e7549798434f27f3784fa8c4e734053787))
+* `dcode mcp config` and unify `--mcp-config` flag ([#3541](https://github.com/langchain-ai/deepagents/issues/3541)) ([f037b14](https://github.com/langchain-ai/deepagents/commit/f037b140f90a1ba3725b3ef23ab385b3cafe223b))
+* Interpreter middleware via `langchain-quickjs` ([#3525](https://github.com/langchain-ai/deepagents/issues/3525)) ([f0ca89c](https://github.com/langchain-ai/deepagents/commit/f0ca89c962c22058194121526638bc2d29f546bd))
+
+### Bug Fixes
+
+* Chat input history navigation and newline scrolling ([#3560](https://github.com/langchain-ai/deepagents/issues/3560)) ([3b51cbd](https://github.com/langchain-ai/deepagents/commit/3b51cbdc8c50d9990477e18a47de6a58e9165bab))
+* Distinguish LangSmith failure modes in `/trace` ([#3558](https://github.com/langchain-ai/deepagents/issues/3558)) ([4d158a0](https://github.com/langchain-ai/deepagents/commit/4d158a031aecad8862e02e332f127573003938ec))
+* Recover initial session prompts from writes table ([#3535](https://github.com/langchain-ai/deepagents/issues/3535)) ([46b6f3f](https://github.com/langchain-ai/deepagents/commit/46b6f3f3e6ce880cd5ec9cf59622bb745d6ac2eb))
+* Install script binary checks reference `dcode` ([#3546](https://github.com/langchain-ai/deepagents/issues/3546)) ([f8977a6](https://github.com/langchain-ai/deepagents/commit/f8977a63769e3f2037619f32596cb9bb7bd1020b))
+* Show tool call previews during batched HITL approvals ([#3530](https://github.com/langchain-ai/deepagents/issues/3530)) ([84daa1a](https://github.com/langchain-ai/deepagents/commit/84daa1a2e27963a6d7694dc9278de83782b4a7b7))
+
+## [0.1.3](https://github.com/langchain-ai/deepagents/compare/deepagents-code==0.1.2...deepagents-code==0.1.3) (2026-05-20)
+
+### Features
+
+* In-TUI MCP OAuth login with auto-refresh ([#3469](https://github.com/langchain-ai/deepagents/issues/3469)) ([20e38b8](https://github.com/langchain-ai/deepagents/commit/20e38b8ebd8d9aa4697334432f7832a0a07aea3a))
+  * Float unauthorized MCP servers to top and prompt before reconnect ([#3493](https://github.com/langchain-ai/deepagents/issues/3493)) ([2d66580](https://github.com/langchain-ai/deepagents/commit/2d665804131961dfa7e2849248047deec818e4ef))
+  * Disable MCP servers from TUI ([#3501](https://github.com/langchain-ai/deepagents/issues/3501)) ([5725de8](https://github.com/langchain-ai/deepagents/commit/5725de857722dbca768a95bc6d97af5b838a11a9))
+* `/restart` hidden slash command ([#3514](https://github.com/langchain-ai/deepagents/issues/3514)) ([74bdd36](https://github.com/langchain-ai/deepagents/commit/74bdd3688948d8369cdd978590f5a822eabeb12c))
+
+### Bug Fixes
+
+* Persist `_context_tokens` via `after_model` middleware ([#3496](https://github.com/langchain-ai/deepagents/issues/3496)) ([e2bb284](https://github.com/langchain-ai/deepagents/commit/e2bb284e506e0e49a05169fc6de01bdf42350267))
+* Refresh status bar model after recovering from failed startup ([#3511](https://github.com/langchain-ai/deepagents/issues/3511)) ([c96f822](https://github.com/langchain-ai/deepagents/commit/c96f822de187431404d093b852c4a855d3ab8d30))
+
+## [0.1.2](https://github.com/langchain-ai/deepagents/compare/deepagents-code==0.1.1...deepagents-code==0.1.2) (2026-05-19)
+
+### Features
+
+* `/model` toggle for recommended-only list ([#3453](https://github.com/langchain-ai/deepagents/issues/3453)) ([c326b7e](https://github.com/langchain-ai/deepagents/commit/c326b7ec1b9940861175e0466ab4221f03e2bcba))
+* `--timeout` flag for non-interactive ([#3351](https://github.com/langchain-ai/deepagents/issues/3351)) ([44e86ab](https://github.com/langchain-ai/deepagents/commit/44e86abbb1870f689dace8b1be6ed430d65e74c1))
+* Browser loopback OAuth callback for MCP auth ([#3467](https://github.com/langchain-ai/deepagents/issues/3467)) ([d83aa07](https://github.com/langchain-ai/deepagents/commit/d83aa07c818af35800f81d062a147fa45a47ace7))
+* MCP screen metadata ([#3349](https://github.com/langchain-ai/deepagents/issues/3349)) ([ce2f07e](https://github.com/langchain-ai/deepagents/commit/ce2f07e7211f22b3f44a1a232088b89a469a0a99))
+
+### Bug Fixes
+
+* Drop sections from `system_prompt.md` already supplied by SDK middleware ([#3448](https://github.com/langchain-ai/deepagents/issues/3448)) ([9dbf2c2](https://github.com/langchain-ai/deepagents/commit/9dbf2c2f19e941e012d0c93418ef09fb56f30d6a))
+* Rename stale usage commands ([#3460](https://github.com/langchain-ai/deepagents/issues/3460)) ([da43b7f](https://github.com/langchain-ai/deepagents/commit/da43b7f9d913e6190ff03c496a269faf08bbf182))
+* Suppress interrupt-cleanup state writes from traces ([#3465](https://github.com/langchain-ai/deepagents/issues/3465)) ([319b24e](https://github.com/langchain-ai/deepagents/commit/319b24e6f179eaf56f105a6db683901c82fe95be))
+
+## [0.1.1](https://github.com/langchain-ai/deepagents/compare/deepagents-code==0.1.0...deepagents-code==0.1.1) (2026-05-16)
+
+### Bug Fixes
+
+* Correct LangSmith sandbox working directory ([#3415](https://github.com/langchain-ai/deepagents/issues/3415)) ([b0e8d83](https://github.com/langchain-ai/deepagents/commit/b0e8d83f97a2a698268173a839000c84e8368324))
+* Guard `fetch_url` against SSRF ([#3411](https://github.com/langchain-ai/deepagents/issues/3411)) ([54d8521](https://github.com/langchain-ai/deepagents/commit/54d8521976940dfe147ead4b56565360241335be))
+
+## [0.1.0](https://github.com/langchain-ai/deepagents/compare/deepagents-code==0.0.1...deepagents-code==0.1.0) (2026-05-12)
+
+Hello world! Ported from `libs/cli`.
+
+---
+
+`deepagents-code` was forked from `deepagents-cli` at v0.1.0 (2026-05-12).
+For history prior to the fork, see [the `deepagents-cli` changelog](https://github.com/langchain-ai/deepagents/blob/main/libs/cli/CHANGELOG.md).

deepagents_code-0.1.4/COMMANDS.md

@@ -0,0 +1,44 @@
+<!-- AUTO-GENERATED by scripts/generate_commands_catalog.py — do not edit manually. -->
+# Slash command catalog
+
+Canonical list of slash commands for `deepagents-code`, derived from
+`deepagents_code/command_registry.py`. Run `make commands-catalog` to
+regenerate after editing the registry.
+
+
+## Public (25)
+
+| Command | Aliases | Description |
+| --- | --- | --- |
+| `/agents` |  | Browse and switch between available agents |
+| `/auth` | `/connect` | Manage stored API keys for model providers |
+| `/auto-update` |  | Toggle automatic updates on or off |
+| `/changelog` |  | Open changelog in browser |
+| `/clear` |  | Clear chat and start new thread |
+| `/copy` |  | Copy latest assistant message to clipboard |
+| `/docs` |  | Open documentation in browser |
+| `/editor` |  | Open prompt in external editor ($EDITOR) |
+| `/feedback` |  | Submit a bug report or feature request |
+| `/force-clear` |  | Interrupt active work, clear chat, and start new thread |
+| `/help` |  | Show help |
+| `/mcp` |  | Show MCP servers; `/mcp login <server>` to authenticate, `/mcp reconnect` to load deferred logins, F2 in the viewer to disable/enable a server |
+| `/model` |  | Switch or configure model (--model-params, --default) |
+| `/notifications` |  | Configure startup warning preferences |
+| `/offload` | `/compact` | Free up context window space by offloading older messages |
+| `/quit` | `/q` | Exit app |
+| `/reload` |  | Reload config from environment variables and .env |
+| `/remember` |  | Update memory and skills from conversation |
+| `/skill-creator` |  | Guide for creating effective agent skills |
+| `/theme` |  | Switch color theme |
+| `/threads` |  | Browse and resume previous threads |
+| `/tokens` |  | Token usage |
+| `/trace` |  | Open current thread in LangSmith |
+| `/update` |  | Check for and install updates |
+| `/version` | `/about` | Show version |
+
+## Hidden (2)
+
+Hidden commands not exposed in autocomplete or help. See the `HIDDEN_COMMANDS` docstring in the registry for context.
+
+- `/debug-error`
+- `/restart`

{deepagents_code-0.1.2 → deepagents_code-0.1.4}/Makefile

@@ -1,4 +1,4 @@
-.PHONY: format lint type typecheck test tests integration_test integration_tests test_watch benchmark bench bench-memory help run lint_package lint_tests check_imports coverage
+.PHONY: format lint type typecheck test tests integration_test integration_tests test_watch benchmark bench bench-memory help run lint_package lint_tests check_imports coverage commands-catalog commands-catalog-check
 
 .DEFAULT_GOAL := help
 
@@ -66,6 +66,7 @@ lint lint_diff lint_package lint_tests:
 	[ "$(PYTHON_FILES)" = "" ] || uv run --all-groups ruff check $(PYTHON_FILES)
 	[ "$(PYTHON_FILES)" = "" ] || uv run --all-groups ruff format $(PYTHON_FILES) --diff
 	$(MAKE) type PYTHON_FILES="$(PYTHON_FILES)"
+	uv run --all-groups python scripts/generate_commands_catalog.py --check
 
 type: ## Run type checker
 type typecheck:
@@ -80,6 +81,12 @@ check_imports: ## Check imports
 check_imports: $(shell find deepagents_code -name '*.py')
 	uv run --all-groups python ./scripts/check_imports.py $^
 
+commands-catalog: ## Regenerate COMMANDS.md from the slash-command registry
+	uv run --all-groups python scripts/generate_commands_catalog.py
+
+commands-catalog-check: ## Verify COMMANDS.md matches the slash-command registry
+	uv run --all-groups python scripts/generate_commands_catalog.py --check
+
 ######################
 # HELP
 ######################

{deepagents_code-0.1.2 → deepagents_code-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepagents-code
-Version: 0.1.2
+Version: 0.1.4
 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/
@@ -27,7 +27,7 @@ Classifier: Topic :: Terminals
 Requires-Python: <4.0,>=3.11
 Requires-Dist: aiosqlite<1.0.0,>=0.19.0
 Requires-Dist: deepagents-acp>=0.0.4
-Requires-Dist: deepagents==0.6.2
+Requires-Dist: deepagents==0.6.3
 Requires-Dist: httpx<1.0.0,>=0.28.1
 Requires-Dist: langchain-anthropic<2.0.0,>=1.4.3
 Requires-Dist: langchain-google-genai<5.0.0,>=4.2.2
@@ -69,7 +69,7 @@ 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-huggingface<2.0.0,>=1.2.2; extra == 'all-providers'
 Requires-Dist: langchain-ibm<2.0.0,>=1.0.7; extra == 'all-providers'
-Requires-Dist: langchain-litellm<2.0.0,>=0.6.4; 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-nvidia-ai-endpoints<2.0.0,>=1.2.1; extra == 'all-providers'
 Requires-Dist: langchain-ollama<2.0.0,>=1.1.0; extra == 'all-providers'
@@ -106,7 +106,7 @@ Requires-Dist: langchain-huggingface<2.0.0,>=1.2.2; extra == 'huggingface'
 Provides-Extra: ibm
 Requires-Dist: langchain-ibm<2.0.0,>=1.0.7; extra == 'ibm'
 Provides-Extra: litellm
-Requires-Dist: langchain-litellm<2.0.0,>=0.6.4; 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'
 Provides-Extra: modal
@@ -121,6 +121,8 @@ 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.2.0; extra == 'perplexity'
+Provides-Extra: quickjs
+Requires-Dist: langchain-quickjs<0.2.0,>=0.1.2; extra == 'quickjs'
 Provides-Extra: runloop
 Requires-Dist: langchain-runloop>=0.0.4; extra == 'runloop'
 Provides-Extra: together
@@ -154,13 +156,6 @@ curl -LsSf https://langch.in/dcode | bash
 DEEPAGENTS_EXTRAS="nvidia,ollama" curl -LsSf https://langch.in/dcode | bash
 ```
 
-Or install directly with `uv`:
-
-```bash
-# Install with chosen model providers
-uv tool install 'deepagents-code[nvidia,ollama]'
-```
-
 Run:
 
 ```bash

{deepagents_code-0.1.2 → deepagents_code-0.1.4}/README.md

@@ -21,13 +21,6 @@ curl -LsSf https://langch.in/dcode | bash
 DEEPAGENTS_EXTRAS="nvidia,ollama" curl -LsSf https://langch.in/dcode | bash
 ```
 
-Or install directly with `uv`:
-
-```bash
-# Install with chosen model providers
-uv tool install 'deepagents-code[nvidia,ollama]'
-```
-
 Run:
 
 ```bash

{deepagents_code-0.1.2 → deepagents_code-0.1.4}/deepagents_code/__init__.py

@@ -1,4 +1,4 @@
-"""Deep Agents CLI - Interactive AI coding assistant."""
+"""Deep Agents Code - Interactive AI coding assistant."""
 
 from __future__ import annotations
 

{deepagents_code-0.1.2 → deepagents_code-0.1.4}/deepagents_code/_server_config.py

@@ -152,6 +152,26 @@ class ServerConfig:
     enable_skills: bool = True
     """Enable the skills subsystem (SKILL.md loading and skill tools)."""
 
+    enable_interpreter: bool = False
+    """Enable `CodeInterpreterMiddleware` (`js_eval` REPL) on the main agent.
+
+    Local-mode only; the server graph raises if a sandbox is configured and
+    this flag is `True`.
+    """
+
+    interpreter_ptc: str | list[str] | None = None
+    """Override for `settings.interpreter_ptc`.
+
+    `None` means "fall through to whatever `settings.interpreter_ptc` resolves
+    to from `~/.deepagents/config.toml`". A string is one of `"safe"`/`"all"`;
+    a list is an explicit allowlist of tool names.
+    """
+
+    interpreter_ptc_acknowledge_unsafe: bool = False
+    """Mirror of `settings.interpreter_ptc_acknowledge_unsafe` — required when
+    `interpreter_ptc="all"` is paired with non-`auto_approve` mode.
+    """
+
     sandbox_type: str | None = None
     """Sandbox backend identifier (e.g. `'daytona'`); `None` runs tools on the
     host. `'none'` is normalized to `None` in `__post_init__`."""
@@ -159,6 +179,10 @@ class ServerConfig:
     sandbox_id: str | None = None
     """Existing sandbox ID to attach to; `None` creates a fresh sandbox."""
 
+    sandbox_snapshot_name: str | None = None
+    """Sandbox snapshot name to use or create. LangSmith-only; must be `None`
+    when `sandbox_id` is set."""
+
     sandbox_setup: str | None = None
     """Absolute path to a setup script executed inside the sandbox on first attach."""
 
@@ -226,8 +250,18 @@ class ServerConfig:
             "ENABLE_ASK_USER": str(self.enable_ask_user).lower(),
             "ENABLE_MEMORY": str(self.enable_memory).lower(),
             "ENABLE_SKILLS": str(self.enable_skills).lower(),
+            "ENABLE_INTERPRETER": str(self.enable_interpreter).lower(),
+            "INTERPRETER_PTC": (
+                json.dumps(self.interpreter_ptc)
+                if self.interpreter_ptc is not None
+                else None
+            ),
+            "INTERPRETER_PTC_ACKNOWLEDGE_UNSAFE": str(
+                self.interpreter_ptc_acknowledge_unsafe
+            ).lower(),
             "SANDBOX_TYPE": self.sandbox_type,
             "SANDBOX_ID": self.sandbox_id,
+            "SANDBOX_SNAPSHOT_NAME": self.sandbox_snapshot_name,
             "SANDBOX_SETUP": self.sandbox_setup,
             "CWD": self.cwd,
             "PROJECT_ROOT": self.project_root,
@@ -268,8 +302,14 @@ class ServerConfig:
             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),
+            enable_interpreter=_read_env_bool("ENABLE_INTERPRETER"),
+            interpreter_ptc=_read_env_json("INTERPRETER_PTC"),
+            interpreter_ptc_acknowledge_unsafe=_read_env_bool(
+                "INTERPRETER_PTC_ACKNOWLEDGE_UNSAFE"
+            ),
             sandbox_type=_read_env_str("SANDBOX_TYPE"),
             sandbox_id=_read_env_str("SANDBOX_ID"),
+            sandbox_snapshot_name=_read_env_str("SANDBOX_SNAPSHOT_NAME") or None,
             sandbox_setup=_read_env_str("SANDBOX_SETUP"),
             cwd=_read_env_str("CWD"),
             project_root=_read_env_str("PROJECT_ROOT"),
@@ -295,9 +335,13 @@ class ServerConfig:
         shell_allow_list: list[str] | None = None,
         sandbox_type: str = "none",
         sandbox_id: str | None,
+        sandbox_snapshot_name: str | None,
         sandbox_setup: str | None,
         enable_shell: bool,
         enable_ask_user: bool,
+        enable_interpreter: bool = False,
+        interpreter_ptc: str | list[str] | None = None,
+        interpreter_ptc_acknowledge_unsafe: bool = False,
         mcp_config_path: str | None,
         no_mcp: bool,
         trust_project_mcp: bool | None,
@@ -321,9 +365,16 @@ class ServerConfig:
                 server subprocess for `ShellAllowListMiddleware`.
             sandbox_type: Sandbox type.
             sandbox_id: Existing sandbox ID to reuse.
+            sandbox_snapshot_name: Sandbox snapshot name to use or create
+                (langsmith only).
             sandbox_setup: Path to setup script for the sandbox.
             enable_shell: Enable shell execution tools.
             enable_ask_user: Enable ask_user tool.
+            enable_interpreter: Enable `CodeInterpreterMiddleware` on the main
+                agent.
+            interpreter_ptc: Override for `settings.interpreter_ptc`.
+            interpreter_ptc_acknowledge_unsafe: Mirror of
+                `settings.interpreter_ptc_acknowledge_unsafe`.
             mcp_config_path: Path to MCP config.
             no_mcp: Disable MCP.
             trust_project_mcp: Trust project MCP servers.
@@ -344,8 +395,12 @@ class ServerConfig:
             interactive=interactive,
             enable_shell=enable_shell,
             enable_ask_user=enable_ask_user,
+            enable_interpreter=enable_interpreter,
+            interpreter_ptc=interpreter_ptc,
+            interpreter_ptc_acknowledge_unsafe=interpreter_ptc_acknowledge_unsafe,
             sandbox_type=sandbox_type,
             sandbox_id=sandbox_id,
+            sandbox_snapshot_name=sandbox_snapshot_name,
             sandbox_setup=_normalize_path(
                 sandbox_setup, project_context, "sandbox setup"
             ),

deepagents_code-0.1.4/deepagents_code/_startup_error.py

@@ -0,0 +1,45 @@
+"""Stderr marker emission used by the langgraph server graph entry point.
+
+Lives in its own module so unit tests can exercise the marker contract
+without triggering `server_graph.make_graph()` at import time.
+"""
+
+from __future__ import annotations
+
+import logging
+import sys
+import traceback
+
+logger = logging.getLogger(__name__)
+
+STARTUP_ERROR_MARKER = "DEEPAGENTS_STARTUP_ERROR:"
+"""Stderr marker the parent app scans for in `server._extract_startup_error_marker`
+to upgrade an opaque "Server process exited with code N" into a one-line summary.
+Format is `{STARTUP_ERROR_MARKER}{single-line message}`."""
+
+
+def emit_startup_failure(exc: BaseException) -> None:
+    """Report a server graph startup failure to the parent app process.
+
+    Emits two stderr outputs: the full traceback for logs/debugging, then a
+    single-line `{STARTUP_ERROR_MARKER}{type}: {summary}` line that
+    `server._extract_startup_error_marker` parses to upgrade an opaque
+    "Server process exited with code N" into an actionable summary.
+
+    Args:
+        exc: The exception raised during graph initialization.
+    """
+    logger.critical("Failed to initialize server graph", exc_info=exc)
+    print(  # noqa: T201  # stderr fallback — logger may not reach parent process
+        f"Failed to initialize server graph: {exc}\n{traceback.format_exc()}",
+        file=sys.stderr,
+    )
+    # Marker contract is single-line; guard against multi-line/empty `str(exc)`
+    # and include the type so e.g. `ValueError` and `RuntimeError` are
+    # distinguishable in the parent's truncated summary.
+    exc_lines = str(exc).splitlines()
+    summary = exc_lines[0] if exc_lines else "<no message>"
+    print(  # noqa: T201
+        f"{STARTUP_ERROR_MARKER}{type(exc).__name__}: {summary}",
+        file=sys.stderr,
+    )

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