chore: release main

[stainless-app]

✨ Stainless prepared a new release

agentex-client: 0.22.1

0.22.1 (2026-07-29)

Full Changelog: agentex-client-v0.22.0...agentex-client-v0.22.1

Bug Fixes

• ci: push tutorial images from buildx instead of re-pushing a stale local tag (#478) (a7c8f5a)

agentex-sdk: 0.22.1

0.22.1 (2026-07-29)

Full Changelog: agentex-sdk-v0.22.0...agentex-sdk-v0.22.1

Chores

• agentex-sdk: Synchronize agentex versions

---

This pull request is managed by Stainless's GitHub App.

The semver version number is based on included commit messages. Alternatively, you can manually set the version number in the title of this pull request.

For a better experience, it is recommended to use either rebase-merge or squash-merge when merging this pull request.

🔗 Stainless website
📚 Read the docs
🙋 Reach out for help or questions

Greptile Summary

This patch release (0.22.0 → 0.22.1) fixes a CI bug where docker push was re-pushing a stale local tag instead of the freshly built multi-platform image — multi-arch buildx outputs cannot be loaded into the local Docker store, so any subsequent docker push would have sent the wrong image.

• CI workflow redesign: Buildx now pushes directly to an immutable commit-SHA tag (--push flag on the build step), the image is validated from the registry, then promoted to :latest via docker buildx imagetools create (a registry-side manifest copy that preserves the multi-arch manifest list without rebuilding).
• Cache default flipped: agentex agents build and build_agent() now default cache=True instead of False; the old default's rationale (preventing stale layers when republishing a moving :latest tag) no longer applies since the workflow now uses immutable SHA tags for the candidate before promotion.
• Version bumps: agentex-client and agentex-sdk both increment to 0.22.1 with updated changelogs and manifests.

Confidence Score: 5/5

Safe to merge — the CI workflow is well-structured and the new push-from-buildx pattern correctly avoids the multi-platform image problem that the old approach had.

The workflow change is sound: the candidate SHA tag is pushed directly by buildx, validated from the registry, then promoted to :latest via a registry-side copy. No rebuild occurs at the promotion step, and :latest is never touched if validation fails. The cache default flip in the CLI is intentional and consistent with the new immutable-tag build strategy. All other changes are version bumps and changelog entries.

Files Needing Attention: No files require special attention. The GitHub Actions workflow is the most substantive change and the logic is straightforward.

Important Files Changed

Filename	Overview
.github/workflows/build-and-push-tutorial-agent.yml	Core CI fix: build pushes directly from buildx to an immutable SHA tag, validates the candidate, then promotes to :latest via imagetools create — correctly avoids the stale-local-tag re-push problem with multi-platform images
src/agentex/lib/cli/commands/agents.py	Cache CLI flag default flipped from False to True; help text updated to match — intentional companion change to the CI workflow fix
src/agentex/lib/cli/handlers/agent_handlers.py	build_agent() cache parameter default changed from False to True, docstring updated accordingly
src/agentex/_version.py	Version bumped from 0.22.0 to 0.22.1
pyproject.toml	agentex-client package version bumped from 0.22.0 to 0.22.1
adk/pyproject.toml	agentex-sdk package version bumped from 0.22.0 to 0.22.1

Sequence Diagram

sequenceDiagram
    participant GHA as GitHub Actions
    participant Buildx as docker buildx
    participant Registry as Container Registry
    participant Validator as Validate Step

    GHA->>Buildx: agentex agents build --push (SHA tag)
    Buildx->>Registry: Push multi-platform manifest to :sha
    GHA->>Validator: "Validate image (FULL_IMAGE=:sha)"
    Validator->>Registry: "Pull & inspect :sha"
    Validator-->>GHA: All checks passed
    GHA->>Registry: imagetools create --tag :latest :sha
    Note over Registry: :latest now points to validated :sha

Loading

_{Reviews (1): Last reviewed commit: "chore: release main" | Re-trigger Greptile}

[stainless-app]

🤖 Release is at https://github.com/scaleapi/scale-agentex-python/releases/tag/agentex-client-v0.22.1 🌻

[stainless-app]

🤖 Release is at https://github.com/scaleapi/scale-agentex-python/releases/tag/agentex-sdk-v0.22.1 🌻