Make additional_headers kwargs

Merge branch 'main' into feature/google-api-toolset-additional-headers-3105
Format conditional statement for setting headers
2026-07-09 18:19:28 -07:00 · 2025-10-21 12:44:50 -07:00 · 2025-10-20 09:58:15 -07:00 · 2025-10-20 09:36:25 -07:00 · 2025-10-20 10:18:27 +01:00 · 2025-10-18 12:09:45 +01:00
1191 changed files with 12294 additions and 77564 deletions
@@ -7,49 +7,34 @@ assignees: ''

 ---

-## 🔴 Required Information
-*Please ensure all items in this section are completed to allow for efficient triaging. Requests without complete information may be rejected / deprioritized. If an item is not applicable to you - please mark it as N/A*
+** Please make sure you read the contribution guide and file the issues in the right place. **
+[Contribution guide.](https://google.github.io/adk-docs/contributing-guide/)

-**Describe the Bug**
+**Describe the bug**
 A clear and concise description of what the bug is.

-**Steps to Reproduce**
-Please provide a numbered list of steps to reproduce the behavior:
+**To Reproduce**
+Please share a minimal code and data to reproduce your problem.
+Steps to reproduce the behavior:
 1. Install '...'
 2. Run '....'
 3. Open '....'
-4. Provide error or stacktrace
+4. Provie error or stacktrace

-**Expected Behavior**
+**Expected behavior**
 A clear and concise description of what you expected to happen.

-**Observed Behavior**
-What actually happened? Include error messages or crash stack traces here.
+**Screenshots**
+If applicable, add screenshots to help explain your problem.

-**Environment Details**
-* **ADK Library Version:** (e.g., 2.0.1)
-* **Desktop OS:** (e.g., macOS, Linux, Windows)
-* **Python Version:**
+**Desktop (please complete the following information):**
+ - OS: [e.g. macOS, Linux, Windows]
+ - Python version(python -V):
+ - ADK version(pip show google-adk):

-**Model Information**
-* **Are you using LiteLLM:** Yes/No
-* **Which model is being used:** (e.g., gemini-2.5-pro)
+ **Model Information:**
+ - Are you using LiteLLM: Yes/No
+ - Which model is being used(e.g. gemini-2.5-pro)

---
-
-## 🟡 Optional Information
-*Providing this information greatly speeds up the resolution process.*
-
-**Regression**
-Did this work in a previous version of ADK? If so, which one?
-
-**Logs**
-Please attach relevant logs. Wrap them in code blocks (```) or attach a text file.
-```text
-// Paste logs here
-```
-**Screenshots / Video**
-If applicable, add screenshots or screen recordings to help explain your problem.
-
-**Additional Context**
+**Additional context**
 Add any other context about the problem here.
@@ -1,52 +0,0 @@
-**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._
@@ -16,10 +16,10 @@ jobs:

    steps:
      - name: Checkout repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@v4

      - name: Set up Python
-        uses: actions/setup-python@v6
+        uses: actions/setup-python@v5
        with:
          python-version: '3.11'

@@ -1,4 +1,4 @@
-# Copyright 2026 Google LLC
+# 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.
@@ -24,7 +24,7 @@ jobs:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout Code
-        uses: actions/checkout@v6
+        uses: actions/checkout@v4
        with:
          fetch-depth: 2

@@ -89,14 +89,14 @@ 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/.*|src/google/adk/tools/apihub_tool/apihub_toolset.py|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/.*|tests/.*|contributing/samples/' || true)
          if [ -n "$CHANGED_FILES" ]; then
            echo "Changed Python files to check:"
            echo "$CHANGED_FILES"
            echo ""

            set +e
-            FILES_WITH_FORBIDDEN_IMPORT=$(grep -lE '^from.*\bcli\b.*import.*$' $CHANGED_FILES)
+            FILES_WITH_FORBIDDEN_IMPORT=$(grep -lE '^from.*cli.*import.*$' $CHANGED_FILES)
            GREP_EXIT_CODE=$?
            set -e

@@ -1,134 +0,0 @@
-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@v8
-        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 ---');
-            }
@@ -15,16 +15,16 @@ jobs:

    steps:
      - name: Checkout repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@v4

      - name: Set up Python
-        uses: actions/setup-python@v6
+        uses: actions/setup-python@v5
        with:
          python-version: '3.11'

      - name: Authenticate to Google Cloud
        id: auth
-        uses: 'google-github-actions/auth@v3'
+        uses: 'google-github-actions/auth@v2'
        with:
          credentials_json: '${{ secrets.ADK_GCP_SA_KEY }}'

@@ -1,4 +1,4 @@
-# Copyright 2026 Google LLC
+# 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.
@@ -26,12 +26,12 @@ jobs:

    steps:
      - name: Checkout code
-        uses: actions/checkout@v6
+        uses: actions/checkout@v4
        with:
          fetch-depth: 2

      - name: Set up Python
-        uses: actions/setup-python@v6
+        uses: actions/setup-python@v5
        with:
          python-version: '3.x'

@@ -20,10 +20,10 @@ jobs:

    steps:
      - name: Checkout repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@v4

      - name: Set up Python
-        uses: actions/setup-python@v6
+        uses: actions/setup-python@v5
        with:
          python-version: '3.11'

@@ -1,4 +1,4 @@
-# Copyright 2026 Google LLC
+# 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.
@@ -26,12 +26,12 @@ jobs:

    steps:
      - name: Checkout code
-        uses: actions/checkout@v6
+        uses: actions/checkout@v4
        with:
          fetch-depth: 2

      - name: Set up Python
-        uses: actions/setup-python@v6
+        uses: actions/setup-python@v5
        with:
          python-version: '3.x'

@@ -1,4 +1,4 @@
-# Copyright 2026 Google LLC
+# 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.
@@ -25,14 +25,14 @@ jobs:
    runs-on: ubuntu-latest
    strategy:
      matrix:
-        python-version: ["3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]

    steps:
    - name: Checkout code
-      uses: actions/checkout@v6
+      uses: actions/checkout@v4

    - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v6
+      uses: actions/setup-python@v5
      with:
        python-version: ${{ matrix.python-version }}

@@ -48,6 +48,14 @@ jobs:
    - name: Run unit tests with pytest
      run: |
        source .venv/bin/activate
-        pytest tests/unittests \
-          --ignore=tests/unittests/artifacts/test_artifact_service.py \
-          --ignore=tests/unittests/tools/google_api_tool/test_googleapi_to_openapi_converter.py
+        if [[ "${{ matrix.python-version }}" == "3.9" ]]; then
+          pytest tests/unittests \
+            --ignore=tests/unittests/a2a \
+            --ignore=tests/unittests/tools/mcp_tool \
+            --ignore=tests/unittests/artifacts/test_artifact_service.py \
+            --ignore=tests/unittests/tools/google_api_tool/test_googleapi_to_openapi_converter.py
+        else
+          pytest tests/unittests \
+            --ignore=tests/unittests/artifacts/test_artifact_service.py \
+            --ignore=tests/unittests/tools/google_api_tool/test_googleapi_to_openapi_converter.py
+        fi
@@ -1,58 +0,0 @@
-# Copyright 2026 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# 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.
-
-name: ADK Stale Issue Auditor
-
-on:
-  workflow_dispatch:
-
-  schedule:
-    # This runs at 6:00 AM UTC (10 PM PST)
-    - cron: '0 6 * * *'
-
-jobs:
-  audit-stale-issues:
-    if: github.repository == 'google/adk-python'
-    runs-on: ubuntu-latest
-    timeout-minutes: 60
-
-    permissions:
-      issues: write
-      contents: read
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v6
-
-      - name: Set up Python
-        uses: actions/setup-python@v6
-        with:
-          python-version: '3.11'
-
-      - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip
-          pip install requests google-adk
-
-      - name: Run Auditor Agent Script
-        env:
-          GITHUB_TOKEN: ${{ secrets.ADK_TRIAGE_AGENT }}
-          GOOGLE_API_KEY: ${{ secrets.GOOGLE_API_KEY }}
-          OWNER: ${{ github.repository_owner }}
-          REPO: adk-python
-          CONCURRENCY_LIMIT: 3
-          LLM_MODEL_NAME: "gemini-2.5-flash"
-          PYTHONPATH: contributing/samples
-
-        run: python -m adk_stale_agent.main
@@ -2,34 +2,21 @@ name: ADK Issue Triaging Agent

 on:
  issues:
-    types: [opened, labeled]
-  schedule:
-    # Run every 6 hours to triage untriaged issues
-    - cron: '0 */6 * * *'
+    types: [opened, reopened]

 jobs:
  agent-triage-issues:
    runs-on: ubuntu-latest
-    # Run for:
-    # - Scheduled runs (batch processing)
-    # - New issues (need component labeling)
-    # - Issues labeled with "planned" (need owner assignment)
-    if: >-
-      github.repository == 'google/adk-python' && (
-        github.event_name == 'schedule' ||
-        github.event.action == 'opened' ||
-        github.event.label.name == 'planned'
-      )
    permissions:
      issues: write
      contents: read

    steps:
      - name: Checkout repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@v4

      - name: Set up Python
-        uses: actions/setup-python@v6
+        uses: actions/setup-python@v5
        with:
          python-version: '3.11'

@@ -43,8 +30,8 @@ jobs:
          GITHUB_TOKEN: ${{ secrets.ADK_TRIAGE_AGENT }}
          GOOGLE_API_KEY: ${{ secrets.GOOGLE_API_KEY }}
          GOOGLE_GENAI_USE_VERTEXAI: 0
-          OWNER: ${{ github.repository_owner }}
-          REPO: ${{ github.event.repository.name }}
+          OWNER: 'google'
+          REPO: 'adk-python'
          INTERACTIVE: 0
          EVENT_NAME: ${{ github.event_name }} # 'issues', 'schedule', etc.
          ISSUE_NUMBER: ${{ github.event.issue.number }}
@@ -9,12 +9,11 @@ on:

 jobs:
  upload-adk-docs-to-vertex-ai-search:
-    if: github.repository == 'google/adk-python'
    runs-on: ubuntu-latest

    steps:
      - name: Checkout repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@v4

      - name: Clone adk-docs repository
        run: git clone https://github.com/google/adk-docs.git /tmp/adk-docs
@@ -23,13 +22,13 @@ jobs:
        run: git clone https://github.com/google/adk-python.git /tmp/adk-python

      - name: Set up Python
-        uses: actions/setup-python@v6
+        uses: actions/setup-python@v5
        with:
          python-version: '3.11'

      - name: Authenticate to Google Cloud
        id: auth
-        uses: 'google-github-actions/auth@v3'
+        uses: 'google-github-actions/auth@v2'
        with:
          credentials_json: '${{ secrets.ADK_GCP_SA_KEY }}'

@@ -98,21 +98,3 @@ Thumbs.db
 *.bak
 *.tmp
 *.temp
-
-# AI Coding Tools - Project-specific configs
-# Developers should symlink or copy AGENTS.md and add their own overrides locally
-.adk/
-.claude/
-CLAUDE.md
-.cursor/
-.cursorrules
-.cursorignore
-.windsurfrules
-.aider*
-.continue/
-.codeium/
-.githubnext/
-.roo/
-.rooignore
-.bolt/
-.v0/
@@ -56,14 +56,12 @@ information on using pull requests.

 ### Requirement for PRs

-   All PRs, other than small documentation or typo fixes, should have an Issue
-    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.
+-   All PRs, other than small documentation or typo fixes, should have a Issue
+    associated. If not, please create one.
 -   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.
-   Please include a `testing plan` section in your PR to describe how you
+-   Please include a `testing plan` section in your PR to talk about how you
    will test. This will save time for PR review. See `Testing Requirements`
    section for more details.

@@ -126,7 +124,7 @@ Depending on your change:

 For any changes that impact user-facing documentation (guides, API reference,
 tutorials), please open a PR in the
-[adk-docs](https://github.com/google/adk-docs) repository to update the relevant
+[adk-docs](https://github.com/google/adk-docs) repository to update relevant
 part before or alongside your code PR.

 ## Development Setup
@@ -145,7 +143,7 @@ part before or alongside your code PR.

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

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

    Create a workspace venv using uv.
@@ -160,11 +158,7 @@ part before or alongside your code PR.
    source .venv/bin/activate
    ```

-    **Windows**
-
-    ```shell
-    source .\.venv\Scripts\activate
-    ```
+    **windows** `shell source .\.venv\Scripts\activate`

 4.  **Install dependencies:**

@@ -234,10 +228,10 @@ part before or alongside your code PR.
 ## Contributing Resources

 [Contributing folder](https://github.com/google/adk-python/tree/main/contributing)
-has resources that are helpful for contributors.
+has resources that is helpful for contributors.

 ## Vibe Coding

-If you want to contribute by leveraging vibe coding, the AGENTS.md
+If you want to contribute by leveraging viber 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.
@@ -4,45 +4,70 @@
 [![PyPI](https://img.shields.io/pypi/v/google-adk)](https://pypi.org/project/google-adk/)
 [![Python Unit Tests](https://github.com/google/adk-python/actions/workflows/python-unit-tests.yml/badge.svg)](https://github.com/google/adk-python/actions/workflows/python-unit-tests.yml)
 [![r/agentdevelopmentkit](https://img.shields.io/badge/Reddit-r%2Fagentdevelopmentkit-FF4500?style=flat&logo=reddit&logoColor=white)](https://www.reddit.com/r/agentdevelopmentkit/)
-<a href="https://codewiki.google/github.com/google/adk-python"><img src="https://www.gstatic.com/_/boq-sdlc-agents-ui/_/r/Mvosg4klCA4.svg" alt="Ask Code Wiki" height="20"></a>
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/google/adk-python)

 <html>
    <h2 align="center">
      <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 framework for building, evaluating, and deploying sophisticated AI agents with flexibility and control.
+      An open-source, code-first Python toolkit 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-go">Go ADK</a> &
+      <a href="https://github.com/google/adk-java">Java 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 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.
+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

 ---

 ## 🔥 What's new

- **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))
+- **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).

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

- **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))
+- **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.

 ## ✨ Key Features

 - **Rich Tool Ecosystem**: Utilize pre-built tools, custom functions,
-  OpenAPI specs, MCP tools or integrate existing tools to give agents diverse
+  OpenAPI specs, 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
@@ -59,6 +84,13 @@ deployment-agnostic, and compatible with other frameworks.
 - **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)
@@ -82,13 +114,6 @@ 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
@@ -156,19 +181,9 @@ 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 want 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).
+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.

 ## 📄 License

@@ -1,5 +1,5 @@
 #!/bin/bash
-# Copyright 2026 Google LLC
+# 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.
@@ -1,6 +1,6 @@
 # Contributing Resources

-This folder hosts resources for ADK contributors, for example, testing samples etc.
+This folder host resources for ADK contributors, for example, testing samples etc.

 ## Samples

@@ -13,4 +13,4 @@ Samples folder host samples to test different features. The samples are usually
 The [adk_project_overview_and_architecture.md](adk_project_overview_and_architecture.md) describes the ADK project overview and its technical architecture from high-level.

 This is helpful for contributors to understand the project and design philosophy.
- It can also be fed into LLMs for vibe-coding.
+ It can also be feed into LLMs for vibe-coding.
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
Xuan Yang	b8644ef32c	Make `additional_headers` kwargs	2025-10-21 12:44:50 -07:00
Xuan Yang	ace3e5a3a5	Merge branch 'main' into feature/google-api-toolset-additional-headers-3105	2025-10-20 09:58:15 -07:00
Xuan Yang	37179a6e1f	Format conditional statement for setting headers	2025-10-20 09:36:25 -07:00
Parham Alizadeh	d8ded07eb3	addressing comments - tidy ups	2025-10-20 10:18:27 +01:00
Parham MohammadAlizadeh	a09dd4d31f	Merge branch 'main' into feature/google-api-toolset-additional-headers-3105	2025-10-18 12:09:45 +01:00
Parham MohammadAlizadeh	71999b0ef7	Merge branch 'main' into feature/google-api-toolset-additional-headers-3105	2025-10-17 16:37:23 +01:00
Parham MohammadAlizadeh	3d6d6132cd	Merge branch 'main' into feature/google-api-toolset-additional-headers-3105	2025-10-17 16:23:25 +01:00
Parham Alizadeh	78e4d81579	feat(tools): support additional headers for google api toolset #non-breaking	2025-10-17 16:22:55 +01:00