Liang Wu

This commit **fixes broken package references** within the **`google.adk.environment` and `google.adk.tools.environment` modules**. It **refactors import paths** for core components like `BaseEnvironment` and `ExecutionResult` across `_local_environment.py`, `_environment_toolset.py`, and `_tools.py` to reflect their correct internal locations. Additionally, the `_get_tools` method in `_environment_toolset.py` is updated to correctly instantiate environment tools with their new class names. This **maintenance fix** resolves issues introduced by prior refactoring, ensuring the proper functioning and internal consistency of the ADK's environment management and tooling.

This commit introduces a **new capability** by adding the `LocalEnvironment` class, enabling agents to execute shell commands and perform file I/O operations directly on the local machine. Utilizing `asyncio` subprocesses, this environment supports custom working directories and environment variables, significantly expanding agent interaction possibilities. A new sample agent configuration, `root_agent` within the `contributing/samples/local_environment` module, is included to demonstrate the practical application of `LocalEnvironment` and `EnvironmentToolset` for local command execution. This enhancement provides a robust mechanism for **local machine interaction** within the agent framework.

This commit **introduces a new `EnvironmentToolset`** within the **ADK's `tools/environment` module**, providing a **new capability** for interacting with a `BaseEnvironment`. This toolset includes functionalities for **file I/O (ReadFile, WriteFile, EditFile) and shell command execution (Execute)**. It enables **LLMs to directly manipulate the workspace and execute commands**, guided by injected system instructions. This significantly enhances the ADK's ability to manage and operate within execution environments, facilitating more complex automated tasks.

This commit performs a **refactoring** of the **GKE Code Executor** by updating the import path for `SandboxClient` within `src/google/adk/code_executors/gke_code_executor.py` from `agentic_sandbox` to `k8s_agent_sandbox`. Concurrently, it includes a **dependency update** in `pyproject.toml` to require version `>=0.1.1.post3` of the `k8s-agent-sandbox` package. This ensures the executor correctly integrates with the renamed Kubernetes agent sandbox library, preventing import errors and maintaining compatibility. The change is essential for the continued functionality of the **Kubernetes agent sandbox integration** within the system.

This commit **fixes** an issue within the **BigQuery credentials module** by updating the **Dataplex OAuth scope** to a valid, more specific read-write scope. The change in `src/google/adk/tools/bigquery/bigquery_credentials.py` replaces a generic scope, which was causing authentication problems. This **bug fix** ensures proper authorization when **BigQuery** tools interact with **Dataplex**, preventing potential access failures. Corresponding unit tests in `tests/unittests/tools/bigquery/test_bigquery_credentials.py` have been updated to reflect this corrected scope.

This commit introduces **SSE streaming support** to the **conformance testing framework**, enabling the system to accurately record, replay, and verify interactions with streaming LLM responses. It enhances the **CLI tools** via `cli_conformance_record` and `cli_conformance_test` to accept a streaming mode argument, and updates the **recording and replay plugins** to handle mode-specific session files and streaming LLM responses, including an updated `recordings_schema.py` to store a list of LLM responses. The **LLM flows** in `base_llm_flow.py` are modified to dynamically instantiate a mocked Gemini model for replay, while the **conformance test runner** and **markdown report generation** are updated to support and report on multiple streaming modes. This **new capability** ensures that the **conformance tests** can validate the behavior of agents and LLMs under various streaming conditions.

This commit **upgrades** the `actions/checkout` GitHub Action from `v4` to `v6` across all **release-related CI/CD workflows**. This **maintenance chore** affects the `release-cherry-pick`, `release-cut`, `release-finalize`, `release-please`, and `release-publish` pipelines, as seen in the `.github/workflows/` directory. The update is crucial because `v4` relies on a deprecated Node.js 20 environment, ensuring the **stability and security of the build infrastructure** by using a currently supported Node.js version. This change prevents potential issues with outdated dependencies in the automated release process.

This commit **streamlines the GitHub Actions CI workflow** for **Python unit tests** by refining the `uv sync` command. It **removes unnecessary `--extra eval` and `--extra a2a` flags**, ensuring that only `--extra test` dependencies are installed during the setup phase. This **maintenance** change, affecting `.github/workflows/python-unit-tests.yml`, simplifies the CI configuration and makes the dependency synchronization process more precise and efficient for unit test execution.

This commit **fixes a race condition** in the **`DatabaseSessionService`** by refactoring its `_prepare_tables` method. Previously, concurrent initialization could lead to issues during database table creation due to separate schema detection and table creation steps. The change introduces a **single, unified lock** for both operations, ensuring atomicity and preventing multiple threads from attempting to create tables simultaneously. This **bug fix** significantly improves the **robustness and reliability** of database session initialization, especially in high-concurrency scenarios, and is validated by new unit tests.

