list

type Config struct {
	// Usage is the one-line command usage string.
	Usage string
	// ArgsUsage is the positional-arguments usage string.
	ArgsUsage string
	// Description is the long help text.
	Description string
	// Flags is the provider's flag set (param adds --recursive; secret does not).
	Flags []cli.Flag
	// NewList builds the entry-producing closure from the CLI context. withValue
	// mirrors the shared --show flag so the provider can request values.
	NewList func(ctx context.Context, cmd *cli.Command, withValue bool) (func(context.Context) ([]Entry, error), error)
}

type Entry struct {
	Name  string
	Value *string
	Error error
}

type JSONOutputItem struct {
	Name  string  `json:"name"`
	Value *string `json:"value,omitempty"` // nil when error or not requested, pointer to distinguish from empty string
	Error string  `json:"error,omitempty"`
}

type Options struct {
	Show   bool
	Output output.Format
}

type Runner struct {
	List    func(ctx context.Context) ([]Entry, error)
	Options Options
	Stdout  io.Writer
	Stderr  io.Writer
}