Upload folder using huggingface_hub

.gemini/extensions/vertex/commands/vertex/analyze_data_driven_optimize_results.toml

@@ -0,0 +1,21 @@
+name = "analyze_data_driven_optimize_results"
+description = "Analyzes the output of a Data-Driven Optimize job and saves the results."
+prompt = """
+You are tasked with generating parameters for a `prompt_optimizer.analyzer.analyze_results` tool call.
+
+**Parameters:**
+
+1.  **`output_path` (string, required):**
+    *   **Source:** The GCS, Google Drive, or local path containing the job results. This is usually provided by the user.
+
+2.  **`analysis_data_path` (string, optional):**
+    *   **Default:** "analysis_data.json"
+    *   **Source:** The local path where the analysis metadata will be saved.
+
+3.  **`top_n_prompts` (integer, optional):**
+    *   **Default:** 10
+    *   **Source:** The number of top-performing prompts to include in the analysis.
+
+**Workflow Integration:**
+Refer to the "Analysis and Suggestions" workflow in `GEMINI.md`. This tool is the first step in a chain that includes formulating suggestions and generating an HTML report.
+"""

.gemini/extensions/vertex/commands/vertex/create_prompt.toml

@@ -0,0 +1,28 @@
+name = "create_prompt"
+description = "Writes generated prompt content, system instructions, and specified model information to Vertex AI Prompt Management."
+prompt = """
+You are tasked with generating parameters for a `create_prompt` SDK API call to Vertex AI Prompt Management.
+
+**Parameters for the `create_prompt` function:**
+
+1.  **`project_id` (string, optional):**
+    *   **Source:** If the user explicitly provides a 'project_id' in the conversation, use that. Otherwise, **do not ask the user for it**. The underlying Python tool will handle defaulting to the `GOOGLE_CLOUD_PROJECT` environment variable.
+
+2.  **`location_id` (string, optional):**
+    *   **Source:** If the user explicitly provides a 'location_id' in the conversation, use that. Otherwise, **do not ask the user for it**. The underlying Python tool defaults to "us-central1" or uses `GOOGLE_CLOUD_LOCATION`.
+
+3.  **`content` (string, required):**
+    *   **Source:** Refer to the "Detailed Instructions for `create_prompt` Parameters" section in `GEMINI.md` for how to source the `content` argument.
+
+4.  **`system_instruction` (string, required):**
+    *   **Source:** Refer to the "Detailed Instructions for `create_prompt` Parameters" section in `GEMINI.md` for how to source the `system_instruction` argument.
+
+5.  **`model` (string, required):**
+    *   **Source:** Refer to the "Detailed Instructions for `create_prompt` Parameters" section in `GEMINI.md` for how to source the `model` argument.
+
+6.  **`display_name` (string, optional):**
+    *   **Source:** Refer to the "Detailed Instructions for `create_prompt` Parameters" section in `GEMINI.md` for how to source the `display_name` argument.
+
+**Clarification Policy:**
+If any required information (`content`, `system_instruction`, `model`, or `display_name` when not already set) is missing or ambiguous based on the current context, you *must* ask the user for clarification before proceeding with the `create_prompt` call.
+"""

.gemini/extensions/vertex/commands/vertex/delete_prompt.toml

@@ -0,0 +1,19 @@
+name = "delete_prompt"
+description = "Deletes a prompt in Vertex AI Prompt Management."
+prompt = """
+You are tasked with generating parameters for a `delete_prompt` SDK API call to Vertex AI Prompt Management.
+
+**Parameters for the `delete_prompt` function:**
+
+1.  **`prompt_id` (string, required):**
+    *   **Source:** Must be explicitly requested from the user. If not provided, you *must* ask the user for the prompt ID.
+
+2.  **`project_id` (string, optional):**
+    *   **Source:** If the user explicitly provides a 'project_id' in the conversation, use that. Otherwise, **do not ask the user for it**. The underlying Python tool will handle defaulting to the `GOOGLE_CLOUD_PROJECT` environment variable.
+
+3.  **`location_id` (string, optional):**
+    *   **Source:** If the user explicitly provides a 'location_id' in the conversation, use that. Otherwise, **do not ask the user for it**. The underlying Python tool defaults to "us-central1" or uses `GOOGLE_CLOUD_LOCATION`.
+
+**Clarification Policy:**
+If the `prompt_id` is missing, you *must* ask the user for clarification before proceeding with the `delete_prompt` call.
+"""

.gemini/extensions/vertex/commands/vertex/generate_html_report.toml

