mcpserver

type Arg struct {
	Name        string
	Description string
	Required    bool
	Variadic    bool // takes a list
}

type Flag struct {
	Name    string
	Type    string // pflag type: bool, string, int, int64, duration, stringSlice, intSlice
	Default string
	Usage   string
	Values  []string // allowed values, when fixed
}

type Kind int

type Options struct {
	Name         string
	Version      string
	Instructions string
	Tools        []Tool
	Run          Runner
	// Prefix comes before the command of every call, for example --dir <folder>.
	Prefix []string
	// AllowDestructive registers the destructive tools. Without it they do not exist.
	AllowDestructive bool
	// Log receives the stderr of every command.
	Log io.Writer
	// MaxResultBytes cuts longer results, so that one result cannot fill the
	// context of a small model. 0 means no limit.
	MaxResultBytes int
}

type Runner func(ctx context.Context, args []string, progress io.Writer) (code int, stdout []byte)

type Tool struct {
	Name        string
	Title       string
	Description string
	Command     []string // for example ["documents", "get"]
	Kind        Kind
	Flags       []Flag
	Args        []Arg
	// Defaults are flag values used when the caller does not give the parameter.
	Defaults map[string]string
	// Extra arguments always passed, for example --yes.
	Extra []string
}