agentex-client: v0.13.0

0.13.0 (2026-06-10)

Full Changelog: agentex-client-v0.12.0...agentex-client-v0.13.0

⚠ BREAKING CHANGES

• packaging: release tag scheme changes from v* to -v*.

Features

• add AgentCard for self-describing agent capabilities (#296) (6509be1)
• add HTTP-proxy LangGraph checkpointer (19fae2f)
• add OCI Helm registry support for agent deployments (#255) (5f054b5)
• adk: allow all ClaudeAgentOptions in run_claude_agent_activity (25bbe24)
• adk: Revamp run_claude_agent_activity to use more streaming (#309) (0c16595)
• api: api update (7b1b642)
• api: api update (710c63f)
• api: api update (8abce2b)
• api: Switch target to -client (e741990)
• lib: Add task updates to adk (a58747f)
• openai_agents: expose real usage, response_id, plumb previous_response_id, opt-in prompt_cache_key for stateful responses and prompt caching (#335) (ba5d64b)
• packaging: introduce slim agentex-client + heavy agentex-sdk split (bbfb22e)
• pass AGENTEX_DEPLOYMENT_ID in registration metadata (#305) (31af8c6)
• tracing: Add background queue for async span processing (#303) (3a60add)

Bug Fixes

• add litellm retry with exponential backoff for rate limit errors (ccdb24a)
• adk: fix to queue drain (#327) (a862a06)
• api: remove agent_id and task_id parameters from states update method (a7cbaae)
• client: preserve hardcoded query params when merging with user params (d2c4788)
• ensure file data are only sent as 1 parameter (48fae27)
• render .env.example template in agentex init (#351) (6092595)
• Temporal Union deserialization causing tool_response messages to be lost (79ef4dd)
• temporal: allowing-ACP-temporal-telemetry (9b44eb0)
• tests: repair test_streaming_model so all 28 tests run and pass (#334) (7e5e69c)
• tracing: Fix memory leak in SGP tracing processors (#302) (f43dac4)
• tutorials: stop at130-langgraph workflow deadlock on graph compile (#399) (bd90a61)

Performance Improvements

• client: optimize file structure copying in multipart requests (f5064f9)
• tracing: larger span batch + linger_ms for high-volume ingest (#397) (c0d6330)
• tracing: skip span-start upsert by default (end-only ingest) (#394) (ae1c7ca)

Chores

• ci: upgrade actions/github-script (7c867e8)
• gitignore .claude/scheduled_tasks.lock (#400) (e186352)

Documentation

• api: clarify name parameter behavior in agent task creation (ce5af72)
• clarify task name is optional in adk.acp.create_task (#392) (bd41d9b)

Refactors

• config: promote deployment-config models to agentex.config.* (#396) (9825dba)

agentex-sdk: 0.13.0

0.13.0 (2026-06-10)

Full Changelog: agentex-sdk-v0.12.0...agentex-sdk-v0.13.0

⚠ BREAKING CHANGES

• packaging: release tag scheme changes from v* to -v*.

Features

• packaging: introduce slim agentex-client + heavy agentex-sdk split (bbfb22e)

---

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 release (v0.13.0) introduces two major structural changes: a slim/heavy package split (agentex-client for the pure REST client, agentex-sdk for the full ADK overlay) and a config module promotion that moves canonical deployment/agent config models from agentex.lib.sdk.config.* / agentex.lib.types.* into the new agentex.config.* namespace, with back-compat re-export shims keeping old import paths working.

• Package split: pyproject.toml becomes agentex-client (6 slim deps); the new adk/pyproject.toml becomes agentex-sdk with all ADK/CLI/LLM deps, pinning agentex-client>=0.12.0. A scripts/check-slim-deps CI guard prevents dep drift.
• Config promotion: All model classes are now in agentex.config.*; shims in the old paths re-export the identical class objects so isinstance checks remain correct across import styles. AgentEnvironmentsConfig.from_yaml() is replaced by the standalone load_environments_config() helper (kept in the shim module to preserve slim-safety).
• Tracing optimisations: span-start writes are skipped by default (end-only ingest via AGENTEX_TRACING_SKIP_SPAN_START), and the span-queue batch size / linger window are both increased for higher throughput. A tutorial deadlock caused by using LangGraph's ToolNode (a Runnable) inside a Temporal-wrapped workflow node is also fixed.

Confidence Score: 5/5

Safe to merge — all changes are well-tested, breaking changes are documented in the CHANGELOG, and the back-compat shims are covered by identity-checking tests.

The package split and config promotion are structural refactors with comprehensive shim tests confirming symbol parity and class identity. Tracing optimisations default to the new behaviour but are runtime-toggleable via env vars. The states.update parameter removal and from_yaml → load_environments_config migration are properly documented and all internal call sites are updated.

No files require special attention; the suggestion on sgp_tracing_processor.py is cosmetic.

Important Files Changed

Filename	Overview
pyproject.toml	Renamed package agentex-sdk→agentex-client; drops all ADK/CLI/LLM deps, keeping only 6 slim REST-client deps; adds uv workspace config for co-development.
adk/pyproject.toml	New pyproject for the heavy agentex-sdk package shipping agentex/lib/*; pins agentex-client>=0.12.0 (floor-only, co-released at 0.13.0), requires Python >=3.12.
src/agentex/config/environment_config.py	New canonical location for environment config models (AgentEnvironmentsConfig, etc.); yaml-loading helpers intentionally excluded to stay slim-safe.
src/agentex/config/deployment_config.py	New canonical location for DeploymentConfig and related models; uses ConfigBaseModel (populate_by_name=True) replacing the old class Config: validate_by_name pattern.
src/agentex/lib/sdk/config/deployment_config.py	Reduced to a back-compat re-export shim pointing all symbols to the canonical agentex.config.deployment_config location.
src/agentex/lib/sdk/config/environment_config.py	Back-compat shim for model classes; yaml-loading helpers stay here intentionally to keep canonical models slim-safe.
src/agentex/resources/states.py	Removes agent_id and task_id from both sync and async states.update() signatures; breaking API change documented in CHANGELOG.
src/agentex/lib/core/tracing/processors/sgp_tracing_processor.py	Adds end-only ingest optimisation: AGENTEX_TRACING_SKIP_SPAN_START env var (default ON) short-circuits on_span_start/on_spans_start; constructor logs current mode.
src/agentex/lib/core/tracing/span_queue.py	Default batch_size bumped 50→200, linger_ms 100→250ms; batch_size now resolves from env at construction time.
examples/tutorials/10_async/10_temporal/130_langgraph/project/graph.py	Replaces LangGraph ToolNode prebuilt with a plain async function to prevent Temporal deadlock during graph.compile().
tests/test_config_shims.py	New test file pinning back-compat contract: symbol parity, class object identity for isinstance correctness, and populate_by_name behaviour for the global-alias field.
scripts/check-slim-deps	New CI guardrail asserting the slim client has exactly 6 bare-client deps, preventing accidental ADK dep re-injection by Stainless codegen.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    subgraph canonical["agentex.config.* (new canonical)"]
        CC[credentials.py\nCredentialMapping]
        AC[agent_configs.py\nTemporalConfig / WorkflowConfig]
        AGC[agent_config.py\nAgentConfig]
        BC[build_config.py\nBuildConfig]
        DC[deployment_config.py\nDeploymentConfig / Cluster...]
        EC[environment_config.py\nAgentEnvironmentsConfig]
        LDC[local_development_config.py\nLocalDevelopmentConfig]
        AM[agent_manifest.py\nAgentManifest]
    end

    subgraph shims["Back-compat shims (re-export only)"]
        S1[agentex.lib.types.credentials]
        S2[agentex.lib.types.agent_configs]
        S3[agentex.lib.sdk.config.agent_config]
        S4[agentex.lib.sdk.config.deployment_config]
        S5[agentex.lib.sdk.config.environment_config\n+ yaml loaders stay here]
        S6[agentex.lib.sdk.config.agent_manifest]
    end

    subgraph packages["Published packages"]
        CLIENT["agentex-client\n(slim REST client)"]
        SDK["agentex-sdk\n(heavy ADK overlay)\ndeps: agentex-client>=0.12.0"]
    end

    S1 -->|re-exports| CC
    S2 -->|re-exports| AC
    S3 -->|re-exports| AGC
    S4 -->|re-exports| DC
    S5 -->|re-exports models| EC
    S6 -->|re-exports| AM

    canonical -->|ships in| CLIENT
    shims -->|ships in| SDK

Prompt To Fix All With AI

Fix the following 1 code review issue. Work through them one at a time, proposing concise fixes.