chore: update docs and root test

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

CONTRIBUTING.md

@@ -92,11 +92,11 @@ implementation](https://github.com/googleapis/genai-toolbox/blob/main/internal/s
   `newdb.go`. Create a `Config` struct to include all the necessary parameters
   for connecting to the database (e.g., host, port, username, password, database
   name) and a `Source` struct to store necessary parameters for tools (e.g.,
-  Name, Kind, connection object, additional config).
+  Name, Type, connection object, additional config).
 * **Implement the
   [`SourceConfig`](https://github.com/googleapis/genai-toolbox/blob/fd300dc606d88bf9f7bba689e2cee4e3565537dd/internal/sources/sources.go#L57)
   interface**. This interface requires two methods:
-  * `SourceConfigKind() string`: Returns a unique string identifier for your
+  * `SourceConfigType() string`: Returns a unique string identifier for your
     data source (e.g., `"newdb"`).
   * `Initialize(ctx context.Context, tracer trace.Tracer) (Source, error)`:
     Creates a new instance of your data source and establishes a connection to
@@ -104,7 +104,7 @@ implementation](https://github.com/googleapis/genai-toolbox/blob/main/internal/s
 * **Implement the
   [`Source`](https://github.com/googleapis/genai-toolbox/blob/fd300dc606d88bf9f7bba689e2cee4e3565537dd/internal/sources/sources.go#L63)
   interface**. This interface requires one method:
-  * `SourceKind() string`: Returns the same string identifier as `SourceConfigKind()`.
+  * `SourceType() string`: Returns the same string identifier as `SourceConfigType()`.
 * **Implement `init()`** to register the new Source.
 * **Implement Unit Tests** in a file named `newdb_test.go`.
 
@@ -126,7 +126,7 @@ tools.
 * **Implement the
   [`ToolConfig`](https://github.com/googleapis/genai-toolbox/blob/fd300dc606d88bf9f7bba689e2cee4e3565537dd/internal/tools/tools.go#L61)
   interface**. This interface requires one method:
-  * `ToolConfigKind() string`: Returns a unique string identifier for your tool
+  * `ToolConfigType() string`: Returns a unique string identifier for your tool
     (e.g., `"newdb-tool"`).
   * `Initialize(sources map[string]Source) (Tool, error)`: Creates a new
     instance of your tool and validates that it can connect to the specified
@@ -243,7 +243,7 @@ resources.
   | style           | Update src code, with only formatting and whitespace updates (e.g. code formatter or linter changes). |
 
   Pull requests should always add scope whenever possible. The scope is
-  formatted as `<scope-type>/<scope-kind>` (e.g., `sources/postgres`, or
+  formatted as `<scope-resource>/<scope-type>` (e.g., `sources/postgres`, or
   `tools/mssql-sql`).
   
   Ideally, **each PR covers only one scope**, if this is

DEVELOPER.md

@@ -47,11 +47,12 @@ Before you begin, ensure you have the following:
 ### Tool Naming Conventions
 
 This section details the purpose and conventions for MCP Toolbox's tools naming
-properties, **tool name** and **tool kind**.
+properties, **tool name** and **tool type**.
 
 ```
-cancel_hotel: <- tool name
+kind: tools
-    kind: postgres-sql  <- tool kind
+name: cancel_hotel <- tool name
+type: postgres-sql  <- tool type
 source: my_pg_source
 ```
 
@@ -76,17 +77,17 @@ The following guidelines apply to tool names:
   to a function) until they can be validated through extensive testing to ensure
   they do not negatively impact agent's performances.
 
-#### Tool Kind
+#### Tool Type
 
-Tool kind serves as a category or type that a user can assign to a tool.
+Tool type serves as a category or type that a user can assign to a tool.
 
-The following guidelines apply to tool kinds:
+The following guidelines apply to tool types:
 
 * Should user hyphens over underscores (e.g. `firestore-list-collections` or
   `firestore_list_colelctions`).
 * Should use product name in name (e.g. `firestore-list-collections` over
   `list-collections`).
-* Changes to tool kind are breaking changes and should be avoided.
+* Changes to tool type are breaking changes and should be avoided.
 
 ## Testing
 

README.md

@@ -938,9 +938,9 @@ Toolbox should have access to. Most tools will have at least one source to
 execute against.
 
 ```yaml
-sources:
+kind: sources
-  my-pg-source:
+name: my-pg-source
-    kind: postgres
+type: postgres
 host: 127.0.0.1
 port: 5432
 database: toolbox_db
@@ -954,12 +954,12 @@ For more details on configuring different types of sources, see the
 ### Tools
 
 The `tools` section of a `tools.yaml` define the actions an agent can take: what
-kind of tool it is, which source(s) it affects, what parameters it uses, etc.
+type of tool it is, which source(s) it affects, what parameters it uses, etc.
 
 ```yaml
-tools:
+kind: tools
-  search-hotels-by-name:
+name: search-hotels-by-name
-    kind: postgres-sql
+type: postgres-sql
 source: my-pg-source
 description: Search for hotels based on name.
 parameters:

cmd/root.go

@@ -15,6 +15,7 @@
 package cmd
 
 import (
+	"bytes"
 	"context"
 	_ "embed"
 	"fmt"
@@ -394,7 +395,6 @@ func NewCommand(opts ...Option) *Command {
 
 type ToolsFile struct {
 	Sources         server.SourceConfigs         `yaml:"sources"`
-	AuthSources     server.AuthServiceConfigs    `yaml:"authSources"` // Deprecated: Kept for compatibility.
 	AuthServices    server.AuthServiceConfigs    `yaml:"authServices"`
 	EmbeddingModels server.EmbeddingModelConfigs `yaml:"embeddingModels"`
 	Tools           server.ToolConfigs           `yaml:"tools"`
@@ -425,6 +425,106 @@ func parseEnv(input string) (string, error) {
 	return output, err
 }
 
+func convertToolsFile(ctx context.Context, raw []byte) ([]byte, error) {
+	var input yaml.MapSlice
+	decoder := yaml.NewDecoder(bytes.NewReader(raw), yaml.UseOrderedMap())
+	if err := decoder.Decode(&input); err != nil {
+		return nil, err
+	}
+
+	// Convert raw MapSlice to a helper map for quick lookup
+	// while keeping the values as MapSlices to preserve internal order
+	resourceOrder := []string{}
+	lookup := make(map[string]yaml.MapSlice)
+	for _, item := range input {
+		key, ok := item.Key.(string)
+		if !ok {
+			return nil, fmt.Errorf("unexpected non-string key in input: %v", item.Key)
+		}
+		if slice, ok := item.Value.(yaml.MapSlice); ok {
+			// convert authSources to authServices
+			if key == "authSources" {
+				key = "authServices"
+			}
+			// works even if lookup[key] is nil
+			lookup[key] = append(lookup[key], slice...)
+			// preserving the resource's order of original toolsFile
+			if !slices.Contains(resourceOrder, key) {
+				resourceOrder = append(resourceOrder, key)
+			}
+		} else {
+			// toolsfile is already v2
+			if key == "kind" {
+				return raw, nil
+			}
+			return nil, fmt.Errorf("'%s' is not a map", key)
+		}
+	}
+	// convert to tools file v2
+	var buf bytes.Buffer
+	encoder := yaml.NewEncoder(&buf)
+	for _, kind := range resourceOrder {
+		data, exists := lookup[kind]
+		if !exists {
+			// if this is skipped for all keys, the tools file is in v2
+			continue
+		}
+		// Transform each entry
+		for _, entry := range data {
+			entryName, ok := entry.Key.(string)
+			if !ok {
+				return nil, fmt.Errorf("unexpected non-string key for entry in '%s': %v", kind, entry.Key)
+			}
+			entryBody := ProcessValue(entry.Value, kind == "toolsets")
+
+			transformed := yaml.MapSlice{
+				{Key: "kind", Value: kind},
+				{Key: "name", Value: entryName},
+			}
+
+			// Merge the transformed body into our result
+			if bodySlice, ok := entryBody.(yaml.MapSlice); ok {
+				transformed = append(transformed, bodySlice...)
+			} else {
+				return nil, fmt.Errorf("unable to convert entryBody to MapSlice")
+			}
+
+			if err := encoder.Encode(transformed); err != nil {
+				return nil, err
+			}
+		}
+	}
+	return buf.Bytes(), nil
+}
+
+// ProcessValue recursively looks for MapSlices to rename 'kind' -> 'type'
+func ProcessValue(v any, isToolset bool) any {
+	switch val := v.(type) {
+	case yaml.MapSlice:
+		for i := range val {
+			// Perform renaming
+			if val[i].Key == "kind" {
+				val[i].Key = "type"
+			}
+			// Recursive call for nested values (e.g., nested objects or lists)
+			val[i].Value = ProcessValue(val[i].Value, false)
+		}
+		return val
+	case []any:
+		// Process lists: If it's a toolset top-level list, wrap it.
+		if isToolset {
+			return yaml.MapSlice{{Key: "tools", Value: val}}
+		}
+		// Otherwise, recurse into list items (to catch nested objects)
+		for i := range val {
+			val[i] = ProcessValue(val[i], false)
+		}
+		return val
+	default:
+		return val
+	}
+}
+
 // parseToolsFile parses the provided yaml into appropriate configs.
 func parseToolsFile(ctx context.Context, raw []byte) (ToolsFile, error) {
 	var toolsFile ToolsFile
@@ -435,8 +535,13 @@ func parseToolsFile(ctx context.Context, raw []byte) (ToolsFile, error) {
 	}
 	raw = []byte(output)
 
+	raw, err = convertToolsFile(ctx, raw)
+	if err != nil {
+		return toolsFile, fmt.Errorf("error converting tools file: %s", err)
+	}
+
 	// Parse contents
-	err = yaml.UnmarshalContext(ctx, raw, &toolsFile, yaml.Strict())
+	toolsFile.Sources, toolsFile.AuthServices, toolsFile.EmbeddingModels, toolsFile.Tools, toolsFile.Toolsets, toolsFile.Prompts, err = server.UnmarshalResourceConfig(ctx, raw)
 	if err != nil {
 		return toolsFile, err
 	}
@@ -468,18 +573,6 @@ func mergeToolsFiles(files ...ToolsFile) (ToolsFile, error) {
 			}
 		}
 
-		// Check for conflicts and merge authSources (deprecated, but still support)
-		for name, authSource := range file.AuthSources {
-			if _, exists := merged.AuthSources[name]; exists {
-				conflicts = append(conflicts, fmt.Sprintf("authSource '%s' (file #%d)", name, fileIndex+1))
-			} else {
-				if merged.AuthSources == nil {
-					merged.AuthSources = make(server.AuthServiceConfigs)
-				}
-				merged.AuthSources[name] = authSource
-			}
-		}
-
 		// Check for conflicts and merge authServices
 		for name, authService := range file.AuthServices {
 			if _, exists := merged.AuthServices[name]; exists {
@@ -955,20 +1048,6 @@ func run(cmd *Command) error {
 	cmd.cfg.ToolsetConfigs = finalToolsFile.Toolsets
 	cmd.cfg.PromptConfigs = finalToolsFile.Prompts
 
-	authSourceConfigs := finalToolsFile.AuthSources
-	if authSourceConfigs != nil {
-		cmd.logger.WarnContext(ctx, "`authSources` is deprecated, use `authServices` instead")
-
-		for k, v := range authSourceConfigs {
-			if _, exists := cmd.cfg.AuthServiceConfigs[k]; exists {
-				errMsg := fmt.Errorf("resource conflict detected: authSource '%s' has the same name as an existing authService. Please rename your authSource", k)
-				cmd.logger.ErrorContext(ctx, errMsg.Error())
-				return errMsg
-			}
-			cmd.cfg.AuthServiceConfigs[k] = v
-		}
-	}
-
 	instrumentation, err := telemetry.CreateTelemetryInstrumentation(versionString)
 	if err != nil {
 		errMsg := fmt.Errorf("unable to create telemetry instrumentation: %w", err)

cmd/root_test.go

@@ -23,12 +23,14 @@ import (
 	"os"
 	"path"
 	"path/filepath"
+	"reflect"
 	"regexp"
 	"runtime"
 	"strings"
 	"testing"
 	"time"
 
+	yaml "github.com/goccy/go-yaml"
 	"github.com/google/go-cmp/cmp"
 
 	"github.com/googleapis/genai-toolbox/internal/auth/google"
@@ -494,6 +496,309 @@ func TestDefaultLogLevel(t *testing.T) {
 	}
 }
 
+func TestConvertToolsFile(t *testing.T) {
+	ctx, cancelCtx := context.WithTimeout(context.Background(), time.Minute)
+	defer cancelCtx()
+	pr, pw := io.Pipe()
+	defer pw.Close()
+	defer pr.Close()
+
+	logger, err := log.NewStdLogger(pw, pw, "DEBUG")
+	if err != nil {
+		t.Fatalf("failed to setup logger %s", err)
+	}
+	ctx = util.WithLogger(ctx, logger)
+
+	tcs := []struct {
+		desc   string
+		in     string
+		want   string
+		isErr  bool
+		errStr string
+	}{
+		{
+			desc: "basic convert",
+			in: `
+            sources:
+                my-pg-instance:
+                    kind: cloud-sql-postgres
+                    project: my-project
+                    region: my-region
+                    instance: my-instance
+                    database: my_db
+                    user: my_user
+                    password: my_pass
+            authServices:
+                my-google-auth:
+                    kind: google
+                    clientId: testing-id
+            tools:
+                example_tool:
+                    kind: postgres-sql
+                    source: my-pg-instance
+                    description: some description
+                    statement: |
+                      SELECT * FROM SQL_STATEMENT;
+                    parameters:
+                        - name: country
+                          type: string
+                          description: some description
+            toolsets:
+                example_toolset:
+                    - example_tool
+            prompts:
+                code_review:
+                    description: ask llm to analyze code quality
+                    messages:
+                      - content: "please review the following code for quality: {{.code}}"
+                    arguments:
+                        - name: code
+                          description: the code to review
+            embeddingModels:
+                gemini-model:
+                    kind: gemini
+                    model: gemini-embedding-001
+                    apiKey: some-key
+                    dimension: 768`,
+			want: `
+kind: sources
+name: my-pg-instance
+type: cloud-sql-postgres
+project: my-project
+region: my-region
+instance: my-instance
+database: my_db
+user: my_user
+password: my_pass
+---
+kind: authServices
+name: my-google-auth
+type: google
+clientId: testing-id
+---
+kind: tools
+name: example_tool
+type: postgres-sql
+source: my-pg-instance
+description: some description
+statement: |
+    SELECT * FROM SQL_STATEMENT;
+parameters:
+- name: country
+  type: string
+  description: some description
+---
+kind: toolsets
+name: example_toolset
+tools:
+- example_tool
+---
+kind: prompts
+name: code_review
+description: ask llm to analyze code quality
+messages:
+- content: "please review the following code for quality: {{.code}}"
+arguments:
+- name: code
+  description: the code to review
+---
+kind: embeddingModels
+name: gemini-model
+type: gemini
+model: gemini-embedding-001
+apiKey: some-key
+dimension: 768`,
+		},
+		{
+			desc: "preserve resource order with grouping",
+			in: `
+            tools:
+                example_tool:
+                    kind: postgres-sql
+                    source: my-pg-instance
+                    description: some description
+                    statement: |
+                        SELECT * FROM SQL_STATEMENT;
+                    parameters:
+                        - name: country
+                          type: string
+                          description: some description
+            sources:
+                my-pg-instance:
+                    kind: cloud-sql-postgres
+                    project: my-project
+                    region: my-region
+                    instance: my-instance
+                    database: my_db
+                    user: my_user
+                    password: my_pass
+            authServices:
+                my-google-auth:
+                    kind: google
+                    clientId: testing-id
+            toolsets:
+                example_toolset:
+                    - example_tool
+            authSources:
+                my-google-auth:
+                    kind: google
+                    clientId: testing-id`,
+			want: `
+kind: tools
+name: example_tool
+type: postgres-sql
+source: my-pg-instance
+description: some description
+statement: |
+    SELECT * FROM SQL_STATEMENT;
+parameters:
+- name: country
+  type: string
+  description: some description
+---
+kind: sources
+name: my-pg-instance
+type: cloud-sql-postgres
+project: my-project
+region: my-region
+instance: my-instance
+database: my_db
+user: my_user
+password: my_pass
+---
+kind: authServices
+name: my-google-auth
+type: google
+clientId: testing-id
+---
+kind: authServices
+name: my-google-auth
+type: google
+clientId: testing-id
+---
+kind: toolsets
+name: example_toolset
+tools:
+- example_tool`,
+		},
+		{
+			desc: "no convertion needed",
+			in: `
+kind: sources
+name: my-pg-instance
+type: cloud-sql-postgres
+project: my-project
+region: my-region
+instance: my-instance
+database: my_db
+user: my_user
+password: my_pass
+---
+kind: tools
+name: example_tool
+type: postgres-sql
+source: my-pg-instance
+description: some description
+statement: |
+    SELECT * FROM SQL_STATEMENT;
+parameters:
+- name: country
+  type: string
+  description: some description
+---
+kind: toolsets
+name: example_toolset
+tools:
+- example_tool`,
+			want: `
+kind: sources
+name: my-pg-instance
+type: cloud-sql-postgres
+project: my-project
+region: my-region
+instance: my-instance
+database: my_db
+user: my_user
+password: my_pass
+---
+kind: tools
+name: example_tool
+type: postgres-sql
+source: my-pg-instance
+description: some description
+statement: |
+    SELECT * FROM SQL_STATEMENT;
+parameters:
+- name: country
+  type: string
+  description: some description
+---
+kind: toolsets
+name: example_toolset
+tools:
+- example_tool`,
+		},
+		{
+			desc:   "invalid source",
+			in:     `sources: invalid`,
+			isErr:  true,
+			errStr: "'sources' is not a map",
+		},
+		{
+			desc:   "invalid toolset",
+			in:     `toolsets: invalid`,
+			isErr:  true,
+			errStr: "'toolsets' is not a map",
+		},
+	}
+	for _, tc := range tcs {
+		t.Run(tc.desc, func(t *testing.T) {
+			output, err := convertToolsFile(ctx, []byte(tc.in))
+			if tc.isErr {
+				if err == nil {
+					t.Fatalf("missing error: %s", tc.errStr)
+				}
+				if err.Error() != tc.errStr {
+					t.Fatalf("invalid error string: got %s, want %s", err, tc.errStr)
+				}
+				return
+			}
+			if err != nil {
+				t.Fatalf("unexpected error: %s", err)
+			}
+
+			var docs1, docs2 []yaml.MapSlice
+			if docs1, err = decodeToMapSlice(string(output)); err != nil {
+				t.Fatalf("error decoding output: %s", err)
+			}
+			if docs2, err = decodeToMapSlice(tc.want); err != nil {
+				t.Fatalf("Error decoding want: %s", err)
+			}
+			if !reflect.DeepEqual(docs1, docs2) {
+				t.Fatalf("incorrect output: got %s, want %s", string(output), tc.want)
+			}
+		})
+	}
+}
+
+func decodeToMapSlice(data string) ([]yaml.MapSlice, error) {
+	// ensures that the order is correct
+	var docs []yaml.MapSlice
+	decoder := yaml.NewDecoder(strings.NewReader(data))
+	for {
+		var doc yaml.MapSlice
+		err := decoder.Decode(&doc)
+		if err == io.EOF {
+			break
+		}
+		if err != nil {
+			return nil, err
+		}
+		docs = append(docs, doc)
+	}
+	return docs, nil
+}
+
 func TestParseToolFile(t *testing.T) {
 	ctx, err := testutils.ContextWithNewLogger()
 	if err != nil {
@@ -505,7 +810,7 @@ func TestParseToolFile(t *testing.T) {
 		wantToolsFile ToolsFile
 	}{
 		{
-			description: "basic example",
+			description: "basic example tools file v1",
 			in: `
 			sources:
 				my-pg-instance:
@@ -535,7 +840,7 @@ func TestParseToolFile(t *testing.T) {
 				Sources: server.SourceConfigs{
 					"my-pg-instance": cloudsqlpgsrc.Config{
 						Name:     "my-pg-instance",
-						Kind:     cloudsqlpgsrc.SourceKind,
+						Type:     cloudsqlpgsrc.SourceType,
 						Project:  "my-project",
 						Region:   "my-region",
 						Instance: "my-instance",
@@ -548,7 +853,7 @@ func TestParseToolFile(t *testing.T) {
 				Tools: server.ToolConfigs{
 					"example_tool": postgressql.Config{
 						Name:        "example_tool",
-						Kind:        "postgres-sql",
+						Type:        "postgres-sql",
 						Source:      "my-pg-instance",
 						Description: "some description",
 						Statement:   "SELECT * FROM SQL_STATEMENT;\n",
@@ -568,10 +873,124 @@ func TestParseToolFile(t *testing.T) {
 			},
 		},
 		{
-			description: "with prompts example",
+			description: "basic example tools file v2",
 			in: `
-            prompts:
+			kind: sources
-                my-prompt:
+			name: my-pg-instance
+			type: cloud-sql-postgres
+			project: my-project
+			region: my-region
+			instance: my-instance
+			database: my_db
+			user: my_user
+			password: my_pass
+---
+			kind: authServices
+			name: my-google-auth
+			type: google
+			clientId: testing-id
+---
+			kind: embeddingModels
+			name: gemini-model
+			type: gemini
+			model: gemini-embedding-001
+			apiKey: some-key
+			dimension: 768
+---
+			kind: tools
+			name: example_tool
+			type: postgres-sql
+			source: my-pg-instance
+			description: some description
+			statement: |
+				SELECT * FROM SQL_STATEMENT;
+			parameters:
+			- name: country
+			  type: string
+			  description: some description
+---
+			kind: toolsets
+			name: example_toolset
+			tools:
+			- example_tool
+---
+			kind: prompts
+			name: code_review
+			description: ask llm to analyze code quality
+			messages:
+			- content: "please review the following code for quality: {{.code}}"
+			arguments:
+			- name: code
+			  description: the code to review
+			`,
+			wantToolsFile: ToolsFile{
+				Sources: server.SourceConfigs{
+					"my-pg-instance": cloudsqlpgsrc.Config{
+						Name:     "my-pg-instance",
+						Type:     cloudsqlpgsrc.SourceType,
+						Project:  "my-project",
+						Region:   "my-region",
+						Instance: "my-instance",
+						IPType:   "public",
+						Database: "my_db",
+						User:     "my_user",
+						Password: "my_pass",
+					},
+				},
+				AuthServices: server.AuthServiceConfigs{
+					"my-google-auth": google.Config{
+						Name:     "my-google-auth",
+						Type:     google.AuthServiceType,
+						ClientID: "testing-id",
+					},
+				},
+				EmbeddingModels: server.EmbeddingModelConfigs{
+					"gemini-model": gemini.Config{
+						Name:      "gemini-model",
+						Type:      gemini.EmbeddingModelType,
+						Model:     "gemini-embedding-001",
+						ApiKey:    "some-key",
+						Dimension: 768,
+					},
+				},
+				Tools: server.ToolConfigs{
+					"example_tool": postgressql.Config{
+						Name:        "example_tool",
+						Type:        "postgres-sql",
+						Source:      "my-pg-instance",
+						Description: "some description",
+						Statement:   "SELECT * FROM SQL_STATEMENT;\n",
+						Parameters: []parameters.Parameter{
+							parameters.NewStringParameter("country", "some description"),
+						},
+						AuthRequired: []string{},
+					},
+				},
+				Toolsets: server.ToolsetConfigs{
+					"example_toolset": tools.ToolsetConfig{
+						Name:      "example_toolset",
+						ToolNames: []string{"example_tool"},
+					},
+				},
+				Prompts: server.PromptConfigs{
+					"code_review": custom.Config{
+						Name:        "code_review",
+						Description: "ask llm to analyze code quality",
+						Arguments: prompts.Arguments{
+							{Parameter: parameters.NewStringParameter("code", "the code to review")},
+						},
+						Messages: []prompts.Message{
+							{Role: "user", Content: "please review the following code for quality: {{.code}}"},
+						},
+					},
+				},
+			},
+		},
+		{
+			description: "only prompts",
+			in: `
+            kind: prompts
+            name: my-prompt
 			description: A prompt template for data analysis.
 			arguments:
 				- name: country
@@ -638,26 +1057,29 @@ func TestParseToolFileWithAuth(t *testing.T) {
 		{
 			description: "basic example",
 			in: `
-			sources:
+			kind: sources
-				my-pg-instance:
+			name: my-pg-instance
-					kind: cloud-sql-postgres
+			type: cloud-sql-postgres
 			project: my-project
 			region: my-region
 			instance: my-instance
 			database: my_db
 			user: my_user
 			password: my_pass
-			authServices:
+			---
-				my-google-service:
+			kind: authServices
-					kind: google
+			name: my-google-service
+			type: google
 			clientId: my-client-id
-				other-google-service:
+			---
-					kind: google
+			kind: authServices
+			name: other-google-service
+			type: google
 			clientId: other-client-id
-
+			---
-			tools:
+			kind: tools
-				example_tool:
+			name: example_tool
-					kind: postgres-sql
+			type: postgres-sql
 			source: my-pg-instance
 			description: some description
 			statement: |
@@ -680,16 +1102,17 @@ func TestParseToolFileWithAuth(t *testing.T) {
 						field: email
 					- name: other-google-service
 						field: other_email
-
+			---
-			toolsets:
+			kind: toolsets
-				example_toolset:
+			name: example_toolset
+			tools:
 				- example_tool
 			`,
 			wantToolsFile: ToolsFile{
 				Sources: server.SourceConfigs{
 					"my-pg-instance": cloudsqlpgsrc.Config{
 						Name:     "my-pg-instance",
-						Kind:     cloudsqlpgsrc.SourceKind,
+						Type:     cloudsqlpgsrc.SourceType,
 						Project:  "my-project",
 						Region:   "my-region",
 						Instance: "my-instance",
@@ -702,19 +1125,19 @@ func TestParseToolFileWithAuth(t *testing.T) {
 				AuthServices: server.AuthServiceConfigs{
 					"my-google-service": google.Config{
 						Name:     "my-google-service",
-						Kind:     google.AuthServiceKind,
+						Type:     google.AuthServiceType,
 						ClientID: "my-client-id",
 					},
 					"other-google-service": google.Config{
 						Name:     "other-google-service",
-						Kind:     google.AuthServiceKind,
+						Type:     google.AuthServiceType,
 						ClientID: "other-client-id",
 					},
 				},
 				Tools: server.ToolConfigs{
 					"example_tool": postgressql.Config{
 						Name:         "example_tool",
-						Kind:         "postgres-sql",
+						Type:         "postgres-sql",
 						Source:       "my-pg-instance",
 						Description:  "some description",
 						Statement:    "SELECT * FROM SQL_STATEMENT;\n",
@@ -789,7 +1212,7 @@ func TestParseToolFileWithAuth(t *testing.T) {
 				Sources: server.SourceConfigs{
 					"my-pg-instance": cloudsqlpgsrc.Config{
 						Name:     "my-pg-instance",
-						Kind:     cloudsqlpgsrc.SourceKind,
+						Type:     cloudsqlpgsrc.SourceType,
 						Project:  "my-project",
 						Region:   "my-region",
 						Instance: "my-instance",
@@ -799,22 +1222,22 @@ func TestParseToolFileWithAuth(t *testing.T) {
 						Password: "my_pass",
 					},
 				},
-				AuthSources: server.AuthServiceConfigs{
+				AuthServices: server.AuthServiceConfigs{
 					"my-google-service": google.Config{
 						Name:     "my-google-service",
-						Kind:     google.AuthServiceKind,
+						Type:     google.AuthServiceType,
 						ClientID: "my-client-id",
 					},
 					"other-google-service": google.Config{
 						Name:     "other-google-service",
-						Kind:     google.AuthServiceKind,
+						Type:     google.AuthServiceType,
 						ClientID: "other-client-id",
 					},
 				},
 				Tools: server.ToolConfigs{
 					"example_tool": postgressql.Config{
 						Name:         "example_tool",
-						Kind:         "postgres-sql",
+						Type:         "postgres-sql",
 						Source:       "my-pg-instance",
 						Description:  "some description",
 						Statement:    "SELECT * FROM SQL_STATEMENT;\n",
@@ -838,26 +1261,29 @@ func TestParseToolFileWithAuth(t *testing.T) {
 		{
 			description: "basic example with authRequired",
 			in: `
-			sources:
+			kind: sources
-				my-pg-instance:
+			name: my-pg-instance
-					kind: cloud-sql-postgres
+			type: cloud-sql-postgres
 			project: my-project
 			region: my-region
 			instance: my-instance
 			database: my_db
 			user: my_user
 			password: my_pass
-			authServices:
+			---
-				my-google-service:
+			kind: authServices
-					kind: google
+			name: my-google-service
+			type: google
 			clientId: my-client-id
-				other-google-service:
+			---
-					kind: google
+			kind: authServices
+			name: other-google-service
+			type: google
 			clientId: other-client-id
-
+			---
-			tools:
+			kind: tools
-				example_tool:
+			name: example_tool
-					kind: postgres-sql
+			type: postgres-sql
 			source: my-pg-instance
 			description: some description
 			statement: |
@@ -882,16 +1308,17 @@ func TestParseToolFileWithAuth(t *testing.T) {
 						field: email
 					- name: other-google-service
 						field: other_email
-
+			---
-			toolsets:
+			kind: toolsets
-				example_toolset:
+			name: example_toolset
+			tools:
 				- example_tool
 			`,
 			wantToolsFile: ToolsFile{
 				Sources: server.SourceConfigs{
 					"my-pg-instance": cloudsqlpgsrc.Config{
 						Name:     "my-pg-instance",
-						Kind:     cloudsqlpgsrc.SourceKind,
+						Type:     cloudsqlpgsrc.SourceType,
 						Project:  "my-project",
 						Region:   "my-region",
 						Instance: "my-instance",
@@ -904,19 +1331,19 @@ func TestParseToolFileWithAuth(t *testing.T) {
 				AuthServices: server.AuthServiceConfigs{
 					"my-google-service": google.Config{
 						Name:     "my-google-service",
-						Kind:     google.AuthServiceKind,
+						Type:     google.AuthServiceType,
 						ClientID: "my-client-id",
 					},
 					"other-google-service": google.Config{
 						Name:     "other-google-service",
-						Kind:     google.AuthServiceKind,
+						Type:     google.AuthServiceType,
 						ClientID: "other-client-id",
 					},
 				},
 				Tools: server.ToolConfigs{
 					"example_tool": postgressql.Config{
 						Name:         "example_tool",
-						Kind:         "postgres-sql",
+						Type:         "postgres-sql",
 						Source:       "my-pg-instance",
 						Description:  "some description",
 						Statement:    "SELECT * FROM SQL_STATEMENT;\n",
@@ -1062,7 +1489,7 @@ func TestEnvVarReplacement(t *testing.T) {
 				Sources: server.SourceConfigs{
 					"my-http-instance": httpsrc.Config{
 						Name:           "my-http-instance",
-						Kind:           httpsrc.SourceKind,
+						Type:           httpsrc.SourceType,
 						BaseURL:        "http://test_server/",
 						Timeout:        "10s",
 						DefaultHeaders: map[string]string{"Authorization": "ACTUAL_HEADER"},
@@ -1072,19 +1499,165 @@ func TestEnvVarReplacement(t *testing.T) {
 				AuthServices: server.AuthServiceConfigs{
 					"my-google-service": google.Config{
 						Name:     "my-google-service",
-						Kind:     google.AuthServiceKind,
+						Type:     google.AuthServiceType,
 						ClientID: "ACTUAL_CLIENT_ID",
 					},
 					"other-google-service": google.Config{
 						Name:     "other-google-service",
-						Kind:     google.AuthServiceKind,
+						Type:     google.AuthServiceType,
 						ClientID: "ACTUAL_CLIENT_ID_2",
 					},
 				},
 				Tools: server.ToolConfigs{
 					"example_tool": http.Config{
 						Name:         "example_tool",
-						Kind:         "http",
+						Type:         "http",
+						Source:       "my-instance",
+						Method:       "GET",
+						Path:         "search?name=alice&pet=cat",
+						Description:  "some description",
+						AuthRequired: []string{"my-google-auth-service", "other-auth-service"},
+						QueryParams: []parameters.Parameter{
+							parameters.NewStringParameterWithAuth("country", "some description",
+								[]parameters.ParamAuthService{{Name: "my-google-auth-service", Field: "user_id"},
+									{Name: "other-auth-service", Field: "user_id"}}),
+						},
+						RequestBody: `{
+  "age": {{.age}},
+  "city": "{{.city}}",
+  "food": "food",
+  "other": "$OTHER"
+}
+`,
+						BodyParams:   []parameters.Parameter{parameters.NewIntParameter("age", "age num"), parameters.NewStringParameter("city", "city string")},
+						Headers:      map[string]string{"Authorization": "API_KEY", "Content-Type": "application/json"},
+						HeaderParams: []parameters.Parameter{parameters.NewStringParameter("Language", "language string")},
+					},
+				},
+				Toolsets: server.ToolsetConfigs{
+					"ACTUAL_TOOLSET_NAME": tools.ToolsetConfig{
+						Name:      "ACTUAL_TOOLSET_NAME",
+						ToolNames: []string{"example_tool"},
+					},
+				},
+				Prompts: server.PromptConfigs{
+					"ACTUAL_PROMPT_NAME": &custom.Config{
+						Name:        "ACTUAL_PROMPT_NAME",
+						Description: "A test prompt for {{.name}}.",
+						Messages: []prompts.Message{
+							{
+								Role:    "user",
+								Content: "ACTUAL_CONTENT",
+							},
+						},
+						Arguments: nil,
+					},
+				},
+			},
+		},
+		{
+			description: "file with env var example toolsfile v2",
+			in: `
+			kind: sources
+			name: my-http-instance
+			type: http
+			baseUrl: http://test_server/
+			timeout: 10s
+			headers:
+				Authorization: ${TestHeader}
+			queryParams:
+				api-key: ${API_KEY}
+			---
+			kind: authServices
+			name: my-google-service
+			type: google
+			clientId: ${clientId}
+			---
+			kind: authServices
+			name: other-google-service
+			type: google
+			clientId: ${clientId2}
+			---
+			kind: tools
+			name: example_tool
+			type: http
+			source: my-instance
+			method: GET
+			path: "search?name=alice&pet=${cat_string}"
+			description: some description
+			authRequired:
+				- my-google-auth-service
+				- other-auth-service
+			queryParams:
+				- name: country
+					type: string
+					description: some description
+					authServices:
+					- name: my-google-auth-service
+						field: user_id
+					- name: other-auth-service
+						field: user_id
+			requestBody: |
+					{
+						"age": {{.age}},
+						"city": "{{.city}}",
+						"food": "${food_string}",
+						"other": "$OTHER"
+					}
+			bodyParams:
+				- name: age
+					type: integer
+					description: age num
+				- name: city
+					type: string
+					description: city string
+			headers:
+				Authorization: API_KEY
+				Content-Type: application/json
+			headerParams:
+				- name: Language
+					type: string
+					description: language string
+			---
+			kind: toolsets
+			name: ${toolset_name}
+			tools:
+				- example_tool
+			---
+			kind: prompts
+			name: ${prompt_name}
+			description: A test prompt for {{.name}}.
+			messages:
+				- role: user
+					content: ${prompt_content}
+			`,
+			wantToolsFile: ToolsFile{
+				Sources: server.SourceConfigs{
+					"my-http-instance": httpsrc.Config{
+						Name:           "my-http-instance",
+						Type:           httpsrc.SourceType,
+						BaseURL:        "http://test_server/",
+						Timeout:        "10s",
+						DefaultHeaders: map[string]string{"Authorization": "ACTUAL_HEADER"},
+						QueryParams:    map[string]string{"api-key": "ACTUAL_API_KEY"},
+					},
+				},
+				AuthServices: server.AuthServiceConfigs{
+					"my-google-service": google.Config{
+						Name:     "my-google-service",
+						Type:     google.AuthServiceType,
+						ClientID: "ACTUAL_CLIENT_ID",
+					},
+					"other-google-service": google.Config{
+						Name:     "other-google-service",
+						Type:     google.AuthServiceType,
+						ClientID: "ACTUAL_CLIENT_ID_2",
+					},
+				},
+				Tools: server.ToolConfigs{
+					"example_tool": http.Config{
+						Name:         "example_tool",
+						Type:         "http",
 						Source:       "my-instance",
 						Method:       "GET",
 						Path:         "search?name=alice&pet=cat",
@@ -1950,16 +2523,17 @@ func TestPrebuiltAndCustomTools(t *testing.T) {
 	t.Setenv("SQLITE_DATABASE", "test.db")
 	// Setup custom tools file
 	customContent := `
-tools:
+kind: tools
-  custom_tool:
+name: custom_tool
-    kind: http
+type: http
 source: my-http
 method: GET
 path: /
 description: "A custom tool for testing"
-sources:
+---
-  my-http:
+kind: sources
-    kind: http
+name: my-http
+type: http
 baseUrl: http://example.com
 `
 	customFile := filepath.Join(t.TempDir(), "custom.yaml")
@@ -1970,16 +2544,17 @@ sources:
 	// Tool Conflict File
 	// SQLite prebuilt has a tool named 'list_tables'
 	toolConflictContent := `
-tools:
+kind: tools
-  list_tables:
+name: list_tables
-    kind: http
+type: http
 source: my-http
 method: GET
 path: /
 description: "Conflicting tool"
-sources:
+---
-  my-http:
+kind: sources
-    kind: http
+name: my-http
+type: http
 baseUrl: http://example.com
 `
 	toolConflictFile := filepath.Join(t.TempDir(), "tool_conflict.yaml")
@@ -1990,13 +2565,14 @@ sources:
 	// Source Conflict File
 	// SQLite prebuilt has a source named 'sqlite-source'
 	sourceConflictContent := `
-sources:
+kind: sources
-  sqlite-source:
+name: sqlite-source
-    kind: http
+type: http
 baseUrl: http://example.com
-tools:
+---
-  dummy_tool:
+kind: tools
-    kind: http
+name: dummy_tool
+type: http
 source: sqlite-source
 method: GET
 path: /
@@ -2010,19 +2586,21 @@ tools:
 	// Toolset Conflict File
 	// SQLite prebuilt has a toolset named 'sqlite_database_tools'
 	toolsetConflictContent := `
-sources:
+kind: sources
-  dummy-src:
+name: dummy-src
-    kind: http
+type: http
 baseUrl: http://example.com
-tools:
+---
-  dummy_tool:
+kind: tools
-    kind: http
+name: dummy_tool
+type: http
 source: dummy-src
 method: GET
 path: /
 description: "Dummy"
-toolsets:
+---
-  sqlite_database_tools:
+kind: toolsets
+name: sqlite_database_tools
 - dummy_tool
 `
 	toolsetConflictFile := filepath.Join(t.TempDir(), "toolset_conflict.yaml")

docs/en/about/faq.md

@@ -45,7 +45,7 @@ most popular issues, so make sure to +1 ones you are the most interested in.
 ## Can Toolbox be used for non-database tools?
 
 **Yes!** While Toolbox is primarily focused on databases, it also supports generic 
-**HTTP tools** (`kind: http`). These allow you to connect your agents to REST APIs 
+**HTTP tools** (`type: http`). These allow you to connect your agents to REST APIs 
 and other web services, enabling workflows that extend beyond database interactions.
 
 For configuration details, see the [HTTP Tools documentation](../resources/tools/http/http.md).

docs/en/concepts/telemetry/index.md

@@ -64,7 +64,7 @@ The structured logging outputs log as JSON:
   "timestamp":"2024-11-04T16:45:11.987299-08:00",
   "severity":"ERROR",
   "logging.googleapis.com/sourceLocation":{...},
-  "message":"unable to parse tool file at \"tools.yaml\": \"cloud-sql-postgres1\" is not a valid kind of data source"
+  "message":"unable to parse tool file at \"tools.yaml\": \"cloud-sql-postgres1\" is not a valid type of data source"
 }
 ```
 

docs/en/getting-started/colab_quickstart.ipynb

@@ -300,17 +300,18 @@
         "# You can also upload a tools file and use that to run toolbox.\n",
         "tools_file_name = \"tools.yml\"\n",
         "file_content = f\"\"\"\n",
-        "sources:\n",
+        "kind: sources\n",
-        "  my-pg-source:\n",
+        "name: my-pg-source\n",
-        "    kind: postgres\n",
+        "type: postgres\n",
         "host: 127.0.0.1\n",
         "port: 5432\n",
         "database: toolbox_db\n",
         "user: toolbox_user\n",
         "password: my-password\n",
-        "tools:\n",
+        "---\n",
-        "  search-hotels-by-name:\n",
+        "kind: tools\n",
-        "    kind: postgres-sql\n",
+        "name: search-hotels-by-name\n",
+        "type: postgres-sql\n",
         "source: my-pg-source\n",
         "description: Search for hotels based on name.\n",
         "parameters:\n",
@@ -318,8 +319,10 @@
         "    type: string\n",
         "    description: The name of the hotel.\n",
         "statement: SELECT * FROM hotels WHERE name ILIKE '%' || \\$1 || '%';\n",
-        "  search-hotels-by-location:\n",
+        "---\n",
-        "    kind: postgres-sql\n",
+        "kind: tools\n",
+        "name: search-hotels-by-location\n",
+        "type: postgres-sql\n",
         "source: my-pg-source\n",
         "description: Search for hotels based on location.\n",
         "parameters:\n",
@@ -327,8 +330,10 @@
         "    type: string\n",
         "    description: The location of the hotel.\n",
         "statement: SELECT * FROM hotels WHERE location ILIKE '%' || \\$1 || '%';\n",
-        "  book-hotel:\n",
+        "---\n",
-        "    kind: postgres-sql\n",
+        "kind: tools\n",
+        "name: book-hotel\n",
+        "type: postgres-sql\n",
         "source: my-pg-source\n",
         "description: >-\n",
         "   Book a hotel by its ID. If the hotel is successfully booked, returns a NULL, raises an error if not.\n",
@@ -337,8 +342,10 @@
         "    type: string\n",
         "    description: The ID of the hotel to book.\n",
         "statement: UPDATE hotels SET booked = B'1' WHERE id = \\$1;\n",
-        "  update-hotel:\n",
+        "---\n",
-        "    kind: postgres-sql\n",
+        "kind: tools\n",
+        "name: update-hotel\n",
+        "type: postgres-sql\n",
         "source: my-pg-source\n",
         "description: >-\n",
         "  Update a hotel's check-in and check-out dates by its ID. Returns a message\n",
@@ -356,8 +363,10 @@
         "statement: >-\n",
         "  UPDATE hotels SET checkin_date = CAST(\\$2 as date), checkout_date = CAST(\\$3\n",
         "  as date) WHERE id = \\$1;\n",
-        "  cancel-hotel:\n",
+        "---\n",
-        "    kind: postgres-sql\n",
+        "kind: tools\n",
+        "name: cancel-hotel\n",
+        "type: postgres-sql\n",
         "source: my-pg-source\n",
         "description: Cancel a hotel by its ID.\n",
         "parameters:\n",
@@ -365,8 +374,10 @@
         "    type: string\n",
         "    description: The ID of the hotel to cancel.\n",
         "statement: UPDATE hotels SET booked = B'0' WHERE id = \\$1;\n",
-        "toolsets:\n",
+        "---\n",
-        "  my-toolset:\n",
+        "kind: toolsets\n",
+        "name: my-toolset\n",
+        "tools:\n",
         "  - search-hotels-by-name\n",
         "  - search-hotels-by-location\n",
         "  - book-hotel\n",

docs/en/getting-started/configure.md

@@ -36,9 +36,9 @@ Toolbox should have access to. Most tools will have at least one source to
 execute against.
 
 ```yaml
-sources:
+kind: sources
-  my-pg-source:
+name: my-pg-source
-    kind: postgres
+type: postgres
 host: 127.0.0.1
 port: 5432
 database: toolbox_db
@@ -52,13 +52,13 @@ For more details on configuring different types of sources, see the
 ### Tools
 
 The `tools` section of your `tools.yaml` defines the actions your agent can
-take: what kind of tool it is, which source(s) it affects, what parameters it
+take: what type of tool it is, which source(s) it affects, what parameters it
 uses, etc.
 
 ```yaml
-tools:
+kind: tools
-  search-hotels-by-name:
+name: search-hotels-by-name
-    kind: postgres-sql
+type: postgres-sql
 source: my-pg-source
 description: Search for hotels based on name.
 parameters:
@@ -78,11 +78,15 @@ that you want to be able to load together. This can be useful for defining
 different sets for different agents or different applications.
 
 ```yaml
-toolsets:
+kind: toolsets
-  my_first_toolset:
+name: my_first_toolset
+tools:
   - my_first_tool
   - my_second_tool
-  my_second_toolset:
+---
+kind: toolsets
+name: my_second_toolset
+tools:
   - my_second_tool
   - my_third_tool
 ```
@@ -103,8 +107,8 @@ The `prompts` section of your `tools.yaml` defines the templates containing
 structured messages and instructions for interacting with language models.
 
 ```yaml
-prompts:
+kind: prompts
-  code_review:
+name: code_review
 description: "Asks the LLM to analyze code quality and suggest improvements."
 messages:
   - content: "Please review the following code for quality, correctness, and potential improvements: \n\n{{.code}}"

docs/en/getting-started/mcp_quickstart/_index.md

@@ -125,17 +125,18 @@ In this section, we will download Toolbox, configure our tools in a
     {{< /notice >}}
 
     ```yaml
-    sources:
+    kind: sources
-      my-pg-source:
+    name: my-pg-source
-        kind: postgres
+    type: postgres
     host: 127.0.0.1
     port: 5432
     database: toolbox_db
     user: toolbox_user
     password: my-password
-    tools:
+    ---
-      search-hotels-by-name:
+    kind: tools
-        kind: postgres-sql
+    name: search-hotels-by-name
+    type: postgres-sql
     source: my-pg-source
     description: Search for hotels based on name.
     parameters:
@@ -143,8 +144,10 @@ In this section, we will download Toolbox, configure our tools in a
         type: string
         description: The name of the hotel.
     statement: SELECT * FROM hotels WHERE name ILIKE '%' || $1 || '%';
-      search-hotels-by-location:
+    ---
-        kind: postgres-sql
+    kind: tools
+    name: search-hotels-by-location
+    type: postgres-sql
     source: my-pg-source
     description: Search for hotels based on location.
     parameters:
@@ -152,8 +155,10 @@ In this section, we will download Toolbox, configure our tools in a
         type: string
         description: The location of the hotel.
     statement: SELECT * FROM hotels WHERE location ILIKE '%' || $1 || '%';
-      book-hotel:
+    ---
-        kind: postgres-sql
+    kind: tools
+    name: book-hotel
+    type: postgres-sql
     source: my-pg-source
     description: >-
        Book a hotel by its ID. If the hotel is successfully booked, returns a NULL, raises an error if not.
@@ -162,8 +167,10 @@ In this section, we will download Toolbox, configure our tools in a
         type: string
         description: The ID of the hotel to book.
     statement: UPDATE hotels SET booked = B'1' WHERE id = $1;
-      update-hotel:
+    ---
-        kind: postgres-sql
+    kind: tools
+    name: update-hotel
+    type: postgres-sql
     source: my-pg-source
     description: >-
       Update a hotel's check-in and check-out dates by its ID. Returns a message
@@ -181,8 +188,10 @@ In this section, we will download Toolbox, configure our tools in a
     statement: >-
       UPDATE hotels SET checkin_date = CAST($2 as date), checkout_date = CAST($3
       as date) WHERE id = $1;
-      cancel-hotel:
+    ---
-        kind: postgres-sql
+    kind: tools
+    name: cancel-hotel
+    type: postgres-sql
     source: my-pg-source
     description: Cancel a hotel by its ID.
     parameters:
@@ -190,8 +199,10 @@ In this section, we will download Toolbox, configure our tools in a
         type: string
         description: The ID of the hotel to cancel.
     statement: UPDATE hotels SET booked = B'0' WHERE id = $1;
-   toolsets:
+    ---
-      my-toolset:
+    kind: toolsets
+    name: my-toolset
+    tools:
       - search-hotels-by-name
       - search-hotels-by-location
       - book-hotel

docs/en/getting-started/prompts_quickstart_gemini_cli.md

@@ -157,17 +157,18 @@ Create a file named `tools.yaml`. This file defines the database connection, the
 SQL tools available, and the prompts the agents will use.
 
 ```yaml
-sources:
+kind: sources
-  my-foodiefind-db:
+name: my-foodiefind-db
-    kind: postgres
+type: postgres
 host: 127.0.0.1
 port: 5432
 database: toolbox_db
 user: toolbox_user
 password: my-password
-tools:
+---
-  find_user_by_email:
+kind: tools
-    kind: postgres-sql
+name: find_user_by_email
+type: postgres-sql
 source: my-foodiefind-db
 description: Find a user's ID by their email address.
 parameters:
@@ -175,8 +176,10 @@ tools:
     type: string
     description: The email address of the user to find.
 statement: SELECT id FROM users WHERE email = $1;
-  find_restaurant_by_name:
+---
-    kind: postgres-sql
+kind: tools
+name: find_restaurant_by_name
+type: postgres-sql
 source: my-foodiefind-db
 description: Find a restaurant's ID by its exact name.
 parameters:
@@ -184,8 +187,10 @@ tools:
     type: string
     description: The name of the restaurant to find.
 statement: SELECT id FROM restaurants WHERE name = $1;
-  find_review_by_user_and_restaurant:
+---
-    kind: postgres-sql
+kind: tools
+name: find_review_by_user_and_restaurant
+type: postgres-sql
 source: my-foodiefind-db
 description: Find the full record for a specific review using the user's ID and the restaurant's ID.
 parameters:
@@ -196,8 +201,9 @@ tools:
     type: integer
     description: The numerical ID of the restaurant.
 statement: SELECT * FROM reviews WHERE user_id = $1 AND restaurant_id = $2;
-prompts:
+---
-  investigate_missing_review:
+kind: prompts
+name: investigate_missing_review
 description: "Investigates a user's missing review by finding the user, restaurant, and the review itself, then analyzing its status."
 arguments:
   - name: "user_email"

docs/en/getting-started/quickstart/shared/configure_toolbox.md

@@ -33,17 +33,18 @@ In this section, we will download Toolbox, configure our tools in a
     {{< /notice >}}
 
     ```yaml
-    sources:
+    kind: sources
-      my-pg-source:
+    name: my-pg-source
-        kind: postgres
+    type: postgres
     host: 127.0.0.1
     port: 5432
     database: toolbox_db
-        user: ${USER_NAME}
+    user: toolbox_user
-        password: ${PASSWORD}
+    password: my-password
-    tools:
+    ---
-      search-hotels-by-name:
+    kind: tools
-        kind: postgres-sql
+    name: search-hotels-by-name
+    type: postgres-sql
     source: my-pg-source
     description: Search for hotels based on name.
     parameters:
@@ -51,8 +52,10 @@ In this section, we will download Toolbox, configure our tools in a
         type: string
         description: The name of the hotel.
     statement: SELECT * FROM hotels WHERE name ILIKE '%' || $1 || '%';
-      search-hotels-by-location:
+    ---
-        kind: postgres-sql
+    kind: tools
+    name: search-hotels-by-location
+    type: postgres-sql
     source: my-pg-source
     description: Search for hotels based on location.
     parameters:
@@ -60,8 +63,10 @@ In this section, we will download Toolbox, configure our tools in a
         type: string
         description: The location of the hotel.
     statement: SELECT * FROM hotels WHERE location ILIKE '%' || $1 || '%';
-      book-hotel:
+    ---
-        kind: postgres-sql
+    kind: tools
+    name: book-hotel
+    type: postgres-sql
     source: my-pg-source
     description: >-
        Book a hotel by its ID. If the hotel is successfully booked, returns a NULL, raises an error if not.
@@ -70,8 +75,10 @@ In this section, we will download Toolbox, configure our tools in a
         type: string
         description: The ID of the hotel to book.
     statement: UPDATE hotels SET booked = B'1' WHERE id = $1;
-      update-hotel:
+    ---
-        kind: postgres-sql
+    kind: tools
+    name: update-hotel
+    type: postgres-sql
     source: my-pg-source
     description: >-
       Update a hotel's check-in and check-out dates by its ID. Returns a message
@@ -89,8 +96,10 @@ In this section, we will download Toolbox, configure our tools in a
     statement: >-
       UPDATE hotels SET checkin_date = CAST($2 as date), checkout_date = CAST($3
       as date) WHERE id = $1;
-      cancel-hotel:
+    ---
-        kind: postgres-sql
+    kind: tools
+    name: cancel-hotel
+    type: postgres-sql
     source: my-pg-source
     description: Cancel a hotel by its ID.
     parameters:
@@ -98,8 +107,10 @@ In this section, we will download Toolbox, configure our tools in a
         type: string
         description: The ID of the hotel to cancel.
     statement: UPDATE hotels SET booked = B'0' WHERE id = $1;
-   toolsets:
+    ---
-      my-toolset:
+    kind: toolsets
+    name: my-toolset
+    tools:
       - search-hotels-by-name
       - search-hotels-by-location
       - book-hotel

docs/en/resources/authServices/_index.md

@@ -28,16 +28,18 @@ The following configurations are placed at the top level of a `tools.yaml` file.
 {{< notice tip >}}
 If you are accessing Toolbox with multiple applications, each
  application should register their own Client ID even if they use the same
- "kind" of auth provider.
+ "type" of auth provider.
 {{< /notice >}}
 
 ```yaml
-authServices:
+kind: authServices
-  my_auth_app_1:
+name: my_auth_app_1
-    kind: google
+type: google
 clientId: ${YOUR_CLIENT_ID_1}
-  my_auth_app_2:
+---
-    kind: google
+kind: authServices
+name: my_auth_app_2
+type: google
 clientId: ${YOUR_CLIENT_ID_2}
 ```
 

docs/en/resources/authServices/google.md

@@ -40,9 +40,9 @@ id-token][provided-claims] can be used for the parameter.
 ## Example
 
 ```yaml
-authServices:
+kind: authServices
-  my-google-auth:
+name: my-google-auth
-    kind: google
+type: google
 clientId: ${YOUR_GOOGLE_CLIENT_ID}
 ```
 
@@ -55,5 +55,5 @@ instead of hardcoding your secrets into the configuration file.
 
 | **field** | **type** | **required** | **description**                                                  |
 |-----------|:--------:|:------------:|------------------------------------------------------------------|
-| kind      |  string  |     true     | Must be "google".                                                |
+| type      |  string  |     true     | Must be "google".                                                |
 | clientId  |  string  |     true     | Client ID of your application from registering your application. |

docs/en/resources/embeddingModels/_index.md

@@ -34,13 +34,12 @@ instead of hardcoding your API keys into the configuration file.
 Define an embedding model in the `embeddingModels` section:
 
 ```yaml
-embeddingModels:
+kind: embeddingModels
-  gemini-model: # Name of the embedding model
+name: gemini-model: # Name of the embedding model
-    kind: gemini
+type: gemini
 model: gemini-embedding-001
 apiKey: ${GOOGLE_API_KEY}
 dimension: 768
-
 ```
 
 ### Step 2 - Embed Tool Parameters
@@ -50,10 +49,10 @@ Use the defined embedding model, embed your query parameters using the
 parameters can be embedded:
 
 ```yaml
-tools:
 # Vector ingestion tool
-  insert_embedding:
+kind: tools
-    kind: postgres-sql
+name: insert_embedding
+type: postgres-sql
 source: my-pg-instance
 statement: |
   INSERT INTO documents (content, embedding) 
@@ -65,10 +64,11 @@ tools:
     type: string
     description: The text to be vectorized and stored.
     embeddedBy: gemini-model # refers to the name of a defined embedding model
-
+---
 # Semantic search tool
-  search_embedding:
+kind: tools
-    kind: postgres-sql
+name: search_embedding
+type: postgres-sql
 source: my-pg-instance
 statement: |
   SELECT id, content, embedding <-> $1 AS distance 

docs/en/resources/embeddingModels/gemini.md

@@ -50,9 +50,9 @@ information.
 ## Example
 
 ```yaml
-embeddingModels:
+kind: embeddingModels
-  gemini-model:
+name: gemini-model
-    kind: gemini
+type: gemini
 model: gemini-embedding-001
 apiKey: ${GOOGLE_API_KEY}
 dimension: 768
@@ -67,7 +67,7 @@ instead of hardcoding your secrets into the configuration file.
 
 | **field** | **type** | **required** | **description**                                              |
 |-----------|:--------:|:------------:|--------------------------------------------------------------|
-| kind      |  string  |     true     | Must be `gemini`.                                            |
+| type      |  string  |     true     | Must be `gemini`.                                            |
 | model     |  string  |     true     | The Gemini model ID to use (e.g., `gemini-embedding-001`).   |
 | apiKey    |  string  |    false     | Your API Key from Google AI Studio.                          |
 | dimension | integer  |    false     | The number of dimensions in the output vector (e.g., `768`). |

docs/en/resources/prompts/_index.md

@@ -16,8 +16,8 @@ can be sent to a Large Language Model (LLM). The Toolbox server implements the
 specification, allowing clients to discover and retrieve these prompts.
 
 ```yaml
-prompts:
+kind: prompts
-  code_review:
+name: code_review
 description: "Asks the LLM to analyze code quality and suggest improvements."
 messages:
    - content: "Please review the following code for quality, correctness, and potential improvements: \n\n{{.code}}"
@@ -31,7 +31,7 @@ prompts:
 | **field**   | **type**                       | **required** | **description**                                                          |
 |-------------|--------------------------------|--------------|--------------------------------------------------------------------------|
 | description | string                         | No           | A brief explanation of what the prompt does.                             |
-| kind        | string                         | No           | The kind of prompt. Defaults to `"custom"`.                              |
+| type        | string                         | No           | The type of prompt. Defaults to `"custom"`.                              |
 | messages    | [][Message](#message-schema)   | Yes          | A list of one or more message objects that make up the prompt's content. |
 | arguments   | [][Argument](#argument-schema) | No           | A list of arguments that can be interpolated into the prompt's content.  |
 

docs/en/resources/prompts/custom/_index.md

@@ -17,8 +17,8 @@ Here is an example of a simple prompt that takes a single argument, code, and
 asks an LLM to review it.
 
 ```yaml
-prompts:
+kind: prompts
-  code_review:
+name: code_review
 description: "Asks the LLM to analyze code quality and suggest improvements."
 messages:
   - content: "Please review the following code for quality, correctness, and potential improvements: \n\n{{.code}}"
@@ -33,8 +33,8 @@ You can define prompts with multiple messages to set up more complex
 conversational contexts, like a role-playing scenario.
 
 ```yaml
-prompts:
+kind: prompts
-  roleplay_scenario:
+name: roleplay_scenario
 description: "Sets up a roleplaying scenario with initial messages."
 arguments:
   - name: "character"
@@ -54,7 +54,7 @@ prompts:
 
 | **field**   | **type**                       | **required** | **description**                                                          |
 |-------------|--------------------------------|--------------|--------------------------------------------------------------------------|
-| kind        | string                         | No           | The kind of prompt. Must be `"custom"`.                                  |
+| type        | string                         | No           | The type of prompt. Must be `"custom"`.                                  |
 | description | string                         | No           | A brief explanation of what the prompt does.                             |
 | messages    | [][Message](#message-schema)   | Yes          | A list of one or more message objects that make up the prompt's content. |
 | arguments   | [][Argument](#argument-schema) | No           | A list of arguments that can be interpolated into the prompt's content.  |

docs/en/resources/sources/_index.md

@@ -17,9 +17,9 @@ instead of hardcoding your secrets into the configuration file.
 {{< /notice >}}
 
 ```yaml
-sources:
+kind: sources
-    my-cloud-sql-source:
+name: my-cloud-sql-source
-        kind: cloud-sql-postgres
+type: cloud-sql-postgres
 project: my-project-id
 region: us-central1
 instance: my-instance-name

docs/en/resources/sources/alloydb-admin.md

@@ -25,12 +25,13 @@ Authentication can be handled in two ways:
 ## Example
 
 ```yaml
-sources:
+kind: sources
-    my-alloydb-admin:
+name: my-alloydb-admin
-        kind: alloy-admin
+type: alloy-admin
-
+---
-    my-oauth-alloydb-admin:
+kind: sources
-        kind: alloydb-admin
+name: my-oauth-alloydb-admin
+type: alloydb-admin
 useClientOAuth: true
 ```
 
@@ -38,6 +39,6 @@ sources:
 
 | **field**      | **type** | **required** | **description**                                                                                                                                |
 | -------------- | :------: | :----------: | ---------------------------------------------------------------------------------------------------------------------------------------------- |
-| kind           |  string  |     true     | Must be "alloydb-admin".                                                                                                                       |
+| type           |  string  |     true     | Must be "alloydb-admin".                                                                                                                       |
 | defaultProject |  string  |     false    | The Google Cloud project ID to use for AlloyDB infrastructure tools.                                                                           |
 | useClientOAuth |  boolean |     false    | If true, the source will use client-side OAuth for authorization. Otherwise, it will use Application Default Credentials. Defaults to `false`. |

docs/en/resources/sources/alloydb-pg.md

@@ -176,9 +176,9 @@ To connect using IAM authentication:
 ## Example
 
 ```yaml
-sources:
+kind: sources
-    my-alloydb-pg-source:
+name: my-alloydb-pg-source
-        kind: alloydb-postgres
+type: alloydb-postgres
 project: my-project-id
 region: us-central1
 cluster: my-cluster
@@ -198,7 +198,7 @@ instead of hardcoding your secrets into the configuration file.
 
 | **field** | **type** | **required** | **description**                                                                                                          |
 |-----------|:--------:|:------------:|--------------------------------------------------------------------------------------------------------------------------|
-| kind      |  string  |     true     | Must be "alloydb-postgres".                                                                                              |
+| type      |  string  |     true     | Must be "alloydb-postgres".                                                                                              |
 | project   |  string  |     true     | Id of the GCP project that the cluster was created in (e.g. "my-project-id").                                            |
 | region    |  string  |     true     | Name of the GCP region that the cluster was created in (e.g. "us-central1").                                             |
 | cluster   |  string  |     true     | Name of the AlloyDB cluster (e.g. "my-cluster").                                                                         |

docs/en/resources/sources/bigquery.md

@@ -121,9 +121,9 @@ identity used has been granted the correct IAM permissions.
 Initialize a BigQuery source that uses ADC:
 
 ```yaml
-sources:
+kind: sources
-  my-bigquery-source:
+name: my-bigquery-source
-    kind: "bigquery"
+type: "bigquery"
 project: "my-project-id"
 # location: "US" # Optional: Specifies the location for query jobs.
 # writeMode: "allowed" # One of: allowed, blocked, protected. Defaults to "allowed".
@@ -140,9 +140,9 @@ sources:
 Initialize a BigQuery source that uses the client's access token:
 
 ```yaml
-sources:
+kind: sources
-  my-bigquery-client-auth-source:
+name: my-bigquery-client-auth-source
-    kind: "bigquery"
+type: "bigquery"
 project: "my-project-id"
 useClientOAuth: true
 # location: "US" # Optional: Specifies the location for query jobs.
@@ -161,7 +161,7 @@ sources:
 
 | **field**                 | **type** | **required** | **description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
 |---------------------------|:--------:|:------------:|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| kind                      |  string  |     true     | Must be "bigquery".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| type                      |  string  |     true     | Must be "bigquery".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
 | project                   |  string  |     true     | Id of the Google Cloud project to use for billing and as the default project for BigQuery resources.                                                                                                                                                                                                                                                                                                                                                                                                                |
 | location                  |  string  |    false     | Specifies the location (e.g., 'us', 'asia-northeast1') in which to run the query job. This location must match the location of any tables referenced in the query. Defaults to the table's location or 'US' if the location cannot be determined. [Learn More](https://cloud.google.com/bigquery/docs/locations)                                                                                                                                                                                                    |
 | writeMode                 |  string  |    false     | Controls the write behavior for tools. `allowed` (default): All queries are permitted. `blocked`: Only `SELECT` statements are allowed for the `bigquery-execute-sql` tool. `protected`: Enables session-based execution where all tools associated with this source instance share the same [BigQuery session](https://cloud.google.com/bigquery/docs/sessions-intro). This allows for stateful operations using temporary tables (e.g., `CREATE TEMP TABLE`). For `bigquery-execute-sql`, `SELECT` statements can be used on all tables, but write operations are restricted to the session's temporary dataset. For tools like `bigquery-sql`, `bigquery-forecast`, and `bigquery-analyze-contribution`, the `writeMode` restrictions do not apply, but they will operate within the shared session. **Note:** The `protected` mode cannot be used with `useClientOAuth: true`. It is also not recommended for multi-user server environments, as all users would share the same session. A session is terminated automatically after 24 hours of inactivity or after 7 days, whichever comes first. A new session is created on the next request, and any temporary data from the previous session will be lost. |

docs/en/resources/sources/bigtable.md

@@ -59,9 +59,9 @@ applying IAM permissions and roles to an identity.
 ## Example
 
 ```yaml
-sources:
+kind: sources
-  my-bigtable-source:
+name: my-bigtable-source
-    kind: "bigtable"
+type: "bigtable"
 project: "my-project-id"
 instance: "test-instance"
 ```
@@ -70,6 +70,6 @@ sources:
 
 | **field** | **type** | **required** | **description**                                                               |
 |-----------|:--------:|:------------:|-------------------------------------------------------------------------------|
-| kind      |  string  |     true     | Must be "bigtable".                                                           |
+| type      |  string  |     true     | Must be "bigtable".                                                           |
 | project   |  string  |     true     | Id of the GCP project that the cluster was created in (e.g. "my-project-id"). |
 | instance  |  string  |     true     | Name of the Bigtable instance.                                                |

docs/en/resources/sources/cassandra.md

@@ -23,9 +23,9 @@ distributed architectures, and a flexible approach to schema definition.
 ## Example
 
 ```yaml
-sources:
+kind: sources
-    my-cassandra-source:
+name: my-cassandra-source
-        kind: cassandra
+type: cassandra
 hosts:
     - 127.0.0.1
 keyspace: my_keyspace
@@ -47,7 +47,7 @@ instead of hardcoding your secrets into the configuration file.
 
 | **field**              | **type** | **required** | **description**                                                                                                                                    |
 |------------------------|:--------:|:------------:|----------------------------------------------------------------------------------------------------------------------------------------------------|
-| kind                   |  string  |     true     | Must be "cassandra".                                                                                                                               |
+| type                   |  string  |     true     | Must be "cassandra".                                                                                                                               |
 | hosts                  | string[] |     true     | List of IP addresses to connect to (e.g., ["192.168.1.1:9042", "192.168.1.2:9042","192.168.1.3:9042"]). The default port is 9042 if not specified. |
 | keyspace               |  string  |     true     | Name of the Cassandra keyspace to connect to (e.g., "my_keyspace").                                                                                |
 | protoVersion           | integer  |    false     | Protocol version for the Cassandra connection (e.g., 4).                                                                                           |

docs/en/resources/sources/clickhouse.md

@@ -46,9 +46,9 @@ ClickHouse supports multiple protocols:
 ### Secure Connection Example
 
 ```yaml
-sources:
+kind: sources
-    secure-clickhouse-source:
+name: secure-clickhouse-source
-        kind: clickhouse
+type: clickhouse
 host: clickhouse.example.com
 port: "8443"
 database: analytics
@@ -61,9 +61,9 @@ sources:
 ### HTTP Protocol Example
 
 ```yaml
-sources:
+kind: sources
-    http-clickhouse-source:
+name: http-clickhouse-source
-        kind: clickhouse
+type: clickhouse
 host: localhost
 port: "8123"
 database: logs
@@ -82,7 +82,7 @@ instead of hardcoding your secrets into the configuration file.
 
 | **field** | **type** | **required** | **description**                                                                     |
 |-----------|:--------:|:------------:|-------------------------------------------------------------------------------------|
-| kind      |  string  |     true     | Must be "clickhouse".                                                               |
+| type      |  string  |     true     | Must be "clickhouse".                                                               |
 | host      |  string  |     true     | IP address or hostname to connect to (e.g. "127.0.0.1" or "clickhouse.example.com") |
 | port      |  string  |     true     | Port to connect to (e.g. "8443" for HTTPS, "8123" for HTTP)                         |
 | database  |  string  |     true     | Name of the ClickHouse database to connect to (e.g. "my_database").                 |

docs/en/resources/sources/cloud-gda.md

@@ -20,13 +20,14 @@ Authentication can be handled in two ways:
 ## Example
 
 ```yaml
-sources:
+kind: sources
-  my-gda-source:
+name: my-gda-source
-    kind: cloud-gemini-data-analytics
+type: cloud-gemini-data-analytics
 projectId: my-project-id
-
+---
-  my-oauth-gda-source:
+kind: sources
-    kind: cloud-gemini-data-analytics
+name: my-oauth-gda-source
+type: cloud-gemini-data-analytics
 projectId: my-project-id
 useClientOAuth: true
 ```
@@ -35,6 +36,6 @@ sources:
 
 | **field**      | **type** | **required** | **description**                                                                                                                                                              |
 | -------------- | :------: | :----------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| kind           |  string  |     true     | Must be "cloud-gemini-data-analytics".                                                                                                                                       |
+| type           |  string  |     true     | Must be "cloud-gemini-data-analytics".                                                                                                                                       |
 | projectId      |  string  |     true     | The Google Cloud Project ID where the API is enabled.                                                                                                                        |
 | useClientOAuth | boolean  |    false     | If true, the source uses the token provided by the caller (forwarded to the API). Otherwise, it uses server-side Application Default Credentials (ADC). Defaults to `false`. |

docs/en/resources/sources/cloud-healthcare.md

@@ -123,9 +123,9 @@ identity used has been granted the correct IAM permissions.
 Initialize a Cloud Healthcare API source that uses ADC:
 
 ```yaml
-sources:
+kind: sources
-  my-healthcare-source:
+name: my-healthcare-source
-    kind: "cloud-healthcare"
+type: "cloud-healthcare"
 project: "my-project-id"
 region: "us-central1"
 dataset: "my-healthcare-dataset-id"
@@ -139,9 +139,9 @@ sources:
 Initialize a Cloud Healthcare API source that uses the client's access token:
 
 ```yaml
-sources:
+kind: sources
-  my-healthcare-client-auth-source:
+name: my-healthcare-client-auth-source
-    kind: "cloud-healthcare"
+type: "cloud-healthcare"
 project: "my-project-id"
 region: "us-central1"
 dataset: "my-healthcare-dataset-id"
@@ -157,7 +157,7 @@ sources:
 
 | **field**          | **type** | **required** | **description**                                                                                                                                                                                                                                                              |
 |--------------------|:--------:|:------------:|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| kind               |  string  |     true     | Must be "cloud-healthcare".                                                                                                                                                                                                                                                  |
+| type               |  string  |     true     | Must be "cloud-healthcare".                                                                                                                                                                                                                                                  |
 | project            |  string  |     true     | ID of the GCP project that the dataset lives in.                                                                                                                                                                                                                             |
 | region             |  string  |     true     | Specifies the region (e.g., 'us', 'asia-northeast1') of the healthcare dataset. [Learn More](https://cloud.google.com/healthcare-api/docs/regions)                                                                                                                           |
 | dataset            |  string  |     true     | ID of the healthcare dataset.                                                                                                                                                                                                                                                |

docs/en/resources/sources/cloud-monitoring.md

@@ -25,12 +25,13 @@ Authentication can be handled in two ways:
 ## Example
 
 ```yaml
-sources:
+kind: sources
-    my-cloud-monitoring:
+name: my-cloud-monitoring
-        kind: cloud-monitoring
+type: cloud-monitoring
-
+---
-    my-oauth-cloud-monitoring:
+kind: sources
-        kind: cloud-monitoring
+name: my-oauth-cloud-monitoring
+type: cloud-monitoring
 useClientOAuth: true
 ```
 
@@ -38,5 +39,5 @@ sources:
 
 | **field**      | **type** | **required** | **description**                                                                                                                                |
 |----------------|:--------:|:------------:|------------------------------------------------------------------------------------------------------------------------------------------------|
-| kind           |  string  |     true     | Must be "cloud-monitoring".                                                                                                                    |
+| type           |  string  |     true     | Must be "cloud-monitoring".                                                                                                                    |
 | useClientOAuth | boolean  |    false     | If true, the source will use client-side OAuth for authorization. Otherwise, it will use Application Default Credentials. Defaults to `false`. |

docs/en/resources/sources/cloud-sql-admin.md

@@ -24,12 +24,13 @@ Authentication can be handled in two ways:
 ## Example
 
 ```yaml
-sources:
+kind: sources
-    my-cloud-sql-admin:
+name: my-cloud-sql-admin
-        kind: cloud-sql-admin
+type: cloud-sql-admin
-
+---
-    my-oauth-cloud-sql-admin:
+kind: sources
-        kind: cloud-sql-admin
+name: my-oauth-cloud-sql-admin
+type: cloud-sql-admin
 useClientOAuth: true
 ```
 
@@ -37,6 +38,6 @@ sources:
 
 | **field**      | **type** | **required** | **description**                                                                                                                                |
 | -------------- | :------: | :----------: | ---------------------------------------------------------------------------------------------------------------------------------------------- |
-| kind           |  string  |     true     | Must be "cloud-sql-admin".                                                                                                                     |
+| type           |  string  |     true     | Must be "cloud-sql-admin".                                                                                                                     |
 | defaultProject |  string  |     false    | The Google Cloud project ID to use for Cloud SQL infrastructure tools.                                                                         |
 | useClientOAuth |  boolean |     false    | If true, the source will use client-side OAuth for authorization. Otherwise, it will use Application Default Credentials. Defaults to `false`. |

docs/en/resources/sources/cloud-sql-mssql.md

@@ -87,9 +87,9 @@ Currently, this source only uses standard authentication. You will need to
 ## Example
 
 ```yaml
-sources:
+kind: sources
-    my-cloud-sql-mssql-instance:
+name: my-cloud-sql-mssql-instance
-     kind: cloud-sql-mssql
+type: cloud-sql-mssql
 project: my-project
 region: my-region
 instance: my-instance
@@ -108,7 +108,7 @@ instead of hardcoding your secrets into the configuration file.
 
 | **field** | **type** | **required** | **description**                                                                                      |
 |-----------|:--------:|:------------:|------------------------------------------------------------------------------------------------------|
-| kind      |  string  |     true     | Must be "cloud-sql-mssql".                                                                           |
+| type      |  string  |     true     | Must be "cloud-sql-mssql".                                                                           |
 | project   |  string  |     true     | Id of the GCP project that the cluster was created in (e.g. "my-project-id").                        |
 | region    |  string  |     true     | Name of the GCP region that the cluster was created in (e.g. "us-central1").                         |
 | instance  |  string  |     true     | Name of the Cloud SQL instance within the cluster (e.g. "my-instance").                              |

docs/en/resources/sources/cloud-sql-mysql.md

@@ -128,9 +128,9 @@ To connect using IAM authentication:
 ## Example
 
 ```yaml
-sources:
+kind: sources
-    my-cloud-sql-mysql-source:
+name: my-cloud-sql-mysql-source
-        kind: cloud-sql-mysql
+type: cloud-sql-mysql
 project: my-project-id
 region: us-central1
 instance: my-instance
@@ -149,7 +149,7 @@ instead of hardcoding your secrets into the configuration file.
 
 | **field** | **type** | **required** | **description**                                                                                      |
 |-----------|:--------:|:------------:|------------------------------------------------------------------------------------------------------|
-| kind      |  string  |     true     | Must be "cloud-sql-mysql".                                                                           |
+| type      |  string  |     true     | Must be "cloud-sql-mysql".                                                                           |
 | project   |  string  |     true     | Id of the GCP project that the cluster was created in (e.g. "my-project-id").                        |
 | region    |  string  |     true     | Name of the GCP region that the cluster was created in (e.g. "us-central1").                         |
 | instance  |  string  |     true     | Name of the Cloud SQL instance within the cluster (e.g. "my-instance").                              |

docs/en/resources/sources/cloud-sql-pg.md

@@ -178,9 +178,9 @@ To connect using IAM authentication:
 ## Example
 
 ```yaml
-sources:
+kind: sources
-    my-cloud-sql-pg-source:
+name: my-cloud-sql-pg-source
-        kind: cloud-sql-postgres
+type: cloud-sql-postgres
 project: my-project-id
 region: us-central1
 instance: my-instance
@@ -199,7 +199,7 @@ instead of hardcoding your secrets into the configuration file.
 
 | **field** | **type** | **required** | **description**                                                                                                          |
 |-----------|:--------:|:------------:|--------------------------------------------------------------------------------------------------------------------------|
-| kind      |  string  |     true     | Must be "cloud-sql-postgres".                                                                                            |
+| type      |  string  |     true     | Must be "cloud-sql-postgres".                                                                                            |
 | project   |  string  |     true     | Id of the GCP project that the cluster was created in (e.g. "my-project-id").                                            |
 | region    |  string  |     true     | Name of the GCP region that the cluster was created in (e.g. "us-central1").                                             |
 | instance  |  string  |     true     | Name of the Cloud SQL instance within the cluster (e.g. "my-instance").                                                  |

docs/en/resources/sources/couchbase.md

@@ -19,9 +19,9 @@ allowing tools to execute SQL queries against it.
 ## Example
 
 ```yaml
-sources:
+kind: sources
-    my-couchbase-instance:
+name: my-couchbase-instance
-        kind: couchbase
+type: couchbase
 connectionString: couchbase://localhost
 bucket: travel-sample
 scope: inventory
@@ -38,7 +38,7 @@ Connections](https://docs.couchbase.com/java-sdk/current/howtos/managing-connect
 
 | **field**            | **type** | **required** | **description**                                                                                                                                                                                                                                                                                                                                                                          |
 |----------------------|:--------:|:------------:|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| kind                 |  string  |     true     | Must be "couchbase".                                                                                                                                                                                                                                                                                                                                                                     |
+| type                 |  string  |     true     | Must be "couchbase".                                                                                                                                                                                                                                                                                                                                                                     |
 | connectionString     |  string  |     true     | Connection string for the Couchbase cluster.                                                                                                                                                                                                                                                                                                                                             |
 | bucket               |  string  |     true     | Name of the bucket to connect to.                                                                                                                                                                                                                                                                                                                                                        |
 | scope                |  string  |     true     | Name of the scope within the bucket.                                                                                                                                                                                                                                                                                                                                                     |

docs/en/resources/sources/dataplex.md

@@ -23,9 +23,9 @@ applying artificial intelligence and machine learning.
 ## Example
 
 ```yaml
-sources:
+kind: sources
-  my-dataplex-source:
+name: my-dataplex-source
-    kind: "dataplex"
+type: "dataplex"
 project: "my-project-id"
 ```
 
@@ -355,5 +355,5 @@ This abbreviated syntax works for the qualified predicates except for `label` in
 
 | **field** | **type** | **required** | **description**                                                                  |
 |-----------|:--------:|:------------:|----------------------------------------------------------------------------------|
-| kind      |  string  |     true     | Must be "dataplex".                                                              |
+| type      |  string  |     true     | Must be "dataplex".                                                              |
 | project   |  string  |     true     | ID of the GCP project used for quota and billing purposes (e.g. "my-project-id").|

docs/en/resources/sources/dgraph.md

@@ -40,9 +40,9 @@ and user credentials for that namespace.
 ## Example
 
 ```yaml
-sources:
+kind: sources
-    my-dgraph-source:
+name: my-dgraph-source
-        kind: dgraph
+type: dgraph
 dgraphUrl: https://xxxx.cloud.dgraph.io
 user: ${USER_NAME}
 password: ${PASSWORD}
@@ -59,7 +59,7 @@ instead of hardcoding your secrets into the configuration file.
 
 | **Field**   | **Type** | **Required** | **Description**                                                                                  |
 |-------------|:--------:|:------------:|--------------------------------------------------------------------------------------------------|
-| kind        |  string  |     true     | Must be "dgraph".                                                                                |
+| type        |  string  |     true     | Must be "dgraph".                                                                                |
 | dgraphUrl   |  string  |     true     | Connection URI (e.g. "<https://xxx.cloud.dgraph.io>", "<https://localhost:8080>").               |
 | user        |  string  |     false    | Name of the Dgraph user to connect as (e.g., "groot").                                           |
 | password    |  string  |     false    | Password of the Dgraph user (e.g., "password").                                                  |

docs/en/resources/sources/elasticsearch.md

@@ -59,9 +59,9 @@ applying permissions to an API key.
 ## Example
 
 ```yaml
-sources:
+kind: sources
-  my-elasticsearch-source:
+name: my-elasticsearch-source
-    kind: "elasticsearch"
+type: "elasticsearch"
 addresses:
   - "http://localhost:9200"
 apikey: "my-api-key"
@@ -71,6 +71,6 @@ sources:
 
 | **field** | **type** | **required** | **description**                            |
 |-----------|:--------:|:------------:|--------------------------------------------|
-| kind      |  string  |     true     | Must be "elasticsearch".                   |
+| type      |  string  |     true     | Must be "elasticsearch".                   |
 | addresses | []string |     true     | List of Elasticsearch hosts to connect to. |
 | apikey    |  string  |     true     | The API key to use for authentication.     |

docs/en/resources/sources/firebird.md

@@ -36,9 +36,9 @@ user][fb-users] to login to the database with.
 ## Example
 
 ```yaml
-sources:
+kind: sources
-    my_firebird_db:
+name: my_firebird_db
-        kind: firebird
+type: firebird
 host: "localhost"
 port: 3050
 database: "/path/to/your/database.fdb"
@@ -55,7 +55,7 @@ instead of hardcoding your secrets into the configuration file.
 
 | **field** | **type** | **required** | **description**                                                              |
 |-----------|:--------:|:------------:|------------------------------------------------------------------------------|
-| kind      |  string  |     true     | Must be "firebird".                                                          |
+| type      |  string  |     true     | Must be "firebird".                                                          |
 | host      |  string  |     true     | IP address to connect to (e.g. "127.0.0.1")                                  |
 | port      |  string  |     true     | Port to connect to (e.g. "3050")                                             |
 | database  |  string  |     true     | Path to the Firebird database file (e.g. "/var/lib/firebird/data/test.fdb"). |

docs/en/resources/sources/firestore.md

@@ -61,9 +61,9 @@ database named `(default)` will be used.
 ## Example
 
 ```yaml
-sources:
+kind: sources
-  my-firestore-source:
+name: my-firestore-source
-    kind: "firestore"
+type: "firestore"
 project: "my-project-id"
 # database: "my-database"  # Optional, defaults to "(default)"
 ```
@@ -72,6 +72,6 @@ sources:
 
 | **field** | **type** | **required** | **description**                                                                                          |
 |-----------|:--------:|:------------:|----------------------------------------------------------------------------------------------------------|
-| kind      |  string  |     true     | Must be "firestore".                                                                                     |
+| type      |  string  |     true     | Must be "firestore".                                                                                     |
 | project   |  string  |     true     | Id of the GCP project that contains the Firestore database (e.g. "my-project-id").                       |
 | database  |  string  |     false    | Name of the Firestore database to connect to. Defaults to "(default)" if not specified.                  |

docs/en/resources/sources/http.md

@@ -21,9 +21,9 @@ and other HTTP-accessible resources.
 ## Example
 
 ```yaml
-sources:
+kind: sources
-  my-http-source:
+name: my-http-source
-    kind: http
+type: http
 baseUrl: https://api.example.com/data
 timeout: 10s # default to 30s
 headers:
@@ -44,7 +44,7 @@ instead of hardcoding your secrets into the configuration file.
 
 | **field**              |     **type**      | **required** | **description**                                                                                                                    |
 |------------------------|:-----------------:|:------------:|------------------------------------------------------------------------------------------------------------------------------------|
-| kind                   |      string       |     true     | Must be "http".                                                                                                                    |
+| type                   |      string       |     true     | Must be "http".                                                                                                                    |
 | baseUrl                |      string       |     true     | The base URL for the HTTP requests (e.g., `https://api.example.com`).                                                              |
 | timeout                |      string       |    false     | The timeout for HTTP requests (e.g., "5s", "1m", refer to [ParseDuration][parse-duration-doc] for more examples). Defaults to 30s. |
 | headers                | map[string]string |    false     | Default headers to include in the HTTP requests.                                                                                   |

docs/en/resources/sources/looker.md

@@ -56,9 +56,9 @@ To initialize the application default credential run `gcloud auth login
 ## Example
 
 ```yaml
-sources:
+kind: sources
-    my-looker-source:
+name: my-looker-source
-        kind: looker
+type: looker
 base_url: http://looker.example.com
 client_id: ${LOOKER_CLIENT_ID}
 client_secret: ${LOOKER_CLIENT_SECRET}
@@ -93,7 +93,7 @@ instead of hardcoding your secrets into the configuration file.
 
 | **field**            | **type** | **required** | **description**                                                                                                                                     |
 |----------------------|:--------:|:------------:|-----------------------------------------------------------------------------------------------------------------------------------------------------|
-| kind                 |  string  |     true     | Must be "looker".                                                                                                                                   |
+| type                 |  string  |     true     | Must be "looker".                                                                                                                                   |
 | base_url             |  string  |     true     | The URL of your Looker server with no trailing /.                                                                                                   |
 | client_id            |  string  |    false     | The client id assigned by Looker.                                                                                                                   |
 | client_secret        |  string  |    false     | The client secret assigned by Looker.                                                                                                               |

docs/en/resources/sources/mariadb.md

@@ -45,9 +45,9 @@ MariaDB user][mariadb-users] to log in to the database.
 ## Example
 
 ```yaml
-sources:
+kind: sources
-    my_mariadb_db:
+name: my_mariadb_db
-        kind: mysql
+type: mysql
 host: 127.0.0.1
 port: 3306
 database: my_db
@@ -68,7 +68,7 @@ Use environment variables instead of committing credentials to source files.
 
 | **field**    | **type** | **required** | **description**                                                                                 |
 | ------------ | :------: | :----------: | ----------------------------------------------------------------------------------------------- |
-| kind         |  string  |     true     | Must be `mysql`.                                                                                |
+| type         |  string  |     true     | Must be `mysql`.                                                                                |
 | host         |  string  |     true     | IP address to connect to (e.g. "127.0.0.1").                                                    |
 | port         |  string  |     true     | Port to connect to (e.g. "3307").                                                               |
 | database     |  string  |     true     | Name of the MariaDB database to connect to (e.g. "my_db").                                        |

docs/en/resources/sources/mindsdb.md

@@ -125,9 +125,9 @@ can omit the password field.
 ## Example
 
 ```yaml
-sources:
+kind: sources
-    my-mindsdb-source:
+name: my-mindsdb-source
-        kind: mindsdb
+type: mindsdb
 host: 127.0.0.1
 port: 3306
 database: my_db
@@ -141,9 +141,9 @@ sources:
 Here's a working configuration that has been tested:
 
 ```yaml
-sources:
+kind: sources
-  my-pg-source:
+name: my-pg-source
-    kind: mindsdb
+type: mindsdb
 host: 127.0.0.1
 port: 47335
 database: files
@@ -176,7 +176,7 @@ With MindsDB integration, you can:
 
 | **field**    | **type** | **required** | **description**                                                                                              |
 |--------------|:--------:|:------------:|--------------------------------------------------------------------------------------------------------------|
-| kind         |  string  |     true     | Must be "mindsdb".                                                                                           |
+| type         |  string  |     true     | Must be "mindsdb".                                                                                           |
 | host         |  string  |     true     | IP address to connect to (e.g. "127.0.0.1").                                                                 |
 | port         |  string  |     true     | Port to connect to (e.g. "3306").                                                                            |
 | database     |  string  |     true     | Name of the MindsDB database to connect to (e.g. "my_db").                                                   |

docs/en/resources/sources/mongodb.md

@@ -17,9 +17,9 @@ flexible, JSON-like documents, making it easy to develop and scale applications.
 ## Example
 
 ```yaml
-sources:
+kind: sources
-    my-mongodb:
+name: my-mongodb
-        kind: mongodb
+type: mongodb
 uri: "mongodb+srv://username:password@host.mongodb.net"       
 
 ```
@@ -28,5 +28,5 @@ sources:
 
 | **field** | **type** | **required** | **description**                                                   |
 |-----------|:--------:|:------------:|-------------------------------------------------------------------|
-| kind      |  string  |     true     | Must be "mongodb".                                                |
+| type      |  string  |     true     | Must be "mongodb".                                                |
 | uri       |  string  |     true     | connection string to connect to MongoDB                           |

docs/en/resources/sources/mssql.md

@@ -39,9 +39,9 @@ SQL Server user][mssql-users] to login to the database with.
 ## Example
 
 ```yaml
-sources:
+kind: sources
-    my-mssql-source:
+name: my-mssql-source
-        kind: mssql
+type: mssql
 host: 127.0.0.1
 port: 1433
 database: my_db
@@ -59,7 +59,7 @@ instead of hardcoding your secrets into the configuration file.
 
 | **field** | **type** | **required** | **description**                                                                                                                                                                                                                                                          |
 |-----------|:--------:|:------------:|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| kind      |  string  |     true     | Must be "mssql".                                                                                                                                                                                                                                                         |
+| type      |  string  |     true     | Must be "mssql".                                                                                                                                                                                                                                                         |
 | host      |  string  |     true     | IP address to connect to (e.g. "127.0.0.1").                                                                                                                                                                                                                             |
 | port      |  string  |     true     | Port to connect to (e.g. "1433").                                                                                                                                                                                                                                        |
 | database  |  string  |     true     | Name of the SQL Server database to connect to (e.g. "my_db").                                                                                                                                                                                                            |

docs/en/resources/sources/mysql.md

@@ -49,9 +49,9 @@ MySQL user][mysql-users] to login to the database with.
 ## Example
 
 ```yaml
-sources:
+kind: sources
-    my-mysql-source:
+name: my-mysql-source
-        kind: mysql
+type: mysql
 host: 127.0.0.1
 port: 3306
 database: my_db
@@ -72,7 +72,7 @@ instead of hardcoding your secrets into the configuration file.
 
 | **field**    | **type** | **required** | **description**                                                                                 |
 | ------------ | :------: | :----------: | ----------------------------------------------------------------------------------------------- |
-| kind         |  string  |     true     | Must be "mysql".                                                                                |
+| type         |  string  |     true     | Must be "mysql".                                                                                |
 | host         |  string  |     true     | IP address to connect to (e.g. "127.0.0.1").                                                    |
 | port         |  string  |     true     | Port to connect to (e.g. "3306").                                                               |
 | database     |  string  |     true     | Name of the MySQL database to connect to (e.g. "my_db").                                        |

docs/en/resources/sources/neo4j.md

@@ -33,9 +33,9 @@ user if available.
 ## Example
 
 ```yaml
-sources:
+kind: sources
-    my-neo4j-source:
+name: my-neo4j-source
-        kind: neo4j
+type: neo4j
 uri: neo4j+s://xxxx.databases.neo4j.io:7687
 user: ${USER_NAME}
 password: ${PASSWORD}
@@ -51,7 +51,7 @@ instead of hardcoding your secrets into the configuration file.
 
 | **field** | **type** | **required** | **description**                                                      |
 |-----------|:--------:|:------------:|----------------------------------------------------------------------|
-| kind      |  string  |     true     | Must be "neo4j".                                                     |
+| type      |  string  |     true     | Must be "neo4j".                                                     |
 | uri       |  string  |     true     | Connect URI ("bolt://localhost", "neo4j+s://xxx.databases.neo4j.io") |
 | user      |  string  |     true     | Name of the Neo4j user to connect as (e.g. "neo4j").                 |
 | password  |  string  |     true     | Password of the Neo4j user (e.g. "my-password").                     |

docs/en/resources/sources/oceanbase.md

@@ -33,9 +33,9 @@ with SSL).
 ## Example
 
 ```yaml
-sources:
+kind: sources
-    my-oceanbase-source:
+name: my-oceanbase-source
-        kind: oceanbase
+type: oceanbase
 host: 127.0.0.1
 port: 2881
 database: my_db
@@ -53,7 +53,7 @@ instead of hardcoding your secrets into the configuration file.
 
 | **field**    | **type** | **required** | **description**                                                                                 |
 | ------------ | :------: | :----------: |-------------------------------------------------------------------------------------------------|
-| kind         |  string  |     true     | Must be "oceanbase".                                                                            |
+| type         |  string  |     true     | Must be "oceanbase".                                                                            |
 | host         |  string  |     true     | IP address to connect to (e.g. "127.0.0.1").                                                    |
 | port         |  string  |     true     | Port to connect to (e.g. "2881").                                                               |
 | database     |  string  |     true     | Name of the OceanBase database to connect to (e.g. "my_db").                                    |

docs/en/resources/sources/oracle.md

@@ -90,9 +90,9 @@ using a TNS (Transparent Network Substrate) alias.
 This example demonstrates the four connection methods you could choose from:
 
 ```yaml
-sources:
+kind: sources
-    my-oracle-source:
+name: my-oracle-source
-        kind: oracle
+type: oracle
 
 # --- Choose one connection method ---
 # 1. Host, Port, and Service Name
@@ -122,9 +122,9 @@ Oracle Wallet allows you to store credentails used for database connection. Depe
 The `go-ora` driver uses the `walletLocation` field to connect to a database secured with an Oracle Wallet without standard username and password.
 
 ```yaml
-sources:
+kind: sources
-    pure-go-wallet:
+name: pure-go-wallet
-        kind: oracle
+type: oracle
 connectionString: "127.0.0.1:1521/XEPDB1"
 user: ${USER_NAME}
 password: ${PASSWORD}
@@ -138,9 +138,9 @@ sources:
 For the OCI-based driver, wallet authentication is triggered by setting tnsAdmin to the wallet directory and connecting via a tnsAlias. 
 
 ```yaml
-sources:
+kind: sources
-    oci-wallet:
+name: oci-wallet
-        kind: oracle
+type: oracle
 connectionString: "127.0.0.1:1521/XEPDB1"
 user: ${USER_NAME}
 password: ${PASSWORD}
@@ -158,7 +158,7 @@ instead of hardcoding your secrets into the configuration file.
 
 | **field**        | **type** | **required** | **description**                                                                                                                                                                         |
 |------------------|:--------:|:------------:|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| kind             |  string  |     true     | Must be "oracle".                                                                                                                                                                       |
+| type             |  string  |     true     | Must be "oracle".                                                                                                                                                                       |
 | user             |  string  |     true     | Name of the Oracle user to connect as (e.g. "my-oracle-user").                                                                                                                          |
 | password         |  string  |     true     | Password of the Oracle user (e.g. "my-password").                                                                                                                                       |
 | host             |  string  |    false     | IP address or hostname to connect to (e.g. "127.0.0.1"). Required if not using `connectionString` or `tnsAlias`.                                                                        |

docs/en/resources/sources/postgres.md

@@ -107,9 +107,9 @@ PostgreSQL user][pg-users] to login to the database with.
 ## Example
 
 ```yaml
-sources:
+kind: sources
-    my-pg-source:
+name: my-pg-source
-        kind: postgres
+type: postgres
 host: 127.0.0.1
 port: 5432
 database: my_db
@@ -126,7 +126,7 @@ instead of hardcoding your secrets into the configuration file.
 
 |  **field**  |      **type**      | **required** | **description**                                                        |
 |-------------|:------------------:|:------------:|------------------------------------------------------------------------|
-| kind        |       string       |     true     | Must be "postgres".                                                    |
+| type        |       string       |     true     | Must be "postgres".                                                    |
 | host        |       string       |     true     | IP address to connect to (e.g. "127.0.0.1")                            |
 | port        |       string       |     true     | Port to connect to (e.g. "5432")                                       |
 | database    |       string       |     true     | Name of the Postgres database to connect to (e.g. "my_db").            |

docs/en/resources/sources/redis.md

@@ -34,9 +34,9 @@ connections must authenticate in order to connect.
 Specify your AUTH string in the password field:
 
 ```yaml
-sources:
+kind: sources
-    my-redis-instance:
+name: my-redis-instance
-     kind: redis
+type: redis
 address:
   - 127.0.0.1:6379
 username: ${MY_USER_NAME}
@@ -59,9 +59,9 @@ string.
 Here is an example tools.yaml config with [AUTH][auth] enabled:
 
 ```yaml
-sources:
+kind: sources
-    my-redis-cluster-instance:
+name: my-redis-cluster-instance
-     kind: memorystore-redis
+type: memorystore-redis
 address:
   - 127.0.0.1:6379
 password: ${MY_AUTH_STRING}
@@ -76,9 +76,9 @@ Here is an example tools.yaml config for Memorystore Redis Cluster instances
 using IAM authentication:
 
 ```yaml
-sources:
+kind: sources
-    my-redis-cluster-instance:
+name: my-redis-cluster-instance
-     kind: memorystore-redis
+type: memorystore-redis
 address:
   - 127.0.0.1:6379
 useGCPIAM: true
@@ -91,7 +91,7 @@ sources:
 
 | **field**      | **type** | **required** | **description**                                                                                                                 |
 |----------------|:--------:|:------------:|---------------------------------------------------------------------------------------------------------------------------------|
-| kind           |  string  |     true     | Must be "memorystore-redis".                                                                                                    |
+| type           |  string  |     true     | Must be "memorystore-redis".                                                                                                    |
 | address        |  string  |     true     | Primary endpoint for the Memorystore Redis instance to connect to.                                                              |
 | username       |  string  |    false     | If you are using a non-default user, specify the user name here. If you are using Memorystore for Redis, leave this field blank |
 | password       |  string  |    false     | If you have [Redis AUTH][auth] enabled, specify the AUTH string here                                                            |

docs/en/resources/sources/serverless-spark.md

@@ -49,9 +49,9 @@ set up your ADC.
 ## Example
 
 ```yaml
-sources:
+kind: sources
-  my-serverless-spark-source:
+name: my-serverless-spark-source
-    kind: serverless-spark
+type: serverless-spark
 project: my-project-id
 location: us-central1
 ```
@@ -60,6 +60,6 @@ sources:
 
 | **field** | **type** | **required** | **description**                                                   |
 | --------- | :------: | :----------: | ----------------------------------------------------------------- |
-| kind      |  string  |     true     | Must be "serverless-spark".                                       |
+| type      |  string  |     true     | Must be "serverless-spark".                                       |
 | project   |  string  |     true     | ID of the GCP project with Serverless for Apache Spark resources. |
 | location  |  string  |     true     | Location containing Serverless for Apache Spark resources.        |

docs/en/resources/sources/singlestore.md

@@ -39,9 +39,9 @@ database user][singlestore-user] to login to the database with.
 ## Example
 
 ```yaml
-sources:
+kind: sources
-    my-singlestore-source:
+name: my-singlestore-source
-        kind: singlestore
+type: singlestore
 host: 127.0.0.1
 port: 3306
 database: my_db
@@ -59,7 +59,7 @@ instead of hardcoding your secrets into the configuration file.
 
 | **field**    | **type** | **required** | **description**                                                                                 |
 |--------------|:--------:|:------------:|-------------------------------------------------------------------------------------------------|
-| kind         |  string  |     true     | Must be "singlestore".                                                                          |
+| type         |  string  |     true     | Must be "singlestore".                                                                          |
 | host         |  string  |     true     | IP address to connect to (e.g. "127.0.0.1").                                                    |
 | port         |  string  |     true     | Port to connect to (e.g. "3306").                                                               |
 | database     |  string  |     true     | Name of the SingleStore database to connect to (e.g. "my_db").                                  |

docs/en/resources/sources/snowflake.md

@@ -31,9 +31,9 @@ Snowflake user to login to the database with.
 ## Example
 
 ```yaml
-sources:
+kind: sources
-    my-sf-source:
+name: my-sf-source
-        kind: snowflake
+type: snowflake
 account: ${SNOWFLAKE_ACCOUNT}
 user: ${SNOWFLAKE_USER}
 password: ${SNOWFLAKE_PASSWORD}
@@ -52,7 +52,7 @@ instead of hardcoding your secrets into the configuration file.
 
 | **field** | **type** | **required** | **description**                                                        |
 |-----------|:--------:|:------------:|------------------------------------------------------------------------|
-| kind      |  string  |     true     | Must be "snowflake".                                                   |
+| type      |  string  |     true     | Must be "snowflake".                                                   |
 | account   |  string  |     true     | Your Snowflake account identifier.                                     |
 | user      |  string  |     true     | Name of the Snowflake user to connect as (e.g. "my-sf-user").          |
 | password  |  string  |     true     | Password of the Snowflake user (e.g. "my-password").                   |

docs/en/resources/sources/spanner.md

@@ -64,9 +64,9 @@ applying IAM permissions and roles to an identity.
 ## Example
 
 ```yaml
-sources:
+kind: sources
-    my-spanner-source:
+name: my-spanner-source
-        kind: "spanner"
+type: "spanner"
 project: "my-project-id"
 instance: "my-instance"
 database: "my_db"
@@ -77,7 +77,7 @@ sources:
 
 | **field** | **type** | **required** | **description**                                                                                                     |
 |-----------|:--------:|:------------:|---------------------------------------------------------------------------------------------------------------------|
-| kind      |  string  |     true     | Must be "spanner".                                                                                                  |
+| type      |  string  |     true     | Must be "spanner".                                                                                                  |
 | project   |  string  |     true     | Id of the GCP project that the cluster was created in (e.g. "my-project-id").                                       |
 | instance  |  string  |     true     | Name of the Spanner instance.                                                                                       |
 | database  |  string  |     true     | Name of the database on the Spanner instance                                                                        |

docs/en/resources/sources/sqlite.md

@@ -48,18 +48,18 @@ You need a SQLite database file. This can be:
 ## Example
 
 ```yaml
-sources:
+kind: sources
-    my-sqlite-db:
+name: my-sqlite-db
-        kind: "sqlite"
+type: "sqlite"
 database: "/path/to/database.db"
 ```
 
 For an in-memory database:
 
 ```yaml
-sources:
+kind: sources
-    my-sqlite-memory-db:
+name: my-sqlite-memory-db
-        kind: "sqlite"
+type: "sqlite"
 database: ":memory:"
 ```
 
@@ -69,7 +69,7 @@ sources:
 
 | **field** | **type** | **required** | **description**                                                                                                     |
 |-----------|:--------:|:------------:|---------------------------------------------------------------------------------------------------------------------|
-| kind      |  string  |     true     | Must be "sqlite".                                                                                                   |
+| type      |  string  |     true     | Must be "sqlite".                                                                                                   |
 | database  |  string  |     true     | Path to SQLite database file, or ":memory:" for an in-memory database.                                              |
 
 ### Connection Properties

docs/en/resources/sources/tidb.md

@@ -46,9 +46,9 @@ console.
 - TiDB Cloud
 
     ```yaml
-    sources:
+    kind: sources
-        my-tidb-cloud-source:
+    name: my-tidb-cloud-source
-            kind: tidb
+    type: tidb
     host: gateway01.us-west-2.prod.aws.tidbcloud.com
     port: 4000
     database: my_db
@@ -60,9 +60,9 @@ console.
 - Self-Hosted TiDB
 
     ```yaml
-    sources:
+    kind: sources
-        my-tidb-source:
+    name: my-tidb-source
-            kind: tidb
+    type: tidb
     host: 127.0.0.1
     port: 4000
     database: my_db
@@ -80,7 +80,7 @@ instead of hardcoding your secrets into the configuration file.
 
 | **field** | **type** | **required** | **description**                                                                            |
 |-----------|:--------:|:------------:|--------------------------------------------------------------------------------------------|
-| kind      |  string  |     true     | Must be "tidb".                                                                            |
+| type      |  string  |     true     | Must be "tidb".                                                                            |
 | host      |  string  |     true     | IP address or hostname to connect to (e.g. "127.0.0.1" or "gateway01.*.tidbcloud.com").    |
 | port      |  string  |     true     | Port to connect to (typically "4000" for TiDB).                                            |
 | database  |  string  |     true     | Name of the TiDB database to connect to (e.g. "my_db").                                    |

docs/en/resources/sources/trino.md

@@ -32,9 +32,9 @@ the catalogs and schemas you want to query.
 ## Example
 
 ```yaml
-sources:
+kind: sources
-    my-trino-source:
+name: my-trino-source
-    kind: trino
+type: trino
 host: trino.example.com
 port: "8080"
 user: ${TRINO_USER}  # Optional for anonymous access
@@ -52,7 +52,7 @@ instead of hardcoding your secrets into the configuration file.
 
 | **field**              | **type** | **required** | **description**                                                              |
 | ---------------------- | :------: | :----------: | ---------------------------------------------------------------------------- |
-| kind                   |  string  |     true     | Must be "trino".                                                             |
+| type                   |  string  |     true     | Must be "trino".                                                             |
 | host                   |  string  |     true     | Trino coordinator hostname (e.g. "trino.example.com")                        |
 | port                   |  string  |     true     | Trino coordinator port (e.g. "8080", "8443")                                 |
 | user                   |  string  |    false     | Username for authentication (e.g. "analyst"). Optional for anonymous access. |

docs/en/resources/sources/valkey.md

@@ -27,9 +27,9 @@ the [official Valkey website](https://valkey.io/topics/quickstart/).
 ## Example
 
 ```yaml
-sources:
+kind: sources
-    my-valkey-instance:
+name: my-valkey-instance
-     kind: valkey
+type: valkey
 address:
   - 127.0.0.1:6379
 username: ${YOUR_USERNAME}
@@ -51,9 +51,9 @@ authentication. Grant your account the required [IAM role][iam] and set
 `useGCPIAM` to `true`:
 
 ```yaml
-sources:
+kind: sources
-    my-valkey-instance:
+name: my-valkey-instance
-     kind: valkey
+type: valkey
 address:
   - 127.0.0.1:6379
 useGCPIAM: true
@@ -65,7 +65,7 @@ sources:
 
 | **field**    | **type** | **required** | **description**                                                                                                                  |
 |--------------|:--------:|:------------:|----------------------------------------------------------------------------------------------------------------------------------|
-| kind         |  string  |     true     | Must be "valkey".                                                                                                                |
+| type         |  string  |     true     | Must be "valkey".                                                                                                                |
 | address      | []string |     true     | Endpoints for the Valkey instance to connect to.                                                                                 |
 | username     |  string  |    false     | If you are using a non-default user, specify the user name here. If you are using Memorystore for Valkey, leave this field blank |
 | password     |  string  |    false     | Password for the Valkey instance                                                                                                 |

docs/en/resources/sources/yugabytedb.md

@@ -17,9 +17,9 @@ compatibility.
 ## Example
 
 ```yaml
-sources:
+kind: sources
-    my-yb-source:
+name: my-yb-source
-        kind: yugabytedb
+type: yugabytedb
 host: 127.0.0.1
 port: 5433
 database: yugabyte
@@ -33,7 +33,7 @@ sources:
 
 | **field**                    | **type** | **required** | **description**                                                                                                                                                       |
 |------------------------------|:--------:|:------------:|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| kind                         |  string  |     true     | Must be "yugabytedb".                                                                                                                                                 |
+| type                         |  string  |     true     | Must be "yugabytedb".                                                                                                                                                 |
 | host                         |  string  |     true     | IP address to connect to.                                                                                                                                             |
 | port                         | integer  |     true     | Port to connect to. The default port is 5433.                                                                                                                         |
 | database                     |  string  |     true     | Name of the YugabyteDB database to connect to. The default database name is yugabyte.                                                                                 |

docs/en/resources/tools/_index.md

@@ -12,9 +12,9 @@ statement. You can define Tools as a map in the `tools` section of your
 `tools.yaml` file. Typically, a tool will require a source to act on:
 
 ```yaml
-tools:
+kind: tools
- search_flights_by_number:
+name: search_flights_by_number
-    kind: postgres-sql
+type: postgres-sql
 source: my-pg-instance
 statement: |
   SELECT * FROM flights
@@ -171,9 +171,9 @@ the required [authServices](../authServices/) to specific claims within the
 user's ID token.
 
 ```yaml
-  tools:
+kind: tools
-    search_flights_by_user_id:
+name: search_flights_by_user_id
-        kind: postgres-sql
+type: postgres-sql
 source: my-pg-instance
 statement: |
   SELECT * FROM flights WHERE user_id = $1
@@ -222,9 +222,9 @@ can use `minValue` and `maxValue` to define the allowable range.
 {{< /notice >}}
 
 ```yaml
-tools:
+kind: tools
- select_columns_from_table:
+name: select_columns_from_table
-    kind: postgres-sql
+type: postgres-sql
 source: my-pg-instance
 statement: |
   SELECT {{array .columnNames}} FROM {{.tableName}}
@@ -267,9 +267,9 @@ specifying an `authRequired` field. Specify a list of
 [authServices](../authServices/) defined in the previous section.
 
 ```yaml
-tools:
+kind: tools
-  search_all_flight:
+name: search_all_flight
-      kind: postgres-sql
+type: postgres-sql
 source: my-pg-instance
 statement: |
   SELECT * FROM flights

docs/en/resources/tools/alloydb/alloydb-create-cluster.md

@@ -40,9 +40,9 @@ The tool takes the following input parameters:
 ## Example
 
 ```yaml
-tools:
+kind: tools
-  create_cluster:
+name: create_cluster
-    kind: alloydb-create-cluster
+type: alloydb-create-cluster
 source: alloydb-admin-source
 description: Use this tool to create a new AlloyDB cluster in a given project and location.
 ```
@@ -51,6 +51,6 @@ tools:
 
 | **field**   | **type** | **required** | **description**                                      |
 |-------------|:--------:|:------------:|------------------------------------------------------|
-| kind        |  string  |     true     | Must be alloydb-create-cluster.                      |
+| type        |  string  |     true     | Must be alloydb-create-cluster.                      |
 | source      |  string  |     true     | The name of an `alloydb-admin` source.               |
 | description |  string  |    false     | Description of the tool that is passed to the agent. |

docs/en/resources/tools/alloydb/alloydb-create-instance.md

@@ -45,9 +45,9 @@ The tool takes the following input parameters:
 ## Example
 
 ```yaml
-tools:
+kind: tools
-  create_instance:
+name: create_instance
-    kind: alloydb-create-instance
+type: alloydb-create-instance
 source: alloydb-admin-source
 description: Use this tool to create a new AlloyDB instance within a specified cluster.
 ```
@@ -56,6 +56,6 @@ tools:
 
 | **field**   | **type** | **required** | **description**                                      |
 | ----------- | :------: | :----------: | ---------------------------------------------------- |
-| kind        |  string  |     true     | Must be alloydb-create-instance.                     |
+| type        |  string  |     true     | Must be alloydb-create-instance.                     |
 | source      |  string  |     true     | The name of an `alloydb-admin` source.               |
 | description |  string  |     false    | Description of the tool that is passed to the agent. |

docs/en/resources/tools/alloydb/alloydb-create-user.md

@@ -39,9 +39,9 @@ The tool takes the following input parameters:
 ## Example
 
 ```yaml
-tools:
+kind: tools
-  create_user:
+name: create_user
-    kind: alloydb-create-user
+type: alloydb-create-user
 source: alloydb-admin-source
 description: Use this tool to create a new database user for an AlloyDB cluster.
 ```
@@ -50,6 +50,6 @@ tools:
 
 | **field**   | **type** | **required** | **description**                                      |
 | ----------- | :------: | :----------: | ---------------------------------------------------- |
-| kind        |  string  |     true     | Must be alloydb-create-user.                         |
+| type        |  string  |     true     | Must be alloydb-create-user.                         |
 | source      |  string  |     true     | The name of an `alloydb-admin` source.               |
 | description |  string  |     false    | Description of the tool that is passed to the agent. |

docs/en/resources/tools/alloydb/alloydb-get-cluster.md

@@ -3,7 +3,7 @@ title: alloydb-get-cluster
 type: docs
 weight: 1
 description: "The \"alloydb-get-cluster\" tool retrieves details for a specific AlloyDB cluster.\n"
-aliases: [/resources/tools/alloydb-get-cluster]
+alias: [/resources/tools/alloydb-get-cluster]
 ---
 
 ## About
@@ -21,9 +21,9 @@ specified AlloyDB cluster. It is compatible with
 ## Example
 
 ```yaml
-tools:
+kind: tools
-  get_specific_cluster:
+name: get_specific_cluster
-    kind: alloydb-get-cluster
+type: alloydb-get-cluster
 source: my-alloydb-admin-source
 description: Use this tool to retrieve details for a specific AlloyDB cluster.
 ```
@@ -32,6 +32,6 @@ tools:
 
 | **field**   | **type** | **required** | **description**                                      |
 | ----------- | :------: | :----------: | ---------------------------------------------------- |
-| kind        |  string  |     true     | Must be alloydb-get-cluster.                         |
+| type        |  string  |     true     | Must be alloydb-get-cluster.                         |
 | source      |  string  |     true     | The name of an `alloydb-admin` source.               |
 | description |  string  |     false    | Description of the tool that is passed to the agent. |

docs/en/resources/tools/alloydb/alloydb-get-instance.md

@@ -22,9 +22,9 @@ specified AlloyDB instance. It is compatible with
 ## Example
 
 ```yaml
-tools:
+kind: tools
-  get_specific_instance:
+name: get_specific_instance
-    kind: alloydb-get-instance
+type: alloydb-get-instance
 source: my-alloydb-admin-source
 description: Use this tool to retrieve details for a specific AlloyDB instance.
 ```
@@ -33,6 +33,6 @@ tools:
 
 | **field**   | **type** | **required** | **description**                                      |
 |-------------|:--------:|:------------:|------------------------------------------------------|
-| kind        |  string  |     true     | Must be alloydb-get-instance.                        |
+| type        |  string  |     true     | Must be alloydb-get-instance.                        |
 | source      |  string  |     true     | The name of an `alloydb-admin` source.               |
 | description |  string  |    false     | Description of the tool that is passed to the agent. |

docs/en/resources/tools/alloydb/alloydb-get-user.md

@@ -22,9 +22,9 @@ specified AlloyDB user. It is compatible with
 ## Example
 
 ```yaml
-tools:
+kind: tools
-  get_specific_user:
+name: get_specific_user
-    kind: alloydb-get-user
+type: alloydb-get-user
 source: my-alloydb-admin-source
 description: Use this tool to retrieve details for a specific AlloyDB user.
 ```
@@ -33,6 +33,6 @@ tools:
 
 | **field**   | **type** | **required** | **description**                                      |
 | ----------- | :------: | :----------: | ---------------------------------------------------- |
-| kind        |  string  |     true     | Must be alloydb-get-user.                            |
+| type        |  string  |     true     | Must be alloydb-get-user.                            |
 | source      |  string  |     true     | The name of an `alloydb-admin` source.               |
 | description |  string  |     false    | Description of the tool that is passed to the agent. |

docs/en/resources/tools/alloydb/alloydb-list-clusters.md

@@ -24,9 +24,9 @@ location. The tool takes the following input parameters:
 ## Example
 
 ```yaml
-tools:
+kind: tools
-  list_clusters:
+name: list_clusters
-    kind: alloydb-list-clusters
+type: alloydb-list-clusters
 source: alloydb-admin-source
 description: Use this tool to list all AlloyDB clusters in a given project and location.
 ```
@@ -35,6 +35,6 @@ tools:
 
 | **field**   | **type** | **required** | **description**                                      |
 | ----------- | :------: | :----------: | ---------------------------------------------------- |
-| kind        |  string  |     true     | Must be alloydb-list-clusters.                       |
+| type        |  string  |     true     | Must be alloydb-list-clusters.                       |
 | source      |  string  |     true     | The name of an `alloydb-admin` source.               |
 | description |  string  |     false    | Description of the tool that is passed to the agent. |

docs/en/resources/tools/alloydb/alloydb-list-instances.md

@@ -26,9 +26,9 @@ parameters:
 ## Example
 
 ```yaml
-tools:
+kind: tools
-  list_instances:
+name: list_instances
-    kind: alloydb-list-instances
+type: alloydb-list-instances
 source: alloydb-admin-source
 description: Use this tool to list all AlloyDB instances for a given project, cluster and location.
 ```
@@ -37,6 +37,6 @@ tools:
 
 | **field**   | **type** | **required** | **description**                                      |
 | ----------- | :------: | :----------: | ---------------------------------------------------- |
-| kind        |  string  |     true     | Must be alloydb-list-instances.                      |
+| type        |  string  |     true     | Must be alloydb-list-instances.                      |
 | source      |  string  |     true     | The name of an `alloydb-admin` source.               |
 | description |  string  |     false    | Description of the tool that is passed to the agent. |

docs/en/resources/tools/alloydb/alloydb-list-users.md

@@ -22,9 +22,9 @@ The tool takes the following input parameters:
 ## Example
 
 ```yaml
-tools:
+kind: tools
-  list_users:
+name: list_users
-    kind: alloydb-list-users
+type: alloydb-list-users
 source: alloydb-admin-source
 description: Use this tool to list all database users within an AlloyDB cluster
 ```
@@ -33,6 +33,6 @@ tools:
 
 | **field**   | **type** | **required** | **description**                                      |
 | ----------- | :------: | :----------: | ---------------------------------------------------- |
-| kind        |  string  |     true     | Must be alloydb-list-users.                          |
+| type        |  string  |     true     | Must be alloydb-list-users.                          |
 | source      |  string  |     true     | The name of an `alloydb-admin` source.               |
 | description |  string  |     false    | Description of the tool that is passed to the agent. |

docs/en/resources/tools/alloydb/alloydb-wait-for-operation.md

@@ -25,9 +25,9 @@ and shouldn't be used for production agents.
 ## Example
 
 ```yaml
-tools:
+kind: tools
-  wait_for_operation:
+name: wait_for_operation
-    kind: alloydb-wait-for-operation
+type: alloydb-wait-for-operation
 source: my-alloydb-admin-source
 description: "This will poll on operations API until the operation is done. For checking operation status we need projectId, locationID and operationId. Once instance is created give follow up steps on how to use the variables to bring data plane MCP server up in local and remote setup."
 delay: 1s
@@ -40,7 +40,7 @@ tools:
 
 | **field**   | **type** | **required** | **description**                                                                                                  |
 | ----------- | :------: | :----------: | ---------------------------------------------------------------------------------------------------------------- |
-| kind        |  string  |     true     | Must be "alloydb-wait-for-operation".                                                                            |
+| type        |  string  |     true     | Must be "alloydb-wait-for-operation".                                                                            |
 | source      |  string  |     true     | The name of a `alloydb-admin` source to use for authentication.                                                  |
 | description |  string  |     false    | A description of the tool.                                                                                       |
 | delay       | duration |     false    | The initial delay between polling requests (e.g., `3s`). Defaults to 3 seconds.                                  |

docs/en/resources/tools/alloydbainl/alloydb-ai-nl.md

@@ -103,9 +103,9 @@ CREATE EXTENSION IF NOT EXISTS parameterized_views;
 ## Example
 
 ```yaml
-tools:
+kind: tools
-  ask_questions:
+name: ask_questions
-    kind: alloydb-ai-nl
+type: alloydb-ai-nl
 source: my-alloydb-source
 description: "Ask questions to check information about flights"
 nlConfig: "cymbal_air_nl_config"
@@ -125,7 +125,7 @@ tools:
 
 | **field**          |                **type**                 | **required** | **description**                                                          |
 |--------------------|:---------------------------------------:|:------------:|--------------------------------------------------------------------------|
-| kind               |                 string                  |     true     | Must be "alloydb-ai-nl".                                                 |
+| type               |                 string                  |     true     | Must be "alloydb-ai-nl".                                                 |
 | source             |                 string                  |     true     | Name of the AlloyDB source the natural language query should execute on. |
 | description        |                 string                  |     true     | Description of the tool that is passed to the LLM.                       |
 | nlConfig           |                 string                  |     true     | The name of the  `nl_config` in AlloyDB                                  |

docs/en/resources/tools/bigquery/bigquery-analyze-contribution.md

@@ -64,9 +64,9 @@ the `bigquery` source:
 ## Example
 
 ```yaml
-tools:
+kind: tools
-  contribution_analyzer:
+name: contribution_analyzer
-    kind: bigquery-analyze-contribution
+type: bigquery-analyze-contribution
 source: my-bigquery-source
 description: Use this tool to run contribution analysis on a dataset in BigQuery.
 ```
@@ -88,6 +88,6 @@ And use the following sample prompts to call this tool:
 
 | **field**   | **type** | **required** | **description**                                    |
 |-------------|:--------:|:------------:|----------------------------------------------------|
-| kind        |  string  |     true     | Must be "bigquery-analyze-contribution".           |
+| type        |  string  |     true     | Must be "bigquery-analyze-contribution".           |
 | source      |  string  |     true     | Name of the source the tool should execute on.     |
 | description |  string  |     true     | Description of the tool that is passed to the LLM. |

docs/en/resources/tools/bigquery/bigquery-conversational-analytics.md

@@ -53,9 +53,9 @@ dataset specified in the `table_references` parameter.
 ## Example
 
 ```yaml
-tools:
+kind: tools
-  ask_data_insights:
+name: ask_data_insights
-    kind: bigquery-conversational-analytics
+type: bigquery-conversational-analytics
 source: my-bigquery-source
 description: |
   Use this tool to perform data analysis, get insights, or answer complex 
@@ -66,6 +66,6 @@ tools:
 
 | **field**   | **type** | **required** | **description**                                    |
 |-------------|:--------:|:------------:|----------------------------------------------------|
-| kind        |  string  |     true     | Must be "bigquery-conversational-analytics".       |
+| type        |  string  |     true     | Must be "bigquery-conversational-analytics".       |
 | source      |  string  |     true     | Name of the source for chat.                       |
 | description |  string  |     true     | Description of the tool that is passed to the LLM. |

docs/en/resources/tools/bigquery/bigquery-execute-sql.md

@@ -54,9 +54,9 @@ layer of security by controlling which datasets can be accessed:
 ## Example
 
 ```yaml
-tools:
+kind: tools
- execute_sql_tool:
+name: execute_sql_tool
-    kind: bigquery-execute-sql
+type: bigquery-execute-sql
 source: my-bigquery-source
 description: Use this tool to execute sql statement.
 ```
@@ -65,6 +65,6 @@ tools:
 
 | **field**   | **type** | **required** | **description**                                    |
 |-------------|:--------:|:------------:|----------------------------------------------------|
-| kind        |  string  |     true     | Must be "bigquery-execute-sql".                    |
+| type        |  string  |     true     | Must be "bigquery-execute-sql".                    |
 | source      |  string  |     true     | Name of the source the SQL should execute on.      |
 | description |  string  |     true     | Description of the tool that is passed to the LLM. |

docs/en/resources/tools/bigquery/bigquery-forecast.md

@@ -58,9 +58,9 @@ the `bigquery` source:
 ## Example
 
 ```yaml
-tools:
+kind: tools
- forecast_tool:
+name: forecast_tool
-    kind: bigquery-forecast
+type: bigquery-forecast
 source: my-bigquery-source
 description: Use this tool to forecast time series data in BigQuery.
 ```
@@ -78,6 +78,6 @@ You can use the following sample prompts to call this tool:
 
 | **field**   | **type** | **required** | **description**                                         |
 |-------------|:--------:|:------------:|---------------------------------------------------------|
-| kind        |  string  |     true     | Must be "bigquery-forecast".                            |
+| type        |  string  |     true     | Must be "bigquery-forecast".                            |
 | source      |  string  |     true     | Name of the source the forecast tool should execute on. |
 | description |  string  |     true     | Description of the tool that is passed to the LLM.      |

docs/en/resources/tools/bigquery/bigquery-get-dataset-info.md

@@ -34,9 +34,9 @@ The tool's behavior regarding these parameters is influenced by the
 ## Example
 
 ```yaml
-tools:
+kind: tools
-  bigquery_get_dataset_info:
+name: bigquery_get_dataset_info
-    kind: bigquery-get-dataset-info
+type: bigquery-get-dataset-info
 source: my-bigquery-source
 description: Use this tool to get dataset metadata.
 ```
@@ -45,6 +45,6 @@ tools:
 
 | **field**   |                  **type**                  | **required** | **description**                                                                                  |
 |-------------|:------------------------------------------:|:------------:|--------------------------------------------------------------------------------------------------|
-| kind        |                   string                   |     true     | Must be "bigquery-get-dataset-info".                                                             |
+| type        |                   string                   |     true     | Must be "bigquery-get-dataset-info".                                                             |
 | source      |                   string                   |     true     | Name of the source the SQL should execute on.                                                    |
 | description |                   string                   |     true     | Description of the tool that is passed to the LLM.                                               |

docs/en/resources/tools/bigquery/bigquery-get-table-info.md

@@ -35,9 +35,9 @@ The tool's behavior regarding these parameters is influenced by the
 ## Example
 
 ```yaml
-tools:
+kind: tools
-  bigquery_get_table_info:
+name: bigquery_get_table_info
-    kind: bigquery-get-table-info
+type: bigquery-get-table-info
 source: my-bigquery-source
 description: Use this tool to get table metadata.
 ```
@@ -46,6 +46,6 @@ tools:
 
 | **field**   |                  **type**                  | **required** | **description**                                                                                  |
 |-------------|:------------------------------------------:|:------------:|--------------------------------------------------------------------------------------------------|
-| kind        |                   string                   |     true     | Must be "bigquery-get-table-info".                                                               |
+| type        |                   string                   |     true     | Must be "bigquery-get-table-info".                                                               |
 | source      |                   string                   |     true     | Name of the source the SQL should execute on.                                                    |
 | description |                   string                   |     true     | Description of the tool that is passed to the LLM.                                               |

docs/en/resources/tools/bigquery/bigquery-list-dataset-ids.md

@@ -32,9 +32,9 @@ The tool's behavior regarding this parameter is influenced by the
 ## Example
 
 ```yaml
-tools:
+kind: tools
-  bigquery_list_dataset_ids:
+name: bigquery_list_dataset_ids
-    kind: bigquery-list-dataset-ids
+type: bigquery-list-dataset-ids
 source: my-bigquery-source
 description: Use this tool to get dataset metadata.
 ```
@@ -43,6 +43,6 @@ tools:
 
 | **field**   |                  **type**                  | **required** | **description**                                                                                  |
 |-------------|:------------------------------------------:|:------------:|--------------------------------------------------------------------------------------------------|
-| kind        |                   string                   |     true     | Must be "bigquery-list-dataset-ids".                                                             |
+| type        |                   string                   |     true     | Must be "bigquery-list-dataset-ids".                                                             |
 | source      |                   string                   |     true     | Name of the source the SQL should execute on.                                                    |
 | description |                   string                   |     true     | Description of the tool that is passed to the LLM.                                               |

docs/en/resources/tools/bigquery/bigquery-list-table-ids.md

@@ -34,9 +34,9 @@ will be used as the default value for the `dataset` parameter.
 ## Example
 
 ```yaml
-tools:
+kind: tools
-  bigquery_list_table_ids:
+name: bigquery_list_table_ids
-    kind: bigquery-list-table-ids
+type: bigquery-list-table-ids
 source: my-bigquery-source
 description: Use this tool to get table metadata.
 ```
@@ -45,6 +45,6 @@ tools:
 
 | **field**   |                  **type**                  | **required** | **description**                                                                                  |
 |-------------|:------------------------------------------:|:------------:|--------------------------------------------------------------------------------------------------|
-| kind        |                   string                   |     true     | Must be "bigquery-list-table-ids".                                                               |
+| type        |                   string                   |     true     | Must be "bigquery-list-table-ids".                                                               |
 | source      |                   string                   |     true     | Name of the source the SQL should execute on.                                                    |
 | description |                   string                   |     true     | Description of the tool that is passed to the LLM.                                               |

docs/en/resources/tools/bigquery/bigquery-search-catalog.md

@@ -48,9 +48,9 @@ applying IAM permissions and roles to an identity.
 ## Example
 
 ```yaml
-tools:
+kind: tools
-  search_catalog:
+name: search_catalog
-    kind: bigquery-search-catalog
+type: bigquery-search-catalog
 source: bigquery-source
 description: Use this tool to find tables, views, models, routines or connections.
 ```
@@ -59,6 +59,6 @@ tools:
 
 | **field**   |                  **type**                  | **required** | **description**                                                                                  |
 |-------------|:------------------------------------------:|:------------:|--------------------------------------------------------------------------------------------------|
-| kind        |                   string                   |     true     | Must be "bigquery-search-catalog".                                                               |
+| type        |                   string                   |     true     | Must be "bigquery-search-catalog".                                                               |
 | source      |                   string                   |     true     | Name of the source the tool should execute on.                                                   |
 | description |                   string                   |     true     | Description of the tool that is passed to the LLM.                                               |

docs/en/resources/tools/bigquery/bigquery-sql.md

@@ -46,10 +46,10 @@ same query.
 > identifiers, column names, table names, or other parts of the query.
 
 ```yaml
-tools:
 # Example: Querying a user table in BigQuery
-  search_users_bq:
+kind: tools
-    kind: bigquery-sql
+name: search_users_bq
+type: bigquery-sql
 source: my-bigquery-source
 statement: |
   SELECT
@@ -87,9 +87,9 @@ tools:
 > [templateParameters](../#template-parameters).
 
 ```yaml
-tools:
+kind: tools
- list_table:
+name: list_table
-    kind: bigquery-sql
+type: bigquery-sql
 source: my-bigquery-source
 statement: |
   SELECT * FROM {{.tableName}};
@@ -109,7 +109,7 @@ tools:
 
 | **field**          |                   **type**                    | **required** | **description**                                                                                                                         |
 |--------------------|:---------------------------------------------:|:------------:|-----------------------------------------------------------------------------------------------------------------------------------------|
-| kind               |                    string                     |     true     | Must be "bigquery-sql".                                                                                                                 |
+| type               |                    string                     |     true     | Must be "bigquery-sql".                                                                                                                 |
 | source             |                    string                     |     true     | Name of the source the GoogleSQL should execute on.                                                                                     |
 | description        |                    string                     |     true     | Description of the tool that is passed to the LLM.                                                                                      |
 | statement          |                    string                     |     true     | The GoogleSQL statement to execute.                                                                                                     |

docs/en/resources/tools/bigtable/bigtable-sql.md

@@ -40,9 +40,9 @@ inserted according to their name: e.g. `@name`.
 > names, or other parts of the query.
 
 ```yaml
-tools:
+kind: tools
- search_user_by_id_or_name:
+name: search_user_by_id_or_name
-    kind: bigtable-sql
+type: bigtable-sql
 source: my-bigtable-instance
 statement: |
   SELECT
@@ -80,9 +80,9 @@ tools:
 > [templateParameters](..#template-parameters).
 
 ```yaml
-tools:
+kind: tools
- list_table:
+name: list_table
-    kind: bigtable-sql
+type: bigtable-sql
 source: my-bigtable-instance
 statement: |
   SELECT * FROM {{.tableName}};
@@ -102,7 +102,7 @@ tools:
 
 | **field**          |                   **type**                   | **required** | **description**                                                                                                                        |
 |--------------------|:--------------------------------------------:|:------------:|----------------------------------------------------------------------------------------------------------------------------------------|
-| kind               |                    string                    |     true     | Must be "bigtable-sql".                                                                                                                |
+| type               |                    string                    |     true     | Must be "bigtable-sql".                                                                                                                |
 | source             |                    string                    |     true     | Name of the source the SQL should execute on.                                                                                          |
 | description        |                    string                    |     true     | Description of the tool that is passed to the LLM.                                                                                     |
 | statement          |                    string                    |     true     | SQL statement to execute on.                                                                                                           |

docs/en/resources/tools/cassandra/cassandra-cql.md

@@ -31,9 +31,9 @@ the form of placeholders `?`.
 > names, or other parts of the query.
 
 ```yaml
-tools:
+kind: tools
-  search_users_by_email:
+name: search_users_by_email
-    kind: cassandra-cql
+type: cassandra-cql
 source: my-cassandra-cluster
 statement: |
   SELECT user_id, email, first_name, last_name, created_at 
@@ -63,9 +63,9 @@ tools:
 > [templateParameters](../#template-parameters).
 
 ```yaml
-tools:
+kind: tools
-  list_keyspace_table:
+name: list_keyspace_table
-    kind: cassandra-cql
+type: cassandra-cql
 source: my-cassandra-cluster
 statement: |
   SELECT * FROM {{.keyspace}}.{{.tableName}};
@@ -89,7 +89,7 @@ tools:
 
 | **field**          |                   **type**                    | **required** | **description**                                                                                                                         |
 |--------------------|:---------------------------------------------:|:------------:|-----------------------------------------------------------------------------------------------------------------------------------------|
-| kind               |                    string                     |     true     | Must be "cassandra-cql".                                                                                                                |
+| type               |                    string                     |     true     | Must be "cassandra-cql".                                                                                                                |
 | source             |                    string                     |     true     | Name of the source the CQL should execute on.                                                                                           |
 | description        |                    string                     |     true     | Description of the tool that is passed to the LLM.                                                                                      |
 | statement          |                    string                     |     true     | CQL statement to execute.                                                                                                               |

docs/en/resources/tools/clickhouse/clickhouse-execute-sql.md

@@ -25,9 +25,9 @@ capabilities for monitoring and debugging purposes.
 ## Example
 
 ```yaml
-tools:
+kind: tools
-  execute_sql_tool:
+name: execute_sql_tool
-    kind: clickhouse-execute-sql
+type: clickhouse-execute-sql
 source: my-clickhouse-instance
 description: Use this tool to execute SQL statements against ClickHouse.
 ```
@@ -42,6 +42,6 @@ tools:
 
 | **field**   | **type** | **required** | **description**                                       |
 |-------------|:--------:|:------------:|-------------------------------------------------------|
-| kind        |  string  |     true     | Must be "clickhouse-execute-sql".                     |
+| type        |  string  |     true     | Must be "clickhouse-execute-sql".                     |
 | source      |  string  |     true     | Name of the ClickHouse source to execute SQL against. |
 | description |  string  |     true     | Description of the tool that is passed to the LLM.    |

docs/en/resources/tools/clickhouse/clickhouse-list-databases.md

@@ -21,9 +21,9 @@ discovery and exploration tasks.
 ## Example
 
 ```yaml
-tools:
+kind: tools
-  list_clickhouse_databases:
+name: list_clickhouse_databases
-    kind: clickhouse-list-databases
+type: clickhouse-list-databases
 source: my-clickhouse-instance
 description: List all available databases in the ClickHouse instance
 ```
@@ -49,7 +49,7 @@ Example response:
 
 | **field**    |      **type**      | **required** | **description**                                       |
 |--------------|:------------------:|:------------:|-------------------------------------------------------|
-| kind         |       string       |     true     | Must be "clickhouse-list-databases".                  |
+| type         |       string       |     true     | Must be "clickhouse-list-databases".                  |
 | source       |       string       |     true     | Name of the ClickHouse source to list databases from. |
 | description  |       string       |     true     | Description of the tool that is passed to the LLM.    |
 | authRequired |  array of string   |    false     | Authentication services required to use this tool.    |

docs/en/resources/tools/clickhouse/clickhouse-list-tables.md

@@ -21,9 +21,9 @@ user, making it useful for schema exploration and table discovery tasks.
 ## Example
 
 ```yaml
-tools:
+kind: tools
-  list_clickhouse_tables:
+name: list_clickhouse_tables
-    kind: clickhouse-list-tables
+type: clickhouse-list-tables
 source: my-clickhouse-instance
 description: List all tables in a specific ClickHouse database
 ```
@@ -56,7 +56,7 @@ Example response:
 
 | **field**    |      **type**      | **required** | **description**                                         |
 |--------------|:------------------:|:------------:|---------------------------------------------------------|
-| kind         |       string       |     true     | Must be "clickhouse-list-tables".                       |
+| type         |       string       |     true     | Must be "clickhouse-list-tables".                       |
 | source       |       string       |     true     | Name of the ClickHouse source to list tables from.      |
 | description  |       string       |     true     | Description of the tool that is passed to the LLM.      |
 | authRequired |  array of string   |    false     | Authentication services required to use this tool.      |

docs/en/resources/tools/clickhouse/clickhouse-sql.md

@@ -21,9 +21,9 @@ query execution capabilities.
 ## Example
 
 ```yaml
-tools:
+kind: tools
-  my_analytics_query:
+name: my_analytics_query
-    kind: clickhouse-sql
+type: clickhouse-sql
 source: my-clickhouse-instance
 description: Get user analytics for a specific date range
 statement: |
@@ -48,9 +48,9 @@ tools:
 ## Template Parameters Example
 
 ```yaml
-tools:
+kind: tools
-  flexible_table_query:
+name: flexible_table_query
-    kind: clickhouse-sql
+type: clickhouse-sql
 source: my-clickhouse-instance
 description: Query any table with flexible columns
 statement: |
@@ -74,7 +74,7 @@ tools:
 
 | **field**          |      **type**      | **required** | **description**                                       |
 |--------------------|:------------------:|:------------:|-------------------------------------------------------|
-| kind               |       string       |     true     | Must be "clickhouse-sql".                             |
+| type               |       string       |     true     | Must be "clickhouse-sql".                             |
 | source             |       string       |     true     | Name of the ClickHouse source to execute SQL against. |
 | description        |       string       |     true     | Description of the tool that is passed to the LLM.    |
 | statement          |       string       |     true     | The SQL statement template to execute.                |

docs/en/resources/tools/cloudgda/cloud-gda-query.md

@@ -15,9 +15,9 @@ The `cloud-gemini-data-analytics-query` tool allows you to send natural language
 ## Example
 
 ```yaml
-tools:
+kind: tools
-  my-gda-query-tool:
+name: my-gda-query-tool
-    kind: cloud-gemini-data-analytics-query
+type: cloud-gemini-data-analytics-query
 source: my-gda-source
 description: "Use this tool to send natural language queries to the Gemini Data Analytics API and receive SQL, natural language answers, and explanations."
 location: ${your_database_location}
@@ -84,7 +84,7 @@ How many accounts who have region in Prague are eligible for loans? A3 contains
 
 | **field**         | **type** | **required** | **description**                                                                                                                                                                                                                                              |
 | ----------------- | :------: | :----------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| kind              |  string  |     true     | Must be "cloud-gemini-data-analytics-query".                                                                                                                                                                                                                 |
+| type              |  string  |     true     | Must be "cloud-gemini-data-analytics-query".                                                                                                                                                                                                                 |
 | source            |  string  |     true     | The name of the `cloud-gemini-data-analytics` source to use.                                                                                                                                                                                                 |
 | description       |  string  |     true     | A description of the tool's purpose.                                                                                                                                                                                                                         |
 | location          |  string  |     true     | The Google Cloud location of the target database resource (e.g., "us-central1"). This is used to construct the parent resource name in the API call.                                                                                                         |

docs/en/resources/tools/cloudhealthcare/cloud-healthcare-fhir-fetch-page.md

@@ -23,9 +23,9 @@ response bundle.
 ## Example
 
 ```yaml
-tools:
+kind: tools
-  get_fhir_store:
+name: get_fhir_store
-    kind: cloud-healthcare-fhir-fetch-page
+type: cloud-healthcare-fhir-fetch-page
 source: my-healthcare-source
 description: Use this tool to fetch a page of FHIR resources from a FHIR Bundle's entry.link.url
 ```
@@ -34,7 +34,7 @@ tools:
 
 | **field**   | **type** | **required** | **description**                                    |
 |-------------|:--------:|:------------:|----------------------------------------------------|
-| kind        |  string  |     true     | Must be "cloud-healthcare-fhir-fetch-page".        |
+| type        |  string  |     true     | Must be "cloud-healthcare-fhir-fetch-page".        |
 | source      |  string  |     true     | Name of the healthcare source.                     |
 | description |  string  |     true     | Description of the tool that is passed to the LLM. |
 

docs/en/resources/tools/cloudhealthcare/cloud-healthcare-fhir-patient-everything.md

@@ -22,9 +22,9 @@ types, or only resources that have been updated after a given time.
 ## Example
 
 ```yaml
-tools:
+kind: tools
-  fhir_patient_everything:
+name: fhir_patient_everything
-    kind: cloud-healthcare-fhir-patient-everything
+type: cloud-healthcare-fhir-patient-everything
 source: my-healthcare-source
 description: Use this tool to retrieve all the information about a given patient.
 ```
@@ -33,7 +33,7 @@ tools:
 
 | **field**   | **type** | **required** | **description**                                     |
 |-------------|:--------:|:------------:|-----------------------------------------------------|
-| kind        |  string  |     true     | Must be "cloud-healthcare-fhir-patient-everything". |
+| type        |  string  |     true     | Must be "cloud-healthcare-fhir-patient-everything". |
 | source      |  string  |     true     | Name of the healthcare source.                      |
 | description |  string  |     true     | Description of the tool that is passed to the LLM.  |
 

docs/en/resources/tools/cloudhealthcare/cloud-healthcare-fhir-patient-search.md

@@ -21,9 +21,9 @@ given criteria.
 ## Example
 
 ```yaml
-tools:
+kind: tools
-  fhir_patient_search:
+name: fhir_patient_search
-    kind: cloud-healthcare-fhir-patient-search
+type: cloud-healthcare-fhir-patient-search
 source: my-healthcare-source
 description: Use this tool to search for patients in the FHIR store.
 ```
@@ -32,7 +32,7 @@ tools:
 
 | **field**   | **type** | **required** | **description**                                    |
 |-------------|:--------:|:------------:|----------------------------------------------------|
-| kind        |  string  |     true     | Must be "cloud-healthcare-fhir-patient-search".    |
+| type        |  string  |     true     | Must be "cloud-healthcare-fhir-patient-search".    |
 | source      |  string  |     true     | Name of the healthcare source.                     |
 | description |  string  |     true     | Description of the tool that is passed to the LLM. |
 

docs/en/resources/tools/cloudhealthcare/cloud-healthcare-get-dataset.md

@@ -21,9 +21,9 @@ configured in the source. It takes no extra parameters.
 ## Example
 
 ```yaml
-tools:
+kind: tools
-  get_dataset:
+name: get_dataset
-    kind: cloud-healthcare-get-dataset
+type: cloud-healthcare-get-dataset
 source: my-healthcare-source
 description: Use this tool to get healthcare dataset metadata.
 ```
@@ -32,6 +32,6 @@ tools:
 
 | **field**   |                  **type**                  | **required** | **description**                                    |
 |-------------|:------------------------------------------:|:------------:|----------------------------------------------------|
-| kind        |                   string                   |     true     | Must be "cloud-healthcare-get-dataset".            |
+| type        |                   string                   |     true     | Must be "cloud-healthcare-get-dataset".            |
 | source      |                   string                   |     true     | Name of the healthcare source.                     |
 | description |                   string                   |     true     | Description of the tool that is passed to the LLM. |

docs/en/resources/tools/cloudhealthcare/cloud-healthcare-get-dicom-store-metrics.md

@@ -20,9 +20,9 @@ store. It's compatible with the following sources:
 ## Example
 
 ```yaml
-tools:
+kind: tools
-  get_dicom_store_metrics:
+name: get_dicom_store_metrics
-    kind: cloud-healthcare-get-dicom-store-metrics
+type: cloud-healthcare-get-dicom-store-metrics
 source: my-healthcare-source
 description: Use this tool to get metrics for a DICOM store.
 ```
@@ -31,7 +31,7 @@ tools:
 
 | **field**   | **type** | **required** | **description**                                     |
 |-------------|:--------:|:------------:|-----------------------------------------------------|
-| kind        |  string  |     true     | Must be "cloud-healthcare-get-dicom-store-metrics". |
+| type        |  string  |     true     | Must be "cloud-healthcare-get-dicom-store-metrics". |
 | source      |  string  |     true     | Name of the healthcare source.                      |
 | description |  string  |     true     | Description of the tool that is passed to the LLM.  |
 

docs/en/resources/tools/cloudhealthcare/cloud-healthcare-get-dicom-store.md

@@ -20,9 +20,9 @@ compatible with the following sources:
 ## Example
 
 ```yaml
-tools:
+kind: tools
-  get_dicom_store:
+name: get_dicom_store
-    kind: cloud-healthcare-get-dicom-store
+type: cloud-healthcare-get-dicom-store
 source: my-healthcare-source
 description: Use this tool to get information about a DICOM store.
 ```
@@ -31,7 +31,7 @@ tools:
 
 | **field**   | **type** | **required** | **description**                                    |
 |-------------|:--------:|:------------:|----------------------------------------------------|
-| kind        |  string  |     true     | Must be "cloud-healthcare-get-dicom-store".        |
+| type        |  string  |     true     | Must be "cloud-healthcare-get-dicom-store".        |
 | source      |  string  |     true     | Name of the healthcare source.                     |
 | description |  string  |     true     | Description of the tool that is passed to the LLM. |
 

docs/en/resources/tools/cloudhealthcare/cloud-healthcare-get-fhir-resource.md

@@ -23,9 +23,9 @@ by its type and ID.
 ## Example
 
 ```yaml
-tools:
+kind: tools
-  get_fhir_resource:
+name: get_fhir_resource
-    kind: cloud-healthcare-get-fhir-resource
+type: cloud-healthcare-get-fhir-resource
 source: my-healthcare-source
 description: Use this tool to retrieve a specific FHIR resource.
 ```
@@ -34,7 +34,7 @@ tools:
 
 | **field**   | **type** | **required** | **description**                                    |
 |-------------|:--------:|:------------:|----------------------------------------------------|
-| kind        |  string  |     true     | Must be "cloud-healthcare-get-fhir-resource".      |
+| type        |  string  |     true     | Must be "cloud-healthcare-get-fhir-resource".      |
 | source      |  string  |     true     | Name of the healthcare source.                     |
 | description |  string  |     true     | Description of the tool that is passed to the LLM. |
 

docs/en/resources/tools/cloudhealthcare/cloud-healthcare-get-fhir-store-metrics.md

@@ -20,9 +20,9 @@ compatible with the following sources:
 ## Example
 
 ```yaml
-tools:
+kind: tools
-  get_fhir_store_metrics:
+name: get_fhir_store_metrics
-    kind: cloud-healthcare-get-fhir-store-metrics
+type: cloud-healthcare-get-fhir-store-metrics
 source: my-healthcare-source
 description: Use this tool to get metrics for a FHIR store.
 ```
@@ -31,7 +31,7 @@ tools:
 
 | **field**   | **type** | **required** | **description**                                    |
 |-------------|:--------:|:------------:|----------------------------------------------------|
-| kind        |  string  |     true     | Must be "cloud-healthcare-get-fhir-store-metrics". |
+| type        |  string  |     true     | Must be "cloud-healthcare-get-fhir-store-metrics". |
 | source      |  string  |     true     | Name of the healthcare source.                     |
 | description |  string  |     true     | Description of the tool that is passed to the LLM. |
 

docs/en/resources/tools/cloudhealthcare/cloud-healthcare-get-fhir-store.md

@@ -20,9 +20,9 @@ compatible with the following sources:
 ## Example
 
 ```yaml
-tools:
+kind: tools
-  get_fhir_store:
+name: get_fhir_store
-    kind: cloud-healthcare-get-fhir-store
+type: cloud-healthcare-get-fhir-store
 source: my-healthcare-source
 description: Use this tool to get information about a FHIR store.
 ```
@@ -31,7 +31,7 @@ tools:
 
 | **field**   | **type** | **required** | **description**                                    |
 |-------------|:--------:|:------------:|----------------------------------------------------|
-| kind        |  string  |     true     | Must be "cloud-healthcare-get-fhir-store".         |
+| type        |  string  |     true     | Must be "cloud-healthcare-get-fhir-store".         |
 | source      |  string  |     true     | Name of the healthcare source.                     |
 | description |  string  |     true     | Description of the tool that is passed to the LLM. |
 

docs/en/resources/tools/cloudhealthcare/cloud-healthcare-list-dicom-stores.md

@@ -22,9 +22,9 @@ stores in the dataset of the healthcare source. It takes no extra parameters.
 ## Example
 
 ```yaml
-tools:
+kind: tools
-  list_dicom_stores:
+name: list_dicom_stores
-    kind: cloud-healthcare-list-dicom-stores
+type: cloud-healthcare-list-dicom-stores
 source: my-healthcare-source
 description: Use this tool to list DICOM stores in the healthcare dataset.
 ```
@@ -33,6 +33,6 @@ tools:
 
 | **field**   | **type** | **required** | **description**                                    |
 |-------------|:--------:|:------------:|----------------------------------------------------|
-| kind        |  string  |     true     | Must be "cloud-healthcare-list-dicom-stores".      |
+| type        |  string  |     true     | Must be "cloud-healthcare-list-dicom-stores".      |
 | source      |  string  |     true     | Name of the healthcare source.                     |
 | description |  string  |     true     | Description of the tool that is passed to the LLM. |

docs/en/resources/tools/cloudhealthcare/cloud-healthcare-list-fhir-stores.md

@@ -22,9 +22,9 @@ stores in the dataset of the healthcare source. It takes no extra parameters.
 ## Example
 
 ```yaml
-tools:
+kind: tools
-  list_fhir_stores:
+name: list_fhir_stores
-    kind: cloud-healthcare-list-fhir-stores
+type: cloud-healthcare-list-fhir-stores
 source: my-healthcare-source
 description: Use this tool to list FHIR stores in the healthcare dataset.
 ```
@@ -33,6 +33,6 @@ tools:
 
 | **field**   | **type** | **required** | **description**                                    |
 |-------------|:--------:|:------------:|----------------------------------------------------|
-| kind        |  string  |     true     | Must be "cloud-healthcare-list-fhir-stores".       |
+| type        |  string  |     true     | Must be "cloud-healthcare-list-fhir-stores".       |
 | source      |  string  |     true     | Name of the healthcare source.                     |
 | description |  string  |     true     | Description of the tool that is passed to the LLM. |