runner

Feb 19, 2026

Changes in this version

+ type RichResponse struct

+ Actions []domain.ActionRequest

+ State *domain.State

+ Terminal bool

+ func NavigateAndRender(ctx context.Context, engine ports.StatelessEngine, currentState *domain.State, ...) (*RichResponse, error)

+ func SignalAndRender(ctx context.Context, engine ports.StatelessEngine, currentState *domain.State, ...) (*RichResponse, error)

Feb 17, 2026

Changes in this version

type TextHandlerOption

+ func WithStdin() TextHandlerOption

Feb 17, 2026

Changes in this version

type Option

+ func WithEngine(engine *trellis.Engine) Option

+ func WithInitialState(state *domain.State) Option

type Runner

+ func (r *Runner) State() *domain.State

+ func (r *Runner) Watch(ctx context.Context) <-chan introspection.StateChange[*domain.State]

Feb 15, 2026

Changes in this version

+ const DefaultInputBufferSize

type IOHandler

+ Signal func(ctx context.Context, name string, args map[string]any) error

type JSONHandler

+ func (h *JSONHandler) FeedInput(line string, err error)

+ func (h *JSONHandler) Signal(ctx context.Context, name string, args map[string]any) error

type JSONHandlerOption

+ func WithJSONInputBufferSize(size int) JSONHandlerOption

type Option

+ func WithInterruptSource(ch <-chan struct{}) Option

type Runner

+ InterruptSource <-chan struct{}

type TextHandler

+ func (h *TextHandler) FeedInput(text string, err error)

+ func (h *TextHandler) Signal(ctx context.Context, name string, args map[string]any) error

type TextHandlerOption

+ func WithTextInputBufferSize(size int) TextHandlerOption

Jan 24, 2026

Changes in this version

type Option

+ func WithToolRunner(tr ToolRunner) Option

type Runner

+ ToolRunner ToolRunner

+ type ToolRunner interface

+ Execute func(ctx context.Context, call domain.ToolCall) (domain.ToolResult, error)

Jan 23, 2026

Changes in this version

+ type JSONHandlerOption func(*JSONHandler)

+ func WithJSONHandlerRegistry(reg *registry.Registry) JSONHandlerOption

+ type Option func(*Runner)

+ func WithHeadless(headless bool) Option

+ func WithInputHandler(handler IOHandler) Option

+ func WithInterceptor(interceptor ToolInterceptor) Option

+ func WithLogger(logger *slog.Logger) Option

+ func WithRenderer(renderer ContentRenderer) Option

+ func WithSessionID(id string) Option

+ func WithStore(store ports.StateStore) Option

type Runner

+ SessionID string

+ Store ports.StateStore

+ type SessionManager struct

+ Store ports.StateStore

+ func NewSessionManager(store ports.StateStore) *SessionManager

+ func (sm *SessionManager) LoadOrStart(ctx context.Context, engine *trellis.Engine, sessionID string, ...) (*domain.State, bool, error)

+ func (sm *SessionManager) Save(ctx context.Context, sessionID string, state *domain.State) error

+ type TextHandlerOption func(*TextHandler)

+ func WithTextHandlerRegistry(reg *registry.Registry) TextHandlerOption

+ func WithTextHandlerRenderer(renderer ContentRenderer) TextHandlerOption

Jan 15, 2026

Changes in this version

+ var DefaultMaxInputSize = 4096

+ var EnvMaxInputSize = "TRELLIS_MAX_INPUT_SIZE"

+ var ErrInputTooLarge = errors.New("input exceeds maximum allowed size")

+ var ErrInvalidUTF8 = errors.New("input contains invalid UTF-8 sequences")

+ func SanitizeInput(input string) (string, error)

type Runner

+ Logger *slog.Logger

+ type SignalManager struct

+ func NewSignalManager() *SignalManager

+ func (sm *SignalManager) CheckRace()

+ func (sm *SignalManager) Context() context.Context

+ func (sm *SignalManager) Reset()

+ func (sm *SignalManager) Stop()

Jan 14, 2026

Changes in this version

type IOHandler

+ SystemOutput func(ctx context.Context, msg string) error

type JSONHandler

+ Registry *registry.Registry

+ func (h *JSONHandler) SystemOutput(ctx context.Context, msg string) error

type Runner

+ Interceptor ToolInterceptor

type TextHandler

+ Registry *registry.Registry

+ func (h *TextHandler) SystemOutput(ctx context.Context, msg string) error

+ type ToolInterceptor func(ctx context.Context, call domain.ToolCall) (bool, domain.ToolResult, error)

+ func AutoApproveMiddleware() ToolInterceptor

+ func ConfirmationMiddleware(handler IOHandler) ToolInterceptor

+ func MultiInterceptor(interceptors ...ToolInterceptor) ToolInterceptor

Jan 10, 2026

Changes in this version

type IOHandler

+ HandleTool func(ctx context.Context, call domain.ToolCall) (domain.ToolResult, error)

type JSONHandler

+ Decoder *json.Decoder

+ func (h *JSONHandler) HandleTool(ctx context.Context, call domain.ToolCall) (domain.ToolResult, error)

type TextHandler

+ func (h *TextHandler) HandleTool(ctx context.Context, call domain.ToolCall) (domain.ToolResult, error)

Jan 9, 2026

Changes in this version

+ type ContentRenderer func(string) (string, error)

+ type IOHandler interface

+ Input func(ctx context.Context) (string, error)

+ Output func(ctx context.Context, actions []domain.ActionRequest) (bool, error)

+ type JSONHandler struct

+ Encoder *json.Encoder

+ Reader *bufio.Reader

+ Writer io.Writer

+ func NewJSONHandler(r io.Reader, w io.Writer) *JSONHandler

+ func (h *JSONHandler) Input(ctx context.Context) (string, error)

+ func (h *JSONHandler) Output(ctx context.Context, actions []domain.ActionRequest) (bool, error)

+ type Runner struct

+ Handler IOHandler

+ Headless bool

+ Input io.Reader

+ Output io.Writer

+ Renderer ContentRenderer

+ func NewRunner() *Runner

+ func (r *Runner) Run(engine *trellis.Engine) error

+ type TextHandler struct

+ Reader *bufio.Reader

+ Renderer ContentRenderer

+ Writer io.Writer

+ func NewTextHandler(r io.Reader, w io.Writer) *TextHandler

+ func (h *TextHandler) Input(ctx context.Context) (string, error)

+ func (h *TextHandler) Output(ctx context.Context, actions []domain.ActionRequest) (bool, error)