# NousResearch/hermes-agent · Plugin manifests missing from PyPI package releases

## Open now

- Nothing open on GitHub.

A packaging defect caused plugin.yaml manifest files to be absent from distributed wheels and sdists, preventing platform adapters (Discord, IRC, Teams, etc.) from being discovered. Multiple fix attempts and related refactoring efforts address manifest inclusion and plugin discovery via entry points.

## TL;DR

- 7 member(s): 0 open issue(s), 3 closed issue(s), 0 open PR(s), 1 merged PR(s), 3 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: `partially_resolved` · deciding PR(s): `pr-34484`. This is distinct from the fix status above. Weigh it yourself.

## How this cluster was grouped

- Link evidence (`STRUCTURAL_PARTIAL`): some members are connected by structural evidence (shared changed files, or a closing/superseded reference); the rest are joined by an automated relevance judgement over their text.
- Members outside that structural core may belong to a different underlying problem.
- Pairwise link density `0.22`: 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

- #34034: v0.15.0 PyPI release breaks ALL platforms — plugin.yaml manifests missing from package
- #34511: \[Bug\]: Discord gateway adapter not registered/discovered in PyPI v0.15.1
- #34576: Platform plugins (Discord, IRC, Teams, etc.) missing plugin.yaml in pip package — adapters cannot be discovered

## 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`; implication `superseded`
  - 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)"
    +    )
    ```
- **#34061: fix(packaging): include plugin manifests in wheels**. closed without merge
  - maintainer direction: category `silent_close`; implication `active`
- **#34072: fix(packaging): include plugin.yaml in PyPI package-data (#34034)**. closed without merge
  - maintainer direction: category `implemented_elsewhere`; implication `superseded`; refs `#34484`, `#28170`, `#28162`, `#31753`
- **#34533: fix(cli): discover pip-installed plugins via entry points in list/enable/disable**. closed without merge
  - maintainer direction: category `duplicate_of`; implication `duplicate`; refs `#23802`, `#23814`, `#25040`

## 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: `gateway`