workflowcontract

type BuiltInTypeDefinition struct {
	Key    StepTypeKey
	Step   StepDefinition
	Docs   ToolMetadata
	Schema SchemaMetadata
}

type FieldDoc struct {
	Description string
	Example     string
}

type OutputRootConstraint struct {
	Path    string
	Root    string
	Example string
}

type ParallelMetadata struct {
	ApplySafe        bool
	ApplyTargetPaths []string
	PrepareOutput    OutputRootConstraint
}

type SchemaMetadata struct {
	GeneratorName string
	SpecType      any
	Patch         func(root map[string]any)
}

type StepDefinition struct {
	APIVersion          string
	Kind                string
	Family              string
	FamilyTitle         string
	Group               string
	GroupOrder          int
	DocsPage            string
	DocsOrder           int
	SchemaFile          string
	ToolSchemaGenerator string
	Visibility          string
	Category            string
	Summary             string
	WhenToUse           string
	Roles               []string
	Outputs             []string
	Parallel            ParallelMetadata
}

type StepTypeKey struct {
	APIVersion string
	Kind       string
}

type ToolMetadata struct {
	Kind      string
	Category  string
	Summary   string
	WhenToUse string
	Example   string
	FieldDocs map[string]FieldDoc
	Notes     []string
}