@@ -0,0 +1,23 @@
+name = "generate_html_report"
+description = "Generates a comprehensive HTML report from Data-Driven Optimize analysis results."
+prompt = """
+You are tasked with generating parameters for a `prompt_optimizer.analyzer.generate_report` tool call.
+
+**Parameters:**
+
+1.  **`analysis_data_path` (string, required):**
+    *   **Source:** The path to the JSON file generated by `analyze_results`.
+
+2.  **`report_path` (string, optional):**
+    *   **Default:** "data_driven_optimize_analysis_report.html"
+    *   **Source:** The path where the HTML report will be saved.
+
+3.  **`suggested_config_data` (object, optional):**
+    *   **Source:** A dictionary containing `"suggested_config"` (modifications) and `"rationale"`. You must formulate this based on the `analysis_data` from the previous step using the guidelines in `src/vertex/prompt_optimizer/docs/data_driven_optimize_tuning_guide.md`.
+
+4.  **`top_n_prompts` (integer, optional):**
+    *   **Default:** 10
+
+**Workflow Integration:**
+Refer to the "Analysis and Suggestions" workflow in `GEMINI.md`. This tool is the final step in the analysis chain.
+"""

.gemini/extensions/vertex/commands/vertex/list_prompts.toml

@@ -0,0 +1,19 @@
+name = "list_prompts"
+description = "List Vertex AI prompts, optionally filtered by display name."
+prompt = """
+You are tasked with generating parameters for an `list_prompts` SDK API call to Vertex AI Prompt Management.
+
+**Parameters for the `list_prompts` function:**
+
+1.  **`display_name` (string, optional):**
+    *   **Source:** User's input for the display name to filter by.
+
+2.  **`page_size` (int, optional):**
+    *   **Source:** The user's input for the maximum number of prompts to return. Defaults to 10.
+
+3.  **`project_id` (string, optional):**
+    *   **Source:** If the user explicitly provides a 'project_id' in the conversation, use that. Otherwise, **do not ask the user for it**. The underlying Python tool will handle defaulting to the `GOOGLE_CLOUD_PROJECT` environment variable.
+
+4.  **`location_id` (string, optional):**
+    *   **Source:** If the user explicitly provides a 'location_id' in the conversation, use that. Otherwise, **do not ask the user for it**. The underlying Python tool defaults to "us-central1" or uses `GOOGLE_CLOUD_LOCATION`.
+"""

.gemini/extensions/vertex/commands/vertex/read_prompt.toml

@@ -0,0 +1,19 @@
+name = "read_prompt"
+description = "Read the prompt content with given prompt id from Vertex AI Prompt Management."
+prompt = """
+You are tasked with generating parameters for a `read_prompt` SDK API call to Vertex AI Prompt Management.
+
+**Parameters for the `read_prompt` function:**
+
+1.  **`prompt_id` (string, required):**
+    *   **Source:** Must be explicitly requested from the user. If not provided, you *must* ask the user for the prompt ID.
+
+2.  **`project_id` (string, optional):**
+    *   **Source:** If the user explicitly provides a 'project_id' in the conversation, use that. Otherwise, **do not ask the user for it**. The underlying Python tool will handle defaulting to the `GOOGLE_CLOUD_PROJECT` environment variable.
+
+3.  **`location_id` (string, optional):**
+    *   **Source:** If the user explicitly provides a 'location_id' in the conversation, use that. Otherwise, **do not ask the user for it**. The underlying Python tool defaults to "us-central1" or uses `GOOGLE_CLOUD_LOCATION`.
+
+**Clarification Policy:**
+If the `prompt_id` is missing, you *must* ask the user for clarification before proceeding with the `read_prompt` call.
+"""

.gemini/extensions/vertex/commands/vertex/run_data_driven_optimize.toml

@@ -0,0 +1,23 @@
+name = "run_data_driven_optimize"
+description = "Starts a data-driven prompt optimization job on Vertex AI."
+prompt = """
+You are tasked with generating parameters for a `run_data_driven_optimize` tool call.
+
+**Parameters:**
+
+1.  **`config_gcs_path` (string, required):**
+    *   **Source:** The GCS URI to the configuration JSON file.
+
+2.  **`service_account` (string, required):**
+    *   **Source:** The service account email to run the job (typically `{project_number}-compute@developer.gserviceaccount.com`). Ask the user if not known.
+
+3.  **`prompt_optimizer_method` (string, required):**
+    *   **Source:** The method for prompt optimization. Either "VAPO" or "OPTIMIZATION_TARGET_GEMINI_NANO".
+
+4.  **`wait_for_completion` (boolean, optional):**
+    *   **Default:** false
+    *   **Source:** Whether to block until the job completes.
+
+**Clarification Policy:**
+If `config_gcs_path`, `service_account` or `prompt_optimizer_method` is missing, ask the user for it.
+"""

