Handlers

Handlers define what happens when a trigger fires. They contain execution blocks that run in sequence.

Handler Structure

yaml

Each block has a human-readable name (shown in debug UI) and a type that determines its behavior.

Generate a response from the LLM:

yaml

With options:

yaml

Add a message to the conversation:

yaml

For internal directives (LLM sees it, user doesn't):

yaml

Call a tool deterministically:

yaml

Update a persistent resource:

yaml

Create a named conversation thread:

yaml

Convert conversation to text:

yaml

Every block has a display property:

yaml

Map variables to block inputs:

yaml

Use independent: true for content that shouldn't go to the main chat:

yaml

This is useful for: