mcpserver

type Engine interface {
	// Tasks returns the exposable (non-private) tasks with their metadata.
	Tasks() []TaskInfo
	// Call runs a task by display name with string arguments, capturing output.
	Call(ctx context.Context, name string, args map[string]string) (Result, error)
}

type HTTPConfig struct {
	Addr  string // e.g. 127.0.0.1:7777
	Token string // required bearer token
}

type Options struct {
	// AllowDestructive permits calling tasks marked destructive ([confirm]).
	AllowDestructive bool
	// AllowList, when non-empty, narrows callable tasks to these names.
	AllowList []string
	// Version reported to clients.
	Version string
	// Instructions, when non-empty, is delivered to clients as the MCP
	// server instructions in the initialize result. Rune uses it for the
	// [context] hook's project-health text (spec 021 FR-002). It must
	// already be masked; this package never processes it.
	Instructions string
}

type ParamInfo struct {
	Name     string
	Required bool
	Variadic bool
}

type Result struct {
	Stdout   string
	Stderr   string
	ExitCode int
	// FixSuggestion is the captured output of the task's || failure hooks
	// (spec 022). Like Options.Instructions, it must already be masked and
	// size-capped by the engine; this package never processes it, only
	// renders it as a delimited section after the exit marker. Empty means
	// no section is rendered.
	FixSuggestion string
}

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

type TaskInfo struct {
	Name        string // display name (namespaced mod::task becomes mod__task as a tool)
	Doc         string
	Params      []ParamInfo
	Destructive bool // has [confirm]/destructive => DestructiveHint
	Network     bool // has [network] => OpenWorldHint
}