Merge branch 'main' into test/forwarding-artifact-service-coverage

Author: rohityan

.github/workflows/issue-maintenance.yml

@@ -0,0 +1,100 @@
+# 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 Issue Tracker Maintenance"
+
+on:
+  # Daily background cleanup at 6:00 AM UTC (10 PM PST)
+  schedule:
+    - cron: '0 6 * * *'
+
+  # Allows manual triggering from the Actions console
+  workflow_dispatch:
+    inputs:
+      run_spam_monitor:
+        description: 'Run Issue Monitoring Agent (Spam Sweep)'
+        type: boolean
+        default: true
+      full_scan:
+        description: 'For Issue Monitoring: Run an Initial Full Scan of ALL open issues'
+        type: boolean
+        default: false
+      run_stale_auditor:
+        description: 'Run Stale Issue Auditor Agent'
+        type: boolean
+        default: true
+
+permissions:
+  issues: write
+  contents: read
+
+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-3.5-flash"
+  PYTHONPATH: contributing/samples/adk_team
+
+jobs:
+  # 1. Sweep for spam, advertising, and invalid issues
+  sweep-spam:
+    if: |
+      github.repository == 'google/adk-python' &&
+      (github.event_name == 'schedule' || github.event.inputs.run_spam_monitor == 'true')
+    runs-on: ubuntu-latest
+    timeout-minutes: 120
+    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 python-dotenv
+
+      - name: Run Issue Monitoring Agent (Spam Sweep)
+        env:
+          INITIAL_FULL_SCAN: ${{ github.event.inputs.full_scan == 'true' }}
+        run: python -m adk_issue_monitoring_agent.main
+
+  # 2. Audit inactive issues and nudge/close them
+  audit-stale:
+    if: |
+      github.repository == 'google/adk-python' &&
+      (github.event_name == 'schedule' || github.event.inputs.run_stale_auditor == 'true')
+    runs-on: ubuntu-latest
+    timeout-minutes: 60
+    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 python-dateutil
+
+      - name: Run Stale Auditor Agent
+        run: python -m adk_stale_agent.main

.github/workflows/issue-monitor.yml

@@ -15,22 +15,24 @@
 name: ADK Pull Request Triaging Agent
 
 on:
-  pull_request_target:
-    types: [opened, reopened, edited]
+  schedule:
+    # Run every 6 hours
+    - cron: '0 */6 * * *'
   workflow_dispatch:
     inputs:
       pr_number:
-        description: 'The Pull Request number to triage'
-        required: true
+        description: 'The Pull Request number to triage (leave empty for batch mode)'
+        required: false
+        type: 'string'
+      pr_count:
+        description: 'Number of PRs to process in batch mode (default: 10)'
+        required: false
+        default: '10'
         type: 'string'
 
 jobs:
   agent-triage-pull-request:
-    if: >-
-      github.event_name == 'workflow_dispatch' || (
-        github.event.pull_request.head.repo.full_name == github.repository &&
-        !contains(github.event.pull_request.labels.*.name, 'google-contributor')
-      )
+    if: github.repository == 'google/adk-python'
     runs-on: ubuntu-latest
     permissions:
       pull-requests: write
@@ -57,7 +59,8 @@ jobs:
           GOOGLE_GENAI_USE_VERTEXAI: 0
           OWNER: 'google'
           REPO: 'adk-python'
-          PULL_REQUEST_NUMBER: ${{ github.event.pull_request.number || github.event.inputs.pr_number }}
+          PULL_REQUEST_NUMBER: ${{ github.event.pull_request.number || github.event.inputs.pr_number || '' }}
+          PR_COUNT_TO_PROCESS: ${{ github.event.inputs.pr_count || '10' }}
           INTERACTIVE: ${{ vars.PR_TRIAGE_INTERACTIVE }}
           PYTHONPATH: contributing/samples/adk_team
         run: python -m adk_pr_triaging_agent.main

