fix(tools/looker): refactor looker-git-branch tool into 5 separate tools with proper annotations to isolate readonly and destructive tool actions

Author: drstrangelooker

.gitignore

@@ -26,3 +26,4 @@ __pycache__/
 genai-toolbox
 toolbox
 toolbox.exe
+**/test.db

cmd/internal/config_test.go

@@ -1866,7 +1866,7 @@ func TestPrebuiltTools(t *testing.T) {
 			wantToolset: server.ToolsetConfigs{
 				"looker_dev_tools": tools.ToolsetConfig{
 					Name:      "looker_dev_tools",
-					ToolNames: []string{"health_pulse", "health_analyze", "health_vacuum", "dev_mode", "get_projects", "get_project_files", "get_project_file", "create_project_file", "update_project_file", "delete_project_file", "get_project_directories", "create_project_directory", "delete_project_directory", "validate_project", "get_connections", "get_connection_schemas", "get_connection_databases", "get_connection_tables", "get_connection_table_columns", "get_lookml_tests", "run_lookml_tests", "create_view_from_table", "project_git_branch"},
+					ToolNames: []string{"health_pulse", "health_analyze", "health_vacuum", "dev_mode", "get_projects", "get_project_files", "get_project_file", "create_project_file", "update_project_file", "delete_project_file", "get_project_directories", "create_project_directory", "delete_project_directory", "validate_project", "get_connections", "get_connection_schemas", "get_connection_databases", "get_connection_tables", "get_connection_table_columns", "get_lookml_tests", "run_lookml_tests", "create_view_from_table", "list_git_branches", "get_git_branch", "create_git_branch", "switch_git_branch", "delete_git_branch"},
 				},
 			},
 		},

cmd/internal/imports.go

