Repository navigation
[deps-release-notes] mcpg — upstream release action items #1253
Copy link
Copy link
Closed as not planned
Labels
automationdependenciesPull requests that update a dependency filePull requests that update a dependency file
Description
Rolling upstream release action items — mcpg
This is the single canonical tracking issue for action items from new mcpg releases. The update-awf-version workflow appends a comment here for each version bump going forward — the most recent activity lives in the comments below. This body consolidates everything filed so far.
Latest pinned version covered: 0.3.32
Consolidated history (earliest → latest)
0.3.12 → 0.3.23 (was #882)
- OTel span attributes aligned with gen_ai semantic conventions (v0.3.16): MCPG now emits OTel spans following the OpenTelemetry gen_ai semconv. ado-aw's audit analyzer (
src/audit/analyzers/otel.rs) may need updating if it relies on specific MCPG span field names. - Per-session tool call limits in allow-only guard policies (v0.3.20): MCPG enforces per-session limits in allow-only mode; ado-aw could expose as a configurable field (e.g.,
tools.call-limit:). - Timeout fields added to embedded JSON schema (v0.3.23): MCPG config schema now includes timeout fields; ado-aw should review whether to surface in
engine:ortools:front-matter. - Security: GHE Cloud data residency proxy routing fix (v0.3.23): GraphQL requests were routed to wrong upstream for GHE Cloud data-residency tenants; fixed automatically on version bump.
0.3.23 → 0.3.24 (was #903)
- Breaking: "API key" surface renamed to "Agent ID" (v0.3.24): Deprecated compatibility aliases removed; gateway now uses
X-Agent-IDfor routing. Audit MCPG config types insrc/compile/extensions/mod.rsfor any removed alias fields. - Unauthenticated
/reflectendpoint for live DIFC label snapshots (v0.3.24): New diagnostics endpoint; ado-aw'saudit/statuscommands could use this for richer DIFC diagnostics.
0.3.23 → 0.3.25 (was #931)
- Security:
$ENVexpansion disabled in tool response filters (v0.3.25): Prevents environment variable leakage/injection through crafted tool responses. Verify any custom filter expressions remain functional. - Metadata endpoint allowlisting (v0.3.25): MCPG proxy now allowlists metadata endpoints and passes through unrecognized reads; may resolve prior MCP client liveness/metadata call blocking.
0.3.25 → 0.3.26 (was #1059)
- OTLP multi-endpoint fan-out via
GH_AW_OTLP_ENDPOINTS(v0.3.26): MCPG supports sending OTel telemetry to multiple OTLP endpoints; ado-aw could expose in compiled pipeline variables. - Deprecation:
MCP_GATEWAY_API_KEY→MCP_GATEWAY_AGENT_ID(v0.3.26):run.shnow readsMCP_GATEWAY_AGENT_IDwith deprecated fallback forMCP_GATEWAY_API_KEY. ado-aw generates pipelines that setMCP_GATEWAY_API_KEY(src/compile/agentic_pipeline.rs,src/compile/common.rs); migrate toMCP_GATEWAY_AGENT_IDbefore the fallback is removed.
0.3.25 → 0.3.27 (was #1119)
- GitHub MCP Server v1.3.0 support (v0.3.27): MCPG routes PR commits and supports
get_file_blamespec; verify GitHub MCP extension config + network allowlists are compatible. refusal-labelsguard policy (v0.3.27): New guard policy type for classifying agent refusals; ado-aw could expose in MCPG configuration.MCP_GATEWAY_SHUTDOWN_TIMEOUTenv var documented (v0.3.27): ado-aw could expose in generated pipeline teardown steps.
0.3.25 → 0.3.28 (was #1169)
- Security: wazero WASM guard hardening (v0.3.28): Added memory cap and backend call limit to wazero WASM runtime; protects against malicious/malformed WASM guards. Consumers benefit automatically on upgrade.
0.3.25 → 0.3.29 (was #1185)
- Security: DIFC labeling gaps covered (v0.3.28):
get_code_quality_finding,ui_get,add_gpg_key,add_ssh_keypreviously lacked DIFC integrity/secrecy labels; gap now closed. Older MCPG versions did not enforce integrity for these operations. - Opt-in observed URL domain audit pipeline (v0.3.29): Records which URL domains appear in MCP tool responses + write sinks; ado-aw could expose opt-in flag and surface data in
ado-aw auditreports.
0.3.29 → 0.3.31 (was #1242)
- Gateway domain validation widened to RFC-1123 topology hostnames (v0.3.30): Accepts topology hostnames like
my-server.namespace.svc.cluster.local; fixes unexpected validation errors. - Prompt passthrough via go-sdk (v0.3.31): Fixes context propagation + adds prompt passthrough through SDK-mediated backend calls.
- DIFC proxy GHEC data-residency REST API host derivation fix (v0.3.31): Fixes wrong API host calculation for GHEC data-residency deployments.
0.3.29 → 0.3.32 (was #1253) — canonical
- GitHub reaction operations classified as
WRITE_OPERATIONS(v0.3.32): Adding/removing emoji reactions now subject to DIFC integrity enforcement. Agents calling GitHub reaction APIs require adequate DIFC integrity clearance. This is a security tightening — confirm DIFC integrity level is configured correctly.
Consolidated by the Deps Release-Notes Consolidator workflow. Superseded per-release issues were closed and point here.
Generated by Deps Release-Notes Consolidator · 319.3 AIC · ⌖ 17.7 AIC · ⊞ 6.6K · ◷
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
automationdependenciesPull requests that update a dependency filePull requests that update a dependency file
Activity
[-][deps-release-notes] mcpg v0.3.32 action items[/-][+][deps-release-notes] mcpg — upstream release action items[/+]github-actions commentedon Jul 3, 2026
mcpg0.3.29→0.3.33Releases analyzed
Security fixes
fix(guard): add reaction operations to WRITE_OPERATIONS and DIFC rules— GitHub reaction operations (👍/👎 etc.) were previously missing from theWRITE_OPERATIONSand DIFC enforcement rules. They are now correctly classified. ado-aw workflows whose agent uses reaction tools may see tighter authorization enforcement after this MCPG upgrade.Fix DIFC proxy GHEC data-residency REST API host derivation— the DIFC proxy was incorrectly deriving the REST API host for GitHub Enterprise Cloud (GHEC) data-residency domains. Fixed to ensure DIFC policies apply correctly to GHEC endpoints.Deprecations
api_keydeprecated in favour ofagent_id(v0.3.33):Replace deprecated api_key with agent_id in example config— if ado-aw's compiled pipelines or documentation reference theapi_keyMCPG config field, they should be updated to useagent_idinstead.github-actions commentedon Jul 8, 2026
mcpg0.3.29→0.4.0Releases analyzed
Security fixes
WRITE_OPERATIONS. They now are. No ado-aw changes needed; this confirms reactions are properly gated at the MCPG layer.Add sink-visibility to write-sink guard policy to prevent GitLost exfiltration) checks sink visibility before allowing writes, preventing a class of exfiltration where an agent could write to a private or unlisted sink. No ado-aw changes required; defense-in-depth improvement at the MCPG guard layer.Notable features for ado-aw to adopt
Fix ToolAnnotations drop in routed mode— tool annotations were silently dropped in multi-backend (routed) mode. Since ado-aw uses routed mode for its MCP setup, tool annotations set by ado-aw's safe-outputs MCP tools are now correctly propagated to the agent.feat(tracing): OTel improvements from go-fan review— improved OpenTelemetry span and trace coverage in the MCPG routing layer; better observability for diagnosing tool-call latency and routing hops inado-aw audit.fix: widen gateway.domain validation to accept RFC-1123 topology hostnames—gateway.domainnow accepts hostnames likemcpg.namespace.svc.cluster.local; relevant for ado-aw users deploying MCPG inside Kubernetes clusters.Deprecations
api_keyconfig field deprecated in favor ofagent_id(v0.3.33):Replace deprecated api_key with agent_id in example config— theapi_keyfield in MCPG config has been replaced byagent_id. Audit ado-aw's MCPG config generation (e.g.src/compile/extensions/safe_outputs.rs,src/compile/common.rs) for anyapi_keyfield emission and migrate toagent_id.github-actions commentedon Jul 9, 2026
mcpg0.3.29→0.4.1Releases analyzed
Notable features for ado-aw to adopt
force-public-reposenforcement for public repositories (v0.4.1, #8933, #8948): MCPG now automatically enforcesrepos="public"when a workflow runs in a public GitHub repository, applying in both standard and proxy modes. ado-aw should document this behavior indocs/mcpg.mdanddocs/network.mdso users authoring workflows for public repositories understand why they may see stronger repo-access restrictions at runtime. No compiler change required, but the behavioural guarantee may be worth surfacing to users.ToolAnnotations now pass through in routed mode (v0.4.0, #8567): A bug that silently dropped
ToolAnnotationswhen routing MCP calls through MCPG was fixed. If ado-aw surfaces tool annotations (e.g., for theazure-devopsorcache-memorytools), those annotations will now be visible to the agent. No ado-aw code change required; verify that any tool-annotation metadata ado-aw emits is intentional.Deprecations
api_keyfield deprecated in favour ofagent_id(v0.3.33, #8342): MCPG's example config replacedapi_keywithagent_id. If ado-aw generates or documents MCPG config that includesapi_key, it should be updated to useagent_idto stay aligned with the upstream recommendation. Checksrc/compile/extensions/safe_outputs.rs,src/compile/extensions/github.rs, and any doc references to MCPG config schema.github-actions commentedon Jul 20, 2026
mcpg0.4.1→0.4.3Releases analyzed
Notable features for ado-aw to adopt
MCP_GATEWAY_FORCE_PUBLIC_REPOSandGITHUB_REPOSITORYdocumented as gateway env vars — v0.4.2 adds these toENVIRONMENT_VARIABLES.md.MCP_GATEWAY_FORCE_PUBLIC_REPOSforces the gateway to treat all repos as public (useful for restricted-token scenarios). ado-aw could consider surfacingMCP_GATEWAY_FORCE_PUBLIC_REPOSas a config option for consumers that need it. (v0.4.2)MCP_GATEWAY_WASM_GUARDS_DIRenv var now checked bydetectGuardWasm— v0.4.2 extends WASM guard discovery to also check this env var, giving consumers an additional way to configure custom WASM guards. No ado-aw change required; noted for awareness. (v0.4.2)github-actions commentedon Jul 24, 2026
mcpg0.4.1→0.4.5Releases analyzed
Security fixes
0.4.5. (v0.4.5)Notable features for ado-aw to adopt
MCP_GATEWAY_FORCE_PUBLIC_REPOSenv var documented —MCP_GATEWAY_FORCE_PUBLIC_REPOSandGITHUB_REPOSITORYare now formally documented inENVIRONMENT_VARIABLES.md. ado-aw could exposeMCP_GATEWAY_FORCE_PUBLIC_REPOSas a front-matter option if consumers need to force MCPG to treat repos as public for routing purposes. (v0.4.2)lint/mcp-authorerror surfaces may benefit from consuming these improved error messages if they forward MCPG config errors to users. (v0.4.4)github-actions commentedon Jul 27, 2026
mcpg0.4.1→0.4.6Releases analyzed
Security fixes
fix: bump Go to 1.26.4 and grpc to v1.82.1 to clear High CVEs(v0.4.5) — Go runtime and gRPC were bumped to resolve High severity CVEs. This fix is contained in the pre-built MCPG binary that ado-aw pins; updatingMCPG_VERSIONto0.4.5+ picks it up automatically.Notable features for ado-aw to adopt
Add configurable stdio container runtime (Docker/Podman) with runtime command overrides(v0.4.6) — MCPG now supports selecting between Docker and Podman (and overriding runtime commands) via a newMCP_GATEWAY_CONTAINER_RUNTIMEenvironment variable. ado-aw could expose this option in theengine:ortools:front-matter block to let consumers running rootless Podman environments switch runtimes without forking the pipeline.chore: bump MCPGatewaySpecVersion to 1.15.0(v0.4.6) — The MCP Gateway spec version advanced to 1.15.0. ado-aw should verify that any spec-version-gated behaviour in the gateway (e.g. new routing modes or capability negotiation) remains compatible with the compiled pipeline output.docs: add MCP_GATEWAY_FORCE_PUBLIC_REPOS and GITHUB_REPOSITORY to ENVIRONMENT_VARIABLES.md(v0.4.2) — Two new documented environment variables:MCP_GATEWAY_FORCE_PUBLIC_REPOS(forces public-repo scope) andGITHUB_REPOSITORY(repo context injection). ado-aw may want to passGITHUB_REPOSITORYthrough to the MCPG container in the compiled pipeline.github-actions commentedon Jul 30, 2026
mcpg0.4.1→0.4.7Releases analyzed
Security fixes
Notable features for ado-aw to adopt
github-actions commentedon Aug 5, 2026
mcpg0.4.1→0.4.8Releases analyzed
Security fixes
ghcr.io/github/gh-aw-mcpg), consumers benefit automatically once the pinned version is updated — no action needed beyond the version bump itself.The remaining releases in this range (0.4.2, 0.4.3, 0.4.4, 0.4.6, 0.4.7, 0.4.8) were documentation updates, clippy/lint fixes, internal refactors, and test-coverage improvements with no consumer-visible effect — no breaking changes, notable adoptable features, or deprecations were found.
Warning
Firewall blocked 1 domain
The following domain was blocked by the firewall during workflow execution:
index.crates.ioTo allow these domains, add them to the
network.allowedlist in your workflow frontmatter:See Network Configuration for more information.
github-actions commentedon Aug 10, 2026
mcpg0.4.1→0.4.9Releases analyzed
Security fixes
docs/mcp.md) remain compatible.Notable features for ado-aw to adopt
container-runtime:option intools:/mcp:front-matter for consumers who prefer Podman over Docker./reflect-adjacent diagnostics / DIFC labeling coverage expansion (v0.4.8–v0.4.9): continued DIFC label test coverage additions (PR review write tools, legacy aliases) reduce the chance of unlabeled write operations; no direct action needed, but reinforces confidence in DIFC-based safe-output policy forazure-devops/GitHub MCP tools.The remainder of the 0.4.2–0.4.9 range is dominated by internal refactors, test-coverage improvements, and doc reconciliation with no consumer-visible behavior change.
github-actions commentedon Aug 20, 2026
mcpg0.4.1→0.4.10Releases analyzed
Security fixes
src/tools/, MCPG extension wiring) don't rely on any host-path mount pattern that this policy would now reject.Notable features for ado-aw to adopt
runtime:(docker/podman) option in its MCPG/container tool configuration for environments where Docker-in-Docker isn't available or Podman is preferred for security/isolation reasons.github-actions commentedon Aug 26, 2026
mcpg0.4.10→0.4.11Releases analyzed
Notable features for ado-aw to adopt
This release was otherwise routine: test coverage improvements, debug logging additions, internal refactors (DIFC resource API cleanup, Rust guard dedup), a testify dependency bump, and CI/workflow maintenance — no breaking changes, security fixes, or deprecations.
github-actions commentedon Aug 29, 2026
Consolidated into the canonical rolling issue #2040 ( [deps-release-notes] mcpg — upstream release action items ). Its action items have been preserved there.