config

Valid sandbox provider identifiers.

Valid sandbox scope values.

Valid sandbox providers for deploy (subset of sandbox_factory, plus "none").

Load and parse a deepagents.toml file.

Find deepagents.toml in start_path (or cwd if not given).

Only checks the single directory — does not walk parent directories.

Returns the path if found, or None otherwise.

Generate a starter deepagents.toml template.

Generate a starter AGENTS.md template.

Generate a starter .env template.

Generate a starter mcp.json template.

Generate a starter skills/review/SKILL.md for code review.

[agent] section — core agent identity.

[sandbox] section — sandbox provider settings.

The whole section is optional. When omitted (or provider = "none") the runtime falls back to an in-process StateBackend and tools like execute become no-ops.

scope controls how the sandbox cache keys are built:

• "thread" (default): one sandbox per thread. Different threads get different sandboxes, same thread reuses across turns.
• "assistant": one sandbox per assistant. All threads of the same assistant share a single sandbox and its filesystem.

Top-level deploy configuration parsed from deepagents.toml.