feat: Propagate application_name set for the BigQuery Tools as BigQuery job labels

This change will help the tools user identify per agent job usage in BQ console and INFORMATION_SCHEMA views. This change fulfills the feature request #3582. Here is a demo after change: screen/C6YB4ge2FM2ZREi. PiperOrigin-RevId: 834480140
fix: Change name for builder agent
2026-07-09 18:19:28 -07:00 · 2025-11-19 16:02:32 -08:00 · 2025-11-19 16:00:51 -08:00 · 2025-11-19 15:12:48 -08:00 · 2025-11-19 12:28:52 -08:00 · 2025-11-19 11:37:29 -08:00
468 changed files with 38335 additions and 7405 deletions
@@ -19,7 +19,7 @@ Steps to reproduce the behavior:
 1. Install '...'
 2. Run '....'
 3. Open '....'
-4. Provie error or stacktrace
+4. Provide error or stacktrace

 **Expected behavior**
 A clear and concise description of what you expected to happen.
@@ -0,0 +1,52 @@
+**Please ensure you have read the [contribution guide](https://github.com/google/adk-python/blob/main/CONTRIBUTING.md) before creating a pull request.**
+
+### Link to Issue or Description of Change
+
+**1. Link to an existing issue (if applicable):**
+
+- Closes: #_issue_number_
+- Related: #_issue_number_
+
+**2. Or, if no issue exists, describe the change:**
+
+_If applicable, please follow the issue templates to provide as much detail as
+possible._
+
+**Problem:**
+_A clear and concise description of what the problem is._
+
+**Solution:**
+_A clear and concise description of what you want to happen and why you choose
+this solution._
+
+### Testing Plan
+
+_Please describe the tests that you ran to verify your changes. This is required
+for all PRs that are not small documentation or typo fixes._
+
+**Unit Tests:**
+
+- [ ] I have added or updated unit tests for my change.
+- [ ] All unit tests pass locally.
+
+_Please include a summary of passed `pytest` results._
+
+**Manual End-to-End (E2E) Tests:**
+
+_Please provide instructions on how to manually test your changes, including any
+necessary setup or configuration. Please provide logs or screenshots to help
+reviewers better understand the fix._
+
+### Checklist
+
+- [ ] I have read the [CONTRIBUTING.md](https://github.com/google/adk-python/blob/main/CONTRIBUTING.md) document.
+- [ ] I have performed a self-review of my own code.
+- [ ] I have commented my code, particularly in hard-to-understand areas.
+- [ ] I have added tests that prove my fix is effective or that my feature works.
+- [ ] New and existing unit tests pass locally with my changes.
+- [ ] I have manually tested my changes end-to-end.
+- [ ] Any dependent changes have been merged and published in downstream modules.
+
+### Additional context
+
+_Add any other context or screenshots about the feature request here._
@@ -89,7 +89,7 @@ jobs:
      - name: Check for import from cli package in certain changed Python files
        run: |
          git fetch origin ${{ github.base_ref }}
-          CHANGED_FILES=$(git diff --diff-filter=ACMR --name-only origin/${{ github.base_ref }}...HEAD | grep -E '\.py$' | grep -v -E 'cli/.*|tests/.*|contributing/samples/' || true)
+          CHANGED_FILES=$(git diff --diff-filter=ACMR --name-only origin/${{ github.base_ref }}...HEAD | grep -E '\.py$' | grep -v -E 'cli/.*|src/google/adk/tools/apihub_tool/apihub_toolset.py|tests/.*|contributing/samples/' || true)
          if [ -n "$CHANGED_FILES" ]; then
            echo "Changed Python files to check:"
            echo "$CHANGED_FILES"
@@ -0,0 +1,134 @@
+name: Copybara PR Handler
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+    inputs:
+      pr_number:
+        description: 'PR number to close (for testing)'
+        required: true
+        type: string
+      commit_sha:
+        description: 'Commit SHA reference (optional, for testing)'
+        required: false
+        type: string
+
+jobs:
+  close-imported-pr:
+    runs-on: ubuntu-latest
+    permissions:
+      pull-requests: write
+      issues: write
+      contents: read
+
+    steps:
+      - name: Check for Copybara commits and close PRs
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.ADK_TRIAGE_AGENT }}
+          script: |
+            // Check if this is a manual test run
+            const isManualRun = context.eventName === 'workflow_dispatch';
+
+            let prsToClose = [];
+
+            if (isManualRun) {
+              // Manual testing mode
+              const prNumber = parseInt(context.payload.inputs.pr_number);
+              const commitSha = context.payload.inputs.commit_sha || context.sha.substring(0, 7);
+
+              console.log('=== MANUAL TEST MODE ===');
+              console.log(`Testing with PR #${prNumber}, commit ${commitSha}`);
+
+              prsToClose.push({ prNumber, commitSha });
+            } else {
+              // Normal mode: process commits from push event
+              const commits = context.payload.commits || [];
+              console.log(`Found ${commits.length} commit(s) in this push`);
+
+              // Process each commit
+              for (const commit of commits) {
+                const sha = commit.id;
+                const committer = commit.committer.name;
+                const message = commit.message;
+
+                console.log(`\n--- Processing commit ${sha.substring(0, 7)} ---`);
+                console.log(`Committer: ${committer}`);
+
+                // Check if this is a Copybara commit
+                if (committer !== 'Copybara-Service') {
+                  console.log('Not a Copybara commit, skipping');
+                  continue;
+                }
+
+                // Extract PR number from commit message
+                // Pattern: "Merge https://github.com/google/adk-python/pull/3333"
+                const prMatch = message.match(/Merge https:\/\/github\.com\/google\/adk-python\/pull\/(\d+)/);
+
+                if (!prMatch) {
+                  console.log('No PR number found in Copybara commit message');
+                  continue;
+                }
+
+                const prNumber = parseInt(prMatch[1]);
+                const commitSha = sha.substring(0, 7);
+
+                prsToClose.push({ prNumber, commitSha });
+              }
+            }
+
+            // Process PRs to close
+            for (const { prNumber, commitSha } of prsToClose) {
+              console.log(`\n--- Processing PR #${prNumber} ---`);
+
+              // Get PR details to check if it's open
+              let pr;
+              try {
+                pr = await github.rest.pulls.get({
+                  owner: context.repo.owner,
+                  repo: context.repo.repo,
+                  pull_number: prNumber
+                });
+              } catch (error) {
+                console.log(`PR #${prNumber} not found or inaccessible:`, error.message);
+                continue;
+              }
+
+              // Only close if PR is still open
+              if (pr.data.state !== 'open') {
+                console.log(`PR #${prNumber} is already ${pr.data.state}, skipping`);
+                continue;
+              }
+
+              const author = pr.data.user.login;
+
+              try {
+                // Add comment with commit reference
+                await github.rest.issues.createComment({
+                  owner: context.repo.owner,
+                  repo: context.repo.repo,
+                  issue_number: prNumber,
+                  body: `Thank you @${author} for your contribution! 🎉\n\nYour changes have been successfully imported and merged via Copybara in commit ${commitSha}.\n\nClosing this PR as the changes are now in the main branch.`
+                });
+
+                // Close the PR
+                await github.rest.pulls.update({
+                  owner: context.repo.owner,
+                  repo: context.repo.repo,
+                  pull_number: prNumber,
+                  state: 'closed'
+                });
+
+                console.log(`Successfully closed PR #${prNumber}`);
+              } catch (error) {
+                console.log(`Error closing PR #${prNumber}:`, error.message);
+              }
+            }
+
+            if (isManualRun) {
+              console.log('\n=== TEST COMPLETED ===');
+            } else {
+              console.log('\n--- Finished processing all commits ---');
+            }
@@ -98,3 +98,20 @@ Thumbs.db
 *.bak
 *.tmp
 *.temp
+
+# AI Coding Tools - Project-specific configs
+# Developers should symlink or copy AGENTS.md and add their own overrides locally
+.claude/
+CLAUDE.md
+.cursor/
+.cursorrules
+.cursorignore
+.windsurfrules
+.aider*
+.continue/
+.codeium/
+.githubnext/
+.roo/
+.rooignore
+.bolt/
+.v0/
@@ -1,5 +1,191 @@
 # Changelog