@@ -114,10 +114,12 @@ import (
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookeradddashboardfilter"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookerconversationalanalytics"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookercreateagent"
+	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookercreategitbranch"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookercreateprojectdirectory"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookercreateprojectfile"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookercreateviewfromtable"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookerdeleteagent"
+	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookerdeletegitbranch"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookerdeleteprojectdirectory"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookerdeleteprojectfile"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookerdevmode"
@@ -132,6 +134,7 @@ import (
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookergetdimensions"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookergetexplores"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookergetfilters"
+	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookergetgitbranch"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookergetlookmltests"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookergetlooks"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookergetmeasures"
@@ -141,11 +144,11 @@ import (
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookergetprojectfile"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookergetprojectfiles"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookergetprojects"
-	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookergitbranch"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookerhealthanalyze"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookerhealthpulse"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookerhealthvacuum"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookerlistagents"
+	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookerlistgitbranches"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookermakedashboard"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookermakelook"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookerquery"
@@ -154,6 +157,7 @@ import (
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookerrundashboard"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookerrunlook"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookerrunlookmltests"
+	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookerswitchgitbranch"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookerupdateagent"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookerupdateprojectfile"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookervalidateproject"

docs/en/documentation/connect-to/ides/looker_mcp.md

@@ -551,7 +551,11 @@ as well as get the database schema needed to write LookML effectively.
 1. **get_lookml_tests**: Retrieves a list of available LookML tests for a project.
 1. **run_lookml_tests**: Executes specific LookML tests within a project.
 1. **create_view_from_table**: Generates boilerplate LookML views directly from the database schema.
-1. **project_git_branch**: Fetch and manipulate the git branch of a LookML project.
+1. **list_git_branches**: List the available git branches of a LookML project.
+1. **get_git_branch**: Get the current git branch of a LookML project.
+1. **create_git_branch**: Create a new git branch for a LookML project.
+1. **switch_git_branch**: Switch the git branch of a LookML project.
+1. **delete_git_branch**: Delete a git branch of a LookML project.
 
 {{< notice note >}}
 Prebuilt tools are pre-1.0, so expect some tool changes between versions. LLMs

docs/en/integrations/looker/prebuilt-configs/looker-dev.md

@@ -43,4 +43,8 @@ description: "Details of the Looker Dev prebuilt configuration."
     *   `get_lookml_tests`: Retrieves a list of available LookML tests for a project.
     *   `run_lookml_tests`: Executes specific LookML tests within a project.
     *   `create_view_from_table`: Generates boilerplate LookML views directly from the database schema.
-    *   `project_git_branch`: Fetch and manipulate the git branch of a LookML project.
+    *   `list_git_branches`: List the available git branches of a LookML project.
+    *   `get_git_branch`: Get the current git branch of a LookML project.
+    *   `create_git_branch`: Create a new git branch for a LookML project.
+    *   `switch_git_branch`: Switch the git branch of a LookML project.
+    *   `delete_git_branch`: Delete a git branch of a LookML project.

docs/en/integrations/looker/tools/looker-create-git-branch.md

@@ -0,0 +1,44 @@
+---
+title: "Create Git Branch Tool"
+type: docs
+weight: 1
+description: >
+  A "looker-create-git-branch" tool is used to create a new git branch for a LookML project.
+---
+
+## About
+
+A `looker-create-git-branch` tool is used to create a new git branch
+for a LookML project.
+
+## Compatible Sources
+
+{{< compatible-sources >}}
+
+## Parameters
+
+| **field**  | **type** | **required** | **description**                           |
+| ---------- | :------: | :----------: | ----------------------------------------- |
+| project_id |  string  |     true     | The unique ID of the LookML project.      |
+| branch     |  string  |     true     | The git branch to create.                 |
+| ref        |  string  |     false    | The ref to use as the start of a new branch. Defaults to HEAD of current branch. |
+
+## Example
+
+```yaml
+kind: tool
+name: create_project_git_branch
+type: looker-create-git-branch
+source: looker-source
+description: |
+  This tool is used to create a new git branch of a LookML
+  project. This only works in dev mode.
+```
+
+## Reference
+
+| **field**   | **type** | **required** | **description**                                    |
+|-------------|:--------:|:------------:|----------------------------------------------------|
+| type        |  string  |     true     | Must be "looker-create-git-branch".                |
+| source      |  string  |     true     | Name of the source.                                |
+| description |  string  |     true     | Description of the tool that is passed to the LLM. |

docs/en/integrations/looker/tools/looker-delete-git-branch.md

@@ -0,0 +1,43 @@
+---
+title: "Delete Git Branch Tool"
+type: docs
+weight: 1
+description: >
+  A "looker-delete-git-branch" tool is used to delete a git branch of a LookML project.
+---
+
+## About
+
+A `looker-delete-git-branch` tool is used to delete a git branch
+of a LookML project.
+
+## Compatible Sources
+
+{{< compatible-sources >}}
+
+## Parameters
+
+| **field**  | **type** | **required** | **description**                           |
+| ---------- | :------: | :----------: | ----------------------------------------- |
+| project_id |  string  |     true     | The unique ID of the LookML project.      |
+| branch     |  string  |     true     | The git branch to delete.                 |
+
+## Example
+
+```yaml
+kind: tool
+name: delete_project_git_branch
+type: looker-delete-git-branch
+source: looker-source
+description: |
+  This tool is used to delete a git branch of a LookML
+  project. This only works in dev mode.
+```
+
+## Reference
+
+| **field**   | **type** | **required** | **description**                                    |
+|-------------|:--------:|:------------:|----------------------------------------------------|
+| type        |  string  |     true     | Must be "looker-delete-git-branch".                |
+| source      |  string  |     true     | Name of the source.                                |
+| description |  string  |     true     | Description of the tool that is passed to the LLM. |

docs/en/integrations/looker/tools/looker-get-git-branch.md

@@ -0,0 +1,42 @@
+---
+title: "Get Git Branch Tool"
+type: docs
+weight: 1
+description: >
+  A "looker-get-git-branch" tool is used to retrieve the current git branch of a LookML project.
+---
+
+## About
+
+A `looker-get-git-branch` tool is used to retrieve the current git branch
+of a LookML project.
+
+## Compatible Sources
+
+{{< compatible-sources >}}
+
+## Parameters
+
+| **field**  | **type** | **required** | **description**                           |
+| ---------- | :------: | :----------: | ----------------------------------------- |
+| project_id |  string  |     true     | The unique ID of the LookML project.      |
+
+## Example
+
+```yaml
+kind: tool
+name: get_project_git_branch
+type: looker-get-git-branch
+source: looker-source
+description: |
+  This tool is used to retrieve the current git branch of a LookML
+  project.
+```
+
+## Reference
+
+| **field**   | **type** | **required** | **description**                                    |
+|-------------|:--------:|:------------:|----------------------------------------------------|
+| type        |  string  |     true     | Must be "looker-get-git-branch".                   |
+| source      |  string  |     true     | Name of the source.                                |
+| description |  string  |     true     | Description of the tool that is passed to the LLM. |

docs/en/integrations/looker/tools/looker-git-branch.md

@@ -0,0 +1,42 @@
+---
+title: "List Git Branches Tool"
+type: docs
+weight: 1
+description: >
+  A "looker-list-git-branches" tool is used to retrieve the list of available git branches of a LookML project.
+---
+
+## About
+
+A `looker-list-git-branches` tool is used to retrieve the list of available git branches
+of a LookML project.
+
+## Compatible Sources
+
+{{< compatible-sources >}}
+
+## Parameters
+
+| **field**  | **type** | **required** | **description**                           |
+| ---------- | :------: | :----------: | ----------------------------------------- |
+| project_id |  string  |     true     | The unique ID of the LookML project.      |
+
+## Example
+
+```yaml
+kind: tool
+name: list_project_git_branches
+type: looker-list-git-branches
+source: looker-source
+description: |
+  This tool is used to retrieve the list of available git branches of a LookML
+  project.
+```
+
+## Reference
+
+| **field**   | **type** | **required** | **description**                                    |
+|-------------|:--------:|:------------:|----------------------------------------------------|
+| type        |  string  |     true     | Must be "looker-list-git-branches".                |
+| source      |  string  |     true     | Name of the source.                                |
+| description |  string  |     true     | Description of the tool that is passed to the LLM. |