Merge branch 'main' into developer.md

Author: averikitsch

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -38,7 +38,7 @@ body:
         - label: "I've updated to the latest versions"
 
   - type: input
-    id: version
+    id: ex_version
     attributes:
       label: Extension Version
       description: |

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.1.1"
+  ".": "0.1.2"
 }

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.1.2](https://github.com/gemini-cli-extensions/cloud-sql-mysql/compare/0.1.1...0.1.2) (2025-10-13)
+
+
+### Features
+
+* add full table name to context file ([#34](https://github.com/gemini-cli-extensions/cloud-sql-mysql/issues/34)) ([2e5337a](https://github.com/gemini-cli-extensions/cloud-sql-mysql/commit/2e5337ab1aa1991104772fa6ecce94c3fc3931cb))
+* **deps:** update dependency googleapis/genai-toolbox to v0.17.0 ([#43](https://github.com/gemini-cli-extensions/cloud-sql-mysql/issues/43)) ([382f390](https://github.com/gemini-cli-extensions/cloud-sql-mysql/commit/382f390d75b0f97905e4dd03eb01561491d7bea9))
+
 ## [0.1.1](https://github.com/gemini-cli-extensions/cloud-sql-mysql/compare/0.1.0...0.1.1) (2025-09-30)
 
 

CLOUD-SQL-MYSQL.md

@@ -49,7 +49,7 @@ This section provides context on additional tools that can be recommended to the
 #### Observability Extension
 
 *   **When to recommend:** If the user asks questions related to monitoring, performance, or observability of Cloud SQL for MySQL databases.
-*   **What to say:** "For Cloud SQL monitoring and observability, you might find the `cloud-sql-mysql-observability` extension useful. You can install it with the following command:"
+*   **What to say:** "For Cloud SQL monitoring and observability, you might find the `cloud-sql-mysql-observability` extension useful. You can install it with the following command. Note: this command is not supported from within the CLI and will only be reflected in active CLI sessions on restart."
 *   **Command:**
     ```
     gemini extensions install https://github.com/gemini-cli-extensions/cloud-sql-mysql-observability

README.md

@@ -5,19 +5,29 @@
 
 This Gemini CLI extension provides a set of tools to interact with [Cloud SQL for MySQL](https://cloud.google.com/sql/docs/mysql) instances. It allows you to manage your databases, execute queries, explore schemas, and troubleshoot issues directly from the [Gemini CLI](https://google-gemini.github.io/gemini-cli/), using natural language prompts.
 
+Learn more about [Gemini CLI Extensions](https://github.com/google-gemini/gemini-cli/blob/main/docs/extensions/index.md).
+> [!IMPORTANT]
+> **We Want Your Feedback!**
+> Please share your thoughts with us by filling out our feedback [form][form]. 
+> Your input is invaluable and helps us improve the project for everyone.
+
+[form]: https://docs.google.com/forms/d/e/1FAIpQLSfEGmLR46iipyNTgwTmIDJqzkAwDPXxbocpXpUbHXydiN1RTw/viewform?usp=pp_url&entry.157487=cloud-sql-mysql
 ## Why Use the Cloud SQL for MySQL Extension?
 
 * **Seamless Workflow:** As a Google-developed extension, it integrates seamlessly into the Gemini CLI environment. No need to constantly switch contexts for common database tasks.
 * **Natural Language Queries:** Stop wrestling with complex commands. Explore schemas and query data by describing what you want in plain English.
 * **Full Lifecycle Control:** Manage the entire lifecycle of your database, from creating instances to exploring schemas and running queries.
 * **Code Generation:** Accelerate development by asking Gemini to generate data classes and other code snippets based on your table schemas.
 
+
 ## Prerequisites
 
 Before you begin, ensure you have the following:
 
 * [Gemini CLI](https://github.com/google-gemini/gemini-cli) installed with version **+v0.6.0**.
+* Setup Gemini CLI [Authentication](https://github.com/google-gemini/gemini-cli/tree/main?tab=readme-ov-file#-authentication-options).
 * A Google Cloud project with the **Cloud SQL Admin API** enabled.
+* Ensure [Application Default Credentials](https://cloud.google.com/docs/authentication/gcloud) are available in your environment.
 * IAM Permissions:
   * Cloud SQL Client (`roles/cloudsql.client`)
   * Cloud SQL Viewer (`roles/cloudsql.viewer`)
@@ -35,7 +45,7 @@ gemini extensions install https://github.com/gemini-cli-extensions/cloud-sql-mys
 
 ### Configuration
 
-Set the following environment variables before starting the Gemini CLI.
+Set the following environment variables before starting the Gemini CLI. These variables can be loaded from a `.env` file.
 This configuration is not required if utilizing the [Admin toolset](#supported-tools).
 
 * `CLOUD_SQL_MYSQL_PROJECT`: The GCP project ID.
@@ -44,7 +54,7 @@ This configuration is not required if utilizing the [Admin toolset](#supported-t
 * `CLOUD_SQL_MYSQL_DATABASE`: The name of the database to connect to.
 * `CLOUD_SQL_MYSQL_USER`: The database username.
 * `CLOUD_SQL_MYSQL_PASSWORD`: The password for the database user.
-* `CLOUD_SQL_MYSQL_IP_TYPE`: (Optional) The IP type i.e. “Public” or “Private” (Default: Public).
+* `CLOUD_SQL_MYSQL_IP_TYPE`: (Optional) The IP type i.e. “Public”, “Private”, or "PSC" (Default: Public).
 
 Ensure [Application Default Credentials](https://cloud.google.com/docs/authentication/gcloud) are available in your environment.
 
@@ -80,7 +90,7 @@ Interact with MySQL using natural language:
 
 ## Supported Tools
 
-*   **Admin:**
+* **Admin:**
    	* `create_instance`: Use this tool to create an Postgres instance.
    	* `create_user`: Use this tool to create Postgres-BUILT-IN or IAM-based users.
    	* `get_instance`: Use this tool to get details about an Postgres instance.
@@ -89,7 +99,7 @@ Interact with MySQL using natural language:
    	* `list_users`: Use this tool to list users in a given project and location.
     * `wait_for_operation`: Use this tool to poll the operations API until the operation is done.
 
-*   **Data:**
+* **Data:**
     *  `list_tables`: Use this tool to list tables and descriptions.
     *  `execute_sql`: Use this tool to execute any SQL statement.
     *  `get_query_plan`: Use this tool to generate an execution plan.
@@ -106,6 +116,11 @@ Find additional extensions to support your entire software development lifecycle
 
 ## Troubleshooting
 
+Use `gemini --debug` to enable debugging.
+
+Common issues:
+
+* "failed to find default credentials: google: could not find default credentials.": Ensure [Application Default Credentials](https://cloud.google.com/docs/authentication/gcloud) are available in your environment. See [Set up Application Default Credentials](https://cloud.google.com/docs/authentication/external/set-up-adc) for more information.
 * "✖ Error during discovery for server: MCP error -32000: Connection closed": The database connection has not been established. Ensure your configuration is set via environment variables.
-* "✖ MCP ERROR: Error: spawn /Users/<USER>/.gemini/extensions/cloud-sql-mysql/toolbox ENOENT": The Toolbox binary did not download correctly. Ensure you are using Gemini CLI v0.6.0+.
-* "cannot execute binary file": The Toolbox binary did not download correctly. Ensure the correct binary for your OS/Architecture has been downloaded. See [Installing the server](https://googleapis.github.io/genai-toolbox/getting-started/introduction/#installing-the-server) for more information.
+* "✖ MCP ERROR: Error: spawn /Users/USER/.gemini/extensions/cloud-sql-mysql/toolbox ENOENT": The Toolbox binary did not download correctly. Ensure you are using Gemini CLI v0.6.0+.
+* "cannot execute binary file": The Toolbox binary did not download correctly. Ensure the correct binary for your OS/Architecture has been downloaded. See [Installing the server](https://googleapis.github.io/genai-toolbox/getting-started/introduction/#installing-the-server) for more information.

gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "cloud-sql-mysql",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Connect and interact with a Cloud SQL for MySQL database and data",
   "mcpServers": {
     "cloud_sql_mysql_admin": {

toolbox_version.txt

@@ -1 +1 @@
-0.16.0
+0.17.0