fix: map LiteLLM thought parts to reasoning_content

- Treat Part(thought=True) as reasoning_content when building assistant messages.
- Add unit tests for thought-only and thought+text cases.

Close #4069

Co-authored-by: George Weale <gweale@google.com>
PiperOrigin-RevId: 853790274

.github/workflows/analyze-releases-for-adk-docs-updates.yml

@@ -16,7 +16,7 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
 
       - name: Set up Python
         uses: actions/setup-python@v6

.github/workflows/check-file-contents.yml

@@ -24,7 +24,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           fetch-depth: 2
 

.github/workflows/discussion_answering.yml

@@ -15,7 +15,7 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
 
       - name: Set up Python
         uses: actions/setup-python@v6
@@ -24,7 +24,7 @@ jobs:
 
       - name: Authenticate to Google Cloud
         id: auth
-        uses: 'google-github-actions/auth@v2'
+        uses: 'google-github-actions/auth@v3'
         with:
           credentials_json: '${{ secrets.ADK_GCP_SA_KEY }}'
 

.github/workflows/isort.yml

@@ -26,7 +26,7 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           fetch-depth: 2
 

.github/workflows/pr-triage.yml

@@ -20,7 +20,7 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
 
       - name: Set up Python
         uses: actions/setup-python@v6

.github/workflows/pyink.yml

@@ -26,7 +26,7 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           fetch-depth: 2
 

.github/workflows/python-unit-tests.yml

@@ -29,7 +29,7 @@ jobs:
 
     steps:
     - name: Checkout code
-      uses: actions/checkout@v5
+      uses: actions/checkout@v6
 
     - name: Set up Python ${{ matrix.python-version }}
       uses: actions/setup-python@v6

.github/workflows/stale-bot.yml

@@ -1,3 +1,17 @@
+# 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.
+
 name: ADK Stale Issue Auditor
 
 on:
@@ -18,7 +32,7 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
 
       - name: Set up Python
         uses: actions/setup-python@v6

.github/workflows/triage.yml

@@ -24,7 +24,7 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
 
       - name: Set up Python
         uses: actions/setup-python@v6

.github/workflows/upload-adk-docs-to-vertex-ai-search.yml

@@ -13,7 +13,7 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
 
       - name: Clone adk-docs repository
         run: git clone https://github.com/google/adk-docs.git /tmp/adk-docs
@@ -28,7 +28,7 @@ jobs:
 
       - name: Authenticate to Google Cloud
         id: auth
-        uses: 'google-github-actions/auth@v2'
+        uses: 'google-github-actions/auth@v3'
         with:
           credentials_json: '${{ secrets.ADK_GCP_SA_KEY }}'
 

CHANGELOG.md

@@ -4,7 +4,7 @@
 
 ### Features
 * **[Interactions API Support]**
