Skip to content

chore(templates): bump aws-opentelemetry-distro to ~= 0.18.0 in Python templates - #2287

Merged
jariy17 merged 1 commit into
mainfrom
fix/bump-adot-templates
Sep 11, 2026
Merged

chore(templates): bump aws-opentelemetry-distro to ~= 0.18.0 in Python templates#2287
jariy17 merged 1 commit into
mainfrom
fix/bump-adot-templates

Conversation

@jariy17

@jariy17 jariy17 commented Sep 11, 2026

Copy link
Copy Markdown
Contributor

What

Pins aws-opentelemetry-distro to the 0.18.x line for the Python agent templates that use ADOT, across the http, a2a, and agui protocols:

  • Strands (http, a2a, agui)
  • LangChain / LangGraph (http, a2a, agui)
  • OpenAIAgents (http)

The AgentCore Runtime reports telemetry.auto.version: 0.18.0-aws, so this aligns the vended templates with the runtime's ADOT version.

Why GoogleADK is intentionally excluded

GoogleADK templates are left on their existing ADOT pin. aws-opentelemetry-distro 0.18.0 requires opentelemetry-api == 1.42.1, but google-adk < 2.0.0 caps opentelemetry-api at <= 1.41.1 — the two constraints are unsatisfiable together, and deploy fails at dependency resolution (before any runtime is created).

Moving GoogleADK to 0.18.0 would require bumping google-adk from 1.x to 2.x (a major version with breaking changes to template code), which is out of scope for this dependency bump. (The a2a GoogleADK template already tracks google-adk[a2a] >= 2.5.0 and is unaffected either way.)

Verification

Each changed template was deployed to AgentCore Runtime and invoked; telemetry was confirmed landing in the agent's own log group:

  • telemetry.auto.version: 0.18.0-aws present on emitted spans/records
  • non-zero sampled traceId in the spans stream

All 8 verified templates passed. (OpenAIAgents http required an OpenAI key to complete a functional invoke, but ADOT telemetry was confirmed regardless.)

Tests

  • npm run test:update-snapshots — asset snapshots regenerated
  • npm test — 6275 passed

Pins the ADOT distro to the 0.18.x line (runtime ships
telemetry.auto.version 0.18.0-aws) for the Strands, LangChain/LangGraph,
and OpenAIAgents templates across the http, a2a, and agui protocols.

GoogleADK templates are intentionally left on their existing ADOT pin:
0.18.0 requires opentelemetry-api 1.42.1, but google-adk < 2.0.0 caps
opentelemetry-api at <= 1.41.1, making the two unsatisfiable together.
Moving GoogleADK to 0.18.0 would require a google-adk 1.x -> 2.x major
bump (breaking changes), which is out of scope here.
@jariy17
jariy17 requested a review from a team September 11, 2026 19:19
@github-actions github-actions Bot added the size/xs PR size: XS label Sep 11, 2026
@jariy17
jariy17 deployed to e2e-testing September 11, 2026 19:20 — with GitHub Actions Active
@agentcore-devx-automation agentcore-devx-automation Bot added agentcore-harness-reviewing AgentCore Harness review in progress claude-security-reviewing Claude Code /security-review in progress labels Sep 11, 2026
@agentcore-devx-automation

Copy link
Copy Markdown
Contributor

Claude Security Review: no high-confidence findings. (run)

@agentcore-devx-automation agentcore-devx-automation Bot removed the claude-security-reviewing Claude Code /security-review in progress label Sep 11, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Package Tarball

aws-agentcore-0.28.1.tgz

How to install

gh release download pr-2287-tarball --repo aws/agentcore-cli --pattern "*.tgz" --dir /tmp/pr-tarball
npm install -g /tmp/pr-tarball/aws-agentcore-0.28.1.tgz

@agentcore-devx-automation agentcore-devx-automation Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AgentCore Harness Review

Verdict: Changes requested

Missed template: a2a/googleadk

The PR pins aws-opentelemetry-distro ~= 0.18.0 in 7 of the 8 pyproject.toml templates that declare this dependency, but misses src/assets/python/a2a/googleadk/base/pyproject.toml (line 13), which still has an unpinned "aws-opentelemetry-distro",.

If the motivation for this pin is to avoid a bad upstream release (0.19.0 is the current latest on PyPI, and the constraint ~= 0.18.0 deliberately excludes it), then generated Google ADK A2A projects will still resolve to the excluded version, defeating the purpose of the pin.

Please either:

  1. Update src/assets/python/a2a/googleadk/base/pyproject.toml to use "aws-opentelemetry-distro ~= 0.18.0" and regenerate the snapshot in src/assets/__tests__/__snapshots__/assets.snapshot.test.ts.snap (the entry for python/a2a/googleadk/base/pyproject.toml currently still shows the unpinned form), or
  2. Explicitly document in the PR description why a2a/googleadk is intentionally excluded from the pin.

The other googleadk templates (agui/googleadk, http/googleadk) don't declare this dependency, so nothing is needed for them.

@agentcore-devx-automation agentcore-devx-automation Bot removed the agentcore-harness-reviewing AgentCore Harness review in progress label Sep 11, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Coverage Report

Status Category Percentage Covered / Total
🔵 Lines 41.08% 15742 / 38319
🔵 Statements 40.34% 16790 / 41618
🔵 Functions 35.19% 2712 / 7705
🔵 Branches 34.24% 10526 / 30738
Generated in workflow #4468 for commit 661eb93 by the Vitest Coverage Report Action

@jariy17 jariy17 changed the title Bump aws-opentelemetry-distro to ~= 0.18.0 in Python templates chore(templates): bump aws-opentelemetry-distro to ~= 0.18.0 in Python templates Sep 11, 2026
@github-actions github-actions Bot added size/xs PR size: XS and removed size/xs PR size: XS labels Sep 11, 2026
@jariy17
jariy17 merged commit 86f9ae0 into main Sep 11, 2026
43 of 46 checks passed
@jariy17
jariy17 deleted the fix/bump-adot-templates branch September 11, 2026 19:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/xs PR size: XS

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants