mcpgen

type FlagMap struct {
	Flag  string `yaml:"flag"`
	Param string `yaml:"param"`
	As    string `yaml:"as"` // "" | seconds
}

type Invoker func(ctx context.Context, path string, req invoke.Request) (invoke.Result, error)

type Options struct {
	Registry *cmdregistry.Registry
	Invoke   Invoker
	// Schema returns a committed schema by its path relative to schemas/.
	Schema func(name string) ([]byte, bool)
	// V15 selects v1.5 mode: generated tools and aliases only.
	V15 bool
	// Warn receives one line for each plugin command skipped because its tool
	// name is invalid or taken; core conflicts fail Tools instead.
	Warn func(string)
}

type Param struct {
	Name        string `yaml:"name"`
	Type        string `yaml:"type"` // string | integer | number | boolean
	Description string `yaml:"description"`
	Default     any    `yaml:"default"`
	// AllowEmpty keeps an empty string as a value (config set may clear a key);
	// otherwise an empty string counts as not given, as the hand tools did.
	AllowEmpty bool `yaml:"allow_empty"`
	// Positive makes a value of zero or less fall back to Default, as the hand
	// tools did (lines <= 0 meant 50).
	Positive bool `yaml:"positive"`
}

type Removed struct {
	Code    string   `yaml:"code"`
	Message string   `yaml:"message"`
	Use     []string `yaml:"use"`
}

type ResourceOptions struct {
	Registry *cmdregistry.Registry
	Invoke   Invoker
	Schema   func(name string) ([]byte, bool)
	// Catalog returns the cached plugin catalogue document, or an error when
	// there is none; it must not touch the network.
	Catalog func() ([]byte, error)
	// Fallback serves a legacy URI whose command is not exposed on machine
	// surfaces yet (for example one with no envelope), so the URI keeps working
	// until the command is converted. Keyed by URI; optional.
	Fallback map[string]server.ResourceHandlerFunc
	V15      bool
}

type Row struct {
	Name        string    `yaml:"name"`
	Kind        string    `yaml:"kind"`
	Target      string    `yaml:"target"`
	Plugin      string    `yaml:"plugin"`
	SideEffect  string    `yaml:"side_effect"`
	Summary     string    `yaml:"summary"`
	Params      []Param   `yaml:"params"`
	Required    []string  `yaml:"required"`
	Args        []string  `yaml:"args"`
	Flags       []FlagMap `yaml:"flags"`
	Unsupported []string  `yaml:"unsupported"`
	Removed     *Removed  `yaml:"removed"`
	// Shortcut marks a row that is not a legacy name: a short, current alias
	// of a generated tool (nself_capabilities). It is registered in both modes,
	// is not deprecated and adds no deprecation note.
	Shortcut bool `yaml:"shortcut"`
}

type Table struct {
	RemovalAt string
	Rows      []Row
	// contains filtered or unexported fields
}