registry

type Cache interface {
	// Get retrieves a cached toolset schema by key.
	// Returns nil, nil if the key is not found or expired.
	Get(ctx context.Context, key string) (*ToolsetSchema, error)
	// Set stores a toolset schema with the given TTL.
	Set(ctx context.Context, key string, schema *ToolsetSchema, ttl time.Duration) error
	// Delete removes a cached entry.
	Delete(ctx context.Context, key string) error
}

type FederationConfig struct {
	// Include patterns for namespaces to import.
	Include []string
	// Exclude patterns for namespaces to skip.
	Exclude []string
}

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

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

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

type MemoryCacheOption func(*MemoryCache)

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

type OperationEvent struct {
	// Operation is the type of operation performed.
	Operation OperationType
	// Registry is the name of the registry involved.
	Registry string
	// Toolset is the name of the toolset involved (if applicable).
	Toolset string
	// Query is the search query (if applicable).
	Query string
	// Duration is how long the operation took.
	Duration time.Duration
	// Outcome is the result of the operation.
	Outcome OperationOutcome
	// Error is the error message if the operation failed.
	Error string
	// ResultCount is the number of results returned (if applicable).
	ResultCount int
	// CacheKey is the cache key used (if applicable).
	CacheKey string
}

type OperationOutcome string

type OperationType string

type Option func(*Manager)

type RefreshFunc func(ctx context.Context, key string) (*ToolsetSchema, error)

type RegistryClient interface {
	// ListToolsets returns all available toolsets from the registry.
	ListToolsets(ctx context.Context) ([]*ToolsetInfo, error)
	// GetToolset retrieves the full schema for a specific toolset.
	GetToolset(ctx context.Context, name string) (*ToolsetSchema, error)
	// Search performs a semantic or keyword search on the registry.
	Search(ctx context.Context, query string) ([]*SearchResult, error)
}

type RegistryConfig struct {
	// SyncInterval specifies how often to refresh the registry catalog.
	SyncInterval time.Duration
	// CacheTTL specifies local cache duration for registry data.
	CacheTTL time.Duration
	// Federation configures external registry import settings.
	Federation *FederationConfig
}

type SearchCapabilities struct {
	// SemanticSearch indicates if the registry supports semantic/vector search.
	SemanticSearch bool
	// KeywordSearch indicates if the registry supports keyword-based search.
	KeywordSearch bool
	// TagFiltering indicates if the registry supports filtering by tags.
	TagFiltering bool
	// TypeFiltering indicates if the registry supports filtering by type.
	TypeFiltering bool
}

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

type SearchOptions struct {
	// Registries limits search to specific registries. If empty, all registries are searched.
	Registries []string
	// Types filters results by type (e.g., "tool", "toolset", "agent").
	Types []string
	// Tags filters results by tags.
	Tags []string
	// MinRelevance filters results below this relevance score (0.0-1.0).
	MinRelevance float64
	// MaxResults limits the number of results returned.
	MaxResults int
	// PreferSemantic indicates whether to prefer semantic search over keyword.
	// When true, keyword search is only used as fallback.
	PreferSemantic bool
}

type SearchResult struct {
	// ID is the unique identifier.
	ID string
	// Name is the human-readable name.
	Name string
	// Description provides details.
	Description string
	// Type indicates the result type (e.g., "tool", "toolset", "agent").
	Type string
	// SchemaRef is a reference to the full schema.
	SchemaRef string
	// RelevanceScore indicates how relevant this result is to the query.
	RelevanceScore float64
	// Tags are metadata tags.
	Tags []string
	// Origin indicates the federation source if applicable.
	Origin string
}

type SemanticSearchClient interface {
	RegistryClient
	// SemanticSearch performs a semantic/vector search on the registry.
	SemanticSearch(ctx context.Context, query string, opts SemanticSearchOptions) ([]*SearchResult, error)
	// Capabilities returns the search capabilities of this registry.
	Capabilities() SearchCapabilities
}

type SemanticSearchOptions struct {
	// Types filters results by type.
	Types []string
	// Tags filters results by tags.
	Tags []string
	// MaxResults limits the number of results.
	MaxResults int
}

type ToolSchema struct {
	// Name is the tool identifier.
	Name string
	// Description explains what the tool does.
	Description string
	// Tags are optional metadata tags for discovery and filtering.
	Tags []string
	// PayloadSchema is the JSON Schema for tool input.
	PayloadSchema []byte
	// ResultSchema is the JSON Schema for tool output.
	ResultSchema []byte
	// SidecarSchema is the JSON Schema for tool sidecar (UI-only), when present.
	SidecarSchema []byte
}

type ToolsetInfo struct {
	// ID is the unique identifier for the toolset.
	ID string
	// Name is the human-readable name.
	Name string
	// Description provides details about the toolset.
	Description string
	// Version is the toolset version.
	Version string
	// Tags are metadata tags for discovery.
	Tags []string
	// Origin indicates the source registry for federated items.
	Origin string
}

type ToolsetSchema struct {
	// ID is the unique identifier for the toolset.
	ID string
	// Name is the human-readable name.
	Name string
	// Description provides details about the toolset.
	Description string
	// Version is the toolset version.
	Version string
	// Tools contains the tool definitions.
	Tools []*ToolSchema
	// Origin indicates the source registry for federated items.
	Origin string
}