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.

Component lifecycle hook payloads.

​
Classes

​
CLASS ComponentPreExecutePayload

Payload for component_pre_execute — before component execution via aact(). Attributes:
  • component_type: Class name of the component being executed.
  • action: The Component or CBlock about to be executed.
  • context_view: Optional snapshot of the context as a list.
  • requirements: List of Requirement instances for validation (writable).
  • model_options: Dict of model options passed to the backend (writable).
  • format: Optional BaseModel subclass for structured output / constrained decoding (writable).
  • strategy: Optional SamplingStrategy instance controlling retry logic (writable).
  • tool_calls_enabled: Whether tool calling is enabled for this execution (writable).

​
CLASS ComponentPostSuccessPayload

Payload for component_post_success — after successful component execution. Attributes:
  • component_type: Class name of the executed component.
  • action: The Component or CBlock that was executed.
  • result: The ModelOutputThunk containing the generation result.
  • context_before: The Context before execution.
  • context_after: The Context after execution (with action + result appended).
  • generate_log: The GenerateLog from the final generation pass.
  • sampling_results: Optional list of ModelOutputThunk from all sampling attempts.
  • latency_ms: Wall-clock time for the full execution in milliseconds.

​
CLASS ComponentPostErrorPayload

Payload for component_post_error — after component execution fails. Attributes:
  • component_type: Class name of the component that failed.
  • action: The Component or CBlock that was being executed.
  • error: The Exception that was raised.
  • error_type: Class name of the exception (e.g. "ValueError").
  • stack_trace: Formatted traceback string.
  • context: The Context at the time of the error.
  • model_options: Dict of model options that were in effect.