agentex-sdk: v0.13.1

0.13.1 (2026-06-17)

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

Bug Fixes

• packaging: guard agentex-client surface, bump floor, smoke-test wheel install (#406) (a5abbb9)

Documentation

• drop stale keep_files / dashboard-config comments (#401) (23858df)

agentex-client: v0.13.1

0.13.1 (2026-06-17)

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

Bug Fixes

• adk: re-send task_id/agent_id in state updates for backend compatibility (#405) (f59f26d)
• packaging: guard agentex-client surface, bump floor, smoke-test wheel install (#406) (a5abbb9)

Documentation

• drop stale keep_files / dashboard-config comments (#401) (23858df)

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-toggleab...

v0.12.0

0.12.0 (2026-06-02)

Full Changelog: v0.11.9...v0.12.0

Features

• api: Bump edition to switch rye -> UV (1bd4ff7)

Bug Fixes

• cap Python test matrix at 3.13 and align dev tooling versions (#391) (729763c)

---

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 is the automated 0.12.0 release PR, primarily migrating the entire dev toolchain from rye to uv 0.10.2 and bumping the version consistently across pyproject.toml, _version.py, and the release manifest.

• All CI jobs (lint, build, test), the publish workflow, the devcontainer, and helper scripts (bootstrap, test, lint, format, publish-pypi) are updated to use uv commands; the uv version is uniformly pinned to 0.10.2.
• The devcontainer base Python image is upgraded from 3.9 → 3.12, aligning with the new test matrix minimum.
• Lock files (uv.lock, requirements-dev.lock, requirements.lock) are regenerated to reflect the new toolchain.

Confidence Score: 5/5

Safe to merge — this is a clean tooling migration with the uv version pinned consistently at 0.10.2 across CI, the publish workflow, and the devcontainer.

The rye-to-uv migration is internally consistent: all three CI jobs, the publish workflow, and the devcontainer use the same uv 0.10.2 binary. The version bump is coherent across all version-bearing files. The two observations (broad required-version floor and the 3.11 test-coverage gap) are non-blocking quality notes that don't affect runtime correctness of the published package.

No files require special attention; scripts/test and pyproject.toml have a minor declared-vs-tested Python version gap worth cleaning up at leisure.

Important Files Changed

Filename	Overview
.github/workflows/ci.yml	Migrated all three jobs (lint, build, test) from rye to uv 0.10.2 via astral-sh/setup-uv; version is consistent across all jobs.
.github/workflows/publish-pypi.yml	Updated from rye to uv 0.10.2, now consistent with CI; previous version mismatch (0.9.13 vs 0.10.2) has been resolved.
pyproject.toml	Bumped to 0.12.0, migrated build tooling config to uv; requires-python declares 3.11+ but test matrix only covers 3.12-3.13.
scripts/test	Migrated from rye to uv; test matrix now runs 3.12 and 3.13 only, leaving Python 3.11 (declared supported) untested.
scripts/bootstrap	Replaced rye sync with uv python install + uv sync + uv export for lock file generation.
.devcontainer/Dockerfile	Upgraded base Python from 3.9 to 3.12 and replaced rye install with uv 0.10.2 copied from the official image.
src/agentex/_version.py	Version bumped to 0.12.0, consistent with pyproject.toml and .release-please-manifest.json.
bin/publish-pypi	Replaced rye build/publish commands with uv build + uv publish.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[Push / PR] --> B[CI: lint job]
    A --> C[CI: build job]
    A --> D[CI: test job]

    B --> B1["uv 0.10.2 install\nuv sync --all-extras\n./scripts/lint"]
    C --> C1["uv 0.10.2 install\nuv sync --all-extras\nuv build"]
    D --> D1["uv 0.10.2 install\n./scripts/bootstrap\n./scripts/test"]

    D1 --> D2["Python 3.12 run\n(PY_VERSION_MIN)"]
    D1 --> D3["Python 3.13 run\n(PY_VERSION_MAX)"]

    E[GitHub Release] --> F[publish-pypi workflow]
    F --> F1["uv 0.10.2 install\nbin/publish-pypi"]
    F1 --> F2["uv build\nuv publish → PyPI"]

<a href="https://chatgpt.com/codex/deeplink?prompt=IMPORTANT%3A%20Work%20in%20the%20repository%20%22scaleapi%2Fscale-agentex-python%22%20on%20the%20existing%20branch%20%22release-please--branches--main--changes--next%22.%20Checkout%20that%20branch%20%E2%80%94%20do%20NOT%20create%20a%20new%20branch%20or%20open%20a%20new%20PR.%20Push%20your%20changes%20to%20%22release-please--branches--main--changes--next%22.%0A%0AFix%20the%20following%202%20code%20review%20issues.%20Work%20through%20them%20one%20at%20a%20time%2C%20proposing%20concise%20fixes.%0A%0A---%0A%0A%23%23%23%20Issue%201%20of%202%0Apyproject.toml%3A80-82%0AThe%20%60required-version%60%20floor%20of%20%60%22%3E%3D0.9%22%60%20is%20quite%20broad%20while%20every%20workflow%20and%20the%20devcontainer%20pins%20exactly%20%600.10.2%60.%20A%20developer%20who%20installs%20uv%20from%20Homebrew%20%28%60brew%20%22uv%22%60%20in%20the%20Brewfile%29%20will%20get%20the%20latest%20available%20version%20rather%20than%20the%20pinned%20one%2C%20but%20at%20l...

v0.11.9

0.11.9 (2026-06-02)

Full Changelog: v0.11.8...v0.11.9

Features

• api: add register build api endpoint (30c5da4)

v0.11.8

0.11.8 (2026-06-01)

Full Changelog: v0.11.7...v0.11.8

Features

• cli: add Temporal + LangGraph agent template and example (#383) (bbc9e02)
• tracing: OTel span queue and export telemetry (SGPINF-1863) (#373) (6669012)

---

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 (0.11.8) ships two features: a new Temporal + LangGraph agent template/example, and OTel span queue + export telemetry instrumentation.

• Temporal + LangGraph template: Adds a full CLI template (temporal-langgraph) and a matching tutorial example. The template includes human-in-the-loop interrupt handling via Temporal signals, live introspection queries, and per-turn SGP tracing (correctly guarded by SGP_API_KEY / SGP_ACCOUNT_ID). A new emit_langgraph_messages ADK helper converts LangGraph message objects to Agentex content types.
• OTel span queue telemetry: Adds tracing_metrics.py (instrument definitions) and tracing_metrics_recording.py (best-effort recording helpers) with bounded tag cardinality throughout. The recording path is disabled via AGENTEX_TRACING_METRICS=0 and swallows all exceptions so it is safe on hot paths. enqueued_at timestamps are correctly preserved through re-enqueues for accurate lag histograms.

Confidence Score: 5/5

Safe to merge — changes are additive, all tag values are bounded, and the recording helpers are exception-safe on hot paths.

Both features are purely additive. The tracing metrics are well-isolated behind a feature flag and best-effort exception handling. The LangGraph template correctly guards credential-dependent setup. No behavioral regressions are introduced in existing code paths.

src/agentex/lib/core/tracing/span_queue.py — the retry path silently re-enqueues failed items without emitting a failure metric, making transient errors invisible until retries are exhausted.

Important Files Changed

Filename	Overview
src/agentex/lib/core/tracing/span_queue.py	Adds OTel instrumentation across enqueue, batch-drain, and shutdown paths. enqueued_at timestamp is correctly preserved through re-enqueues. record_export_failure is only called for permanently-dropped spans (exhausted retries or non-retriable errors), leaving transient failures unobservable in metrics.
src/agentex/lib/core/observability/tracing_metrics.py	New file: defines the OTel instrument set for span queue + export telemetry. All tag cardinalities are explicitly bounded. Singleton is created lazily via get_tracing_metrics().
src/agentex/lib/core/observability/tracing_metrics_recording.py	New file: best-effort recording helpers that lazy-load the OTel SDK module. AGENTEX_TRACING_METRICS=0 disables all recording. All helpers silently swallow exceptions.
src/agentex/lib/core/tracing/processors/sgp_tracing_processor.py	Adds record_export_success calls after successful upsert_batch on both on_spans_start and on_spans_end.
src/agentex/lib/adk/_modules/_langgraph_messages.py	New helper converting LangGraph/LangChain message objects to Agentex content types after ainvoke. Handles both OpenAI and Anthropic content block formats.
src/agentex/lib/cli/templates/temporal-langgraph/project/workflow.py.j2	Full-featured Temporal+LangGraph template with human-in-the-loop, live queries, and properly guarded tracing setup.
examples/tutorials/10_async/10_temporal/130_langgraph/project/workflow.py	Simplified example workflow with durable multi-turn state kept on the workflow instance.
tests/lib/core/tracing/test_span_queue.py	New TestAsyncSpanQueueMetrics suite covering enqueue, drop, failure, and disabled-metrics fast-path scenarios.

Sequence Diagram

sequenceDiagram
    participant Caller
    participant AsyncSpanQueue
    participant Metrics as tracing_metrics_recording
    participant Processor as SGPAsyncTracingProcessor
    participant SGP as SGP HTTP API

    Caller->>AsyncSpanQueue: enqueue(event_type, span, processors)
    AsyncSpanQueue->>Metrics: record_span_enqueued(event_type)
    Note over AsyncSpanQueue: stores enqueued_at timestamp

    AsyncSpanQueue->>AsyncSpanQueue: drain loop (linger_ms)
    AsyncSpanQueue->>Metrics: record_batch_coalesced(queue_depth, batch_items)

    AsyncSpanQueue->>Processor: on_spans_start / on_spans_end
    Processor->>SGP: upsert_batch(...)

    alt HTTP success
        SGP-->>Processor: 200 OK
        Processor->>Metrics: record_export_success(event_type, span_count, sgp)
    else Retriable failure (retries remaining)
        SGP-->>Processor: 5xx / network error
        Processor-->>AsyncSpanQueue: raises exception
        Note over AsyncSpanQueue: re-enqueues item, no metric emitted
    else Retries exhausted
        AsyncSpanQueue->>Metrics: record_export_failure(exhausted_count)
    else Permanent non-retriable failure
        AsyncSpanQueue->>Metrics: record_export_failure(all items)
    end

    AsyncSpanQueue->>Metrics: record_batch_phase(phase, size, duration_ms)

    Note over AsyncSpanQueue: on shutdown timeout
    AsyncSpanQueue->>Metrics: record_shutdown_timeout(remaining_items)

<a href="https://chatgpt.com/codex/deeplink?prompt=IMPORTANT%3A%20Work%20in%2...

v0.11.7

0.11.7 (2026-06-01)

Full Changelog: v0.11.6...v0.11.7

Features

• examples: OpenAI Agents SDK local-sandbox tutorials (sync + async + temporal) (#377) (a66d239)

Performance Improvements

• tracing: bounded-concurrency span export (#374) (7b32a0d)

Chores

• back-merge release 0.11.6 into next (#384) (13d3eab)

v0.11.6

0.11.6 (2026-05-29)

Full Changelog: v0.11.5...v0.11.6

Features

• api: add cleaned_at field to task response types (38ed338)
• deps: bump openai-agents to >=0.14.3 for scale-sandbox oai_agents adapter (#375) (e1b31d9)
• lib: expose data_converter kwarg on AgentexWorker and Temporal client APIs (#372) (d04624e)

Bug Fixes

• tutorials: restore tutorial CI deps after agentex-sdk 0.11.5 (pytest + debugpy) (#379) (0a2418c)

Performance Improvements

• tracing: span queue linger + per-loop httpx keepalive (#362) (feec842)

Chores

• back-merge release 0.11.5 into next (#381) (ab5a7d9)
• deps: drop unused runtime deps and exclude tests from wheel (#367) (f4303d1)

Refactors

• types: promote protocol types to agentex.protocol.* (#371) (6f1c14f)

v0.11.5

0.11.5 (2026-05-29)

Full Changelog: v0.11.4...v0.11.5

Features

• api: add cleaned_at field to task response types (38ed338)
• deps: bump openai-agents to >=0.14.3 for scale-sandbox oai_agents adapter (#375) (e1b31d9)

Performance Improvements

• tracing: span queue linger + per-loop httpx keepalive (#362) (feec842)

Chores

• deps: drop unused runtime deps and exclude tests from wheel (#367) (f4303d1)

Refactors

• types: promote protocol types to agentex.protocol.* (#371) (6f1c14f)

v0.11.4

0.11.4 (2026-05-26)

Full Changelog: v0.11.3...v0.11.4

Chores

• deps: relax redis pin to support 6.x/7.x (#363) (7817ced)
• relax requires-python floor to >= 3.11 (#366) (a064f92)