@spec __plugin_metadata__() :: map()

Returns metadata for Jido.Discovery integration.

This function is used by Jido.Discovery to index plugins for fast lookup and filtering.

@spec actions() :: [module()]

Returns the list of action modules provided by this plugin.

@spec capabilities() :: [atom()]

Returns the capabilities provided by this plugin.

@spec category() :: String.t() | nil

Returns the plugin's category.

@spec config_schema() :: Zoi.schema() | nil

Returns the Zoi schema for per-agent configuration.

@spec description() :: String.t() | nil

Returns the plugin's description.

@spec manifest() :: Jido.Plugin.Manifest.t()

Returns the plugin manifest with all metadata.

The manifest provides compile-time metadata for discovery and introspection, including capabilities, requirements, signal routes, and schedules.

@spec name() :: String.t()

Returns the plugin's name.

@spec otp_app() :: atom() | nil

Returns the OTP application for config resolution.

@spec plugin_spec(map()) :: Jido.Plugin.Spec.t()

Returns the plugin specification with optional per-agent configuration.

Examples

spec = MyModule.plugin_spec(%{})
spec = MyModule.plugin_spec(%{custom_option: true})

@spec requires() :: [tuple()]

Returns the requirements for this plugin.

@spec schedules() :: [tuple()]

Returns the schedules for this plugin.

@spec schema() :: Zoi.schema() | nil

Returns the Zoi schema for plugin state.

@spec signal_patterns() :: [String.t()]

Returns the signal patterns this plugin handles.

@spec signal_routes() :: [tuple()]

Returns the signal routes for this plugin.

@spec singleton?() :: boolean()

Returns whether this plugin is a singleton.

@spec state_key() :: atom()

Returns the key used to store plugin state in the agent.

@spec subscriptions() :: [tuple()]

Returns the sensor subscriptions for this plugin.

@spec tags() :: [String.t()]

Returns the plugin's tags.

@spec vsn() :: String.t() | nil

Returns the plugin's version.