warpdotdev/warp · error · MergeError

unrecognized_wrapper

unrecognized_wrapper

Error message

unrecognized_wrapper

What it means

Error "unrecognized_wrapper" thrown in warpdotdev/warp.

Source

Thrown at resources/bundled/skills/tui-migrate-setup/scripts/merge_mcp_config.py:162

def _detect_wrapper(document: dict[str, Any]) -> tuple[tuple[str, ...], dict[str, Any]]:
    matches: list[tuple[tuple[str, ...], dict[str, Any]]] = []
    for wrapper_path in WRAPPER_PATHS:
        value = _path_value(document, wrapper_path)
        if value is not None:
            if not isinstance(value, dict):
                raise MergeError("invalid_wrapper_shape")
            matches.append((wrapper_path, value))

    if len(matches) > 1:
        raise MergeError("ambiguous_wrapper")
    if matches:
        return matches[0]

    # Warp accepts an unwrapped map. Require object-valued entries so unrelated
    # application JSON does not silently become an MCP config.
    if all(isinstance(value, dict) for value in document.values()):
        return (), document
    raise MergeError("unrecognized_wrapper")


def load_config(path: Path) -> ParsedConfig:
    raw, mode = _read_regular_file(path, missing_ok=True)
    exists = mode is not None
    if not exists:
        return ParsedConfig(
            document={},
            servers={},
            wrapper_path=("mcpServers",),
            exists=False,
            raw=b"",
            mode=None,
        )

    document = _decode_document(raw)
    wrapper_path, servers = _detect_wrapper(document)
    for value in servers.values():

View on GitHub (pinned to e72fd7aacb)

When it happens

Trigger: Thrown at resources/bundled/skills/tui-migrate-setup/scripts/merge_mcp_config.py:162 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of warpdotdev/warp@e72fd7aacb (2026-08-16). Data as JSON: /api/errors/1a4f35f42bdcf193. Report an issue: GitHub.