This commit provides a **documentation update** by modifying an **example agent configuration** in `contributing/samples/core_generate_content_config_config/root_agent.yaml`. Specifically, it demonstrates how to integrate `thinking_config` with `include_thoughts: true` within the `generate_content_config` for agents. This **enhancement to the sample** helps users understand how to enable and configure thought processes, while also updating the example to utilize the `gemini-2.5-flash` model.

chore: remove `scipy` from eval dependencies

This commit **refactors** the dependency installation process for **unit tests** by modifying the `uv sync` command to exclusively use `--extra test`. It removes `--extra eval` and `--extra a2a` from the command, streamlining the dependencies required for unit testing. This **maintenance** change, primarily affecting `scripts/unittests.sh`, aims to **resolve potential GitHub Actions errors** and optimize the CI workflow. Furthermore, the **documentation** in `AGENTS.md` and `CONTRIBUTING.md` is updated to reflect this more precise and efficient command for contributors.

This commit **introduces a new capability** to the **conformance reporting system**, enabling it to fetch and display server version information. Specifically, it **enhances the `adk_web_server_client`** to retrieve version data from the `/version` endpoint, which is then passed by `cli_test.py` to the `_generate_markdown_utils.py` module. As a result, **generated markdown conformance reports** will now include detailed server version information, providing **improved traceability and context** for test results.

This commit performs **CI/CD maintenance** and a broad **code style enforcement** to align the project with updated tooling and internal standards. It **updates the Python versions** for the `pyink` and `isort` GitHub Actions workflows to 3.11 and adds Python 3.14 to the unit test matrix, resolving a recent Pyink error and ensuring pipeline compatibility. Across numerous **ADK core modules**, **contributing samples**, and **test files**, the commit introduces `from __future__ import annotations` imports and reformats various multiline string literals for improved consistency. Additionally, minor **refactorings** simplify code in `src/google/adk/flows/llm_flows/audio_cache_manager.py` and `src/google/adk/tools/bigtable/metadata_tool.py`, alongside general code cleanup. This work ensures the project's automated checks remain functional and enhances overall code readability and maintainability.

This commit introduces **new API endpoints**, `/health` and `/version`, to the **ADK web server** (`AdkWebServer`). These endpoints provide essential **health checks** and detailed **version information**, including the ADK version and Python runtime specifics, enhancing the server's observability. This **new feature** is crucial for generating **ADK conformance test reports** and improving system diagnostics. Comprehensive unit tests have been added to ensure the reliability of these new API routes.

This commit introduces a **new capability** to the **ADK CLI conformance testing framework**, enabling the generation of detailed reports for test runs. It adds `--generate_report` and `--report_dir` command-line options to the `adk conformance test` command, allowing users to produce structured Markdown reports of their test results. A new utility file, `_generate_markdown_utils.py`, provides the core logic for creating these reports, which is then integrated into the `run_conformance_test` function. This enhancement significantly improves the analysis and sharing of conformance test outcomes by providing a comprehensive, human-readable summary.

This commit performs **maintenance** by **removing the unused `tzlocal` dependency** and its associated logging from the project. Specifically, the `DatabaseSessionService` no longer attempts to determine or log the local timezone, as this functionality was found to be redundant and unutilized. This change **simplifies the codebase** and **reduces unnecessary dependencies**, contributing to a leaner and more efficient application.

This commit **fixes a bug** in the **CLI's session management** by refining how the **SQLite session service** processes database connection arguments. The `_create_sqlite_session_factory` function in `src/google/adk/cli/service_registry.py` is updated to **explicitly ignore unsupported `session_db_kwargs`**, ensuring that `SqliteSessionService` only receives its required `db_path`. This change prevents potential runtime issues by logging a warning when extraneous arguments are provided, thereby improving the **robustness and stability of the CLI's database interactions**. New unit tests confirm this defensive behavior.

This commit **fixes a critical issue** within the **`google.adk.sessions` database session service** by ensuring that **database transactions are always rolled back** when exceptions occur. It introduces the `_rollback_on_exception_session` async context manager, which is integrated into all core database session operations like `create_session` and `delete_session`, preventing potential data inconsistencies. This **bug fix** guarantees robust transaction management, and its correct behavior is verified by new unit tests that specifically check for rollbacks on commit failures and exceptions.

This commit **fixes** the broken `/docs` path for the **OpenAPI documentation** within the **FastAPI server**, restoring access to the API specification. The resolution involves **upgrading the `fastapi` dependency** to version `0.124.1` to incorporate an upstream fix and removing a previously imposed upper-bound restriction on the `fastapi` version. Additionally, **deprecated API endpoints** are removed, and a new unit test in `tests/unittests/cli/test_fast_api.py` is added to **verify OpenAPI JSON schema accessibility**, enhancing the stability of the **API documentation** subsystem. This **maintenance** and **bug fix** ensures that developers and users can reliably consult the project's API documentation.