deepagents-code 0.1.20__tar.gz → 0.1.22__tar.gz

{deepagents_code-0.1.20 → deepagents_code-0.1.22}/AGENTS.md

@@ -2,7 +2,7 @@
 
 `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`.
+For monorepo-wide conventions (commit titles, lint, testing, docs, CI, benchmarks), see the root `AGENTS.md`. For a high-level map of the package (client/server processes, request lifecycle, module map), see `ARCHITECTURE.md`.
 
 ## Textual (terminal UI framework)
 
@@ -71,40 +71,7 @@ Casts are acceptable when the type violation is the point of the test (for examp
 
 `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`).
 
-## Local dev installs
-
-Keep the released CLI and editable development CLI separate:
-
-- `dcode` / `deepagents-code` should point at the normal installed tool, typically managed by `uv tool install deepagents-code`.
-- `dcode-dev` should point at a dedicated editable venv under `~/.local/share/dcode-dev`, with a symlink in `~/.local/bin/dcode-dev`.
-
-This uses a manual `uv venv` + `uv pip install -e` rather than `uv sync` or `uv tool install --editable` on purpose: it builds an isolated venv outside the workspace's locked environment, so the dev binary can be re-resolved on demand without disturbing the released tool or the repo's `uv.lock`. `uv pip`/`uv venv` are first-class `uv` subcommands here, not bare `pip`.
-
-`~/.local/bin` must be on your `PATH` for the `dcode-dev` symlink to resolve (`uv tool install` adds its own shim directory automatically, but a hand-rolled symlink does not).
-
-Example setup. The `--python` value is illustrative — any interpreter satisfying the package's `requires-python` (currently `>=3.11`) works; omit the flag to let `uv` pick. Replace `<repo>` with your local checkout path.
-
-```bash
-uv venv ~/.local/share/dcode-dev --python 3.13
-uv pip install --python ~/.local/share/dcode-dev/bin/python -e <repo>/libs/code
-ln -sf ~/.local/share/dcode-dev/bin/dcode ~/.local/bin/dcode-dev
-```
-
-When dependency constraints change in `libs/code/pyproject.toml`, update the dev venv explicitly:
-
-```bash
-uv pip install --python ~/.local/share/dcode-dev/bin/python -e <repo>/libs/code --upgrade
-```
-
-Verify command resolution and editable imports (the `dcode` checks assume the released tool is installed separately, per above):
-
-```bash
-which dcode
-which dcode-dev
-dcode --version
-dcode-dev --version
-~/.local/share/dcode-dev/bin/python -c 'import deepagents_code; print(deepagents_code.__file__)'
-```
+For a persistent editable `dcode-dev` install that stays separate from a released install, see [Local dev installs](./DEVELOPMENT.md#local-dev-installs) in the development guide.
 
 ## Startup performance
 
@@ -124,7 +91,7 @@ Debug logging is configured **once**, on the `deepagents_code` package logger, b
 
 - Do **not** add per-module `configure_debug_logging(logger)` calls. They are redundant now that the package logger is configured at import, and they reintroduce the duplicate-handler problem the single-config approach solves.
 - Every module should create its logger with `logging.getLogger(__name__)` so it stays inside the `deepagents_code.*` hierarchy and inherits the package handler. Don't set `logger.propagate = False` or attach your own handlers.
-- The handler only attaches when `DEEPAGENTS_CODE_DEBUG` is truthy; the no-op path is a single env-var read, so it's safe on the startup hot path. See `DEV.md` for the `DEEPAGENTS_CODE_DEBUG` / `DEEPAGENTS_CODE_DEBUG_FILE` env vars.
+- The handler only attaches when `DEEPAGENTS_CODE_DEBUG` is truthy; the no-op path is a single env-var read, so it's safe on the startup hot path. See `DEVELOPMENT.md` for the `DEEPAGENTS_CODE_DEBUG` / `DEEPAGENTS_CODE_DEBUG_FILE` env vars.
 
 ## CLI help screen
 
@@ -138,7 +105,7 @@ When adding a user-facing CLI feature (new slash command, keybinding, workflow),
 
 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.
+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 commands-catalog` if you changed command names, aliases, descriptions, visibility, or hidden-command metadata, then (5) run `make lint && make test` — the drift test will catch any mismatch.
 
 ## Adding a new model provider
 

deepagents_code-0.1.22/ARCHITECTURE.md

@@ -0,0 +1,70 @@
+# Deep Agents Code Architecture
+
+## What this package is
+
+`deepagents-code` is a prebuilt terminal coding agent built on top of the `deepagents` SDK. It is a reference implementation: one design for packaging the SDK into a useful coding-agent product, based on patterns that have worked well in our experience.
+
+The SDK provides the agent harness. This package shows how to combine that harness with a terminal experience, persistence, tools, skills, and optional sandboxed execution.
+
+## The big picture
+
+Deep Agents Code has two runtime halves:
+
+```text
+┌──────────────────── Terminal client ─────────────────────┐
+│  Presents interactive or headless output                 │
+│  Collects user input and approvals                       │
+└──────────────────────────┬───────────────────────────────┘
+                           │ streaming protocol
+                           ▼
+┌──────────────────── Agent server ────────────────────────┐
+│  Runs the coding agent graph                             │
+│  Connects the model, tools, memory, skills, and backend  │
+└──────────────────────────────────────────────────────────┘
+```
+
+The client and server run in separate processes. The client owns presentation and input. The server owns the agent runtime. Keeping that boundary narrow makes the UI responsive while letting the agent use LangGraph's streaming, checkpointing, and resume behavior.
+
+## Request flow
+
+A request follows the same shape in interactive and headless mode:
+
+1. The client receives user input.
+2. The client sends that input to the agent server.
+3. The server runs the agent and streams events back.
+4. The client renders those events and collects any needed human response.
+5. Session state is preserved so the conversation can continue later.
+
+Headless mode uses the same agent runtime as the interactive UI, but swaps the terminal interface for machine-friendly input and output.
+
+## Configuration and extension
+
+Configuration is layered across user, project, session, and runtime scopes. That lets teams share project defaults while individual users keep their own credentials, preferences, skills, and local settings.
+
+The main extension points are:
+
+- **Skills and subagents** for reusable agent workflows
+- **Tools and MCP servers** for external capabilities
+- **Sandboxes** for changing where tool execution happens
+- **Hooks and commands** for integrating with local workflows
+
+These pieces are designed to compose. A project can provide shared defaults and integrations, while each user can layer personal configuration on top.
+
+## Design tradeoffs
+
+This architecture optimizes for:
+
+- A responsive local terminal experience
+- A reusable agent core that can be tested apart from the UI
+- Durable sessions that can be resumed
+- Controlled tool execution, locally or in a sandbox
+- Practical extension points without rewriting the core app
+
+The main cost is the client/server boundary. When debugging, first decide which side owns the failure: presentation and input usually belong to the client; model execution, tools, memory, and graph startup usually belong to the server.
+
+## Where to go next
+
+- For local setup and debugging, see [`DEVELOPMENT.md`](./DEVELOPMENT.md).
+- For command behavior, see [`COMMANDS.md`](./COMMANDS.md).
+- For security boundaries, see [`THREAT_MODEL.md`](./THREAT_MODEL.md).
+- For package-specific coding conventions, see [`AGENTS.md`](./AGENTS.md).

{deepagents_code-0.1.20 → deepagents_code-0.1.22}/CHANGELOG.md

@@ -2,6 +2,46 @@
 
 # Deep Agents Code Changelog
 
+## [0.1.22](https://github.com/langchain-ai/deepagents/compare/deepagents-code==0.1.21...deepagents-code==0.1.22) (2026-06-24)
+
+### Features
+
+* Add LangSmith tracing config to `/auth` ([#4193](https://github.com/langchain-ai/deepagents/issues/4193)) ([8e62957](https://github.com/langchain-ai/deepagents/commit/8e6295791093c2ddfec7e6ac57f0df7f12048447))
+* Auto-retry credentials-blocked startup after `/auth` ([#4176](https://github.com/langchain-ai/deepagents/issues/4176)) ([d10ba3d](https://github.com/langchain-ai/deepagents/commit/d10ba3dc162e47cc71df56b8e3d0000b6e0ed847))
+* Improve onboarding Installed Integrations screen ([#4195](https://github.com/langchain-ai/deepagents/issues/4195)) ([0827bf1](https://github.com/langchain-ai/deepagents/commit/0827bf1b635b825121740ac8946dd6d98c815c7d))
+
+### Bug Fixes
+
+* Exclude managed bin dir from agent picker ([#4190](https://github.com/langchain-ai/deepagents/issues/4190)) ([d869d1e](https://github.com/langchain-ai/deepagents/commit/d869d1e1fa8558510fb48e71f78fb74c69ca4840))
+* Warn on `/trace` when thread has no messages ([#4162](https://github.com/langchain-ai/deepagents/issues/4162)) ([c338fc9](https://github.com/langchain-ai/deepagents/commit/c338fc914fcd383beb4b97c13f53dfb2684f8c90))
+* Hide "Recent" section during onboarding model selection ([#4198](https://github.com/langchain-ai/deepagents/issues/4198)) ([af882e4](https://github.com/langchain-ai/deepagents/commit/af882e4f6c859878e350d8a37bb75b7bc01bb453))
+* Keep auth modal interactive after install-on-select ([#4187](https://github.com/langchain-ai/deepagents/issues/4187)) ([afbc56a](https://github.com/langchain-ai/deepagents/commit/afbc56a1d9dbe8a89015f4c2f90bb87547d5c1d4))
+* Generic "missing credentials" in model switcher ([#4182](https://github.com/langchain-ai/deepagents/issues/4182)) ([456ce5c](https://github.com/langchain-ai/deepagents/commit/456ce5c2f5487a754d1fea7046e32c03b7e27a17))
+* Hide chat input action buttons in same frame as empty draft ([#4178](https://github.com/langchain-ai/deepagents/issues/4178)) ([f94d417](https://github.com/langchain-ai/deepagents/commit/f94d417d5ad9928db967777fe1d7bc2c37684fb9))
+* Preserve uv tool context when installing extras ([#4201](https://github.com/langchain-ai/deepagents/issues/4201)) ([fcc616c](https://github.com/langchain-ai/deepagents/commit/fcc616cf9bc2bbc7b2dc2574ae8649e2f270dc53))
+* Unpin uv self-updates and warn when a stale dcode shadows PATH ([#4185](https://github.com/langchain-ai/deepagents/issues/4185)) ([8ca0a18](https://github.com/langchain-ai/deepagents/commit/8ca0a185a15f800267cc057178a348fb5063df1e))
+
+## [0.1.21](https://github.com/langchain-ai/deepagents/compare/deepagents-code==0.1.20...deepagents-code==0.1.21) (2026-06-23)
+
+### Features
+
+* `dcode doctor` diagnostics command ([#4148](https://github.com/langchain-ai/deepagents/issues/4148)) ([8179731](https://github.com/langchain-ai/deepagents/commit/81797312c7d857e7d94d03c9c695cd3c8d88799a))
+* Add structured TUI display for `js_eval` ([#4151](https://github.com/langchain-ai/deepagents/issues/4151)) ([91c0dae](https://github.com/langchain-ai/deepagents/commit/91c0dae3fe0253f02a5926fcd3c6f796cd8d11fe))
+* Allow dependency updates without requiring release ([#4157](https://github.com/langchain-ai/deepagents/issues/4157)) ([7beb97a](https://github.com/langchain-ai/deepagents/commit/7beb97a2b02e2fd238baf3b6f05d43a4accf3f42))
+* Clear chat input via `esc+esc`, add `[ X ]/[ COPY ]` buttons ([#4000](https://github.com/langchain-ai/deepagents/issues/4000)) ([c20546f](https://github.com/langchain-ai/deepagents/commit/c20546feac7876786e6816776d1ccfa5fcd4b2c8))
+* Confirm "Launched" after auto-update restart ([#4098](https://github.com/langchain-ai/deepagents/issues/4098)) ([df8db8a](https://github.com/langchain-ai/deepagents/commit/df8db8af6a7cbfc2ab535020b951d73759da73dd))
+* Surface tracing in `doctor` and `config show` ([#4163](https://github.com/langchain-ai/deepagents/issues/4163)) ([2bb3e44](https://github.com/langchain-ai/deepagents/commit/2bb3e44243553a5f2954a0f3ec42364563842a87))
+
+### Bug Fixes
+
+* Handle LangSmith project-not-found and default tracing project ([#4153](https://github.com/langchain-ai/deepagents/issues/4153)) ([e303ce9](https://github.com/langchain-ai/deepagents/commit/e303ce986a3595f0cf458e796d857f7c8f5f8b5c))
+* Make `/timestamps` toggle instant via per-footer class ([#4095](https://github.com/langchain-ai/deepagents/issues/4095)) ([7ae32b0](https://github.com/langchain-ai/deepagents/commit/7ae32b0a606cc200d4311e11036a65f17e8282b3))
+* Refocus `/mcp` filter input after in-place refresh ([#4080](https://github.com/langchain-ai/deepagents/issues/4080)) ([d79cd74](https://github.com/langchain-ai/deepagents/commit/d79cd74cb8a44c300c3bbad712fe77e709f9221a))
+* Report same-version dependency updates ([#4146](https://github.com/langchain-ai/deepagents/issues/4146)) ([156e118](https://github.com/langchain-ai/deepagents/commit/156e1185242a19746f8c268904637c73f07b9a10))
+* Show "Loading..." in `/threads` agent dropdown while loading ([#4101](https://github.com/langchain-ai/deepagents/issues/4101)) ([c2d949e](https://github.com/langchain-ai/deepagents/commit/c2d949e8765fbbbdb81e5a70125932842358099f))
+* Skip tool interrupts once auto-approve is set ([#4092](https://github.com/langchain-ai/deepagents/issues/4092)) ([9e21c34](https://github.com/langchain-ai/deepagents/commit/9e21c346a6eb8ad25b9cc671f24527b07732e2b7))
+* Word-delete backspace parity in ask-user text area ([#4079](https://github.com/langchain-ai/deepagents/issues/4079)) ([ed3c499](https://github.com/langchain-ai/deepagents/commit/ed3c499354467bc5e8476e5c7cdf0cd5f8b6aec1))
+
 ## [0.1.20](https://github.com/langchain-ai/deepagents/compare/deepagents-code==0.1.19...deepagents-code==0.1.20) (2026-06-17)
 
 ### Features

deepagents_code-0.1.22/COMMANDS.md

@@ -0,0 +1,47 @@
+<!-- AUTO-GENERATED by scripts/generate_commands_catalog.py — do not edit manually. -->
+# Slash command catalog
+
+This is the generated reference for `deepagents-code` slash commands. Command
+names, aliases, and descriptions come from `deepagents_code/command_registry.py`.
+Regenerate this file with `make commands-catalog` after changing command names,
+aliases, descriptions, visibility, or hidden-command metadata.
+
+
+## Public (28)
+
+| Command | Aliases | Description |
+| --- | --- | --- |
+| `/agents` |  | Browse and switch between available agents |
+| `/auth` | `/connect` | Connect and manage provider and service credentials |
+| `/auto-update` |  | Turn automatic updates on or off |
+| `/changelog` |  | Open the changelog in a browser |
+| `/clear` |  | Clear the chat and start a new thread |
+| `/copy` |  | Copy the latest assistant message to clipboard |
+| `/docs` |  | Open the docs |
+| `/editor` |  | Open prompt in an external editor ($EDITOR) |
+| `/feedback` |  | Send feedback or report an issue |
+| `/force-clear` |  | Stop active work, clear the chat, and start a new thread |
+| `/help` |  | Show help and available commands |
+| `/install` |  | Install an optional integration |
+| `/mcp` |  | Manage MCP servers and authentication |
+| `/model` |  | Switch models or edit model settings |
+| `/notifications` |  | Configure startup warnings |
+| `/offload` | `/compact` | Offload older messages to free context |
+| `/quit` | `/q` | Exit app |
+| `/reload` |  | Reload environment and config |
+| `/remember` |  | Save useful context to memory or skills |
+| `/restart` |  | Restart the agent server |
+| `/skill-creator` |  | Create or refine agent skills |
+| `/theme` |  | Change color theme |
+| `/threads` |  | Browse and resume past threads |
+| `/timestamps` |  | Show or hide message timestamps |
+| `/tokens` |  | Show token usage |
+| `/trace` |  | Open this thread in LangSmith |
+| `/update` |  | Check for and install updates |
+| `/version` | `/about` | Show version information |
+
+## Hidden (1)
+
+These commands are intentionally omitted from autocomplete and help. See the `HIDDEN_COMMANDS` docstring in the registry for context.
+
+- `/debug-error`

deepagents_code-0.1.22/DEVELOPMENT.md

@@ -0,0 +1,209 @@
+# Deep Agents Code Development Guide
+
+New to the package? Start with [`ARCHITECTURE.md`](./ARCHITECTURE.md) for a high-level map of how the TUI, the `langgraph dev` server subprocess, and the agent graph fit together.
+
+## Contents
+
+- [Quickstart](#quickstart) — get a local checkout running and run the checks CI enforces
+- [Local dev installs](#local-dev-installs) — keep an editable `dcode-dev` separate from a released install
+- [Debugging](#debugging) — diagnose startup crashes and client-side issues
+- [Live CSS development with Textual devtools](#live-css-development-with-textual-devtools) — UI/CSS hot-reload
+
+## Quickstart
+
+This package uses [`uv`](https://docs.astral.sh/uv/) for environment and dependency management. Install it first if you haven't:
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+Clone the monorepo and bootstrap the `code` package. This creates the virtualenv, installs test dependencies, and installs local git hooks (`pre-commit` + `commit-msg`) so the same checks can run before you push:
+
+```bash
+git clone https://github.com/langchain-ai/deepagents.git
+cd deepagents/libs/code
+make bootstrap
+```
+
+If you only want to sync dependencies without installing hooks, run `uv sync --group test` instead.
+
+Run the TUI from `libs/code` in your local checkout:
+
+```bash
+uv run deepagents-code
+```
+
+`uv run` uses the project environment with the package installed editable, so source changes take effect on the next launch. If you want a persistent `dcode-dev` command that stays separate from a released install, use the local dev install setup below.
+
+### Running the tests and linters
+
+All commands run from `libs/code`. Before opening a PR, run the full local check suite:
+
+```bash
+make check
+```
+
+This runs linting, import checks, unit tests, and lockfile/version/extras checks.
+
+For targeted checks while iterating:
+
+```bash
+# Unit tests (no network)
+make test
+
+# A single test file
+make test TEST_FILE=tests/unit_tests/test_specific.py
+
+# Integration tests (network permitted)
+make integration_test
+```
+
+```bash
+# Auto-format (ruff format + autofix)
+make format
+
+# Lint + type-check (ruff, ty, commands-catalog check)
+make lint
+```
+
+Run `make help` to see every available target.
+
+## Debugging
+
+Deep Agents Code runs as two processes: the **Textual TUI** you interact with, and a **`langgraph dev` subprocess** that hosts the agent graph. Each writes its own log, and a single switch turns both on:
+
+```bash
+cd libs/code
+export DEEPAGENTS_CODE_DEBUG=1
+uv run deepagents-code
+```
+
+| Variable | Effect |
+| --- | --- |
+| `DEEPAGENTS_CODE_DEBUG` | Master switch. Preserves the server subprocess log on exit (printing its path to stderr) and attaches the client `DEBUG` file handler. Truthy: `1`/`true`/`yes`/`on` (case-insensitive). Falsy: `0`/`false`/`no`/`off`/empty/unset. |
+| `DEEPAGENTS_CODE_DEBUG_FILE=<path>` | Overrides the client log path (default `/tmp/deepagents_debug.log`). **Only takes effect when `DEEPAGENTS_CODE_DEBUG` is truthy**; does **not** affect the server subprocess log. |
+
+Then pick the log you need by symptom:
+
+| Symptom | Log you want | Default location |
+| --- | --- | --- |
+| App crashes on launch (one-line failure banner) | **Server subprocess log** — the real traceback | `$TMPDIR/deepagents_server_log_*.txt` |
+| App starts, then misbehaves (UI, model calls, slash commands) | **Client app log** — `deepagents_code` at `DEBUG` | `/tmp/deepagents_debug.log` |
+
+### Startup crash -> server subprocess log
+
+The TUI only surfaces a one-line banner; the actual exception lives in the subprocess's combined stdout/stderr. To get it:
+
+1. **Re-run with debugging on** (see above). On exit, the log is preserved and its path is printed to stderr as `Server log preserved at: ...`. Textual's fullscreen mode can hide that line, but the file is still on disk.
+2. **Open the newest log.** On macOS, `tempfile` resolves to `$TMPDIR` (a path under `/var/folders/.../T/`):
+
+   ```bash
+   # Newest first
+   ls -lt ${TMPDIR:-/tmp}/deepagents_server_log_*.txt | head -5
+
+   # Or tail the latest live while you reproduce the crash
+   tail -F "$(ls -t ${TMPDIR:-/tmp}/deepagents_server_log_*.txt | head -1)"
+   ```
+
+3. **Search for `Failed to initialize server graph`.** The traceback beneath it names the concrete failure — MCP config validation, sandbox init, model resolution, subagent load, and so on. Everything above that line is uvicorn/lifespan unwinding and can be ignored.
+
+### Client-side issue -> app log
+
+For problems that appear after the app is up, tail the client log in another terminal while reproducing:
+
+```bash
+tail -f /tmp/deepagents_debug.log
+```
+
+To send it elsewhere, also `export DEEPAGENTS_CODE_DEBUG_FILE=<path>`. The handler appends across runs, so a single file accumulates every session.
+
+## Local dev installs
+
+A *local dev install* gives you a persistent `dcode-dev` command that launches your checkout directly. It lives in a dedicated editable venv under `~/.local/share/dcode-dev`, symlinked into `~/.local/bin/dcode-dev`. It can sit alongside a released `dcode` without interfering:
+
+- `dcode` / `deepagents-code` — the released tool, installed via `curl -LsSf https://langch.in/dcode | bash` (the install script).
+- `dcode-dev` — your local checkout.
+
+That lets you compare released behavior against local, and fall back to a known-good build if your checkout breaks. Either way, the dedicated venv keeps the dev binary's dependency experiments out of the repo's locked `uv sync` environment.
+
+### Setup
+
+`~/.local/bin` must be on your `PATH` for the symlink to resolve (`uv tool install` adds its own shim directory automatically, but a hand-rolled symlink does not). Replace `<repo>` with your local checkout path:
+
+```bash
+# 1. Create an isolated venv for the dev binary
+uv venv ~/.local/share/dcode-dev --python 3.13
+
+# 2. Install your checkout into it, editable
+uv pip install --python ~/.local/share/dcode-dev/bin/python -e <repo>/libs/code
+
+# 3. Expose it as `dcode-dev` on your PATH
+ln -sf ~/.local/share/dcode-dev/bin/dcode ~/.local/bin/dcode-dev
+```
+
+The `--python 3.13` is illustrative — any interpreter satisfying the package's `requires-python` (currently `>=3.11`) works; omit the flag to let `uv` pick.
+
+> **Why `uv venv` + `uv pip install -e` rather than `uv sync` or `uv tool install --editable`?** This builds an isolated venv *outside* the workspace's locked environment, so the dev binary can be re-resolved on demand without disturbing the released tool or the repo's `uv.lock`. (`uv pip` and `uv venv` are first-class `uv` subcommands here, not bare `pip`.)
+
+### Updating
+
+When dependency constraints change in `libs/code/pyproject.toml`, refresh the dev venv:
+
+```bash
+uv pip install --python ~/.local/share/dcode-dev/bin/python -e <repo>/libs/code --upgrade
+```
+
+### Verifying
+
+Confirm command resolution and editable imports (the `dcode` checks assume the released tool is installed separately, per above):
+
+```bash
+which dcode
+which dcode-dev
+dcode --version
+dcode-dev --version
+~/.local/share/dcode-dev/bin/python -c 'import deepagents_code; print(deepagents_code.__file__)'
+```
+
+## Live CSS development with Textual devtools
+
+After completing the [Quickstart](#quickstart), use Textual's devtools console for CSS hot-reload and live `self.log()` output during development.
+
+Create the dev wrapper script once:
+
+```bash
+cat > /tmp/dev_deepagents.py << 'PYEOF'
+"""Dev wrapper to run Deep Agents Code with textual devtools."""
+import sys
+sys.argv = ["deepagents"] + sys.argv[1:]
+
+from deepagents_code.main import cli_main
+cli_main()
+PYEOF
+```
+
+Run both commands from `libs/code`:
+
+**Terminal 1** — devtools console:
+
+```bash
+uv run --group test textual console
+```
+
+**Terminal 2** — TUI with live reload:
+
+```bash
+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_code`. The wrapper script bridges the gap — `uv run --group test textual run --dev` ensures both `textual-dev` (from the `test` group) and `deepagents_code` are available in the same environment.

{deepagents_code-0.1.20 → deepagents_code-0.1.22}/Makefile

@@ -1,10 +1,12 @@
-.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
+.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 check bootstrap
 
 .DEFAULT_GOAL := help
 
 .EXPORT_ALL_VARIABLES:
 UV_FROZEN = true
 
+REPO_ROOT := $(shell git rev-parse --show-toplevel)
+
 ######################
 # TESTING AND COVERAGE
 ######################
@@ -87,6 +89,28 @@ commands-catalog: ## Regenerate COMMANDS.md from the slash-command registry
 commands-catalog-check: ## Verify COMMANDS.md matches the slash-command registry
 	uv run --all-groups python scripts/generate_commands_catalog.py --check
 
+######################
+# LOCAL CI PARITY
+######################
+
+bootstrap: ## Install dev dependencies and git hooks for local development
+	uv sync --group test
+	cd "$(REPO_ROOT)" && uvx pre-commit install --install-hooks
+	@echo "✅ Dev environment ready: deps synced and git hooks installed."
+
+check: ## Run the full local CI gauntlet (lint, types, imports, tests, repo gates)
+check: lint check_imports test
+	@echo "🔍 Verifying extras stay in sync with required deps..."
+	uv run --all-groups python "$(REPO_ROOT)/.github/scripts/check_extras_sync.py" pyproject.toml
+	@echo "🔍 Verifying pyproject.toml and _version.py agree..."
+	uv run --all-groups python "$(REPO_ROOT)/.github/scripts/check_version_equality.py"
+	@echo "🔒 Verifying uv.lock is up-to-date..."
+	uv lock --check
+	@echo "🔗 Checking SDK pin against workspace SDK (advisory)..."
+	@uv run --all-groups python "$(REPO_ROOT)/.github/scripts/check_sdk_pin.py" || \
+		{ rc=$$?; [ $$rc -eq 1 ] && echo "⚠️  SDK pin drift (advisory, non-fatal)." || exit $$rc; }
+	@echo "✅ All local CI checks passed!"
+
 ######################
 # HELP
 ######################

{deepagents_code-0.1.20 → deepagents_code-0.1.22}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepagents-code
-Version: 0.1.20
+Version: 0.1.22
 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,19 +27,20 @@ Classifier: Topic :: Terminals
 Requires-Python: <4.0,>=3.11
 Requires-Dist: aiosqlite<1.0.0,>=0.22.1
 Requires-Dist: deepagents-acp<1.0.0,>=0.0.8
-Requires-Dist: deepagents==0.6.10
+Requires-Dist: deepagents==0.6.11
 Requires-Dist: httpx<1.0.0,>=0.28.1
-Requires-Dist: langchain-anthropic<2.0.0,>=1.4.6
+Requires-Dist: langchain-anthropic<2.0.0,>=1.4.7
 Requires-Dist: langchain-google-genai<5.0.0,>=4.2.5
 Requires-Dist: langchain-mcp-adapters<1.0.0,>=0.3.0
-Requires-Dist: langchain-openai<2.0.0,>=1.3.2
-Requires-Dist: langchain<2.0.0,>=1.3.9
+Requires-Dist: langchain-openai<2.0.0,>=1.3.3
+Requires-Dist: langchain<2.0.0,>=1.3.11
 Requires-Dist: langgraph-checkpoint-sqlite<4.0.0,>=3.1.0
-Requires-Dist: langgraph-cli[inmem]<1.0.0,>=0.4.29
+Requires-Dist: langgraph-cli[inmem]<1.0.0,>=0.4.30
 Requires-Dist: langgraph-runtime-inmem<1.0.0,>=0.30.0
 Requires-Dist: langgraph-sdk<1.0.0,>=0.4.2
-Requires-Dist: langsmith[sandbox]>=0.8.15
+Requires-Dist: langsmith[sandbox]>=0.9.0
 Requires-Dist: markdownify<2.0.0,>=1.2.2
+Requires-Dist: mcp<2.0.0,>=1.9.2
 Requires-Dist: packaging>=26.2
 Requires-Dist: pillow<13.0.0,>=12.2.0
 Requires-Dist: prompt-toolkit<4.0.0,>=3.0.52
@@ -53,12 +54,12 @@ Requires-Dist: textual-autocomplete<5.0.0,>=4.0.6
 Requires-Dist: textual-speedups<1.0.0,>=0.2.1
 Requires-Dist: textual<9.0.0,>=8.2.7
 Requires-Dist: tomli-w<2.0.0,>=1.2.0
-Requires-Dist: uuid-utils<1.0.0,>=0.16.0
+Requires-Dist: uuid-utils<1.0.0,>=0.16.2
 Provides-Extra: agentcore
 Requires-Dist: langchain-agentcore-codeinterpreter<1.0.0,>=0.0.4; extra == 'agentcore'
 Provides-Extra: all-providers
-Requires-Dist: langchain-anthropic<2.0.0,>=1.4.6; extra == 'all-providers'
-Requires-Dist: langchain-aws<2.0.0,>=1.5.1; extra == 'all-providers'
+Requires-Dist: langchain-anthropic<2.0.0,>=1.4.7; extra == 'all-providers'
+Requires-Dist: langchain-aws<2.0.0,>=1.6.0; extra == 'all-providers'
 Requires-Dist: langchain-baseten<1.0.0,>=0.2.0; extra == 'all-providers'
 Requires-Dist: langchain-cohere<1.0.0,>=0.6.0; extra == 'all-providers'
 Requires-Dist: langchain-deepseek<2.0.0,>=1.1.0; extra == 'all-providers'
@@ -68,12 +69,12 @@ Requires-Dist: langchain-google-vertexai<4.0.0,>=3.2.4; extra == 'all-providers'
 Requires-Dist: langchain-groq<2.0.0,>=1.1.3; extra == 'all-providers'
 Requires-Dist: langchain-huggingface<2.0.0,>=1.2.2; extra == 'all-providers'
 Requires-Dist: langchain-ibm<2.0.0,>=1.1.0; extra == 'all-providers'
-Requires-Dist: langchain-litellm<2.0.0,>=0.6.6; extra == 'all-providers'
+Requires-Dist: langchain-litellm<2.0.0,>=0.7.0; extra == 'all-providers'
 Requires-Dist: langchain-mistralai<2.0.0,>=1.1.5; extra == 'all-providers'
 Requires-Dist: langchain-nvidia-ai-endpoints<2.0.0,>=1.4.1; extra == 'all-providers'
 Requires-Dist: langchain-ollama<2.0.0,>=1.1.0; extra == 'all-providers'
-Requires-Dist: langchain-openai<2.0.0,>=1.3.2; extra == 'all-providers'
-Requires-Dist: langchain-openrouter<2.0.0,>=0.2.3; extra == 'all-providers'
+Requires-Dist: langchain-openai<2.0.0,>=1.3.3; extra == 'all-providers'
+Requires-Dist: langchain-openrouter<2.0.0,>=0.2.4; extra == 'all-providers'
 Requires-Dist: langchain-perplexity<2.0.0,>=1.4.0; extra == 'all-providers'
 Requires-Dist: langchain-together<2.0.0,>=0.4.0; extra == 'all-providers'
 Requires-Dist: langchain-xai<2.0.0,>=1.2.2; extra == 'all-providers'
@@ -84,11 +85,11 @@ Requires-Dist: langchain-modal>=0.0.5; extra == 'all-sandboxes'
 Requires-Dist: langchain-runloop>=0.0.6; extra == 'all-sandboxes'
 Requires-Dist: langchain-vercel-sandbox>=0.0.1; extra == 'all-sandboxes'
 Provides-Extra: anthropic
-Requires-Dist: langchain-anthropic<2.0.0,>=1.4.6; extra == 'anthropic'
+Requires-Dist: langchain-anthropic<2.0.0,>=1.4.7; extra == 'anthropic'
 Provides-Extra: baseten
 Requires-Dist: langchain-baseten<1.0.0,>=0.2.0; extra == 'baseten'
 Provides-Extra: bedrock
-Requires-Dist: langchain-aws<2.0.0,>=1.5.1; extra == 'bedrock'
+Requires-Dist: langchain-aws<2.0.0,>=1.6.0; extra == 'bedrock'
 Provides-Extra: cohere
 Requires-Dist: langchain-cohere<1.0.0,>=0.6.0; extra == 'cohere'
 Provides-Extra: daytona
@@ -106,7 +107,7 @@ Requires-Dist: langchain-huggingface<2.0.0,>=1.2.2; extra == 'huggingface'
 Provides-Extra: ibm
 Requires-Dist: langchain-ibm<2.0.0,>=1.1.0; extra == 'ibm'
 Provides-Extra: litellm
-Requires-Dist: langchain-litellm<2.0.0,>=0.6.6; extra == 'litellm'
+Requires-Dist: langchain-litellm<2.0.0,>=0.7.0; extra == 'litellm'
 Provides-Extra: mistralai
 Requires-Dist: langchain-mistralai<2.0.0,>=1.1.5; extra == 'mistralai'
 Provides-Extra: modal
@@ -116,13 +117,13 @@ Requires-Dist: langchain-nvidia-ai-endpoints<2.0.0,>=1.4.1; extra == 'nvidia'
 Provides-Extra: ollama
 Requires-Dist: langchain-ollama<2.0.0,>=1.1.0; extra == 'ollama'
 Provides-Extra: openai
-Requires-Dist: langchain-openai<2.0.0,>=1.3.2; extra == 'openai'
+Requires-Dist: langchain-openai<2.0.0,>=1.3.3; extra == 'openai'
 Provides-Extra: openrouter
-Requires-Dist: langchain-openrouter<2.0.0,>=0.2.3; extra == 'openrouter'
+Requires-Dist: langchain-openrouter<2.0.0,>=0.2.4; extra == 'openrouter'
 Provides-Extra: perplexity
 Requires-Dist: langchain-perplexity<2.0.0,>=1.4.0; extra == 'perplexity'
 Provides-Extra: quickjs
-Requires-Dist: langchain-quickjs<0.3.0,>=0.2.0; extra == 'quickjs'
+Requires-Dist: langchain-quickjs<0.4.0,>=0.3.1; extra == 'quickjs'
 Provides-Extra: runloop
 Requires-Dist: langchain-runloop>=0.0.6; extra == 'runloop'
 Provides-Extra: together