Function install_extra_command

libs/code/deepagents_code/update_check.py:2408–2444

Return the install-script command that adds `extra` to dcode. The promoted install path is the install script (see `scripts/install.sh`). This helper is display-only and avoids uv receipt introspection so unsupported installs can surface method-specific guidance before any uv receip

(
    extra: str,
    *,
    distribution_name: str = "deepagents-code",
)

def install_extra_command(
    extra: str,
    *,
    distribution_name: str = "deepagents-code",
) -> str:
    """Return the install-script command that adds `extra` to dcode.

    The promoted install path is the install script (see `scripts/install.sh`).
    This helper is display-only and avoids uv receipt introspection so
    unsupported installs can surface method-specific guidance before any uv
    receipt is read. Already-detected extras from distribution metadata are
    included when available, so following the command does not drop them.

    Args:
        extra: The extra name (e.g. `'quickjs'`, `'daytona'`, `'fireworks'`).
            Validated internally against PEP 508 grammar before interpolation
            into the shell command.
        distribution_name: Name of the installed distribution to inspect for
            already-installed extras.

    Returns:
        Shell command string suitable for display in error messages.

    Raises:
        ValueError: If `extra` fails PEP 508 validation.
    """
    if not is_valid_extra_name(extra):
        msg = (
            f"Invalid extra name {extra!r}: must match PEP 508 "
            f"({_EXTRA_NAME_RE.pattern})"
        )
        raise ValueError(msg)
    from deepagents_code.extras_info import installed_extra_names

    extras = installed_extra_names(distribution_name)
    extras.add(extra)
    return install_extras_command(extras)


def install_extra_recovery_command(extra: str) -> str: