Skip to main content

mellea.plugins.decorators

Mellea hook decorator.

Functions​

FUNC hook ​

hook(hook_type: str) -> Callable

Register an async function or method as a hook handler.

Args:

  • hook_type: The hook point name (e.g., "generation_pre_call").
  • mode: Execution mode — PluginMode.SEQUENTIAL (default), PluginMode.CONCURRENT, PluginMode.AUDIT, or PluginMode.FIRE_AND_FORGET.
  • priority: Lower numbers execute first. For methods on a Plugin subclass, falls back to the class-level priority, then 50. For standalone functions, defaults to 50.

Returns:

  • A decorator that attaches HookMeta to the decorated function.

Raises:

  • TypeError: If the decorated function is not async def.

Classes​

CLASS HookMeta ​

Metadata attached by the @hook decorator.

Args:

  • hook_type: The hook point name (e.g., "generation_pre_call").
  • mode: Execution mode for the hook handler.
  • priority: Execution priority — lower numbers execute first.