-  * The newly released Gemini [Interactions API](https://ai.google.dev/gemini-api/docs/interactions) is supported in ADK Now. To use it:
+  * The newly released Gemini [Interactions API](https://ai.google.dev/gemini-api/docs/interactions) is supported in ADK now. To use it:
   ```Python
   Agent(
     model=Gemini(
@@ -352,7 +352,7 @@
 
 * 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 the broken langchain importing caused by 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))
@@ -629,7 +629,7 @@
 ### Documentation
 
 * Clean up docs in sample [a360bc2](https://github.com/google/adk-python/commit/a360bc25429bf4bef6a80da59afe30d6933a844b)
-* Fixes root_agent.yaml in tool_mcp_stdio_notion_config for Agent Config sample and add README.md [2c088ac](https://github.com/google/adk-python/commit/2c088acc9b34f030537b02b45a4afd458445d15b)
+* Fixes root_agent.yaml in tool_mcp_stdio_notion_config for Agent Config sample and adds README.md [2c088ac](https://github.com/google/adk-python/commit/2c088acc9b34f030537b02b45a4afd458445d15b)
 * Add What's new section to README.md [ccab076](https://github.com/google/adk-python/commit/ccab076aceff917591eb3a3cc89a9f85226b832a)
 
 ## 1.12.0 (2025-08-21)

CONTRIBUTING.md

@@ -56,14 +56,14 @@ information on using pull requests.
 
 ### Requirement for PRs
 
--   All PRs, other than small documentation or typo fixes, should have a Issue
+-   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.
 -   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 talk about how you
+-   Please include a `testing plan` section in your PR to describe how you
     will test. This will save time for PR review. See `Testing Requirements`
     section for more details.
 
@@ -126,7 +126,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 relevant
+[adk-docs](https://github.com/google/adk-docs) repository to update the relevant
 part before or alongside your code PR.
 
 ## Development Setup
@@ -160,7 +160,11 @@ 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:**
 
@@ -230,7 +234,7 @@ part before or alongside your code PR.
 ## Contributing Resources
 
 [Contributing folder](https://github.com/google/adk-python/tree/main/contributing)
-has resources that is helpful for contributors.
+has resources that are helpful for contributors.
 
 ## Vibe Coding
 

README.md

@@ -158,13 +158,13 @@ We welcome contributions from the community! Whether it's bug reports, feature r
 
 ## 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
+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.
+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
 

contributing/README.md

@@ -1,6 +1,6 @@
 # Contributing Resources
 
-This folder host resources for ADK contributors, for example, testing samples etc.
+This folder hosts 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 feed into LLMs for vibe-coding.
+ It can also be fed into LLMs for vibe-coding.

contributing/adk_project_overview_and_architecture.md

@@ -34,7 +34,7 @@ my_adk_project/
     └── my_app/
         ├── agents/
         │   ├── my_agent/
-        │   │   ├── __init__.py   # Must contain: from. import agent \
+        │   │   ├── __init__.py   # Must contain: from . import agent \
         │   │   └── agent.py      # Must contain: root_agent = Agent(...) \
         │   └── another_agent/
         │       ├── __init__.py
@@ -43,7 +43,7 @@ my_adk_project/
 
 agent.py: Must define the agent and assign it to a variable named root_agent. This is how ADK's tools find it.
 
-`__init__.py`: In each agent directory, it must contain from. import agent to make the agent discoverable.
+`__init__.py`: In each agent directory, it must contain `from . import agent` to make the agent discoverable.
 
 ## Local Development & Debugging
 
@@ -69,7 +69,7 @@ We expose agents as production APIs using FastAPI.
 
 - Custom Endpoints: We can add our own routes (e.g., /health) to the app object returned by the helper.
 
-Python
+```Python
 
 from google.adk.cli.fast_api import get_fast_api_app
 app = get_fast_api_app(agent_dir="./agents")
@@ -77,6 +77,7 @@ app = get_fast_api_app(agent_dir="./agents")
 @app.get("/health")
 async def health_check():
     return {"status": "ok"}
+```
 
 
 ## Deployment to Production

contributing/samples/adk_stale_agent/PROMPT_INSTRUCTION.txt

@@ -45,7 +45,7 @@ Your job is to analyze a specific issue and report findings before taking action
             - **IF True**: The user edited the description silently, and we haven't alerted yet.
               -> **Action**: Call `alert_maintainer_of_edit`.
               -> **Report**: "Analysis for Issue #[number]: ACTIVE. Silent update detected (Description Edit). Alerted maintainer."
-            - **IF False**: 
+            - **IF False**:
               -> **Report**: "Analysis for Issue #[number]: ACTIVE. Last action was by user. No action."
 
     - **Check Role**: If `last_action_role` is 'maintainer':
@@ -53,16 +53,21 @@ Your job is to analyze a specific issue and report findings before taking action
 
 **STEP 3: ANALYZE MAINTAINER INTENT**
 - **Context**: The last person to act was a Maintainer.
-- **Action**: Read the text in `last_comment_text`.
-    - **Question Check**: Does the text ask a question, request clarification, ask for logs, or suggest trying a fix?
+- **Action**: Analyze `last_comment_text` using `maintainers` list and `last_actor_name`.
+
+    - **Internal Discussion Check**: Does the comment mention or address any username found in the `maintainers` list (other than the speaker `last_actor_name`)?
+        - **Verdict**: **ACTIVE** (Internal Team Discussion).
+        - **Report**: "Analysis for Issue #[number]: ACTIVE. Maintainer is discussing with another maintainer. No action."
+
+    - **Question Check**: Does the text ask a question, request clarification, ask for logs, or give suggestions?
     - **Time Check**: Is `days_since_activity` > {stale_threshold_days}?
 
     - **DECISION**:
-        - **IF (Question == YES) AND (Time == YES)**:
+        - **IF (Question == YES) AND (Time == YES) AND (Internal Discussion Check == FALSE):**
             - **Action**: Call `add_stale_label_and_comment`.
-            - **Check**: If '{REQUEST_CLARIFICATION_LABEL}' is not in `current_labels`, call `add_label_to_issue` for it.
+            - **Check**: If '{REQUEST_CLARIFICATION_LABEL}' is not in `current_labels`, call `add_label_to_issue` with '{REQUEST_CLARIFICATION_LABEL}'.
             - **Report**: "Analysis for Issue #[number]: STALE. Maintainer asked question [days_since_activity] days ago. Marking stale."
         - **IF (Question == YES) BUT (Time == NO)**:
             - **Report**: "Analysis for Issue #[number]: PENDING. Maintainer asked question, but threshold not met yet. No action."
-        - **IF (Question == NO)** (e.g., "I am working on this"):
-            - **Report**: "Analysis for Issue #[number]: ACTIVE. Maintainer gave status update (not a question). No action."
+        - **IF (Question == NO) OR (Internal Discussion Check == TRUE):**
+            - **Report**: "Analysis for Issue #[number]: ACTIVE. Maintainer gave status update or internal discussion detected. No action."

contributing/samples/adk_stale_agent/agent.py

@@ -49,6 +49,7 @@ logger = logging.getLogger("google_adk." + __name__)
 BOT_ALERT_SIGNATURE = (
     "**Notification:** The author has updated the issue description"
 )
+BOT_NAME = "adk-bot"
 
 # --- Global Cache ---
 _MAINTAINERS_CACHE: Optional[List[str]] = None
@@ -246,8 +247,9 @@ def _build_history_timeline(
     if BOT_ALERT_SIGNATURE in c_body:
       if last_bot_alert_time is None or c_time > last_bot_alert_time:
         last_bot_alert_time = c_time
+      continue
 
-    if actor and not actor.endswith("[bot]"):
+    if actor and not actor.endswith("[bot]") and actor != BOT_NAME:
       # Use edit time if available, otherwise creation time
       e_time = c.get("lastEditedAt")
       actual_time = dateutil.parser.isoparse(e_time) if e_time else c_time
@@ -263,7 +265,7 @@ def _build_history_timeline(
     if not e:
       continue
     actor = e.get("editor", {}).get("login")
-    if actor and not actor.endswith("[bot]"):
+    if actor and not actor.endswith("[bot]") and actor != BOT_NAME:
       history.append({
           "type": "edited_description",
           "actor": actor,
@@ -285,7 +287,7 @@ def _build_history_timeline(
         label_events.append(time_val)
       continue
 
-    if actor and not actor.endswith("[bot]"):
+    if actor and not actor.endswith("[bot]") and actor != BOT_NAME:
       pretty_type = (
           "renamed_title" if etype == "RenamedTitleEvent" else "reopened"
       )
@@ -318,11 +320,13 @@ def _replay_history_to_find_state(
           - last_activity_time (datetime): Timestamp of the last human action.
           - last_action_type (str): The type of the last action (e.g., 'commented').
           - last_comment_text (Optional[str]): The text of the last comment.
+          - last_actor_name (str): The specific username of the last actor.
   """
   last_action_role = "author"
   last_activity_time = history[0]["time"]
   last_action_type = "created"
   last_comment_text = None
+  last_actor_name = issue_author
 
   for event in history:
     actor = event["actor"]
@@ -337,6 +341,7 @@ def _replay_history_to_find_state(
     last_action_role = role
     last_activity_time = event["time"]
     last_action_type = etype
+    last_actor_name = actor
 
     # Only store text if it was a comment (resets on other events like labels/edits)
     if etype == "commented":
@@ -349,6 +354,7 @@ def _replay_history_to_find_state(
       "last_activity_time": last_activity_time,
       "last_action_type": last_action_type,
       "last_comment_text": last_comment_text,
+      "last_actor_name": last_actor_name,
   }
 
 
@@ -428,6 +434,7 @@ def get_issue_state(item_number: int) -> Dict[str, Any]:
         "status": "success",
         "last_action_role": state["last_action_role"],
         "last_action_type": state["last_action_type"],
+        "last_actor_name": state["last_actor_name"],
         "maintainer_alert_needed": maintainer_alert_needed,
         "is_stale": is_stale,
         "days_since_activity": days_since_activity,
@@ -436,6 +443,8 @@ def get_issue_state(item_number: int) -> Dict[str, Any]:
         "current_labels": labels_list,
         "stale_threshold_days": STALE_HOURS_THRESHOLD / 24,
         "close_threshold_days": CLOSE_HOURS_AFTER_STALE_THRESHOLD / 24,
+        "maintainers": maintainers,
+        "issue_author": issue_author,
     }
 
   except RequestException as e:

contributing/samples/api_registry_agent/agent.py

@@ -21,19 +21,26 @@ from google.adk.tools.api_registry import ApiRegistry
 PROJECT_ID = "your-google-cloud-project-id"
 MCP_SERVER_NAME = "your-mcp-server-name"
 
-# Header required for BigQuery MCP server
-header_provider = lambda context: {
-    "x-goog-user-project": PROJECT_ID,
-}
-api_registry = ApiRegistry(PROJECT_ID, header_provider=header_provider)
+api_registry = ApiRegistry(PROJECT_ID)
 registry_tools = api_registry.get_toolset(
     mcp_server_name=MCP_SERVER_NAME,
 )
 root_agent = LlmAgent(
     model="gemini-2.0-flash",
     name="bigquery_assistant",
-    instruction="""
-Help user access their BigQuery data via API Registry tools.
+    instruction=f"""
+You are a helpful data analyst assistant with access to BigQuery. The project ID is: {PROJECT_ID}
+
+When users ask about data:
+- Use the project ID {PROJECT_ID} when calling BigQuery tools.
+- First, explore available datasets and tables to understand what data exists.
+- Check table schemas to understand the structure before querying.
+- Write clear, efficient SQL queries to answer their questions.
+- Explain your findings in simple, non-technical language.
+
+Mandatory Requirements:
+- Always use the BigQuery tools to fetch real data rather than making assumptions.
+- For all BigQuery operations, use project_id: {PROJECT_ID}.
     """,
     tools=[registry_tools],
 )

contributing/samples/bigtable/README.md

@@ -72,7 +72,7 @@ type.
 
 1.  Follow https://developers.google.com/workspace/guides/configure-oauth-consent
     to add scope "https://www.googleapis.com/auth/bigtable.admin" and
-    "https://www.googleapis.com/auth/bigtable.data" as declaration, this is used
+    "https://www.googleapis.com/auth/bigtable.data" as a declaration, this is used
     for review purpose.
 
 1.  Follow

contributing/samples/langchain_youtube_search_agent/README.md

@@ -1,7 +1,7 @@
 # Langchain YouTube Search Agent
 
-This agent utilize the Langchain YoutubeSearchTool to search youtubes.
-You need to install below dependencies:
+This agent utilizes the Langchain YoutubeSearchTool to search Youtube Videos.
+You need to install the following dependencies:
 
 ```python
 uv pip install youtube_search