langchain-ai/deepagents · error · RuntimeError

interpreter.enable_interpreter is missing from the config ma

Error message

interpreter.enable_interpreter is missing from the config manifest

What it means

`ServerConfig.from_cli_args()` resolves the `interpreter.enable_interpreter` option through the config manifest (`config_manifest.get_option`) and the configuration resolver. This `RuntimeError` is raised when the option is absent from the manifest, which indicates an internal inconsistency — the code asks for an option that the shipped manifest does not define (a broken or partial install, or a manifest drift bug).

Source

Thrown at libs/code/deepagents_code/_server_config.py:219

        The explicit `enable_interpreter` value when not `None`; `False` for
            remote-sandbox defaults; otherwise the configured local default
            from `interpreter.enable_interpreter`.

    Raises:
        RuntimeError: If the interpreter option is absent from the manifest.
    """
    if enable_interpreter is not None:
        return enable_interpreter
    if sandbox_type and sandbox_type != "none":
        return False

    from deepagents_code.config_manifest import _emit_ranked_diagnostics, get_option
    from deepagents_code.configuration.resolver import get_config_resolver

    option = get_option("interpreter.enable_interpreter")
    if option is None:
        msg = "interpreter.enable_interpreter is missing from the config manifest"
        raise RuntimeError(msg)
    resolved = get_config_resolver().get(option)
    _emit_ranked_diagnostics(option, resolved)
    return bool(resolved.value)


def _interpreter_suppressed_by_sandbox(
    *, enable_interpreter: bool | None, sandbox_type: str | None, local_default: bool
) -> bool:
    """Whether a remote sandbox suppressed the otherwise-default interpreter.

    Used to decide whether to surface an advisory: returns `True` only when the
    user made no explicit choice, a remote sandbox is active, and the local
    default would have enabled it — i.e. the sandbox (not an explicit
    `--no-interpreter` opt-out, nor a disabled `[interpreter]` config) is why
    `js_eval` is unavailable.

    Takes the *raw* tri-state caller intent rather than the resolved boolean: a
    sandbox-suppressed default and an explicit `--no-interpreter` both resolve to

View on GitHub (pinned to a1af029e6e)

Solutions

1. Reinstall the package cleanly: pip uninstall deepagents-code && pip install --force-reinstall deepagents-code
2. Ensure no stale files (e.g. an old config_manifest.py in site-packages or a shadowing local module) are on the import path
3. Check for version mismatch between installed deepagents-code and the deepagents SDK pin; align versions
4. If reproducible on a clean install, file a bug — the option should always be in the manifest

Example fix

// before (broken/stale install)
python -c "from deepagents_code.config_manifest import get_option; print(get_option('interpreter.enable_interpreter'))"
# None -> RuntimeError at startup
// after
pip uninstall -y deepagents-code && pip install --force-reinstall deepagents-code

from deepagents_code.config_manifest import get_option

if get_option("interpreter.enable_interpreter") is None:
    raise SystemExit("Install is missing manifest options; reinstall deepagents-code")

try:
    config = ServerConfig.from_cli_args(args)
except RuntimeError as e:
    if "missing from the config manifest" in str(e):
        print("Broken installation: reinstall deepagents-code (--force-reinstall)")
        sys.exit(1)
    raise

When it happens

Trigger: Constructing `ServerConfig` via `from_cli_args` (any normal server/CLI start that resolves interpreter settings) while `get_option("interpreter.enable_interpreter")` returns `None` — e.g. a corrupted or incomplete package install where `config_manifest` lost the option, or a version mismatch between the manifest and the resolver code.

Common situations: Pip installs with leftover files from an older version shadowing the new manifest; partially applied upgrades; custom builds or forks that trimmed the config manifest; running from a source checkout where `config_manifest.py` was modified.

Related errors

• shell.allow_list is missing from the configuration manifest
• thread display options are missing from the configuration ma
• manifest option 'interpreter.enable_interpreter' is missing;
• interpreter.enable_interpreter is missing from the config ma
• {what} must be absolute: {path}

AI-assisted analysis of langchain-ai/deepagents@a1af029e6e (2026-08-29). Data as JSON: /api/errors/b99723404f170507. Report an issue: GitHub.