Skip to content

Add plugin host version checks#728

Draft
i386 wants to merge 3 commits into
mainfrom
codex/plugin-min-version-check
Draft

Add plugin host version checks#728
i386 wants to merge 3 commits into
mainfrom
codex/plugin-min-version-check

Conversation

@i386

@i386 i386 commented May 28, 2026

Copy link
Copy Markdown
Collaborator

Summary

Adds a plugin.toml host compatibility gate so installed plugins can declare the minimum mesh-llm version they require.

Changes

  • Parse min_mesh_llm_version from plugin manifests, with aliases for older naming experiments.
  • Reject incompatible plugin archives during install before replacing an existing install.
  • Re-check installed plugins at runtime and mark incompatible plugins inactive instead of launching them.
  • Re-check installed plugin CLI commands before dispatch.
  • Document the manifest field in the plugin packaging docs.

CLI Experience

Install rejects an incompatible archive before replacing any existing plugin install:

$ mesh-llm plugins install mesh-llm/cool-plugin
🚫 Error: 🚫 Plugin requires mesh-llm >= 0.69.0, current host is 0.68.0

Listing installed plugins shows an already-installed incompatible plugin as inactive, with the same minimum-version reason:

$ mesh-llm plugins list
cool-plugin	kind=installed	state=incompatible	error=🚫 Plugin requires mesh-llm >= 0.69.0, current host is 0.68.0

Running a plugin-provided CLI command fails before launching the plugin process:

$ mesh-llm cool-plugin run
🚫 Error: 🚫 Plugin command 'cool-plugin' is not compatible

Caused by:
    🚫 Plugin requires mesh-llm >= 0.69.0, current host is 0.68.0

Configured [[plugin]] command = "..." entries are intentionally outside this manifest check because they do not install a plugin.toml; those still fail through initialize/protocol compatibility checks.

Validation

  • cargo test -p mesh-llm-plugin-manager --lib
  • just build
  • cargo test -p mesh-llm-host-runtime cli::commands::plugin_cli --lib
  • cargo check -p mesh-llm
  • rustfmt --check on changed Rust files
  • git diff --check

@i386 i386 force-pushed the codex/plugin-min-version-check branch from 4ec445c to 1be04a5 Compare May 28, 2026 07:53
@i386 i386 changed the title [codex] Add plugin host version checks Add plugin host version checks May 29, 2026
Base automatically changed from codex/plugin-skills to main May 29, 2026 06:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant