docs: standardize public API docstrings on NumPy style #2668

async def vulnerability_scan(
    target: Target,
    description: str,
    languages: list[str],
    max_scenarios: int | None = None,
) -> SuiteResult:
    """Generate and run the standard vulnerability scan suite.

    Parameters
    ----------
    target : Target
        System under test (sync or async callable).
    description : str
        Natural-language description of the agent under test.
    languages : list of str
        BCP-47 language codes the agent is expected to handle.
    max_scenarios : int, optional
        Upper bound on scenarios across generators. ``None`` uses the
        active preset / per-generator defaults.

    Returns
    -------
    SuiteResult
        Completed suite result (also printed when ``verbose=True``).

    Examples
    --------
    >>> async def echo(inputs: str) -> str:
    ...     return inputs
    >>> result = await vulnerability_scan(
    ...     echo, "A demo agent", ["en"], max_scenarios=5
    ... )
    >>> isinstance(result.pass_rate, float)
    True
    """

"""Generate and run the scan.

Args:
    target: System under test.
    description: Agent description.

Returns:
    SuiteResult for the run.
"""