# NousResearch/hermes-agent · Plugin.yaml manifests missing from distributed packages

## Open now

- Nothing open on GitHub.

These issues and pull requests concern plugin.yaml manifest files being absent from wheel, sdist, and Homebrew bottle distributions. The work involves packaging fixes to ensure these files are included when the software is distributed.

## TL;DR

- 4 member(s): 0 open issue(s), 1 closed issue(s), 0 open PR(s), 1 merged PR(s), 2 PR(s) closed without merging.
- A fix was merged to main in PR #34484. Verify it addresses your case.
- **Recommended:** read PR #34484 (and any competing PRs below) before filing. Confirm the merged change covers your symptom.

## Maintainer resolution verdict

- Internal-tracker verdict over this cluster's issue members: `unresolved`. This is distinct from the fix status above. Weigh it yourself.

## How this cluster was grouped

- Link evidence (`STRUCTURAL_SPANNING`): every member is connected by structural evidence: shared changed files, or a closing/superseded reference.
- Pairwise link density `0.50`: the share of member pairs that carry a link, counting a structural link in full and a relevance-only link at 0.36. `1.00` means every pair is linked.

## Closed / duplicate issues

- #28149: Brew bottle missing plugin.yaml manifests for web search providers

## Prior & competing PRs

- **#34484: fix(packaging): ship bundled plugin.yaml manifests in wheel and sdist**. merged to main · fix tier `verified`
  - maintainer direction: category `merged`
  - files: `MANIFEST.in`, `pyproject.toml`, `tests/test_packaging_metadata.py`
  - fix hunks:
  - `MANIFEST.in`

    ```diff
    @@ -1,4 +1,9 @@
     graft skills
     graft optional-skills
    +# Bundled plugin manifests (plugin.yaml / plugin.yml). Without these the
    +# PluginManager scan (hermes_cli/plugins.py) finds zero plugins on installs
    +# built from the sdist (e.g. Homebrew, downstream packagers). package-data
    +# below covers the wheel; this covers the sdist. See #34034 / #28149.
    +recursive-include plugins plugin.yaml plugin.yml
     global-exclude __pycache__
     global-exclude *.py[cod]
    ```
  - `pyproject.toml`

    ```diff
    @@ -226,6 +226,14 @@ plugins = [
       "*/dashboard/manifest.json",
       "*/dashboard/dist/*",
       "*/dashboard/dist/**/*",
    +  # Plugin discovery (hermes_cli/plugins.py) reads a plugin.yaml/plugin.yml
    +  # manifest from each bundled plugin directory to register it. Wheels only
    +  # carry files declared here, so without this glob the wheel ships every
    +  # plugin's Python code but none of its manifests — the scan finds zero
    +  # plugins and all gateway platforms fail with "No adapter available for
    +  # <platform>" (#34034), web-search providers go missing (#28149), etc.
    +  "**/plugin.yaml",
    +  "**/plugin.yml",
     ]
     
     [tool.setuptools.packages.find]
    ```
  - `tests/test_packaging_metadata.py`

    ```diff
    @@ -20,3 +20,42 @@ def test_manifest_includes_bundled_skills():
     
         assert "graft skills" in manifest
         assert "graft optional-skills" in manifest
    +
    +
    +def test_bundled_plugin_manifests_ship_in_both_wheel_and_sdist():
    +    """Regression test for #34034 / #28149.
    +
    +    Plugin discovery (hermes_cli/plugins.py) registers each bundled plugin by
    +    reading its ``plugin.yaml`` / ``plugin.yml`` manifest. Those manifests are
    +    data files, not Python modules, so they only reach installed packages when
    +    declared explicitly:
    +
    +    - wheel  -> ``[tool.setuptools.package-data]`` ``plugins`` glob
    +    - sdist  -> ``MANIFEST.in`` (Homebrew and other downstream packagers build
    +                from the sdist)
    +
    +    v0.15.0 declared neither, so the wheel shipped every adapter's Python code
    +    but none of its manifests, and *every* gateway platform failed with
    +    "No adapter available for <platform>". Both channels must cover manifests.
    +    """
    +    # There must actually be manifests on disk for the globs to match.
    +    on_disk = list((REPO_ROOT / "plugins").rglob("plugin.yaml")) + list(
    +        (REPO_ROOT / "plugins").rglob("plugin.yml")
    +    )
    +    assert on_disk, "expected bundled plugin manifests under plugins/"
    +
    +    # Wheel channel: package-data must declare a glob that matches plugin
    +    # manifests anywhere under the plugins package.
    +    data = tomllib.loads((REPO_ROOT / "pyproject.toml").read_text(encoding="utf-8"))
    +    plugins_pkg_data = data["tool"]["setuptools"]["package-data"].get("plugins", [])
    +    assert any(
    +        g.endswith("plugin.yaml") or g.endswith("plugin.yml")
    +        for g in plugins_pkg_data
    +    ), "pyproject package-data 'plugins' must ship plugin.yaml/plugin.yml (wheel)"
    +
    +    # Sdist channel: MANIFEST.in must recursively include the manifests so
    +    # downstream packagers building from the sdist also get them.
    +    manifest = (REPO_ROOT / "MANIFEST.in").read_text(encoding="utf-8")
    +    assert "recursive-include plugins" in manifest and "plugin.yaml" in manifest, (
    +        "MANIFEST.in must recursive-include plugins plugin.yaml/plugin.yml (sdist)"
    +    )
    ```
- **#28162: fix(packaging): ship plugin.yaml manifests in wheel and sdist (#28149)**. closed without merge
  - maintainer direction: category `implemented_elsewhere`; implication `superseded`; refs `2765b02021c1e6eb743e2ce2eb359fc66a5aa89e`, `#34484`
- **#28170: fix(packaging): ship plugin.yaml manifests in wheel and sdist**. closed without merge
  - maintainer direction: category `implemented_elsewhere`; implication `superseded`; refs `2765b02021c1e6eb743e2ce2eb359fc66a5aa89e`, `#34484`

## Fix status

- Merged to main in PR #34484 (cited above). No release data is tracked. Verify downstream.
- Fix last verified (merged) `2026-05-29`.
- Subsystem: `skills`