Skip to content

Commit 6627ed4

Browse files
Merge branch 'main' into enforce-tool-confirmation-denials
2 parents 4311da1 + bb9023d commit 6627ed4

266 files changed

Lines changed: 22029 additions & 3748 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.agents/skills/adk-agent-builder/references/advanced-patterns.md‎

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -169,8 +169,7 @@ raises `ValueError` naming the offending node or edge.
169169
4. Every node is reachable from `START`, and `START` has no incoming edges.
170170
5. No two edges share both a source and a target — routes are not part of edge
171171
identity.
172-
6. At most one `__DEFAULT__` route per node, and `__DEFAULT__` never appears
173-
inside a list of routes.
172+
6. A `route` list on one edge never mixes `__DEFAULT__` with named routes.
174173
7. No unconditional cycle — a cycle needs at least one routed edge.
175174
8. Where a source declares `output_schema` and its target declares
176175
`input_schema`, the two must be the same schema.

‎.agents/skills/adk-agent-builder/references/routing-and-conditions.md‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -73,8 +73,9 @@ edges = [
7373
]
7474
```
7575

76-
One default per node. `'__DEFAULT__'` may not appear inside a list of routes on
77-
one edge — give it its own edge.
76+
The default fans out like any other route, so `'__DEFAULT__': (a, b)` triggers
77+
both. `'__DEFAULT__'` may not appear inside a list of routes on one edge — give
78+
it its own edge.
7879

7980
## One edge, several routes
8081

‎.agents/skills/adk-architecture/SKILL.md‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,13 +54,15 @@ code does not. Paths below are relative to `src/google/adk/`.
5454
| `Workflow`, `_LoopState` | `workflow/_workflow.py` |
5555
| `Graph`, edge compilation | `workflow/_graph.py` |
5656
| `NodeRunner` | `workflow/_node_runner.py` |
57-
| `DynamicNodeScheduler` | `workflow/_dynamic_node_scheduler.py` |
57+
| `DynamicNodeScheduler`, `DynamicNodeState`, `DynamicNodeRun` | `workflow/_dynamic_node_scheduler.py` |
5858
| `ReplayManager` (resume scan) | `workflow/utils/_replay_manager.py` |
59+
| `check_interception` (replay fast-forward) | `workflow/utils/_replay_interceptor.py` |
5960
| `NodeInterruptedError`, `NodeTimeoutError` | `workflow/_errors.py` |
6061
| `Context`, `ctx.run_node()` | `agents/context.py` |
6162
| `ReadonlyContext` | `agents/readonly_context.py` |
6263
| `InvocationContext` | `agents/invocation_context.py` |
6364
| `BaseAgent`, `LlmAgent` (aliased `Agent`) | `agents/base_agent.py`, `agents/llm_agent.py` |
65+
| `BaseLlmFlow`, `SingleFlow`, `AutoFlow`, `flows/llm_flows/` subpackages (`context/`, `prompt/`, `tools/`, `extensions/`, `core/`) | `flows/llm_flows/` |
6466
| `Event`, `NodeInfo` | `events/event.py` |
6567
| `EventActions` | `events/event_actions.py` |
6668
| Branch paths (`parent.child@1`) | `events/_branch_path.py` |

‎.agents/skills/adk-architecture/references/architecture-workflow-resumability.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,8 @@ durability.
5656

5757
`Workflow._emit_node_checkpoint` does persist a node-status snapshot when
5858
`ic.is_resumable` — an `agent_state` event carrying `{"nodes": {name: {status,
59-
interrupts, resume_inputs}}}` for each static child. Two sibling markers are
59+
interrupts}}}` for each static child (`resume_inputs` is intentionally omitted
60+
from the checkpoint). Two sibling markers are
6061
written under the same flag: `_maybe_reemit_replayed_output` re-surfaces a
6162
fast-forwarded node's output, and `_emit_end_of_agent` records that the
6263
workflow ran to completion.

‎.agents/skills/adk-architecture/references/interface-workflow.md‎

Lines changed: 169 additions & 88 deletions
Large diffs are not rendered by default.

‎.agents/skills/adk-review/SKILL.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -79,6 +79,14 @@ Confirm the changed files pass `pre-commit run --files {paths}`.
7979
(human-in-the-loop steps and checkpoints). See the `adk-architecture` skill.
8080
- **Concurrency and lifetime**: no race conditions; plugins, exporters, and
8181
connections are closed on every path, including the error path.
82+
- **Database and runtime DDL safety**: runtime startup paths (e.g.,
83+
`DatabaseSessionService.prepare_tables()` and
84+
`_ensure_schema_indexes_exist()`) must never execute destructive DDL such as
85+
`DROP INDEX` (which takes `ACCESS EXCLUSIVE` locks and breaks rolling
86+
deployments/rollbacks). Any additive runtime DDL must account for
87+
multi-container startup races (process-local `asyncio.Lock` does not prevent
88+
cross-container TOCTOU races on `checkfirst=True`) by wrapping creation in a
89+
`SAVEPOINT` (`connection.begin_nested()`) and tolerating concurrent creation.
8290

