Michiel Voortman e0cccd6b37
feat(sandbox): add boxd sandbox provider (#8314)
* feat(sandbox): add boxd sandbox provider

Adds deerflow.community.boxd_sandbox:BoxdSandboxProvider. Each user/thread
scope runs in an isolated boxd machine. New machines get the thread's files
and skills before they are handed out, release mirrors outputs back to
thread storage, and released machines wait in the shared warm pool.

The boxd SDK is an optional extra (deerflow-harness[boxd]). Unit tests run
against a fake client; tests/test_boxd_sandbox_live.py runs against real
machines when DEER_FLOW_RUN_LIVE_TESTS=1 and BOXD_API_KEY are set.

* fix(boxd): retain failed cleanup and bound output mirror calls

---------

Co-authored-by: Willem Jiang <willem.jiang@gmail.com>
2026-11-18 21:29:15 +08:00

120 lines
4.8 KiB
TOML

[project]
name = "deerflow-harness"
version = "2.3.0-dev"
description = "DeerFlow agent harness framework"
requires-python = ">=3.12"
dependencies = [
"agent-client-protocol>=0.4.0",
"agent-sandbox>=0.0.30",
"beautifulsoup4>=4.12",
"html5lib>=1.1",
"croniter>=6.0.0",
# Exact pin by design (extension-system version contract): the host pins
# the contract version it implements, extensions declare ranges. A range
# here would let pip resolve a newer contract package than this harness
# implements, making newer extensions look supported at runtime.
"deerflow-extension-api==0.2.13",
"dotenv>=0.9.9",
"exa-py>=1.0.0",
"httpx>=0.28.0",
"jsonschema>=4.26.0",
"kubernetes>=30.0.0",
# Lower bound reflects what the lockfile resolves and tests run against
# (langgraph 1.2.9 pulls langchain >=1.3 transitively).
"langchain>=1.3",
"langchain-anthropic>=1.4.1",
"langchain-deepseek>=1.0.1",
"langchain-mcp-adapters>=0.2.2",
"langchain-openviking==0.1.0",
"langchain-openai>=1.2.1",
"langfuse>=3.4.1",
"langgraph>=1.2.9,<1.3",
"langgraph-api>=0.8.1",
"langgraph-cli>=0.4.24",
# Standalone Studio's pre-runtime persistence repair is validated against
# the 0.30.0 store lifecycle and must not resolve an older implementation.
"langgraph-runtime-inmem>=0.30.0",
"markdownify>=1.2.2",
"markitdown[all,xlsx]>=0.0.1a2",
"packaging>=24.2",
"pydantic>=2.12.5",
"pyyaml>=6.0.3",
"readabilipy>=0.3.0",
"regex>=2026.4.4",
"tavily-python>=0.7.17",
"firecrawl-py>=1.15.0",
"tiktoken>=0.8.0",
"ddgs>=9.10.0",
"duckdb>=1.4.4",
"langchain-google-genai>=4.2.1",
# Floor matters: 4.2.0 fixed the dropped first post-migration write, and
# 4.3.0 makes same-superstep delta replay preserve live task-path order.
# Older resolutions can silently reintroduce both replay defects.
"langgraph-checkpoint>=4.3.0,<5.0",
"langgraph-checkpoint-sqlite>=3.1.2,<3.2",
"langgraph-sdk>=0.1.51",
"sqlalchemy[asyncio]>=2.0,<3.0",
"aiosqlite>=0.19",
"alembic>=1.13",
"cryptography>=50.0.0",
"e2b-code-interpreter>=2.8.0",
# zoneinfo fallback: ZoneInfo reads the OS zone database first and this
# wheel when the image has none (stripped containers, Windows without
# tzdata), keeping the DEER_FLOW_DATE_TIMEZONE knob portable.
"tzdata>=2025.1",
]
[project.scripts]
deerflow = "deerflow.tui.cli:main"
[project.optional-dependencies]
# Terminal workbench (TUI). Kept optional so the core harness install stays lean;
# the `deerflow` console script degrades to headless help when textual is absent.
tui = ["textual>=0.80"]
# GroundRoute needs no extra packages (httpx is already a core dependency). This
# empty extra exists so the documented `uv add 'deerflow-harness[groundroute]'`
# install command resolves cleanly without an "unknown extra" warning.
groundroute = []
ollama = ["langchain-ollama>=0.3.0"]
postgres = [
"asyncpg>=0.29",
# 3.1.2 finds plain-value delta seeds (upstream #8535); 3.1.3 fixes the
# paged ancestor-walk cursor (upstream #8556).
"langgraph-checkpoint-postgres>=3.1.3,<3.2",
"psycopg[binary]>=3.3.3",
"psycopg-pool>=3.3.0",
]
# Cross-process SSE stream bridge (stream_bridge.type: redis). Optional so
# single-process / memory-bridge installs do not pull redis. The Docker image
# always installs this extra because Docker defaults to the redis bridge.
redis = ["redis>=5.0.0"]
pymupdf = ["pymupdf4llm>=0.0.17"]
boxlite = ["boxlite>=0.9.7"]
# Tenki cloud sandbox provider (deerflow.community.tenki). Optional so a default
# install stays free of the Tenki SDK; only pulled in when the provider is used.
# The distribution is ``tenki``; it still ships the ``tenki_sandbox`` module that
# provider.py and sandbox.py import.
tenki = ["tenki>=1.4.0"]
# OpenSandbox remote sandbox provider (deerflow.community.opensandbox). The
# sync SDK is loaded only when this provider is selected.
opensandbox = ["opensandbox>=0.1.15,<0.2.0"]
# boxd machine sandbox provider (deerflow.community.boxd_sandbox). The SDK is
# loaded only when this provider is selected.
boxd = ["boxd>=0.3.2"]
# Agent observability (Monocle). Optional so a default install stays free of the
# OpenTelemetry stack; only pulled in when MONOCLE_TRACING is used.
monocle = ["monocle_apptrace>=0.8.8"]
# Agentic browser control (browser_navigate/click/type/... tool group). Optional
# so the core harness install stays lean; import is lazy inside the private
# Playwright loop. After install, run `playwright install chromium` once.
browser = ["playwright>=1.40"]
# Optional Chinese tokenization for the FTS5 memory retrieval adapter.
memory-zh = ["jieba>=0.42.1"]
[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"
[tool.hatch.build.targets.wheel]
packages = ["deerflow"]