+## [1.18.0](https://github.com/google/adk-python/compare/v1.17.0...v1.18.0) (2025-11-05)
+
+### Features
+
+* **[ADK Visual Agent Builder]**
+  * Core Features
+    * Visual workflow designer for agent creation
+    * Support for multiple agent types (LLM, Sequential, Parallel, Loop, Workflow)
+    * Agent tool support with nested agent tools
+    * Built-in and custom tool integration
+    * Callback management for all ADK callback types (before/after agent, model, tool)
+    * Assistant to help you build your agents with natural language
+    * Assistant proposes and writes agent configuration yaml files for you
+    * Save to test with chat interfaces as normal
+    * Build and debug at the same time in adk web!
+
+* **[Core]**
+  * Add support for extracting cache-related token counts from LiteLLM usage ([4f85e86](https://github.com/google/adk-python/commit/4f85e86fc3915f0e67312a39fe22451968d4f1b1))
+  * Expose the Python code run by the code interpreter in the logs ([a2c6a8a](https://github.com/google/adk-python/commit/a2c6a8a85cf4f556e9dacfe46cf384d13d964208))
+  * Add run_debug() helper method for quick agent experimentation ([0487eea](https://github.com/google/adk-python/commit/0487eea2abcd05d7efd123962d17b8c6c9a9d975))
+  * Allow injecting a custom Runner into `agent_to_a2a` ([156d235](https://github.com/google/adk-python/commit/156d23547915e8f7f5c6ba55e0362f4b133c3968))
+  * Support MCP prompts via the McpInstructionProvider class ([88032cf](https://github.com/google/adk-python/commit/88032cf5c56bb2d81842353605f9f5ab4b2206ff))
+
+* **[Models]**
+  * Add model tracking to LiteLlm and introduce a LiteLLM with fallbacks demo ([d4c63fc](https://github.com/google/adk-python/commit/d4c63fc5629e7d70ad8b8185be09243a01e3428f))
+  * Add ApigeeLlm as a model that lets ADK Agent developers to connect with an Apigee proxy ([87dcb3f](https://github.com/google/adk-python/commit/87dcb3f7ba344a2ba7d9edfc4817c9e792d90bfc))
+
+* **[Integrations]**
+  * Add example and fix for loading and upgrading old ADK session databases ([338c3c8](https://github.com/google/adk-python/commit/338c3c89c6bce7f3406f729013cedcd78b809a56))
+  * Add support for specifying logging level for adk eval cli command ([b1ff85f](https://github.com/google/adk-python/commit/b1ff85fb2347e3402eedd42e3673be7093a99548))
+  * Propagate LiteLLM finish_reason to LlmResponse for use in callbacks ([71aa564](https://github.com/google/adk-python/commit/71aa5645f6c3d91fd0e0ddb1ed564188c6727080))
+  * Allow LLM request to override the model used in the generate content async method in LiteLLM ([ce8f674](https://github.com/google/adk-python/commit/ce8f674a287368439ba11be3285902671e9bc75a))
+  * Add api key argument to Vertex Session and Memory services for Express Mode support ([9014a84](https://github.com/google/adk-python/commit/9014a849eab9f77b82db4a7f2053fb2a96282f03))
+  * Added support for enums as arguments for function tools ([240ef5b](https://github.com/google/adk-python/commit/240ef5beea9389911e8c03a6039b353befc716ac))
+  * Implement artifact_version related methods in GcsArtifactService ([e194ebb](https://github.com/google/adk-python/commit/e194ebb33c62bc40403ea852a88f77a9511b61a4))
+
+* **[Services]**
+  * Add support for Vertex AI Express Mode when deploying to Agent Engine ([d4b2a8b](https://github.com/google/adk-python/commit/d4b2a8b49f98a9991cb44ac7ec6e538b81a08664))
+  * Remove custom polling logic for Vertex AI Session Service since LRO polling is supported in express mode ([546c2a6](https://github.com/google/adk-python/commit/546c2a68165f54e694664d5b6b6740566301782b))
+  * Make VertexAiSessionService fully asynchronous ([f7e2a7a](https://github.com/google/adk-python/commit/f7e2a7a40ef248dd6fbba9669503b0828a12f0cc))
+
+* **[Tools]**
+  * Add Bigquery detect_anomalies tool ([9851340](https://github.com/google/adk-python/commit/9851340ad1df86d6f5c21e8984199573f239bb2b))
+  * Extend Bigquery detect_anomalies tool to support future data anomaly detection ([38ea749](https://github.com/google/adk-python/commit/38ea749c9cec8e65f5e768f49fd2de79b5545571))
+  * Add get_job_info tool to BigQuery toolset ([6429457](https://github.com/google/adk-python/commit/64294572c1c93590aa3c221015a5cb9b440ee948))
+
+* **[Evals]**
+  * Add "final_session_state" to the EvalCase data model ([2274c4f](https://github.com/google/adk-python/commit/2274c4f3040b20da3690aa03272155776ca330c1))
+  * Marked expected_invocation as optional field on evaluator interface ([b17c8f1](https://github.com/google/adk-python/commit/b17c8f19e5fc67180d1bdc621f84cd43e357571c))
+  * Adds LLM-backed user simulator ([54c4ecc](https://github.com/google/adk-python/commit/54c4ecc73381cffa51cff01c7fb8a2ac59308c53))
+
+* **[Observability]**
+  * Add BigQueryLoggingPlugin for event logging to BigQuery ([b7dbfed](https://github.com/google/adk-python/commit/b7dbfed4a3d4a0165e2c6e51594d1f547bec89d3))
+
+* **[Live]**
+  * Add token usage to live events for bidi streaming ([6e5c0eb](https://github.com/google/adk-python/commit/6e5c0eb6e0474f5b908eb9df20328e7da85ebed9))
+
+### Bug Fixes
+
+* Reduce logging spam for MCP tools without authentication ([11571c3](https://github.com/google/adk-python/commit/11571c37ab948d43cbaa3a1d82522256dfe4d467))
+* Fix typo in several files ([d2888a3](https://github.com/google/adk-python/commit/d2888a3766b87df2baaaa1a67a2235b1b80f138f))
+* Disable SetModelResponseTool workaround for Vertex AI Gemini 2+ models ([6a94af2](https://github.com/google/adk-python/commit/6a94af24bf3367c05a5d405b7e7b79810a1fac4e))
+* Bug when callback_context_invocation_context is missing in GlobalInstructionPlugin ([f81ebdb](https://github.com/google/adk-python/commit/f81ebdb622211031945eb06c3f00ff5208d94f9b))
+* Support models slash prefix in model name extraction ([8dff850](https://github.com/google/adk-python/commit/8dff85099d67623dd6f4a707fb932ea55b8aaf9b))
+* Do not consider events with state delta and no content as final response ([1ee93c8](https://github.com/google/adk-python/commit/1ee93c8bcb7ccd6f33658dc76b2095dd7e58aac9))
+* Parameter filtering for CrewAI functions with **kwargs ([74a3500](https://github.com/google/adk-python/commit/74a3500fc5d4b07e80f914d83a0d91face28086c))
+* Do not treat FinishReason.STOP as error case for LLM responses containing candidates with empty contents ([2f72ceb](https://github.com/google/adk-python/commit/2f72ceb49b452c5a1f257bce6adb004fa5d54472))
+* Fixes null check for reflect_retry plugin sample ([86f0155](https://github.com/google/adk-python/commit/86f01550bd1b52d6d160e8bc54cecc6c4fe8611c))
+* Creates evalset directory on evalset create ([6c3882f](https://github.com/google/adk-python/commit/6c3882f2d66f169d393171be280b6e6218b52a7c))
+* Add ADK_DISABLE_LOAD_DOTENV environment variable that disables automatic loading of .env when running ADK cli, if set to true or 1 ([15afbcd](https://github.com/google/adk-python/commit/15afbcd1587d4102a4dc5c07c0c493917df9d6ea))
+* Allow tenacity 9.0.0 ([ee8acc5](https://github.com/google/adk-python/commit/ee8acc58be7421a3e8eab07b051c45f9319f80dc))
+* Output file uploading to artifact service should handle both base64 encoded and raw bytes ([496f8cd](https://github.com/google/adk-python/commit/496f8cd6bb36d3ba333d7ab1e94e7796d2960300))
+* Correct message part ordering in A2A history ([5eca72f](https://github.com/google/adk-python/commit/5eca72f9bfd05c7c28a3d738391138a59a31167d))
+* Change instruction insertion to respect tool call/response pairs ([1e6a9da](https://github.com/google/adk-python/commit/1e6a9daa63050936ab421f1f684935927aebc63e))
+* DynamicPickleType to support MySQL dialect ([fc15c9a](https://github.com/google/adk-python/commit/fc15c9a0c3c043c0a61dce625b8cd1ee121b4baf))
+* Enable usage metadata in LiteLLM streaming ([f9569bb](https://github.com/google/adk-python/commit/f9569bbb1afbc7f0e8b6e68599590471fd112b9f))
+* Fix issue with MCP tools throwing an error ([1a4261a](https://github.com/google/adk-python/commit/1a4261ad4b66cdeb39d39110a086bd6112b17516))
+* Remove redundant `format` field from LiteLLM content objects ([489c39d](https://github.com/google/adk-python/commit/489c39db01465e38ecbc2c7f32781c349b8cddc9))
+* Update the contribution analysis tool to use original write mode ([54db3d4](https://github.com/google/adk-python/commit/54db3d4434e0706b83a589fa2499d11d439a6e4e))
+* Fix agent evaluations detailed output rows wrapping issue([4284c61](https://github.com/google/adk-python/commit/4284c619010b8246c1ecaa011f14b6cc9de512dd))
+* Update dependency version constraints to be based on PyPI versions([0b1784e](https://github.com/google/adk-python/commit/0b1784e0e493a0e2df1edfe37e5ed5f4247e7d9d))
+
+### Improvements
+
+* Add Community Repo section to README ([432d30a](https://github.com/google/adk-python/commit/432d30af486329aa83f89c5d5752749a85c0b843))
+* Undo adding MCP tools output schema to FunctionDeclaration ([92a7d19](https://github.com/google/adk-python/commit/92a7d1957367d498de773761edd142d8c108d751))
+* Refactor ADK README for clarity and consistency ([b0017ae](https://github.com/google/adk-python/commit/b0017aed4472c73c3b07e71f1d65ae97a5293547))
+* Add support for reversed proxy in adk web ([a0df75b](https://github.com/google/adk-python/commit/a0df75b6fa35d837086decb8802dbf1c0a6637ad))
+* Avoid rendering empty columns as part of detailed results rendering of eval results ([5cb35db](https://github.com/google/adk-python/commit/5cb35db921bf86b5ad0012046bd19fa7cc1e6abb))
+* Clear the behavior of disallow_transfer_to_parent ([48ddd07](https://github.com/google/adk-python/commit/48ddd078941f9240b10f052b6de171c310bc2bc6))
+* Disable the scheduled execution for issue triage workflow ([a02f321](https://github.com/google/adk-python/commit/a02f321f1bdb8be9ad1873db804e0e8393268dc3))
+* Include delimiter when matching events from parent nodes in content processor ([b8a2b6c](https://github.com/google/adk-python/commit/b8a2b6c57080ae29d7a02df7d9fcc2f961d422d2))
+* Improve Tau-bench ADK colab stability ([04dbc42](https://github.com/google/adk-python/commit/04dbc42e50ce40ef3924d1c259e425215e12c2e7))
+* Implement ADK-based agent factory for Tau-bench ([c0c67c8](https://github.com/google/adk-python/commit/c0c67c8698d70ddb9ed958416661f232ef9a5ed8))
+* Add util to run ADK LLM Agent with simulation environment ([87f415a](https://github.com/google/adk-python/commit/87f415a7c36a1f3b6ab84d1fe939726c6ef7f34e))
+* Demonstrate CodeExecutor customization for environment setup ([8eeff35](https://github.com/google/adk-python/commit/8eeff35b35d7e1538a5c9662cc8369f6ff7962f8))
+* Add sample agent for VertexAiCodeExecutor ([edfe553](https://github.com/google/adk-python/commit/edfe5539421d196ca4da14d3a37fac7b598f8c8d))
+* Adds a new sample agent that demonstrates how to integrate PostgreSQL databases using the Model Context Protocol (MCP) ([45a2168](https://github.com/google/adk-python/commit/45a2168e0e6773e595ecfb825d7e4ab0a38c3a38))
+* Add example for using ADK with Fast MCP sampling ([d3796f9](https://github.com/google/adk-python/commit/d3796f9b33251d28d05e6701f11e80f02a2a49e1))
+* Refactor gepa sample code and clean-up user demo colab([63353b2](https://github.com/google/adk-python/commit/63353b2b74e23e97385892415c5a3f2a59c3504f))
+
+## [1.17.0](https://github.com/google/adk-python/compare/v1.16.0...v1.17.0) (2025-10-22)
+
+### Features
+
+* **[Core]**
+  * Add a service registry to provide a generic way to register custom service implementations to be used in FastAPI server. See [short instruction](https://github.com/google/adk-python/discussions/3175#discussioncomment-14745120). ([391628f](https://github.com/google/adk-python/commit/391628fcdc7b950c6835f64ae3ccab197163c990))
+  * Add the ability to rewind a session to before a previous invocation ([9dce06f](https://github.com/google/adk-python/commit/9dce06f9b00259ec42241df4f6638955e783a9d1))
+  * Support resuming a parallel agent with multiple branches paused on tool confirmation requests ([9939e0b](https://github.com/google/adk-python/commit/9939e0b087094038b90d86c2fd35c26dd63f1157))
+  * Support content union as static instruction ([cc24d61](https://github.com/google/adk-python/commit/cc24d616f80c0eba2b09239b621cf3d176f144ea))
+
+* **[Evals]**
+  * ADK cli allows developers to create an eval set and add an eval case ([ae139bb](https://github.com/google/adk-python/commit/ae139bb461c2e7c6be154b04f3f2c80919808d31))
+
+* **[Integrations]**
+  * Allow custom request and event converters in A2aAgentExecutor ([a17f3b2](https://github.com/google/adk-python/commit/a17f3b2e6d2d48c433b42e27763f3d6df80243ca))
+
+* **[Observability]**
+  * Env variable for disabling llm_request and llm_response in spans ([e50f05a](https://github.com/google/adk-python/commit/e50f05a9fc94834796876f7f112f344f788f202e))
+
+* **[Services]**
+  * Allow passing extra kwargs to create_session of VertexAiSessionService ([6a5eac0](https://github.com/google/adk-python/commit/6a5eac0bdc9adc6907a28f65a3d4d7234e863049))
+  * Implement new methods in in-memory artifact service to support custom metadata, artifact versions, etc. ([5a543c0](https://github.com/google/adk-python/commit/5a543c00df2f7a66018df8a67efcf4ce44d4e0e4))
+  * Add create_time and mime_type to ArtifactVersion ([2c7a342](https://github.com/google/adk-python/commit/2c7a34259395b1294319118d0f3d1b3b867b44d6))
+  * Support returning all sessions when user id is none ([141318f](https://github.com/google/adk-python/commit/141318f77554ae4eb5a360bea524e98eff4a086c))
+
+* **[Tools]**
+  * Support additional headers for Google API toolset ([ed37e34](https://github.com/google/adk-python/commit/ed37e343f0c997d3ee5dc98888c5e0dbd7f2a2b6))
+  * Introduces a new AgentEngineSandboxCodeExecutor class that supports executing agent-generated code using the Vertex AI Code Execution Sandbox API ([ee39a89](https://github.com/google/adk-python/commit/ee39a891106316b790621795b5cc529e89815a98))
+  * Support dynamic per-request headers in MCPToolset ([6dcbb5a](https://github.com/google/adk-python/commit/6dcbb5aca642290112a7c81162b455526c15cd14))
+  * Add `bypass_multi_tools_limit` option to GoogleSearchTool and VertexAiSearchTool ([9a6b850](https://github.com/google/adk-python/commit/9a6b8507f06d8367488aac653efecf665619516c), [6da7274](https://github.com/google/adk-python/commit/6da727485898137948d72906d86d78b6db6331ac))
+  * Extend `ReflectAndRetryToolPlugin` to support hallucinating function calls ([f51380f](https://github.com/google/adk-python/commit/f51380f9ea4534591eda76bef27407c0aa7c3fae))
+  * Add require_confirmation param for MCP tool/toolset ([78e74b5](https://github.com/google/adk-python/commit/78e74b5bf2d895d72025a44dbcf589f543514a50))
+
+* **[UI]**
+  * Granular per agent speech configuration ([409df13](https://github.com/google/adk-python/commit/409df1378f36b436139aa909fc90a9e9a0776b3a))
+
+### Bug Fixes
+
+* Returns dict as result from McpTool to comply with BaseTool expectations ([4df9263](https://github.com/google/adk-python/commit/4df926388b6e9ebcf517fbacf2f5532fd73b0f71))
+* Fixes the identity prompt to be one line ([7d5c6b9](https://github.com/google/adk-python/commit/7d5c6b9acf0721dd230f08df919c7409eed2b7d0))
+* Fix the broken langchain importing caused their 1.0.0 release ([c850da3](https://github.com/google/adk-python/commit/c850da3a07ec1441037ced1b654d8aacacd277ab))
+* Fix BuiltInCodeExecutor to support visualizations ([ce3418a](https://github.com/google/adk-python/commit/ce3418a69de56570847d45f56ffe7139ab0a47aa))
+* Relax runner app-name enforcement and improve agent origin inference ([dc4975d](https://github.com/google/adk-python/commit/dc4975dea9fb79ad887460659f8f397a537ee38f))
+* Improve error message when adk web is run in wrong directory ([4a842c5](https://github.com/google/adk-python/commit/4a842c5a1334c3ee01406f796651299589fe12ab))
+* Handle App objects in eval and graph endpoints ([0b73a69](https://github.com/google/adk-python/commit/0b73a6937bd84a41f79a9ada3fc782dca1d6fb11))
+* Exclude `additionalProperties` from Gemini schemas ([307896a](https://github.com/google/adk-python/commit/307896aeceeb97efed352bc0217bae10423e5da6))
+* Overall eval status should be NOT_EVALUATED if no invocations were evaluated ([9fbed0b](https://github.com/google/adk-python/commit/9fbed0b15afb94ec8c0c7ab60221bbc97e481b06))
+* Create context cache only when prefix matches with previous request ([9e0b1fb](https://github.com/google/adk-python/commit/9e0b1fb62b06de7ecb79bf77d54a999167d001e1))
+* Handle `App` instances returned by `agent_loader.load_agent` ([847df16](https://github.com/google/adk-python/commit/847df1638cbf1686aa43e8e094121d4e23e40245))
+* Add support for file URIs in LiteLLM content conversion ([85ed500](https://github.com/google/adk-python/commit/85ed500871ff55c74d16e809ddae0d4db66cbc3a))
+* Only exclude scores that are None ([998264a](https://github.com/google/adk-python/commit/998264a5b1b98ac660fcc1359fb2d25c84fa0d87))
+* Better handling the A2A streaming tasks ([bddc70b](https://github.com/google/adk-python/commit/bddc70b5d004ba5304fe05bcbf6e08210f0e6131))
+* Correctly populate context_id in remote_a2a_agent library ([2158b3c](https://github.com/google/adk-python/commit/2158b3c91531e9125761f211f125d9ab41a55e10))
+* Remove unnecessary Aclosing ([2f4f561](https://github.com/google/adk-python/commit/2f4f5611bdb30bd5eb2fdb3a70f43d748371392f))
+* Fix pickle data was truncated error in database session using MySql ([36c96ec](https://github.com/google/adk-python/commit/36c96ec5b356109b7c874c85d8bb24f0bf6c050d))
+
+### Improvements
+
+* Improve hint message in agent loader ([fe1fc75](https://github.com/google/adk-python/commit/fe1fc75c15a7983829bbe0b023f4b612b1e5c018))
+* Fixes MCPToolset --> McpToolset in various places ([d4dc645](https://github.com/google/adk-python/commit/d4dc6454783f747120d407d0dc2cb78f53598d83))
+* Add span for context caching handling and new cache creation ([a2d9f13](https://github.com/google/adk-python/commit/a2d9f13fa1d31e00ba9493fba321ca151cdd9366))
+* Checks gemini version for `2 and above` for gemini-builtin tools ([0df6759](https://github.com/google/adk-python/commit/0df67599c0eb54a9a5df51af06483b40058953bf))
+* Refactor and fix state management in the session service ([8b3ed05](https://github.com/google/adk-python/commit/8b3ed059c24903e8aca0a09d9d503b48af7df850))
+* Update agent builder instructions and remove run command details ([89344da](https://github.com/google/adk-python/commit/89344da81364d921f778c8bbea93e1df6ad1097e))
+* Clarify how to use adk built-in tool in instruction ([d22b8bf](https://github.com/google/adk-python/commit/d22b8bf8907e723f618dfd18e90dd0a5dbc9518c))
+* Delegate the agent state reset logic to LoopAgent ([bb1ea74](https://github.com/google/adk-python/commit/bb1ea74924127d65d763a45b869da3d4ff4d5c5a))
+* Adjust the instruction about default model ([214986e](https://github.com/google/adk-python/commit/214986ebeb53b2ef34c8aa37cd6403106de82c1b))
+* Migrate invocation_context to callback_context ([e2072af](https://github.com/google/adk-python/commit/e2072af69f40474431b6749b7b9dc22fbcbc7730))
+* Correct the callback signatures ([fa84bcb](https://github.com/google/adk-python/commit/fa84bcb5756773eadff486b99c9bd416b4faa9c6))
+* Set default for `bypass_multi_tools_limit` to False for GoogleSearchTool and VertexAiSearchTool ([6da7274](https://github.com/google/adk-python/commit/6da727485898137948d72906d86d78b6db6331ac))
+* Add more clear instruction to the doc updater agent about one PR for each recommended change ([b21d0a5](https://github.com/google/adk-python/commit/b21d0a50d610407be2f10b73a91274840ffdfe18))
+* Add a guideline to avoid content deletion ([16b030b](https://github.com/google/adk-python/commit/16b030b2b25a9b0b489e47b4b148fc4d39aeffcb))
+* Add a sample agent for the `ReflectAndRetryToolPlugin` ([9b8a4aa](https://github.com/google/adk-python/commit/9b8a4aad6fe65ef37885e5c3368d2799a2666534))
+* Improve error message when adk web is run in wrong directory ([4a842c5](https://github.com/google/adk-python/commit/4a842c5a1334c3ee01406f796651299589fe12ab))
+* Add span for context caching handling and new cache creation ([a2d9f13](https://github.com/google/adk-python/commit/a2d9f13fa1d31e00ba9493fba321ca151cdd9366))
+* Disable the scheduled execution for issue triage workflow ([bae2102](https://github.com/google/adk-python/commit/bae21027d9bd7f811bed638ecce692262cb33fe5))
+* Correct the callback signatures ([fa84bcb](https://github.com/google/adk-python/commit/fa84bcb5756773eadff486b99c9bd416b4faa9c6))
+
+### Documentation
+
+* Format README.md for samples ([0bdba30](https://github.com/google/adk-python/commit/0bdba3026345872fb907aedd1ed75e4135e58a30))
+* Bump models in llms and llms-full to Gemini 2.5 ([ce46386](https://github.com/google/adk-python/commit/ce4638651f376fb6579993d8468ae57198134729))
+* Update gemini_llm_connection.py - typo spelling correction ([e6e2767](https://github.com/google/adk-python/commit/e6e2767c3901a14187f5527540f318317dd6c8e3))
+* Announce the first ADK Community Call in the README ([731bb90](https://github.com/google/adk-python/commit/731bb9078d01359ae770719a8f5c003680ed9f3e))
+
 ## [1.16.0](https://github.com/google/adk-python/compare/v1.15.1...v1.16.0) (2025-10-08)

 ### Features
@@ -18,7 +204,7 @@
  * Add `dry_run` functionality to BigQuery `execute_sql` tool ([960eda3](https://github.com/google/adk-python/commit/960eda3d1f2f46dc93a365eb3de03dc3483fe9bb))
  * Add BigQuery analyze_contribution tool ([4bb089d](https://github.com/google/adk-python/commit/4bb089d386d4e8133e9aadbba5c42d31ff281cf6))
  * Spanner ADK toolset supports customizable template SQL and parameterized SQL ([da62700](https://github.com/google/adk-python/commit/da62700d739cb505149554962a8bcfb30f9428cc))
-  * Support Oauth2 client credentials grant type ([5c6cdcd](https://github.com/google/adk-python/commit/5c6cdcd197a6780fc86d9183fa208f78c8a975d9))
+  * Support OAuth2 client credentials grant type ([5c6cdcd](https://github.com/google/adk-python/commit/5c6cdcd197a6780fc86d9183fa208f78c8a975d9))
  * Add `ReflectRetryToolPlugin` to reflect from errors and retry with different arguments when tool errors ([e55b894](https://github.com/google/adk-python/commit/e55b8946d6a2e01aaf018d6a79d11d13c5286152))
  * Support using `VertexAiSearchTool` built-in tool with other tools in the same agent ([4485379](https://github.com/google/adk-python/commit/4485379a049a5c84583a43c85d444ea1f1ba6f12))
  * Support using google search built-in tool with other tools in the same agent ([d3148da](https://github.com/google/adk-python/commit/d3148dacc97f0a9a39b6d7a9640f7b7b0d6f9a6c))
@@ -99,7 +285,7 @@
  * Add endpoint to generate memory from session ([2595824](https://github.com/google/adk-python/commit/25958242db890b4d2aac8612f7f7cfbb561727fa))
 * **[Tools]**
  * Add Google Maps Grounding Tool to ADK ([6b49391](https://github.com/google/adk-python/commit/6b493915469ecb42068e24818ab547b0856e4709))
-  * **MCP:** Initialize tool_name_prefix in MCPToolse ([86dea5b](https://github.com/google/adk-python/commit/86dea5b53ac305367283b7e353b60d0f4515be3b))
+  * **MCP:** Initialize tool_name_prefix in MCPToolset ([86dea5b](https://github.com/google/adk-python/commit/86dea5b53ac305367283b7e353b60d0f4515be3b))
 * **[Evals]**
  * Data model for storing App Details and data model for steps ([01923a9](https://github.com/google/adk-python/commit/01923a9227895906ca8ae32712d65b178e2cd7d5))
  * Adds Rubric based final response evaluator ([5a485b0](https://github.com/google/adk-python/commit/5a485b01cd64cb49735e13ebd5e7fa3da02cd85f))
@@ -166,7 +352,7 @@
 * Fix discussion answering github action workflow to escape the quote in the discussion content JSON [43c9681](https://github.com/google/adk-python/commit/43c96811da891a5b0c9cf1be525665e65f346a13)
 * Send full MIME types for image/video/pdf in get_content [e45c3be](https://github.com/google/adk-python/commit/e45c3be23895b5ec68908ad9ee19bd622dcbd003)
 * Fix flaky unit tests: tests/unittests/flows/llm_flows/test_functions_simple.py [b92b288](https://github.com/google/adk-python/commit/b92b288c978a9b3d1a76c8bcb96cc8f439ce610b)
-* Make UT of a2a consistent about how tests should be skipped when python verison < 3.10 [98b0426](https://github.com/google/adk-python/commit/98b0426cd2dc5e28014ead22b22dbf50d42d0a9a)
+* Make UT of a2a consistent about how tests should be skipped when python version < 3.10 [98b0426](https://github.com/google/adk-python/commit/98b0426cd2dc5e28014ead22b22dbf50d42d0a9a)

 ### Improvements

@@ -257,7 +443,7 @@ with Bigtable for building AI Agent applications(experimental feature) ([a953807
 * Using base event's invocation id when merge multiple function response event ([279e4fe](https://github.com/google/adk-python/commit/279e4fedd0b1c0d1499c0f9a4454357af7da490e))
 * Avoid crash when there is no candidates_token_count, which is Optional ([22f34e9](https://github.com/google/adk-python/commit/22f34e9d2c552fbcfa15a672ef6ff0c36fa32619))
 * Fix the packaging version comparison logic in adk cli ([a2b7909](https://github.com/google/adk-python/commit/a2b7909fc36e7786a721f28e2bf75a1e86ad230d))
-* Add Spanner admin scope to Spanner tool default Oauth scopes ([b66054d](https://github.com/google/adk-python/commit/b66054dd0d8c5b3d6f6ad58ac1fbd8128d1da614))
+* Add Spanner admin scope to Spanner tool default OAuth scopes ([b66054d](https://github.com/google/adk-python/commit/b66054dd0d8c5b3d6f6ad58ac1fbd8128d1da614))
 * Fixes SequentialAgent.config_type type hint ([8a9a271](https://github.com/google/adk-python/commit/8a9a271141678996c9b84b8c55d4b539d011391c))
 * Fixes the host in the ansi bracket of adk web ([cd357bf](https://github.com/google/adk-python/commit/cd357bf5aeb01f1a6ae2a72349a73700ca9f1ed2))
 * Add spanner tool name prefix ([a27927d](https://github.com/google/adk-python/commit/a27927dc8197c391c80acb8b2c23d610fba2f887))
@@ -269,7 +455,7 @@ with Bigtable for building AI Agent applications(experimental feature) ([a953807
 * Update `openai` dependency version, based on correct OPENAI release ([bb8ebd1](https://github.com/google/adk-python/commit/bb8ebd15f90768b518cd0e21a59b269e30d6d944))
 * Add the missing license header for core_callback_config init file ([f8fd6a4](https://github.com/google/adk-python/commit/f8fd6a4f09ab520b8ecdbd8f9fe48228dbff7ebe))
 * Creates yaml_utils.py in utils to allow adk dump yaml in the same style ([1fd58cb](https://github.com/google/adk-python/commit/1fd58cb3633992cd88fa7e09ca6eda0f9b34236f))
-* Return explict None type for DELETE endpoints ([f03f167](https://github.com/google/adk-python/commit/f03f1677790c0a9e59b6ba6f46010d0b7b64be50))
+* Return explicit None type for DELETE endpoints ([f03f167](https://github.com/google/adk-python/commit/f03f1677790c0a9e59b6ba6f46010d0b7b64be50))
 * Add _config suffix to all yaml-based agent examples ([43f302c](https://github.com/google/adk-python/commit/43f302ce1ab53077ee8f1486d5294540678921e6))
 * Rename run related method and request to align with the conventions ([ecaa7b4](https://github.com/google/adk-python/commit/ecaa7b4c9847b478c7cdc37185b1525f733bb403))
 * Update models in samples/ folder to be gemini 2.0+ ([6c217ba](https://github.com/google/adk-python/commit/6c217bad828edf62b41ec06b168f8a6cb7ece2ed))
@@ -294,7 +480,7 @@ with Bigtable for building AI Agent applications(experimental feature) ([a953807

 ### Bug Fixes

-* A2A RPC URL got overriden by host and port param of adk api server ([52284b1](https://github.com/google/adk-python/commit/52284b1bae561e0d6c93c9d3240a09f210551b97))
+* A2A RPC URL got overridden by host and port param of adk api server ([52284b1](https://github.com/google/adk-python/commit/52284b1bae561e0d6c93c9d3240a09f210551b97))
 * Aclose all async generators to fix OTel tracing context ([a30c63c](https://github.com/google/adk-python/commit/a30c63c5933a770b960b08a6e2f8bf13eece8a22))
 * Use PreciseTimestamp for create and update time in database session service to improve precision ([585141e](https://github.com/google/adk-python/commit/585141e0b7dda20abb024c7164073862c8eea7ae))
 * Ignore AsyncGenerator return types in function declarations ([e2518dc](https://github.com/google/adk-python/commit/e2518dc371fe77d7b30328d8d6f5f864176edeac))
@@ -322,7 +508,7 @@ with Bigtable for building AI Agent applications(experimental feature) ([a953807
 * Group FastAPI endpoints with tags ([c323de5](https://github.com/google/adk-python/commit/c323de5c692223e55372c3797e62d4752835774d))
 * Allow implementations to skip defining a close method on Toolset ([944e39e](https://github.com/google/adk-python/commit/944e39ec2a7c9ad7f20c08fd66bf544de94a23d7))
 * Add sample agent to test support of output_schema and tools at the same time for gemini model ([f2005a2](https://github.com/google/adk-python/commit/f2005a20267e1ee8581cb79c37aa55dc8e18c0ea))
-* Add Github workflow config for uploading ADK docs to knowledge store ([5900273](https://github.com/google/adk-python/commit/59002734559d49a46940db9822b9c5f490220a8c))
+* Add GitHub workflow config for uploading ADK docs to knowledge store ([5900273](https://github.com/google/adk-python/commit/59002734559d49a46940db9822b9c5f490220a8c))
 * Update ADK Answering agent to reference doc site instead of adk-docs repo ([b5a8bad](https://github.com/google/adk-python/commit/b5a8bad170e271b475385dac440c7983ed207df8))

 ### Documentation
@@ -354,7 +540,7 @@ with Bigtable for building AI Agent applications(experimental feature) ([a953807

 ### Improvements

-* Add Github workflow config for the ADK Answering agent ([8dc0c94](https://github.com/google/adk-python/commit/8dc0c949afb9024738ff7ac1b2c19282175c3200))
+* Add GitHub workflow config for the ADK Answering agent ([8dc0c94](https://github.com/google/adk-python/commit/8dc0c949afb9024738ff7ac1b2c19282175c3200))
 * Import AGENT_CARD_WELL_KNOWN_PATH from adk instead of from a2a directly ([37dae9b](https://github.com/google/adk-python/commit/37dae9b631db5060770b66fce0e25cf0ffb56948))
 * Make `LlmRequest.LiveConnectConfig` field default to a factory ([74589a1](https://github.com/google/adk-python/commit/74589a1db7df65e319d1ad2f0676ee0cf5d6ec1d))
 * Update the prompt to make the ADK Answering Agent more objective ([2833030](https://github.com/google/adk-python/commit/283303032a174d51b8d72f14df83c794d66cb605))
@@ -413,14 +599,13 @@ with Bigtable for building AI Agent applications(experimental feature) ([a953807
 ### Features

 * [Core]Add agent card builder ([18f5bea](https://github.com/google/adk-python/commit/18f5bea411b3b76474ff31bfb2f62742825b45e5))
-* [Core]Add an to_a2a util to convert adk agent to A2A ASGI application ([a77d689](https://github.com/google/adk-python/commit/a77d68964a1c6b7659d6117d57fa59e43399e0c2))
+* [Core]Add a to_a2a util to convert adk agent to A2A ASGI application ([a77d689](https://github.com/google/adk-python/commit/a77d68964a1c6b7659d6117d57fa59e43399e0c2))
 * [Core]Add camel case converter for agents ([0e173d7](https://github.com/google/adk-python/commit/0e173d736334f8c6c171b3144ac6ee5b7125c846))
 * [Evals]Use LocalEvalService to run all evals in cli and web ([d1f182e](https://github.com/google/adk-python/commit/d1f182e8e68c4a5a4141592f3f6d2ceeada78887))
 * [Evals]Enable FinalResponseMatchV2 metric as an experiment ([36e45cd](https://github.com/google/adk-python/commit/36e45cdab3bbfb653eee3f9ed875b59bcd525ea1))
 * [Models]Add support for `model-optimizer-*` family of models in vertex ([ffe2bdb](https://github.com/google/adk-python/commit/ffe2bdbe4c2ea86cc7924eb36e8e3bb5528c0016))
 * [Services]Added a sample for History Management ([67284fc](https://github.com/google/adk-python/commit/67284fc46667b8c2946762bc9234a8453d48a43c))
-* [Services]Support passing fully qualified agent engine resource name when constructing session service and memory service ([2e77804](https://github.com/google/adk-python/commit/2e778049d0a675e458f4e
-35fe4104ca1298dbfcf))
+* [Services]Support passing fully qualified agent engine resource name when constructing session service and memory service ([2e77804](https://github.com/google/adk-python/commit/2e778049d0a675e458f4e35fe4104ca1298dbfcf))
 * [Tools]Add ComputerUseToolset ([083dcb4](https://github.com/google/adk-python/commit/083dcb44650eb0e6b70219ede731f2fa78ea7d28))
 * [Tools]Allow toolset to process llm_request before tools returned by it ([3643b4a](https://github.com/google/adk-python/commit/3643b4ae196fd9e38e52d5dc9d1cd43ea0733d36))
 * [Tools]Support input/output schema by fully-qualified code reference ([dfee06a](https://github.com/google/adk-python/commit/dfee06ac067ea909251d6fb016f8331065d430e9))
@@ -533,7 +718,7 @@ with Bigtable for building AI Agent applications(experimental feature) ([a953807

 ### Documentation

-* Update the a2a exmaple link in README.md [d0fdfb8](https://github.com/google/adk-python/commit/d0fdfb8c8e2e32801999c81de8d8ed0be3f88e76)
+* Update the a2a example link in README.md [d0fdfb8](https://github.com/google/adk-python/commit/d0fdfb8c8e2e32801999c81de8d8ed0be3f88e76)
 * Adds AGENTS.md to provide relevant project context for the Gemini CLI [37108be](https://github.com/google/adk-python/commit/37108be8557e011f321de76683835448213f8515)
 * Update CONTRIBUTING.md [ffa9b36](https://github.com/google/adk-python/commit/ffa9b361db615ae365ba62c09a8f4226fb761551)
 * Add adk project overview and architecture [28d0ea8](https://github.com/google/adk-python/commit/28d0ea876f2f8de952f1eccbc788e98e39f50cf5)
@@ -728,7 +913,7 @@ with Bigtable for building AI Agent applications(experimental feature) ([a953807
 * Fix typos in README for sample bigquery_agent and oauth_calendar_agent ([9bdd813](https://github.com/google/adk-python/commit/9bdd813be15935af5c5d2a6982a2391a640cab23))
 * Make tool_call one span for telemetry and renamed to execute_tool ([999a7fe](https://github.com/google/adk-python/commit/999a7fe69d511b1401b295d23ab3c2f40bccdc6f))
 * Use media type in chat window. Remove isArtifactImage and isArtifactAudio reference ([1452dac](https://github.com/google/adk-python/commit/1452dacfeb6b9970284e1ddeee6c4f3cb56781f8))
-* Set output_schema correctly for LiteLllm ([6157db7](https://github.com/google/adk-python/commit/6157db77f2fba4a44d075b51c83bff844027a147))
+* Set output_schema correctly for LiteLlm ([6157db7](https://github.com/google/adk-python/commit/6157db77f2fba4a44d075b51c83bff844027a147))
 * Update pending event dialog style ([1db601c](https://github.com/google/adk-python/commit/1db601c4bd90467b97a2f26fe9d90d665eb3c740))
 * Remove the gap between event holder and image ([63822c3](https://github.com/google/adk-python/commit/63822c3fa8b0bdce2527bd0d909c038e2b66dd98))

@@ -756,7 +941,7 @@ with Bigtable for building AI Agent applications(experimental feature) ([a953807
 ## 1.1.1

 ### Features
-* Add BigQuery first-party tools. See [here](https://github.com/google/adk-python/commit/d6c6bb4b2489a8b7a4713e4747c30d6df0c07961) for more details.
+* Add [BigQuery first-party tools](https://github.com/google/adk-python/commit/d6c6bb4b2489a8b7a4713e4747c30d6df0c07961).


 ## 1.1.0
@@ -892,7 +1077,7 @@ with Bigtable for building AI Agent applications(experimental feature) ([a953807
 * Fix google search reading undefined for `renderedContent`.

 ### Miscellaneous Chores
-* Docstring improvements, typo fixings, github action to enfore code styles on formatting and imports, etc.
+* Docstring improvements, typo fixings, github action to enforce code styles on formatting and imports, etc.

 ## 0.3.0

@@ -931,7 +1116,7 @@ with Bigtable for building AI Agent applications(experimental feature) ([a953807

 ### ⚠ BREAKING CHANGES

-* Fix typo in method name in `Event`: has_trailing_code_exeuction_result --> has_trailing_code_execution_result.
+* Fix typo in method name in `Event`: has_trailing_code_execution_result --> has_trailing_code_execution_result.

 ### Features

@@ -961,7 +1146,7 @@ with Bigtable for building AI Agent applications(experimental feature) ([a953807

 ### Miscellaneous Chores

-* Adds unit tests in Github action.
+* Adds unit tests in GitHub action.
 * Improves test coverage.
 * Various typo fixes.

@@ -57,7 +57,9 @@ information on using pull requests.
 ### Requirement for PRs

 -   All PRs, other than small documentation or typo fixes, should have a Issue
-    associated. If not, please create one.
+    associated. If a relevant issue doesn't exist, please create one first or
+    you may instead describe the bug or feature directly within the PR
+    description, following the structure of our issue templates.
 -   Small, focused PRs. Keep changes minimal—one concern per PR.
 -   For bug fixes or features, please provide logs or screenshot after the fix
    is applied to help reviewers better understand the fix.
@@ -143,7 +145,7 @@ part before or alongside your code PR.

 3.  **Create and activate a virtual environment:**

-    **NOTE**: ADK supports Python 3.9+. Python 3.11 and above is strongly
+    **NOTE**: ADK supports Python 3.10+. Python 3.11 and above is strongly
    recommended.

    Create a workspace venv using uv.
@@ -232,6 +234,6 @@ has resources that is helpful for contributors.

 ## Vibe Coding

-If you want to contribute by leveraging viber coding, the AGENTS.md
+If you want to contribute by leveraging vibe coding, the AGENTS.md
 (https://github.com/google/adk-python/tree/main/AGENTS.md) could be used as
-context to your LLM.
+context to your LLM.
@@ -11,63 +11,38 @@
      <img src="https://raw.githubusercontent.com/google/adk-python/main/assets/agent-development-kit.png" width="256"/>
    </h2>
    <h3 align="center">
-      An open-source, code-first Python toolkit for building, evaluating, and deploying sophisticated AI agents with flexibility and control.
+      An open-source, code-first Python framework for building, evaluating, and deploying sophisticated AI agents with flexibility and control.
    </h3>
    <h3 align="center">
      Important Links:
      <a href="https://google.github.io/adk-docs/">Docs</a>,
      <a href="https://github.com/google/adk-samples">Samples</a>,
-      <a href="https://github.com/google/adk-java">Java ADK</a> &
+      <a href="https://github.com/google/adk-java">Java ADK</a>,
+      <a href="https://github.com/google/adk-go">Go ADK</a> &
      <a href="https://github.com/google/adk-web">ADK Web</a>.
    </h3>
 </html>

-Agent Development Kit (ADK) is a flexible and modular framework for developing and deploying AI agents. While optimized for Gemini and the Google ecosystem, ADK is model-agnostic, deployment-agnostic, and is built for compatibility with other frameworks. ADK was designed to make agent development feel more like software development, to make it easier for developers to create, deploy, and orchestrate agentic architectures that range from simple tasks to complex workflows.
-
-
---
-## 🔥 ADK's very first community call on Oct 15
-
-Join our ADK Community Call! Our first virtual community call is on Oct 15!
-Meet our team, and talk with us about our roadmap and how to contribute.
-
-First Call Details:
-
-Topic: ADK Roadmap
-
-Date: October 15, 2025
-
-Time: 9:30-10:30am PST
-
-Meeting link:
-[Join the call](http://meet.google.com/gjm-gfim-ctz)
-
-Add to your calendar
-[Event calendar invite](https://calendar.google.com/calendar/event?action=TEMPLATE&tmeid=MDUydWo1dHV1dHFtNzJuM3E0bmEyMW12ZnZfMjAyNTEwMTVUMTYzMDAwWiBjXzljNWVjODhhMmQyYWU5YjY5Mzk4ODU1MGZkNDA5MjVmYjgxYjM4MTI1NGNjYTgzNmRkMjMwNzRiMjNmYzcyZDVAZw&tmsrc=c_9c5ec88a2d2ae9b693988550fd40925fb81b381254cca836dd23074b23fc72d5%40group.calendar.google.com), [.ics file](https://calendar.google.com/calendar/ical/c_9c5ec88a2d2ae9b693988550fd40925fb81b381254cca836dd23074b23fc72d5%40group.calendar.google.com/public/basic.ics), [ADK community calendar](https://calendar.google.com/calendar/embed?src=c_9c5ec88a2d2ae9b693988550fd40925fb81b381254cca836dd23074b23fc72d5%40group.calendar.google.com&ctz=America%2FLos_Angeles), [ADK Community Call RSVP](https://google.qualtrics.com/jfe/form/SV_3K0RJZ64H1BexqS)
-
-Agenda:
-[Julia] ADK Roadmap
-[ Bo & Hangfei] Eng Deep Dive: Context Caching
-[Kris] How to Contribute
-
-[Shubham] Upcoming Events
+Agent Development Kit (ADK) is a flexible and modular framework that applies
+software development principles to AI agent creation. It is designed to
+simplify building, deploying, and orchestrating agent workflows, from simple
+tasks to complex systems. While optimized for Gemini, ADK is model-agnostic,
+deployment-agnostic, and compatible with other frameworks.

 ---

 ## 🔥 What's new

- **Context compaction**: Supports context compaction to reduce context length. Here is a [sample](https://github.com/google/adk-python/blob/main/contributing/samples/hello_world_app/agent.py#L156) and [compaction config](https://github.com/google/adk-python/blob/main/src/google/adk/apps/app.py#L51).
+- **Custom Service Registration**: Add a service registry to provide a generic way to register custom service implementations to be used in FastAPI server. See [short instruction](https://github.com/google/adk-python/discussions/3175#discussioncomment-14745120). ([391628f](https://github.com/google/adk-python/commit/391628fcdc7b950c6835f64ae3ccab197163c990))

- **Resumability**: Support pause and resume an invocation in ADK.
+- **Rewind**: Add the ability to rewind a session to before a previous invocation ([9dce06f](https://github.com/google/adk-python/commit/9dce06f9b00259ec42241df4f6638955e783a9d1)).

- **ReflectRetryToolPlugin**: Add [`ReflectRetryToolPlugin`](https://github.com/google/adk-python/blob/main/src/google/adk/plugins/reflect_retry_tool_plugin.py) to reflect from errors and retry with different arguments when tool errors.
-
- **Search tool**: Support using Google built-in search and built-in `VertexAiSearchTool` with other tools in the same agent.
+- **New CodeExecutor**: Introduces a new AgentEngineSandboxCodeExecutor class that supports executing agent-generated code using the Vertex AI Code Execution Sandbox API ([ee39a89](https://github.com/google/adk-python/commit/ee39a891106316b790621795b5cc529e89815a98))

 ## ✨ Key Features

 - **Rich Tool Ecosystem**: Utilize pre-built tools, custom functions,
-  OpenAPI specs, or integrate existing tools to give agents diverse
+  OpenAPI specs, MCP tools or integrate existing tools to give agents diverse
  capabilities, all for tight integration with the Google ecosystem.

 - **Code-First Development**: Define agent logic, tools, and orchestration
@@ -84,13 +59,6 @@ Agenda:
 - **Deploy Anywhere**: Easily containerize and deploy agents on Cloud Run or
  scale seamlessly with Vertex AI Agent Engine.

-## 🤖 Agent2Agent (A2A) Protocol and ADK Integration
-
-For remote agent-to-agent communication, ADK integrates with the
-[A2A protocol](https://github.com/google-a2a/A2A/).
-See this [example](https://github.com/a2aproject/a2a-samples/tree/main/samples/python/agents)
-for how they can work together.
-
 ## 🚀 Installation

 ### Stable Release (Recommended)
@@ -114,6 +82,13 @@ pip install git+https://github.com/google/adk-python.git@main

 Note: The development version is built directly from the latest code commits. While it includes the newest fixes and features, it may also contain experimental changes or bugs not present in the stable release. Use it primarily for testing upcoming changes or accessing critical fixes before they are officially released.

+## 🤖 Agent2Agent (A2A) Protocol and ADK Integration
+
+For remote agent-to-agent communication, ADK integrates with the
+[A2A protocol](https://github.com/google-a2a/A2A/).
+See this [example](https://github.com/a2aproject/a2a-samples/tree/main/samples/python/agents)
+for how they can work together.
+
 ## 📚 Documentation

 Explore the full documentation for detailed guides on building, evaluating, and
@@ -181,10 +156,20 @@ We welcome contributions from the community! Whether it's bug reports, feature r
 - [General contribution guideline and flow](https://google.github.io/adk-docs/contributing-guide/).
 - Then if you want to contribute code, please read [Code Contributing Guidelines](./CONTRIBUTING.md) to get started.

+## Community Repo
+
+We have [adk-python-community repo](https://github.com/google/adk-python-community)that is home to a growing ecosystem of community-contributed tools, third-party
+service integrations, and deployment scripts that extend the core capabilities
+of the ADK.
+
 ## Vibe Coding

 If you are to develop agent via vibe coding the [llms.txt](./llms.txt) and the [llms-full.txt](./llms-full.txt) can be used as context to LLM. While the former one is a summarized one and the later one has the full information in case your LLM has big enough context window.

+## Community Events
+
+- [Completed] ADK's 1st community meeting on Wednesday, October 15, 2025. Remember to [join our group](https://groups.google.com/g/adk-community) to get access to the [recording](https://drive.google.com/file/d/1rpXDq5NSH8-MyMeYI6_5pZ3Lhn0X9BQf/view), and [deck](https://docs.google.com/presentation/d/1_b8LG4xaiadbUUDzyNiapSFyxanc9ZgFdw7JQ6zmZ9Q/edit?slide=id.g384e60cdaca_0_658&resourcekey=0-tjFFv0VBQhpXBPCkZr0NOg#slide=id.g384e60cdaca_0_658).
+
 ## 📄 License

 This project is licensed under the Apache 2.0 License - see the [LICENSE](LICENSE) file for details.
@@ -46,7 +46,7 @@ root_agent = Agent(
      Use the provided tools to conduct various operations on users' data in Google BigQuery.

      Scenario 1:
-      The user wants to query their biguqery datasets
+      The user wants to query their bigquery datasets
      Use bigquery_datasets_list to query user's datasets

      Scenario 2:
@@ -99,7 +99,7 @@ Agent: ✅ Great news! Your reimbursement has been approved by the manager. Proc
 The human-in-the-loop process follows this pattern:

 1. **Initial Call**: Root agent delegates approval request to remote approval agent for amounts >$100
-2. **Pending Response**: Remote approval agent returns immediate response with `status: "pending"` and ticket ID and serface the approval request to root agent
+2. **Pending Response**: Remote approval agent returns immediate response with `status: "pending"` and ticket ID and surface the approval request to root agent
 3. **Agent Acknowledgment**: Root agent informs user about pending approval status
 4. **Human Interaction**: Human manager interacts with root agent to review and approve/reject the request
 5. **Updated Response**: Root agent receives updated tool response with approval decision and send it to remote agent
@@ -1,216 +0,0 @@
-# Copyright 2025 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-"""Agent factory for creating Agent Builder Assistant with embedded schema."""
-
-from pathlib import Path
-from typing import Callable
-from typing import Optional
-from typing import Union
-
-from google.adk.agents import LlmAgent
-from google.adk.agents.readonly_context import ReadonlyContext
-from google.adk.models import BaseLlm
-from google.adk.tools import AgentTool
-from google.adk.tools import FunctionTool
-from google.genai import types
-
-from .sub_agents.adk_knowledge_agent import create_adk_knowledge_agent
-from .sub_agents.google_search_agent import create_google_search_agent
-from .sub_agents.url_context_agent import create_url_context_agent
-from .tools.cleanup_unused_files import cleanup_unused_files
-from .tools.delete_files import delete_files
-from .tools.explore_project import explore_project
-from .tools.read_config_files import read_config_files
-from .tools.read_files import read_files
-from .tools.search_adk_source import search_adk_source
-from .tools.write_config_files import write_config_files
-from .tools.write_files import write_files
-from .utils import load_agent_config_schema
-
-
-class AgentBuilderAssistant:
-  """Agent Builder Assistant factory for creating configured instances."""
-
-  @staticmethod
-  def create_agent(
-      model: Union[str, BaseLlm] = "gemini-2.5-flash",
-      working_directory: Optional[str] = None,
-  ) -> LlmAgent:
-    """Create Agent Builder Assistant with embedded ADK AgentConfig schema.
-
-    Args:
-      model: Model to use for the assistant (default: gemini-2.5-flash)
-      working_directory: Working directory for path resolution (default: current
-        working directory)
-
-    Returns:
-      Configured LlmAgent with embedded ADK AgentConfig schema
-    """
-    # Load full ADK AgentConfig schema directly into instruction context
-    instruction = AgentBuilderAssistant._load_instruction_with_schema(model)
-
-    # TOOL ARCHITECTURE: Hybrid approach using both AgentTools and FunctionTools
-    #
-    # Why use sub-agents for built-in tools?
-    # - ADK's built-in tools (google_search, url_context) are designed as agents
-    # - AgentTool wrapper allows integrating them into our agent's tool collection
-    # - Maintains compatibility with existing ADK tool ecosystem
-
-    # Built-in ADK tools wrapped as sub-agents
-    adk_knowledge_agent = create_adk_knowledge_agent()
-    google_search_agent = create_google_search_agent()
-    url_context_agent = create_url_context_agent()
-    agent_tools = [
-        AgentTool(adk_knowledge_agent),
-        AgentTool(google_search_agent),
-        AgentTool(url_context_agent),
-    ]
-
-    # CUSTOM FUNCTION TOOLS: Agent Builder specific capabilities
-    #
-    # Why FunctionTool pattern?
-    # - Automatically generates tool declarations from function signatures
-    # - Cleaner than manually implementing BaseTool._get_declaration()
-    # - Type hints and docstrings become tool descriptions automatically
-
-    # Core agent building tools
-    custom_tools = [
-        FunctionTool(read_config_files),  # Read/parse multiple YAML configs
-        FunctionTool(
-            write_config_files
-        ),  # Write/validate multiple YAML configs
-        FunctionTool(explore_project),  # Analyze project structure
-        # File management tools (multi-file support)
-        FunctionTool(read_files),  # Read multiple files
-        FunctionTool(write_files),  # Write multiple files
-        FunctionTool(delete_files),  # Delete multiple files
-        FunctionTool(cleanup_unused_files),
-        # ADK source code search (regex-based)
-        FunctionTool(search_adk_source),  # Search ADK source with regex
-    ]
-
-    # Combine all tools
-    all_tools = agent_tools + custom_tools
-
-    # Create agent directly using LlmAgent constructor
-    agent = LlmAgent(
-        name="agent_builder_assistant",
-        description=(
-            "Intelligent assistant for building ADK multi-agent systems "
-            "using YAML configurations"
-        ),
-        instruction=instruction,
-        model=model,
-        tools=all_tools,
-        generate_content_config=types.GenerateContentConfig(
-            max_output_tokens=8192,
-        ),
-    )
-
-    return agent
-
-  @staticmethod
-  def _load_schema() -> str:
-    """Load ADK AgentConfig.json schema content and format for YAML embedding."""
-
-    # CENTRALIZED ADK AGENTCONFIG SCHEMA LOADING: Use common utility function
-    # This avoids duplication across multiple files and provides consistent
-    # ADK AgentConfig schema loading with caching and error handling.
-    schema_content = load_agent_config_schema(
-        raw_format=True,  # Get as JSON string
-    )
-
-    # Format as indented code block for instruction embedding
-    #
-    # Why indentation is needed:
-    # - The ADK AgentConfig schema gets embedded into instruction templates using .format()
-    # - Proper indentation maintains readability in the final instruction
-    # - Code block markers (```) help LLMs recognize this as structured data
-    #
-    # Example final instruction format:
-    #   "Here is the ADK AgentConfig schema:
-    #   ```json
-    #     {"type": "object", "properties": {...}}
-    #   ```"
-    lines = schema_content.split("\n")
-    indented_lines = ["  " + line for line in lines]  # 2-space indent
-    return "```json\n" + "\n".join(indented_lines) + "\n  ```"
-
-  @staticmethod
-  def _load_instruction_with_schema(
-      model: Union[str, BaseLlm],
-  ) -> Callable[[ReadonlyContext], str]:
-    """Load instruction template and embed ADK AgentConfig schema content."""
-    instruction_template = (
-        AgentBuilderAssistant._load_embedded_schema_instruction_template()
-    )
-    schema_content = AgentBuilderAssistant._load_schema()
-
-    # Get model string for template replacement
-    model_str = (
-        str(model)
-        if isinstance(model, str)
-        else getattr(model, "model_name", str(model))
-    )
-
-    # Return a function that accepts ReadonlyContext and returns the instruction
-    def instruction_provider(context: ReadonlyContext) -> str:
-      # Extract project folder name from session state
-      project_folder_name = AgentBuilderAssistant._extract_project_folder_name(
-          context
-      )
-
-      # Fill the instruction template with all variables
-      instruction_text = instruction_template.format(
-          schema_content=schema_content,
-          default_model=model_str,
-          project_folder_name=project_folder_name,
-      )
-      return instruction_text
-
-    return instruction_provider
-
-  @staticmethod
-  def _extract_project_folder_name(context: ReadonlyContext) -> str:
-    """Extract project folder name from session state using resolve_file_path."""
-    from .utils.resolve_root_directory import resolve_file_path
-
-    session_state = context._invocation_context.session.state
-
-    # Use resolve_file_path to get the full resolved path for "."
-    # This handles all the root_directory resolution logic consistently
-    resolved_path = resolve_file_path(".", session_state)
-
-    # Extract the project folder name from the resolved path
-    project_folder_name = resolved_path.name
-
-    # Fallback to "project" if we somehow get an empty name
-    if not project_folder_name:
-      project_folder_name = "project"
-
-    return project_folder_name
-
-  @staticmethod
-  def _load_embedded_schema_instruction_template() -> str:
-    """Load instruction template for embedded ADK AgentConfig schema mode."""
-    template_path = Path(__file__).parent / "instruction_embedded.template"
-
-    if not template_path.exists():
-      raise FileNotFoundError(
-          f"Instruction template not found at {template_path}"
-      )
-
-    with open(template_path, "r", encoding="utf-8") as f:
-      return f.read()
@@ -1,33 +0,0 @@
-# Copyright 2025 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-"""Sub-agent for ADK Knowledge."""
-
-from google.adk.agents.llm_agent import Agent
-from google.adk.agents.remote_a2a_agent import AGENT_CARD_WELL_KNOWN_PATH
-from google.adk.agents.remote_a2a_agent import RemoteA2aAgent
-
-
-def create_adk_knowledge_agent() -> Agent:
-  """Create a sub-agent that only uses google_search tool."""
-  return RemoteA2aAgent(
-      name="adk_knowledge_agent",
-      description=(
-          "Agent for performing Vertex AI Search to find ADK knowledge and"
-          " documentation"
-      ),
-      agent_card=(
-          f"https://adk-agent-builder-knowledge-service-654646711756.us-central1.run.app/a2a/adk_knowledge_agent{AGENT_CARD_WELL_KNOWN_PATH}"
-      ),
-  )
@@ -1,414 +0,0 @@
-# Copyright 2025 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-"""Configuration file writer tool with validation-before-write."""
-
-from pathlib import Path
-from typing import Any
-from typing import Dict
-
-from google.adk.tools.tool_context import ToolContext
-import jsonschema
-import yaml
-
-from ..utils import load_agent_config_schema
-from .write_files import write_files
-
-
-async def write_config_files(
-    configs: Dict[str, str],
-    tool_context: ToolContext,
-    backup_existing: bool = False,  # Changed default to False - user should decide
-    create_directories: bool = True,
-) -> Dict[str, Any]:
-  """Write multiple YAML configurations with comprehensive validation-before-write.
-
-  This tool validates YAML syntax and AgentConfig schema compliance before
-  writing files to prevent invalid configurations from being saved. It
-  provides detailed error reporting and optional backup functionality.
-
-  Args:
-    configs: Dict mapping file_path to config_content (YAML as string)
-    backup_existing: Whether to create timestamped backup of existing files
-      before overwriting (default: False - user should be asked)
-    create_directories: Whether to create parent directories if they don't exist
-      (default: True)
-
-  Returns:
-    Dict containing write operation results:
-      Always included:
-        - success: bool indicating if all write operations succeeded
-        - total_files: number of files requested
-        - successful_writes: number of files written successfully
-        - files: dict mapping file_path to file results
-
-      Success cases only (success=True):
-        - file_size: size of written file in bytes
-        - agent_name: extracted agent name from configuration
-        - agent_class: agent class type (e.g., "LlmAgent")
-        - warnings: list of warning messages for best practice violations.
-                   Empty list if no warnings. Common warning types:
-                   • Agent name formatting issues (special characters)
-                   • Empty instruction for LlmAgent
-                   • Missing sub-agent files
-                   • Incorrect file extensions (.yaml/.yml)
-                   • Mixed tool format consistency
-
-      Conditionally included:
-        - backup: dict with backup information (if backup was created).
-                 Contains:
-                 • "backup_created": True (always True when present)
-                 • "backup_path": absolute path to the timestamped backup file
-                                 (format: "original.yaml.backup.{timestamp}")
-
-      Error cases only (success=False):
-        - error: descriptive error message explaining the failure
-        - error_type: categorized error type for programmatic handling
-        - validation_step: stage where validation process stopped.
-                          Possible values:
-                          • "yaml_parsing": YAML syntax is invalid
-                          • "yaml_structure": YAML is valid but not a
-                          dict/object
-                          • "schema_validation": YAML violates AgentConfig
-                          schema
-                          • Not present: Error during file operations
-        - validation_errors: detailed validation error list (for schema errors
-        only)
-        - retry_suggestion: helpful suggestions for fixing the error
-
-  Examples:
-    Write new configuration:
-      result = await write_config_files({"my_agent.yaml": yaml_content})
-
-    Write without backup:
-      result = await write_config_files(
-          {"temp_agent.yaml": yaml_content},
-          backup_existing=False
-      )
-
-    Check backup information:
-      result = await write_config_files({"existing_agent.yaml": new_content})
-      if result["success"] and
-      result["files"]["existing_agent.yaml"]["backup_created"]:
-          backup_path = result["files"]["existing_agent.yaml"]["backup_path"]
-          print(f"Original file backed up to: {backup_path}")
-
-    Check validation warnings:
-      result = await write_config_files({"agent.yaml": yaml_content})
-      if result["success"] and result["files"]["agent.yaml"]["warnings"]:
-          for warning in result["files"]["agent.yaml"]["warnings"]:
-              print(f"Warning: {warning}")
-
-    Handle validation errors:
-      result = await write_config_files({"agent.yaml": invalid_yaml})
-      if not result["success"]:
-          step = result.get("validation_step", "file_operation")
-          if step == "yaml_parsing":
-              print("YAML syntax error:", result["error"])
-          elif step == "schema_validation":
-              print("Schema validation failed:", result["retry_suggestion"])
-          else:
-              print("Error:", result["error"])
-  """
-  result: Dict[str, Any] = {
-      "success": True,
-      "total_files": len(configs),
-      "successful_writes": 0,
-      "files": {},
-      "errors": [],
-  }
-
-  validated_configs: Dict[str, str] = {}
-
-  # Step 1: Validate all configs before writing any files
-  for file_path, config_content in configs.items():
-    file_result = _validate_single_config(file_path, config_content)
-    result["files"][file_path] = file_result
-
-    if file_result.get("success", False):
-      validated_configs[file_path] = config_content
-    else:
-      result["success"] = False
-
-  # Step 2: If all validations passed, write all files
-  if result["success"] and validated_configs:
-    write_result: Dict[str, Any] = await write_files(
-        validated_configs,
-        tool_context,
-        create_backup=backup_existing,
-        create_directories=create_directories,
-    )
-
-    # Merge write results with validation results
-    files_data = write_result.get("files", {})
-    for file_path, write_info in files_data.items():
-      if file_path in result["files"]:
-        file_entry = result["files"][file_path]
-        if isinstance(file_entry, dict):
-          file_entry.update({
-              "file_size": write_info.get("file_size", 0),
-              "backup_created": write_info.get("backup_created", False),
-              "backup_path": write_info.get("backup_path"),
-          })
-          if write_info.get("error"):
-            file_entry["success"] = False
-            file_entry["error"] = write_info["error"]
-            result["success"] = False
-          else:
-            result["successful_writes"] = result["successful_writes"] + 1
-
-  return result
-
-
-def _validate_single_config(
-    file_path: str, config_content: str
-) -> Dict[str, Any]:
-  """Validate a single configuration file.
-
-  Returns validation results for one config file.
-  """
-  try:
-    # Convert to absolute path
-    path = Path(file_path).resolve()
-
-    # Step 1: Parse YAML content
-    try:
-      config_dict = yaml.safe_load(config_content)
-    except yaml.YAMLError as e:
-      return {
-          "success": False,
-          "error_type": "YAML_PARSE_ERROR",
-          "error": f"Invalid YAML syntax: {str(e)}",
-          "file_path": str(path),
-          "validation_step": "yaml_parsing",
-      }
-
-    if not isinstance(config_dict, dict):
-      return {
-          "success": False,
-          "error_type": "YAML_STRUCTURE_ERROR",
-          "error": "YAML content must be a dictionary/object",
-          "file_path": str(path),
-          "validation_step": "yaml_structure",
-      }
-
-    # Step 2: Validate against AgentConfig schema
-    validation_result = _validate_against_schema(config_dict)
-    if not validation_result["valid"]:
-      return {
-          "success": False,
-          "error_type": "SCHEMA_VALIDATION_ERROR",
-          "error": "Configuration does not comply with AgentConfig schema",
-          "validation_errors": validation_result["errors"],
-          "file_path": str(path),
-          "validation_step": "schema_validation",
-          "retry_suggestion": _generate_retry_suggestion(
-              validation_result["errors"]
-          ),
-      }
-
-    # Step 3: Additional structural validation
-    structural_validation = _validate_structure(config_dict, path)
-
-    # Success response with validation metadata
-    return {
-        "success": True,
-        "file_path": str(path),
-        "agent_name": config_dict.get("name", "unknown"),
-        "agent_class": config_dict.get("agent_class", "LlmAgent"),
-        "warnings": structural_validation.get("warnings", []),
-    }
-
-  except Exception as e:
-    return {
-        "success": False,
-        "error_type": "UNEXPECTED_ERROR",
-        "error": f"Unexpected error during validation: {str(e)}",
-        "file_path": file_path,
-    }
-
-
-def _validate_against_schema(
-    config_dict: Dict[str, Any],
-) -> Dict[str, Any]:
-  """Validate configuration against AgentConfig.json schema."""
-  try:
-    schema = load_agent_config_schema(raw_format=False)
-    jsonschema.validate(config_dict, schema)
-
-    return {"valid": True, "errors": []}
-
-  except jsonschema.ValidationError as e:
-    # JSONSCHEMA QUIRK WORKAROUND: Handle false positive validation errors
-    #
-    # Problem: When AgentConfig schema uses anyOf with inheritance hierarchies,
-    # jsonschema throws ValidationError even for valid configs that match multiple schemas.
-    #
-    # Example scenario:
-    # - AgentConfig schema: {"anyOf": [{"$ref": "#/$defs/LlmAgentConfig"},
-    #                                  {"$ref": "#/$defs/SequentialAgentConfig"},
-    #                                  {"$ref": "#/$defs/BaseAgentConfig"}]}
-    # - Input config: {"agent_class": "SequentialAgent", "name": "test", ...}
-    # - Result: Config is valid against both SequentialAgentConfig AND BaseAgentConfig
-    #   (due to inheritance), but jsonschema considers this an error.
-    #
-    # Error message format:
-    # "{'agent_class': 'SequentialAgent', ...} is valid under each of
-    #  {'$ref': '#/$defs/SequentialAgentConfig'}, {'$ref': '#/$defs/BaseAgentConfig'}"
-    #
-    # Solution: Detect this specific error pattern and treat as valid since the
-    # config actually IS valid - it just matches multiple compatible schemas.
-    if "is valid under each of" in str(e.message):
-      return {"valid": True, "errors": []}
-
-    error_path = " -> ".join(str(p) for p in e.absolute_path)
-    return {
-        "valid": False,
-        "errors": [{
-            "path": error_path or "root",
-            "message": e.message,
-            "invalid_value": e.instance,
-            "constraint": (
-                e.schema.get("type") or e.schema.get("enum") or "unknown"
-            ),
-        }],
-    }
-
-  except jsonschema.SchemaError as e:
-    return {
-        "valid": False,
-        "errors": [{
-            "path": "schema",
-            "message": f"Schema error: {str(e)}",
-            "invalid_value": None,
-            "constraint": "schema_integrity",
-        }],
-    }
-
-  except Exception as e:
-    return {
-        "valid": False,
-        "errors": [{
-            "path": "validation",
-            "message": f"Validation error: {str(e)}",
-            "invalid_value": None,
-            "constraint": "validation_process",
-        }],
-    }
-
-
-def _validate_structure(
-    config: Dict[str, Any], file_path: Path
-) -> Dict[str, Any]:
-  """Perform additional structural validation beyond JSON schema."""
-  warnings = []
-
-  # Check agent name format
-  name = config.get("name", "")
-  if name and not name.replace("_", "").replace("-", "").isalnum():
-    warnings.append(
-        "Agent name contains special characters that may cause issues"
-    )
-
-  # Check for empty instruction
-  instruction = config.get("instruction", "").strip()
-  if config.get("agent_class", "LlmAgent") == "LlmAgent" and not instruction:
-    warnings.append(
-        "LlmAgent has empty instruction which may result in poor performance"
-    )
-
-  # Validate sub-agent references
-  sub_agents = config.get("sub_agents", [])
-  for sub_agent in sub_agents:
-    if isinstance(sub_agent, dict) and "config_path" in sub_agent:
-      config_path = sub_agent["config_path"]
-
-      # Check if path looks like it should be relative to current file
-      if not config_path.startswith("/"):
-        referenced_path = file_path.parent / config_path
-        if not referenced_path.exists():
-          warnings.append(
-              f"Referenced sub-agent file may not exist: {config_path}"
-          )
-
-      # Check file extension
-      if not config_path.endswith((".yaml", ".yml")):
-        warnings.append(
-            "Sub-agent config_path should end with .yaml or .yml:"
-            f" {config_path}"
-        )
-
-  # Check tool format consistency
-  tools = config.get("tools", [])
-  has_object_format = any(isinstance(t, dict) for t in tools)
-  has_string_format = any(isinstance(t, str) for t in tools)
-
-  if has_object_format and has_string_format:
-    warnings.append(
-        "Mixed tool formats detected - consider using consistent object format"
-    )
-
-  return {"warnings": warnings, "has_warnings": len(warnings) > 0}
-
-
-def _generate_retry_suggestion(errors: list) -> str:
-  """Generate helpful suggestions for fixing validation errors."""
-  if not errors:
-    return ""
-
-  suggestions = []
-
-  for error in errors:
-    path = error.get("path", "")
-    message = error.get("message", "")
-
-    if "required" in message.lower():
-      if "name" in message:
-        suggestions.append(
-            "Add required 'name' field with a descriptive agent name"
-        )
-      elif "instruction" in message:
-        suggestions.append(
-            "Add required 'instruction' field with clear agent instructions"
-        )
-      else:
-        suggestions.append(
-            f"Add missing required field mentioned in error at '{path}'"
-        )
-
-    elif "enum" in message.lower() or "not one of" in message.lower():
-      suggestions.append(
-          f"Use valid enum value for field '{path}' - check schema for allowed"
-          " values"
-      )
-
-    elif "type" in message.lower():
-      if "string" in message:
-        suggestions.append(f"Field '{path}' should be a string value")
-      elif "array" in message:
-        suggestions.append(f"Field '{path}' should be a list/array")
-      elif "object" in message:
-        suggestions.append(f"Field '{path}' should be an object/dictionary")
-
-    elif "additional properties" in message.lower():
-      suggestions.append(
-          f"Remove unrecognized field '{path}' or check for typos"
-      )
-
-  if not suggestions:
-    suggestions.append(
-        "Please fix the validation errors and regenerate the configuration"
-    )
-
-  return " | ".join(suggestions[:3])  # Limit to top 3 suggestions
@@ -116,4 +116,4 @@ The following environment variables are required to upload the docs to update th
 * `ADK_DOCS_ROOT_PATH=YOUR_ADK_DOCS_ROOT_PATH`: **(Required)** Path to the root of the downloaded adk-docs repo.
 * `ADK_PYTHON_ROOT_PATH=YOUR_ADK_PYTHON_ROOT_PATH`: **(Required)** Path to the root of the downloaded adk-python repo.

-For local execution in interactive mode, you can place these variables in a `.env` file in the project's root directory. For the GitHub workflow, they should be configured as repository secrets.
+For local execution in interactive mode, you can place these variables in a `.env` file in the project's root directory. For the GitHub workflow, they should be configured as repository secrets.
@@ -61,7 +61,7 @@ Here are the steps to help answer GitHub discussions:

 3. **Decide whether to respond**:
   * If all the following conditions are met, try to add a comment to the
-     discussion, otherwise, do not respond:
+     discussion; otherwise, do not respond:
     - The discussion is not closed.
     - The latest comment is not from you or other agents (marked as
       "Response from XXX Agent").
@@ -102,7 +102,7 @@ IMPORTANT:
    * You **should always** use the `convert_gcs_links_to_https` tool to convert
      GCS links (e.g. "gs://...") to HTTPS links.
    * **Do not** use the `convert_gcs_links_to_https` tool for non-GCS links.
-    * Make sure the citation URL is valid. Otherwise do not list this specific
+    * Make sure the citation URL is valid. Otherwise, do not list this specific
      citation.
  * Do not respond to any other discussion except the one specified by the user.

@@ -130,7 +130,7 @@ def upload_directory_to_gcs(
        )
        return False

-  print(f"Sucessfully uploaded {file_count} files to GCS.")
+  print(f"Successfully uploaded {file_count} files to GCS.")
  return True


@@ -148,7 +148,7 @@ def import_from_gcs_to_vertex_ai(
        # parent has the format of
        # "projects/{project_number}/locations/{location}/collections/{collection}/dataStores/{datastore_id}/branches/default_branch"
        parent=full_datastore_id + "/branches/default_branch",
-        # Specify the GCS source and use "content" for unstructed data.
+        # Specify the GCS source and use "content" for unstructured data.
        gcs_source=discoveryengine.GcsSource(
            input_uris=[gcs_uri], data_schema="content"
        ),
@@ -128,7 +128,7 @@ def convert_gcs_to_https(gcs_uri: str) -> Optional[str]:

    base_url = "https://google.github.io/adk-docs/"
    if os.path.basename(path_after_docs) == "index.md":
-      # Use the directory path if it is a index file
+      # Use the directory path if it is an index file
      final_path_segment = os.path.dirname(path_after_docs)
    else:
      # Otherwise, use the file name without extension
@@ -143,7 +143,7 @@ def convert_gcs_to_https(gcs_uri: str) -> Optional[str]:
    if _check_url_exists(potential_url):
      return potential_url
    else:
-      # If it doesn't exist, fallback to the regular github url
+      # If it doesn't exist, fall back to the regular github url
      return _generate_github_url(prefix, relative_path)

  # Convert the links for other cases, e.g. adk-python
@@ -54,10 +54,10 @@ root_agent = Agent(
    ),
    instruction=f"""
      # 1. Identity
-      You are a helper bot that updates ADK docs in Github Repository {DOC_OWNER}/{DOC_REPO}
-      based on the code in the ADK Python codebase in Github Repository {CODE_OWNER}/{CODE_REPO} according to the instructions in the ADK docs issues.
+      You are a helper bot that updates ADK docs in GitHub Repository {DOC_OWNER}/{DOC_REPO}
+      based on the code in the ADK Python codebase in GitHub Repository {CODE_OWNER}/{CODE_REPO} according to the instructions in the ADK docs issues.

-      You are very familiar with Github, expecially how to search for files in a Github repository using git grep.
+      You are very familiar with GitHub, especially how to search for files in a GitHub repository using git grep.

      # 2. Responsibilities
      Your core responsibility includes:
@@ -69,18 +69,18 @@ root_agent = Agent(
      # 3. Workflow
      1. Always call the `clone_or_pull_repo` tool to make sure the ADK docs and codebase repos exist in the local folder {LOCAL_REPOS_DIR_PATH}/repo_name and are the latest version.
      2. Read and analyze the issue specified by user.
-        - If user only specified the issue number, call the `get_issue` tool to get the issue details, otherwise use the issue details provided by user directly.
+        - If user only specified the issue number, call the `get_issue` tool to get the issue details; otherwise, use the issue details provided by user directly.
      3. If the issue contains instructions about how to update the ADK docs, follow the instructions to update the ADK docs.
      4. Understand the doc update instructions.
        - Ignore and skip the instructions about updating API reference docs, since it will be automatically generated by the ADK team.
      5. Read the doc to update using the `read_local_git_repo_file_content` tool from the local ADK docs repo under {LOCAL_REPOS_DIR_PATH}/{DOC_REPO}.
      6. Find the related Python files in the ADK Python codebase.
-        - If the doc update instructions specify paths to the Python files, use them directly, otherwise use a list of regex search patterns to find the related Python files through the `search_local_git_repo` tool.
+        - If the doc update instructions specify paths to the Python files, use them directly; otherwise, use a list of regex search patterns to find the related Python files through the `search_local_git_repo` tool.
        - You should focus on the main ADK Python codebase, ignore the changes in tests or other auxiliary files.
        - You should find all the related Python files, not only the most relevant one.
      7. Read the specified or found Python files using the `read_local_git_repo_file_content` tool to find all the related code.
-        - You can ignore unit test files, unless you are sure that the test code is uesful to understand the related concepts.
-        - You should read all the the found files to find all the related code, unless you already know the content of the file or you are sure that the file is not related to the ADK doc.
+        - You can ignore unit test files, unless you are sure that the test code is useful to understand the related concepts.
+        - You should read all the found files to find all the related code, unless you already know the content of the file or you are sure that the file is not related to the ADK doc.
      8. Update the ADK doc file according to the doc update instructions and the related code.
        - Use active voice phrasing in your doc updates.
        - Use second person "you" form of address in your doc updates.
@@ -102,12 +102,12 @@ root_agent = Agent(
      - **File Paths:** Always use absolute paths when calling the tools to read files, list directories, or search the codebase.
      - **Tool Call Parallelism:** Execute multiple independent tool calls in parallel when feasible (i.e. searching the codebase).
      - **Avoid deletion:** Do not delete any existing content unless specifically directed to do so.
-      - **Explaination:** Provide concise explanations for your actions and reasoning for each step.
+      - **Explanation:** Provide concise explanations for your actions and reasoning for each step.
      - **Minimize changes:** When making updates to documentation pages, make the minimum amount of changes to achieve the communication goal. Only make changes that are necessary, and leave everything else as-is.
      - **Avoid trivial code sample changes:** Update code samples only when adding or modifying functionality. Do not reformat code samples, change variable names, or change code syntax unless you are specifically directed to make those updates.

      # 5. Output
-      Present the followings in an easy to read format as the final output to the user.
+      Present the following in an easy to read format as the final output to the user.
      - The actions you took and the reasoning
      - The summary of the pull request created
    """,
@@ -56,17 +56,17 @@ root_agent = Agent(
    ),
    instruction=f"""
      # 1. Identity
-      You are a helper bot that checks if ADK docs in Github Repository {DOC_REPO} owned by {DOC_OWNER}
-      should be updated based on the changes in the ADK Python codebase in Github Repository {CODE_REPO} owned by {CODE_OWNER}.
+      You are a helper bot that checks if ADK docs in GitHub Repository {DOC_REPO} owned by {DOC_OWNER}
+      should be updated based on the changes in the ADK Python codebase in GitHub Repository {CODE_REPO} owned by {CODE_OWNER}.

-      You are very familiar with Github, expecially how to search for files in a Github repository using git grep.
+      You are very familiar with GitHub, especially how to search for files in a GitHub repository using git grep.

      # 2. Responsibilities
      Your core responsibility includes:
      - Find all the code changes between the two ADK releases.
      - Find **all** the related docs files in ADK Docs repository under the "/docs/" directory.
      - Compare the code changes with the docs files and analyze the differences.
-      - Write the instructions about how to update the ADK docs in markdown format and create a Github issue in the Github Repository {DOC_REPO} with the instructions.
+      - Write the instructions about how to update the ADK docs in markdown format and create a GitHub issue in the GitHub Repository {DOC_REPO} with the instructions.

      # 3. Workflow
      1. Always call the `clone_or_pull_repo` tool to make sure the ADK docs and codebase repos exist in the local folder {LOCAL_REPOS_DIR_PATH}/repo_name and are the latest version.
@@ -102,8 +102,8 @@ root_agent = Agent(
             **Reference**:
             Reference to the code file (e.g. src/google/adk/tools/spanner/metadata_tool.py).
          ```
-        - When referncing doc file, use the full relative path of the doc file in the ADK Docs repository (e.g. docs/sessions/memory.md).
-      9. Create or recommend to create a Github issue in the Github Repository {DOC_REPO} with the instructions using the `create_issue` tool.
+        - When referencing doc file, use the full relative path of the doc file in the ADK Docs repository (e.g. docs/sessions/memory.md).
+      9. Create or recommend to create a GitHub issue in the GitHub Repository {DOC_REPO} with the instructions using the `create_issue` tool.
        - The title of the issue should be "Found docs updates needed from ADK python release <start_tag> to <end_tag>", where start_tag and end_tag are the release tags.
        - The body of the issue should be the instructions about how to update the ADK docs.
          - Include the compare link between the two ADK releases in the issue body, e.g. https://github.com/google/adk-python/compare/v1.14.0...v1.14.1.
@@ -112,7 +112,7 @@ root_agent = Agent(
      # 4. Guidelines & Rules
      - **File Paths:** Always use absolute paths when calling the tools to read files, list directories, or search the codebase.
      - **Tool Call Parallelism:** Execute multiple independent tool calls in parallel when feasible (i.e. searching the codebase).
-      - **Explaination:** Provide concise explanations for your actions and reasoning for each step.
+      - **Explanation:** Provide concise explanations for your actions and reasoning for each step.
      - **Reference:** For each recommended change, reference the code changes (i.e. links to the commits) **AND** the code files (i.e. relative paths to the code files in the codebase).
      - **Sorting:** Sort the recommended changes by the importance of the changes, from the most important to the least important.
        - Here are the importance groups: Feature changes > Bug fixes > Other changes.
@@ -122,7 +122,7 @@ root_agent = Agent(
        - If a change in the codebase can be covered by the auto-generated API reference docs, you should just recommend to update the API reference docs (i.e. regenerate the API reference docs) instead of the other human-written ADK docs.

      # 5. Output
-      Present the followings in an easy to read format as the final output to the user.
+      Present the following in an easy to read format as the final output to the user.
      - The actions you took and the reasoning
      - The summary of the differences found
    """,
--- a/Show More
+++ b/Show More