finder

package

v0.1.2 Latest Latest Go to latest Published: Mar 27, 2026 License: Apache-2.0 Imports: 6 Imported by: 0

Details

This section is empty.

This section is empty.

This section is empty.

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

Finder is an in-memory cache with optional lazy-loading through Loader.

func New(options ...Option) *Finder

New creates Finder instance.

func (d *Finder) Add(name string, a *agent.Agent)

Add stores an Agent under the provided name key.

func (d *Finder) All() []*agent.Agent

All returns a snapshot of all cached agents. It does not invoke the loader.

func (d *Finder) Find(ctx context.Context, name string) (*agent.Agent, error)

Agent returns an Agent by name, loading it if not found in the cache.

func (d *Finder) Remove(name string)

Remove deletes cached agent by name and bumps Version.

func (d *Finder) Version() int64

Version returns internal version counter.

type Option func(*Finder)

Option mutates Finder during construction.

func WithInitial(agents ...*agent.Agent) Option

func WithLoader(l agent.Loader) Option