Skip to content

The agent that grows with you

docs(plugins): portable packages lack requires_hermes, not a version field

Teknium7489b22af47c
diff --git a/plugin-catalog/README.md b/plugin-catalog/README.md
index 618fce979b3..92bdae26ea3 100644
--- a/plugin-catalog/README.md
+++ b/plugin-catalog/README.md
@@ -120,7 +120,7 @@ meaningful:
at its current pin until Hermes is updated. Declare the same floor in
`plugin.yaml` as well, because older Hermes versions enforce only that one
(the loader skips the plugin when it does not match). A portable package
- (`plugin.json`) has no version field of its own, so the catalog entry's
+ (`plugin.json`) has no `requires_hermes` field, so the catalog entry's
`requires_hermes` is its only floor: set one when the package needs a recent
Hermes (a server declaration key an older release ignores). `version` matches the
pinned code, and Python dependencies resolve under Hermes's core constraints
diff --git a/website/docs/developer-guide/plugins/catalog-submission.md b/website/docs/developer-guide/plugins/catalog-submission.md
index 5b7e124d562..06a3d197f36 100644
--- a/website/docs/developer-guide/plugins/catalog-submission.md
+++ b/website/docs/developer-guide/plugins/catalog-submission.md
@@ -178,7 +178,7 @@ the gallery. There is no separate listing to maintain.
at its current pin until Hermes is updated. Declare the same floor in
`plugin.yaml` as well, because older Hermes versions enforce only that one
(the loader skips the plugin when it does not match). A portable package
- (`plugin.json`) has no version field of its own, so the catalog entry's
+ (`plugin.json`) has no `requires_hermes` field, so the catalog entry's
`requires_hermes` is its only floor: set one when the package needs a recent
Hermes (a server declaration key an older release ignores). `version` matches the
pinned code, and Python dependencies resolve under Hermes's core constraints
diff --git a/website/docs/developer-guide/plugins/index.md b/website/docs/developer-guide/plugins/index.md
index 3b06abfafb4..149d4c84754 100644
--- a/website/docs/developer-guide/plugins/index.md
+++ b/website/docs/developer-guide/plugins/index.md
@@ -210,8 +210,8 @@ A server entry key this Hermes does not know (one a newer release added) is
ignored with a warning, which `hermes plugins validate` lists, and the package
still installs. Releases from before this rule reject the package instead, and a
release that ignores a key may behave less safely than intended, so declare a new
-key together with a catalog `requires_hermes` floor. `plugin.json` has no version
-field, so that catalog floor is a portable package's only one: an install by
+key together with a catalog `requires_hermes` floor. `plugin.json` has no
+`requires_hermes` field, so that catalog floor is a portable package's only one: an install by
catalog name refuses on an older Hermes, and `hermes plugins update` keeps the
installed pin until Hermes is updated.