Function perform_install_extra

libs/code/deepagents_code/update_check.py:2542–2610

Add `extra` to the installed dcode tool environment. Runs `uv tool install --reinstall -U 'deepagents-code[ ]== ' --prerelease allow`, preserving any extras that are already installed. Editable installs are refused — the caller should rerun their `uv tool install --ed

(
    extra: str,
    *,
    progress: UpgradeProgressCallback | None = None,
    log_path: Path | None = None,
)

async def perform_install_extra(
    extra: str,
    *,
    progress: UpgradeProgressCallback | None = None,
    log_path: Path | None = None,
) -> tuple[bool, str]:
    """Add `extra` to the installed dcode tool environment.

    Runs `uv tool install --reinstall -U 'deepagents-code[<extras>]==<current>'
    --prerelease allow`, preserving any extras that are already installed.
    Editable installs are refused — the caller should rerun their
    `uv tool install --editable` command with `--with 'deepagents-code[<extra>]'`
    added so the extra is resolved against the editable source.

    Args:
        extra: The extra name to install. Must satisfy `is_valid_extra_name`;
            invalid names are rejected without invoking uv (defense in depth
            against shell injection via the `--force`/`--yes` bypass paths).
        progress: Optional callback invoked for each output line.
        log_path: Optional path to persist command output.

    Returns:
        `(success, output)` — *output* is the combined stdout/stderr, or an
            explanatory error message when the install method is unsupported
            or `extra` is malformed.
    """
    if not is_valid_extra_name(extra):
        return False, (
            f"Invalid extra name {extra!r}: must match {_EXTRA_NAME_RE.pattern}"
        )
    method = detect_install_method()
    if method == "unknown":
        return False, (
            "Editable install detected — cannot add extras automatically.\n"
            + editable_extra_hint(extra)
        )
    if method == "brew":
        # Homebrew formula doesn't expose extras; uv tool install is the
        # right escape hatch but would conflict with the brew-managed binary.
        return False, (
            "Homebrew install detected — extras are not supported via brew. "
            f"Reinstall with `{install_extra_command(extra)}` to switch to a "
            "uv-managed tool install with extras."
        )
    if method == "other":
        return False, (
            "Unsupported install method detected — cannot add extras without "
            "knowing which environment provides `dcode`. Reinstall with "
            f"`{install_extra_command(extra)}` to switch to a uv-managed tool "
            "install with extras."
        )

    if not shutil.which("uv"):
        return False, (
            "`uv` not found on PATH. Reinstall dcode following the docs, or "
            "install uv (https://docs.astral.sh/uv/) so extras can be added."
        )