feat(tools/looker): tools to list/create/delete directories

within a LookML project. These tools only work on 26.2 and later.

Author: drstrangelooker

cmd/internal/imports.go

@@ -105,7 +105,9 @@ import (
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookeradddashboardelement"
 	_ "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/lookercreateprojectdirectory"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookercreateprojectfile"
+	_ "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"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookergenerateembedurl"
@@ -122,6 +124,7 @@ import (
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookergetmeasures"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookergetmodels"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookergetparameters"
+	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookergetprojectdirectories"
 	_ "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"

cmd/internal/tools_file_test.go

@@ -1778,7 +1778,7 @@ func TestPrebuiltTools(t *testing.T) {
 			wantToolset: server.ToolsetConfigs{
 				"looker_tools": tools.ToolsetConfig{
 					Name:      "looker_tools",
-					ToolNames: []string{"get_models", "get_explores", "get_dimensions", "get_measures", "get_filters", "get_parameters", "query", "query_sql", "query_url", "get_looks", "run_look", "make_look", "get_dashboards", "run_dashboard", "make_dashboard", "add_dashboard_element", "add_dashboard_filter", "generate_embed_url", "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", "validate_project", "get_connections", "get_connection_schemas", "get_connection_databases", "get_connection_tables", "get_connection_table_columns"},
+					ToolNames: []string{"get_models", "get_explores", "get_dimensions", "get_measures", "get_filters", "get_parameters", "query", "query_sql", "query_url", "get_looks", "run_look", "make_look", "get_dashboards", "run_dashboard", "make_dashboard", "add_dashboard_element", "add_dashboard_filter", "generate_embed_url", "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"},
 				},
 			},
 		},

docs/en/reference/prebuilt-tools.md

@@ -543,6 +543,9 @@ See [Usage Examples](../reference/cli.md#examples).
     *   `create_project_file`: Create a new LookML file.
     *   `update_project_file`: Update an existing LookML file.
     *   `delete_project_file`: Delete a LookML file.
+    *   `get_project_directories`: Retrieves a list of project directories for a given LookML project.
+    *   `create_project_directory`: Creates a new directory within a specified LookML project.
+    *   `delete_project_directory`: Deletes a directory from a specified LookML project.
     *   `validate_project`: Check the syntax of a LookML project.
     *   `get_connections`: Get the available connections in a Looker instance.
     *   `get_connection_schemas`: Get the available schemas in a connection.

docs/en/resources/tools/looker/looker-create-project-directory.md

@@ -0,0 +1,44 @@
+---
+title: "looker-create-project-directory"
+type: docs
+weight: 1
+description: >
+  A "looker-create-project-directory" tool creates a new directory in a LookML project.
+aliases:
+- /resources/tools/looker-create-project-directory
+---
+
+## About
+
+A `looker-create-project-directory` tool creates a new directory within a specified LookML project.
+
+It's compatible with the following sources:
+
+- [looker](../../sources/looker.md)
+
+## Example
+
+```yaml
+kind: tools
+name: looker-create-project-directory
+type: looker-create-project-directory
+source: looker-source
+description: |
+  This tool creates a new directory within a specific LookML project.
+  It is useful for organizing project files.
+
+  Parameters:
+  - project_id (string): The ID of the LookML project.
+  - directory_path (string): The path of the directory to create.
+
+  Output:
+  A string confirming the creation of the directory.
+```
+
+## Reference
+
+| **field**   | **type** | **required** | **description**                                    |
+|-------------|:--------:|:------------:|----------------------------------------------------|
+| type        |  string  |     true     | Must be "looker-create-project-directory".         |
+| source      |  string  |     true     | Name of the source Looker instance.                |
+| description |  string  |     true     | Description of the tool that is passed to the LLM. |

docs/en/resources/tools/looker/looker-delete-project-directory.md

@@ -0,0 +1,44 @@
+---
+title: "looker-delete-project-directory"
+type: docs
+weight: 1
+description: >
+  A "looker-delete-project-directory" tool deletes a directory from a LookML project.
+aliases:
+- /resources/tools/looker-delete-project-directory
+---
+
+## About
+
+A `looker-delete-project-directory` tool deletes a directory from a specified LookML project.
+
+It's compatible with the following sources:
+
+- [looker](../../sources/looker.md)
+
+## Example
+
+```yaml
+kind: tools
+name: looker-delete-project-directory
+type: looker-delete-project-directory
+source: looker-source
+description: |
+  This tool deletes a directory from a specific LookML project.
+  It is useful for removing unnecessary or obsolete directories.
+
+  Parameters:
+  - project_id (string): The ID of the LookML project.
+  - directory_path (string): The path of the directory to delete.
+
+  Output:
+  A string confirming the deletion of the directory.
+```
+
+## Reference
+
+| **field**   | **type** | **required** | **description**                                    |
+|-------------|:--------:|:------------:|----------------------------------------------------|
+| type        |  string  |     true     | Must be "looker-delete-project-directory".         |
+| source      |  string  |     true     | Name of the source Looker instance.                |
+| description |  string  |     true     | Description of the tool that is passed to the LLM. |

docs/en/resources/tools/looker/looker-get-project-directories.md

@@ -0,0 +1,43 @@
+---
+title: "looker-get-project-directories"
+type: docs
+weight: 1
+description: >
+  A "looker-get-project-directories" tool returns the directories within a specific LookML project.
+aliases:
+- /resources/tools/looker-get-project-directories
+---
+
+## About
+
+A `looker-get-project-directories` tool retrieves the directories within a specified LookML project.
+
+It's compatible with the following sources:
+
+- [looker](../../sources/looker.md)
+
+## Example
+
+```yaml
+kind: tools
+name: looker-get-project-directories
+type: looker-get-project-directories
+source: looker-source
+description: |
+  This tool retrieves a list of directories within a specific LookML project.
+  It is useful for exploring the project structure.
+
+  Parameters:
+  - project_id (string): The ID of the LookML project.
+
+  Output:
+  A JSON array of strings, representing the directories within the project.
+```
+
+## Reference
+
+| **field**   | **type** | **required** | **description**                                    |
+|-------------|:--------:|:------------:|----------------------------------------------------|
+| type        |  string  |     true     | Must be "looker-get-project-directories".          |
+| source      |  string  |     true     | Name of the source Looker instance.                |
+| description |  string  |     true     | Description of the tool that is passed to the LLM. |

internal/prebuiltconfigs/tools/looker.yaml

@@ -959,6 +959,48 @@ tools:
           Output:
           A confirmation message upon successful file deletion.
 
+    get_project_directories:
+        kind: looker-get-project-directories
+        source: looker-source
+        description: |
+          This tool retrieves the list of directories within a specified LookML project.
+
+          Parameters:
+          - project_id (required): The unique ID of the LookML project.
+
+          Output:
+          A JSON array of strings, where each string is the name of a directory within the project.
+
+    create_project_directory:
+        kind: looker-create-project-directory
+        source: looker-source
+        description: |
+          This tool creates a new directory within a specified LookML project.
+
+          Prerequisite: The Looker session must be in Development Mode. Use `dev_mode: true` first.
+
+          Parameters:
+          - project_id (required): The unique ID of the LookML project.
+          - directory_path (required): The path to the new directory within the project.
+
+          Output:
+          A confirmation message upon successful directory creation.
+
+    delete_project_directory:
+        kind: looker-delete-project-directory
+        source: looker-source
+        description: |
+          This tool permanently deletes a specified directory within a LookML project.
+
+          Prerequisite: The Looker session must be in Development Mode. Use `dev_mode: true` first.
+
+          Parameters:
+          - project_id (required): The unique ID of the LookML project.
+          - directory_path (required): The path to the directory within the project.
+
+          Output:
+          A confirmation message upon successful directory deletion.
+
     validate_project:
         kind: looker-validate-project
         source: looker-source
@@ -1087,6 +1129,9 @@ toolsets:
         - 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

internal/tools/looker/lookercommon/lookercommon.go

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -301,3 +301,32 @@ func UpdateProjectFile(l *v4.LookerSDK, projectId string, fileContent FileConten
 	err := l.AuthSession.Do(nil, "PUT", "/4.0", path, nil, fileContent, options)
 	return err
 }
+
+func GetProjectDirectories(l *v4.LookerSDK, projectId string, options *rtl.ApiSettings) (string, error) {
+	var result string
+	path := fmt.Sprintf("/projects/%s/directories", url.PathEscape(projectId))
+	err := l.AuthSession.Do(&result, "GET", "/4.0", path, nil, nil, options)
+	return result, err
+}
+
+type Directory struct {
+	Path string `json:"path"`
+}
+
+func CreateProjectDirectory(l *v4.LookerSDK, projectId string, directoryPath string, options *rtl.ApiSettings) error {
+	d := Directory{
+		Path: directoryPath,
+	}
+	var result string
+	path := fmt.Sprintf("/projects/%s/directories", url.PathEscape(projectId))
+	return l.AuthSession.Do(&result, "POST", "/4.0", path, nil, d, options)
+}
+
+func DeleteProjectDirectory(l *v4.LookerSDK, projectId string, directoryPath string, options *rtl.ApiSettings) error {
+	var query = map[string]any{
+		"path": directoryPath,
+	}
+	var result string
+	path := fmt.Sprintf("/projects/%s/directories", url.PathEscape(projectId))
+	return l.AuthSession.Do(&result, "DELETE", "/4.0", path, query, nil, options)
+}