names

package

v0.1.0 Latest Latest Go to latest Published: Apr 10, 2026 License: MIT Imports: 4 Imported by: 0

Details

Package names provides random name generation for agents.

This section is empty.

View Source

var DefaultGenerator = New()

DefaultGenerator is a package-level generator for convenience.

func Generate() string

Generate creates a random name using the default generator.

func GenerateUnique(existing map[string]bool, maxAttempts int) (string, error)

GenerateUnique creates a unique random name using the default generator.

func GenerateUniqueFromList(existingNames []string, maxAttempts int) (string, error)

GenerateUniqueFromList creates a unique random name using the default generator.

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

Generator creates random agent names.

func New() *Generator

New creates a new name generator.

func (g *Generator) Generate() string

Generate creates a random adjective-animal name.

func (g *Generator) GenerateUnique(existing map[string]bool, maxAttempts int) (string, error)

GenerateUnique creates a random name that doesn't exist in the given set. Returns error if unable to generate unique name after maxAttempts.

func (g *Generator) GenerateUniqueFromList(existingNames []string, maxAttempts int) (string, error)

GenerateUniqueFromList creates a random name not in the given list.