hitl

package
v0.31.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 31, 2026 License: MIT Imports: 16 Imported by: 0

Documentation

Overview

Package hitl is the human-in-the-loop primitive: any plugin that needs an operator's input — clarifying a question, approving a destructive tool call, picking among curated plans, or signing off on a memory write — emits hitl.requested and waits on hitl.responded.

The plugin owns the LLM-facing ask_user tool, which is the LLM's direct path to the same machinery: the tool accepts an extended schema that lets the model present a freeform question, a multi-choice prompt, or both. Approval gates and memory plugins emit hitl.requested directly, without going through the tool.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func New

func New() engine.Plugin

New creates a new hitl plugin.

Types

type Plugin

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

Plugin owns the hitl.requested/hitl.responded registry and the LLM-facing ask_user tool.

func (*Plugin) Capabilities

func (p *Plugin) Capabilities() []engine.Capability

func (*Plugin) ConfigSchema

func (p *Plugin) ConfigSchema() []byte

ConfigSchema implements engine.ConfigSchemaProvider.

func (*Plugin) Dependencies

func (p *Plugin) Dependencies() []string

func (*Plugin) Emissions

func (p *Plugin) Emissions() []string

func (*Plugin) ID

func (p *Plugin) ID() string

func (*Plugin) Init

func (p *Plugin) Init(ctx engine.PluginContext) error

func (*Plugin) LiveCalls

func (p *Plugin) LiveCalls() uint64

LiveCalls returns the count of ask_user invocations that survived the replay short-circuit. Tests assert zero during replay — the user is never re-prompted; the journaled answer is replayed.

func (*Plugin) Name

func (p *Plugin) Name() string

func (*Plugin) Ready

func (p *Plugin) Ready() error

func (*Plugin) Requires

func (p *Plugin) Requires() []engine.Requirement

func (*Plugin) Shutdown

func (p *Plugin) Shutdown(_ context.Context) error

func (*Plugin) Subscriptions

func (p *Plugin) Subscriptions() []engine.EventSubscription

func (*Plugin) Version

func (p *Plugin) Version() string

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL