Files
wehub-resource-sync e04ed9c211
CF: Deploy Dev Docs / deploy (push) Has been cancelled
Sync Labels / build (push) Has been cancelled
tests / unit tests (macos-latest) (push) Has been cancelled
tests / unit tests (windows-latest) (push) Has been cancelled
tests / unit tests (ubuntu-latest) (push) Has been cancelled
chore: import upstream snapshot with attribution
2026-07-13 13:32:45 +08:00

105 lines
3.1 KiB
Go

// Copyright 2024 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
package tools
import (
"fmt"
"regexp"
"github.com/googleapis/mcp-toolbox/internal/sources"
)
type ToolsetConfig struct {
Name string `yaml:"name"`
ToolNames []string `yaml:",inline"`
}
type Toolset struct {
ToolsetConfig
Tools []*Tool `yaml:",inline"`
Manifest ToolsetManifest `yaml:",inline"`
toolNameSet map[string]struct{}
}
func (t Toolset) ToConfig() ToolsetConfig {
return t.ToolsetConfig
}
// ContainsTool reports whether the toolset includes a tool with the given name.
// When built via Initialize, lookups are O(1) via toolNameSet; for Toolsets
// constructed directly (e.g., in tests), falls back to a linear scan of ToolNames.
func (t Toolset) ContainsTool(name string) bool {
if t.toolNameSet != nil {
_, ok := t.toolNameSet[name]
return ok
}
for _, n := range t.ToolNames {
if n == name {
return true
}
}
return false
}
type ToolsetManifest struct {
ServerVersion string `json:"serverVersion"`
ToolsManifest map[string]Manifest `json:"tools"`
}
// BuildManifest resolves the manifest for every tool in the toolset against the
// provided sources, returning an error if any tool's manifest cannot be built.
func (t Toolset) BuildManifest(srcs map[string]sources.Source) (ToolsetManifest, error) {
toolsManifest := make(map[string]Manifest, len(t.Tools))
for _, tool := range t.Tools {
m, err := (*tool).Manifest(srcs)
if err != nil {
return ToolsetManifest{}, fmt.Errorf("error generating manifest for tool %q: %w", (*tool).GetName(), err)
}
toolsManifest[(*tool).GetName()] = m
}
return ToolsetManifest{ServerVersion: t.Manifest.ServerVersion, ToolsManifest: toolsManifest}, nil
}
func (t ToolsetConfig) Initialize(serverVersion string, toolsMap map[string]Tool) (Toolset, error) {
// finish toolset setup
// Check each declared tool name exists
toolset := Toolset{
ToolsetConfig: t,
Tools: make([]*Tool, 0, len(t.ToolNames)),
Manifest: ToolsetManifest{
ServerVersion: serverVersion,
},
toolNameSet: make(map[string]struct{}, len(t.ToolNames)),
}
if !IsValidName(toolset.Name) {
return toolset, fmt.Errorf("invalid toolset name: %s", toolset.Name)
}
for _, toolName := range t.ToolNames {
tool, ok := toolsMap[toolName]
if !ok {
return toolset, fmt.Errorf("tool does not exist: %s", toolName)
}
toolset.Tools = append(toolset.Tools, &tool)
toolset.toolNameSet[toolName] = struct{}{}
}
return toolset, nil
}
var validName = regexp.MustCompile(`^[a-zA-Z0-9_-]*$`)
func IsValidName(s string) bool {
return validName.MatchString(s)
}