Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mellea.ai/llms.txt

Use this file to discover all available pages before exploring further.

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.