.gemini/extensions/vertex/commands/vertex/run_few_shot_prompt_optimization.toml

@@ -0,0 +1,18 @@
+name = "run_few_shot_prompt_optimization"
+description = "Optimize a prompt based on few examples using few-shot optimization from Vertex AI SDK."
+prompt = """
+You are tasked to call `run_few_shot_prompt_optimization` tool call.
+
+**Parameters:**
+
+1. **`prompt_to_optimize` (string, required):**
+    *   **Source:** Prompt (or system instructions) that will be optimized.
+2. **`example_path` (string, required):**
+    *   **Source:** The GCS URI to the CSV file containing examples
+3. **`method:` (string, required):** 
+    *   **Source:** The method for prompt optimization. Either "TARGET_RESPONSE" or "RUBRICS"
+
+
+**Clarification Policy:**
+If `prompt_to_optimize`, `example_path` or `method` is missing, ask the user for it.
+"""

.gemini/extensions/vertex/commands/vertex/update_prompt.toml

@@ -0,0 +1,33 @@
+name = "update_prompt"
+description = "Updates a prompt in Vertex AI Prompt Management with new content, system instructions, model, or display name."
+prompt = """
+You are tasked with generating parameters for an `update_prompt` SDK API call to Vertex AI Prompt Management.
+
+**Parameters for the `update_prompt` function:**
+
+1.  **`prompt_id` (string, required):**
+    *   **Source:** Must be explicitly requested from the user. If not provided, you *must* ask the user for the prompt ID.
+
+2.  **`project_id` (string, optional):**
+    *   **Source:** If the user explicitly provides a 'project_id' in the conversation, use that. Otherwise, **do not ask the user for it**. The underlying Python tool will handle defaulting to the `GOOGLE_CLOUD_PROJECT` environment variable.
+
+3.  **`location_id` (string, optional):**
+    *   **Source:** If the user explicitly provides a 'location_id' in the conversation, use that. Otherwise, **do not ask the user for it**. The underlying Python tool defaults to "us-central1" or uses `GOOGLE_CLOUD_LOCATION`.
+
+4.  **`content` (string, optional):**
+    *   **Source:** The user's input for the new prompt content.
+
+5.  **`system_instruction` (string, optional):**
+    *   **Source:** The user's input for the new system instruction.
+
+6.  **`model` (string, optional):**
+    *   **Source:** The user's input for the new model.
+
+7.  **`display_name` (string, optional):**
+    *   **Source:** The user's input for the new display name.
+
+**Clarification Policy:**
+# If the `prompt_id` is missing, you *must* ask the user for clarification before proceeding with the `update_prompt` call.
+
+# - If the user provides a display name in the initial request without an ID, the agent should first call 'list_prompts'.
+"""

.gemini/extensions/vertex/commands/vertex/write_data_driven_optimize_config.toml

@@ -0,0 +1,28 @@
+name = "write_data_driven_optimize_config"
+description = "Constructs and uploads a Data-Driven Optimize configuration file to GCS."
+prompt = """
+You are tasked with generating parameters for a `prompt_optimizer.config.write_config` tool call.
+
+**Parameters:**
+
+1.  **`gcs_config_uri` (string, required):**
+    *   **Source:** The destination GCS URI for the config file.
+
+2.  **`prompt_optimizer_method` (string, required):**
+    *   **Source:** The method for prompt optimization. Either "VAPO" or "OPTIMIZATION_TARGET_GEMINI_NANO". If "VAPO", `batch_size` will be automatically removed from the config.
+
+3.  **`target_model_endpoint_url` (string, optional):**
+    *   **Source:** The custom endpoint URL for the target model. This is required ONLY for the Gemini Nano optimization target.
+
+4.  **`base_config` (object, optional):**
+    *   **Source:** A dictionary representing the base configuration.
+
+5.  **`modifications` (object, optional):**
+    *   **Source:** A dictionary of modifications to apply to the JSON configuration file. Only allowed tuning knobs (from `src/vertex/prompt_optimizer/docs/data_driven_optimize_tuning_guide.md`) and path-related fields should be included. Do NOT include tool-level parameters like `prompt_optimizer_method` here.
+
+6.  **`base_config_path` (string, optional):**
+    *   **Source:** A GCS path to an existing config file to use as a base.
+
+**Clarification Policy:**
+If `gcs_config_uri` or `prompt_optimizer_method` is missing, ask the user for it.
+"""