8391
### 5. Documentation impact
8492

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
11
{
2-
".": "2.9.0"
2+
".": "2.9.2"
33
}

‎.github/workflows/continuous-integration.yml‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -53,6 +53,12 @@ jobs:
5353
uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
5454
with:
5555
persist-credentials: false
56+
# The new-file hook resolves what a change added by diffing
57+
# HEAD~1..HEAD, and reads a NO_UNIT_GUIDE waiver from the same
58+
# range. At the default depth of 1 there is no HEAD~1, so the hook
59+
# can see neither, and reports that it could not determine the file
60+
# set rather than checking anything.
61+
fetch-depth: 0
5662

5763
- name: Install the latest version of uv
5864
uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78 # v7
@@ -61,6 +67,16 @@ jobs:
6167

6268
- name: Run pre-commit checks
6369
uses: pre-commit/action@2c7b3805fd2a0fd8c1884dcaebf91fc102a13ecd # v3.0.1
70+
env:
71+
# Skip the new-file hook on pushes to main. Those are Copybara
72+
# exports of changes that were already gated internally, and the
73+
# export keeps only the public part of the description -- so a change
74+
# legitimately waived with NO_UNIT_GUIDE arrives here carrying no
75+
# waiver at all, and the hook would fail main for a rule that was
76+
# already satisfied. Pull requests keep the hook: there the waiver
77+
# travels in the contributor's own commit message, which is inside
78+
# the range the hook reads.
79+
SKIP: ${{ github.event_name == 'push' && 'check-new-py-prefix' || '' }}
6480

6581
# 2. Static type analysis (Mypy Check with Matrix)
6682
# Compares new changes against the target base branch dynamically to support v1.

‎.pre-commit-config.yaml‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -64,6 +64,15 @@ repos:
6464
# This script documents and matches the very patterns it forbids, so
6565
# it must not scan itself or other dev-only tooling.
6666
exclude: ^scripts/
67+
- id: check-docs
68+
name: Check documentation links and guide index
69+
description: Verifies that relative links in docs/ and contributing/ resolve, and that every guide is listed in the guides index.
70+
entry: scripts/check_docs.py
71+
language: script
72+
# Deleting or renaming a guide breaks the index without editing any
73+
# file this hook would be handed, so it reads the tree itself.
74+
always_run: true
75+
pass_filenames: false
6776
- id: update-constraints
6877
name: update-constraints
6978
# --check reuses the resolution date recorded in each constraints file.

‎CHANGELOG.md‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,31 @@
11
# Changelog
22

3+
## [2.9.2](https://github.com/google/adk-python/compare/v2.9.1...v2.9.2) (2026-09-18)
4+
5+
6+
### Highlights
7+
8+
This release focuses on refining telemetry behavior by correcting how OpenTelemetry event names are handled across different environments.
9+
10+
* **Telemetry**: OpenTelemetry event names are now preserved on platforms outside of Agent Engine, ensuring more accurate and consistent tracking. ([9110770](https://github.com/google/adk-python/commit/9110770dc487283b95844ad843db9eec9e56e92d))
11+
12+
### Bug Fixes
13+
14+
* **telemetry:** only drop the OTel event name on Agent Engine ([9110770](https://github.com/google/adk-python/commit/9110770dc487283b95844ad843db9eec9e56e92d))
15+
16+
## [2.9.1](https://github.com/google/adk-python/compare/v2.9.0...v2.9.1) (2026-09-15)
17+
18+
19+
### Highlights
20+
21+
This release focuses on improving visibility into model reasoning steps when utilizing Claude's adaptive thinking capabilities.
22+
23+
* **Claude Integration**: Access the step-by-step reasoning process of Claude models by ensuring visible thoughts are requested during adaptive thinking tasks. ([ba0d542](https://github.com/google/adk-python/commit/ba0d542181df87b6e1da9709fa0410082484443a))
24+
25+
### Bug Fixes
26+
27+
* request visible thoughts for Claude adaptive thinking ([ba0d542](https://github.com/google/adk-python/commit/ba0d542181df87b6e1da9709fa0410082484443a))
28+
329
## [2.9.0](https://github.com/google/adk-python/compare/v2.8.0...v2.9.0) (2026-09-10)
430

531

0 commit comments

Comments
 (0)