narrate

Documentation

Overview

Package narrate produces human-friendly, emoji-rich transition messages describing what the agent is doing. Uses template-based descriptions; LLM-powered enrichment can be layered on as a future enhancement.

Index

• type Narrator
  • func New(enabled bool) *Narrator
  • func (n *Narrator) ThinkingMessage(thought string) string
  • func (n *Narrator) ToolCallMessage(name, args string) string

Types

type Narrator

type Narrator struct {
	// contains filtered or unexported fields
}

Narrator produces engaging progress messages for tool calls and thinking.

func New

func New(enabled bool) *Narrator

New creates a Narrator. When enabled, produces emoji-rich template messages describing what the agent is doing in human-friendly language. If enabled is false, all methods return empty strings (verbose mode).

func (*Narrator) ThinkingMessage

func (n *Narrator) ThinkingMessage(thought string) string

ThinkingMessage returns a narration of the thinking/reasoning phase.

func (*Narrator) ToolCallMessage

func (n *Narrator) ToolCallMessage(name, args string) string

ToolCallMessage returns a human-friendly description of a tool invocation.