release: 0.10.2

[stainless-app]

Automated Release PR

0.10.2 (2026-04-21)

Full Changelog: v0.10.1...v0.10.2

Features

• api: api update (d5b9945)
• adk: add task_id to span creation (#329) (0a120c7)

Bug Fixes

• adk: fix to queue drain (#327) (b59d6d8)

Performance Improvements

• client: optimize file structure copying in multipart requests (87fe899)

---

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.10.2) bundles three changes: a task_id field added to the entire span creation/update/list API surface and propagated through the Temporal activity layer; a performance improvement to AsyncSpanQueue that drains items in concurrent batches (all STARTs before ENDs per batch) instead of one-at-a-time; and a targeted deepcopy_with_paths utility that replaces the broader deepcopy_minimal, copying only the containers that lie on a multipart-file path.

Confidence Score: 5/5

Safe to merge — all changes are well-tested, ordering invariants are preserved, and the task_id field is propagated consistently.

No P0 or P1 findings. The span-queue batch refactor correctly maintains per-span START-before-END ordering. The task_id propagation is thorough and consistent across the sync, async, and Temporal paths. deepcopy_with_paths is well-tested.

No files require special attention.

Important Files Changed

Filename	Overview
src/agentex/lib/core/tracing/span_queue.py	Drain loop refactored to collect items into batches (default 50) and process STARTs concurrently then ENDs concurrently; per-span ordering guarantee preserved; task_done() correctly called in finally block for every gotten item.
src/agentex/_files.py	New deepcopy_with_paths utility replaces deepcopy_minimal; only copies mapping/list containers that lie on a file-extraction path, reducing unnecessary allocations for large payloads with few file fields.
src/agentex/lib/adk/_modules/tracing.py	task_id added to both span() and start_span() and forwarded through the Temporal StartSpanParams; propagation is consistent across the in-workflow and direct code paths.
src/agentex/lib/core/tracing/processors/sgp_tracing_processor.py	on_span_end now syncs span.input to the cached sgp_span before the upsert, matching the treatment of output/metadata; TODO(AGX1-198) added with Linear link for future batch optimisation.
src/agentex/resources/spans.py	task_id parameter added to create, update, and list endpoints for both sync and async resource classes; docstrings and payload dicts updated consistently.

_{Reviews (43): Last reviewed commit: "release: 0.10.2" | Re-trigger Greptile}

[stainless-app]

Release version edited manually

The Pull Request version has been manually set to 0.10.2 and will be used for the release.

If you instead want to use the version number 0.11.0 generated from conventional commits, just remove the label autorelease: custom version from this Pull Request.

[stainless-app]

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