{"record":{"id":"4901ddc13bcaeb7d","repo":"langchain-ai/deepagents","slug":"thread-display-options-are-missing-from-the-config","errorCode":null,"errorMessage":"thread display options are missing from the configuration manifest","messagePattern":"thread display options are missing from the configuration manifest","errorType":"exception","errorClass":"RuntimeError","httpStatus":null,"severity":"error","filePath":"libs/code/deepagents_code/main.py","lineNumber":1118,"sourceCode":"\ndef _resolve_thread_list_display_options(\n    args: argparse.Namespace,\n) -> tuple[str, bool]:\n    \"\"\"Resolve thread display flags through the ranked configuration chain.\n\n    Returns:\n        The effective sort key and relative-time state.\n\n    Raises:\n        RuntimeError: If either option is missing from the manifest.\n    \"\"\"\n    from deepagents_code.config_manifest import _emit_ranked_diagnostics, get_option\n\n    sort_option = get_option(\"threads.sort_order\")\n    relative_option = get_option(\"threads.relative_time\")\n    if sort_option is None or relative_option is None:\n        msg = \"thread display options are missing from the configuration manifest\"\n        raise RuntimeError(msg)\n\n    resolver = _resolver_for_args(args)\n    sort_order = resolver.get(sort_option)\n    relative_time = resolver.get(relative_option)\n    _emit_ranked_diagnostics(sort_option, sort_order)\n    _emit_ranked_diagnostics(relative_option, relative_time)\n    sort_by = \"created\" if sort_order.value == \"created_at\" else \"updated\"\n    return sort_by, bool(relative_time.value)\n\n\ndef _install_cli_provider(args: argparse.Namespace) -> None:\n    \"\"\"Install parsed arguments into the shared resolution chain.\n\n    Uses the deferred install: building the full resolver here would import\n    `deepagents_code.model_config` and read both TOML snapshots, which the\n    help-only fast paths (`dcode help`, bare command groups) must not pay\n    before they return.\n    \"\"\"","sourceCodeStart":1100,"sourceCodeEnd":1136,"githubUrl":"https://github.com/langchain-ai/deepagents/blob/a1af029e6e73cb17c36bff823d227747b28e91e1/libs/code/deepagents_code/main.py#L1100-L1136","documentation":"`_resolve_thread_list_display_options` raises `RuntimeError` when either `threads.sort_order` or `threads.relative_time` is absent from the configuration manifest. The manifest is the managed source of truth for these options; without them the CLI cannot safely resolve thread-list display settings, so it refuses to guess.","triggerScenarios":"Calling `cli_main` (or `_resolve_thread_list_display_options` directly) in an environment where the bundled `config_manifest` is out of sync with the code — e.g. a partially upgraded install, a tampered/stale manifest file, or a custom build that removed the manifest entries.","commonSituations":"Mixed-version installs (pip cache or stale `.pyc`/data files after upgrade); vendored or stripped distributions that dropped manifest entries; local development where the manifest generator was not rerun after schema changes.","solutions":["Reinstall/upgrade `deepagents-code` cleanly (`pip install --force-reinstall deepagents-code`) so the config manifest matches the installed code version","If developing locally, regenerate the config manifest so it includes `threads.sort_order` and `threads.relative_time`","Inspect `deepagents_code/config_manifest` and confirm both option keys are registered; add the missing entries to the manifest definition"],"exampleFix":"// before (manifest fragment)\n// threads.sort_order entry removed\n// after\n{\"option\": \"threads.sort_order\", \"type\": \"enum\", \"default\": \"recent\"},\n{\"option\": \"threads.relative_time\", \"type\": \"bool\", \"default\": true}","handlingStrategy":"validation","validationCode":"from deepagents_code.config_manifest import get_option\n\nfor key in (\"threads.sort_order\", \"threads.relative_time\"):\n    if get_option(key) is None:\n        raise SystemExit(\n            f\"config manifest missing {key!r}; reinstall deepagents-code\"\n        )","typeGuard":null,"tryCatchPattern":"try:\n    opts = _resolve_thread_list_display_options(args)\nexcept RuntimeError as exc:\n    logger.error(\"manifest integrity problem: %s\", exc)\n    raise SystemExit(\"reinstall deepagents-code to restore the config manifest\")","preventionTips":["Use --force-reinstall when upgrading so data files stay in sync with code","Avoid hand-editing or stripping packaged manifest files","In CI, pin the package version so code and manifest always match"],"tags":["configuration","manifest","cli"],"backgroundTag":"missing-config-manifest-option","analyzedSha":"a1af029e6e73cb17c36bff823d227747b28e91e1","analyzedAt":"2026-08-29T11:43:24.718Z","schemaVersion":2},"datasetVersion":"2026-08-29T12:17:43.993Z"}