.github/workflows/pr-triage.yml

@@ -1,33 +1,3 @@
-# AI Coding Assistant Context
-
-This document provides context for AI coding assistants (Antigravity, Gemini CLI, etc.) to understand the ADK Python project and assist with development.
-
-## ADK Knowledge, Architecture, and Style
-
-For all matters regarding ADK development, please use the appropriate skill:
-
-- **`adk-architecture`**: Use this skill whenever you need to understand the architecture, event flow, or state management of the ADK system, or when designing or modifying core components and public APIs.
-  - Read `.agents/skills/adk-architecture/SKILL.md` for full instructions.
-- **`adk-style`**: Use this skill whenever writing code, tests, or reviewing PRs for the ADK project to ensure compliance with styling and coding conventions. Also use it for committing, bug fixing, and testing rules.
-  - Read `.agents/skills/adk-style/SKILL.md` for full instructions.
-- **`adk-git`**: Use this skill for any git operation (commit, push, pull, rebase, etc.). It provides guidelines for Conventional Commits and branch naming.
-  - Read `.agents/skills/adk-git/SKILL.md` for full instructions.
-- **`adk-sample-creator`**: Use this skill when creating new samples demonstrating features or agent patterns, or when adding examples to subdirectories under `contributing/`.
-  - Read `.agents/skills/adk-sample-creator/SKILL.md` for full instructions.
-- **`adk-review`**: Use this skill to review local changes for errors, style compliance, unintended outcomes, and to check if associated design docs, guides, samples, or tests need updates.
-  - Read `.agents/skills/adk-review/SKILL.md` for full instructions.
-- **`adk-issue`**: Use this skill when analyzing, triaging, and resolving GitHub issues for the adk-python repository (orchestrating both triage and fix implementation). Do NOT use this skill if the "/adk-issue-analyze" command is explicitly requested.
-  - Read `.agents/skills/adk-issue/SKILL.md` for full instructions.
-- **`adk-issue-analyze`**: Use this skill to fetch, inspect, and analyze a GitHub issue in a strictly read-only manner. Use this skill when the "/adk-issue-analyze" command is explicitly called.
-  - Read `.agents/skills/adk-issue-analyze/SKILL.md` for full instructions.
-- **`adk-issue-fix`**: Use this skill to implement the code changes, unit tests, and documentation updates for an approved GitHub issue fix. Use this skill when the "/adk-issue-fix" command is explicitly called.
-  - Read `.agents/skills/adk-issue-fix/SKILL.md` for full instructions.
-- **`adk-pr-analyze`**: Use this skill to fetch, inspect, and analyze a GitHub pull request in a strictly read-only manner. Use this skill when the "/adk-pr-analyze" command is explicitly called.
-  - Read `.agents/skills/adk-pr-analyze/SKILL.md` for full instructions.
-- **`adk-pr-triage`**: Use this skill to orchestrate triaging and reviewing GitHub pull requests (PRs) (orchestrating both analysis and user review/checkout). Do NOT use this skill if the "/adk-pr-analyze" command is explicitly requested.
-  - Read `.agents/skills/adk-pr-triage/SKILL.md` for full instructions.
-
-
 ## Project Overview
 
 The Agent Development Kit (ADK) is an open-source, code-first Python toolkit for building, evaluating, and deploying sophisticated AI agents.
@@ -45,6 +15,10 @@ The Agent Development Kit (ADK) is an open-source, code-first Python toolkit for
 
 For details on how the Runner works and the invocation lifecycle, please refer to the `adk-architecture` skill and the referenced documentation therein.
 
+## ADK Knowledge, Architecture, and Style
+
+Skills related to ADK development are in `.agents/skills/`.
+
 ## Project Architecture
 
 For detailed architecture patterns, component descriptions, and core interfaces, please refer to the **`adk-architecture`** skill at `.agents/skills/adk-architecture/SKILL.md`.