{"record":{"id":"b99723404f170507","repo":"langchain-ai/deepagents","slug":"interpreter-enable-interpreter-is-missing-from-the","errorCode":null,"errorMessage":"interpreter.enable_interpreter is missing from the config manifest","messagePattern":"interpreter\\.enable_interpreter is missing from the config manifest","errorType":"exception","errorClass":"RuntimeError","httpStatus":null,"severity":"error","filePath":"libs/code/deepagents_code/_server_config.py","lineNumber":219,"sourceCode":"        The explicit `enable_interpreter` value when not `None`; `False` for\n            remote-sandbox defaults; otherwise the configured local default\n            from `interpreter.enable_interpreter`.\n\n    Raises:\n        RuntimeError: If the interpreter option is absent from the manifest.\n    \"\"\"\n    if enable_interpreter is not None:\n        return enable_interpreter\n    if sandbox_type and sandbox_type != \"none\":\n        return False\n\n    from deepagents_code.config_manifest import _emit_ranked_diagnostics, get_option\n    from deepagents_code.configuration.resolver import get_config_resolver\n\n    option = get_option(\"interpreter.enable_interpreter\")\n    if option is None:\n        msg = \"interpreter.enable_interpreter is missing from the config manifest\"\n        raise RuntimeError(msg)\n    resolved = get_config_resolver().get(option)\n    _emit_ranked_diagnostics(option, resolved)\n    return bool(resolved.value)\n\n\ndef _interpreter_suppressed_by_sandbox(\n    *, enable_interpreter: bool | None, sandbox_type: str | None, local_default: bool\n) -> bool:\n    \"\"\"Whether a remote sandbox suppressed the otherwise-default interpreter.\n\n    Used to decide whether to surface an advisory: returns `True` only when the\n    user made no explicit choice, a remote sandbox is active, and the local\n    default would have enabled it — i.e. the sandbox (not an explicit\n    `--no-interpreter` opt-out, nor a disabled `[interpreter]` config) is why\n    `js_eval` is unavailable.\n\n    Takes the *raw* tri-state caller intent rather than the resolved boolean: a\n    sandbox-suppressed default and an explicit `--no-interpreter` both resolve to","sourceCodeStart":201,"sourceCodeEnd":237,"githubUrl":"https://github.com/langchain-ai/deepagents/blob/a1af029e6e73cb17c36bff823d227747b28e91e1/libs/code/deepagents_code/_server_config.py#L201-L237","documentation":"`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).","triggerScenarios":"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.","commonSituations":"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.","solutions":["Reinstall the package cleanly: pip uninstall deepagents-code && pip install --force-reinstall deepagents-code","Ensure no stale files (e.g. an old config_manifest.py in site-packages or a shadowing local module) are on the import path","Check for version mismatch between installed deepagents-code and the deepagents SDK pin; align versions","If reproducible on a clean install, file a bug — the option should always be in the manifest"],"exampleFix":"// before (broken/stale install)\npython -c \"from deepagents_code.config_manifest import get_option; print(get_option('interpreter.enable_interpreter'))\"\n# None -> RuntimeError at startup\n// after\npip uninstall -y deepagents-code && pip install --force-reinstall deepagents-code","handlingStrategy":"try-catch","validationCode":"from deepagents_code.config_manifest import get_option\n\nif get_option(\"interpreter.enable_interpreter\") is None:\n    raise SystemExit(\"Install is missing manifest options; reinstall deepagents-code\")","typeGuard":null,"tryCatchPattern":"try:\n    config = ServerConfig.from_cli_args(args)\nexcept RuntimeError as e:\n    if \"missing from the config manifest\" in str(e):\n        print(\"Broken installation: reinstall deepagents-code (--force-reinstall)\")\n        sys.exit(1)\n    raise","preventionTips":["Use a clean virtualenv per project; avoid mixing site-packages across upgrades","After upgrading, sanity-check that config_manifest still exposes expected options","Don't ship trimmed/patched copies of deepagents_code internals","Watch for import-path shadowing (local files named like package modules)"],"tags":["configuration","manifest","internal-error","runtimeerror"],"backgroundTag":"missing-config-option","analyzedSha":"a1af029e6e73cb17c36bff823d227747b28e91e1","analyzedAt":"2026-08-29T11:43:24.718Z","schemaVersion":2},"datasetVersion":"2026-08-29T12:17:43.993Z"}