release: 0.10.5

[stainless-app]

Automated Release PR

0.10.5 (2026-05-05)

Full Changelog: v0.10.4...v0.10.5

Features

• api: api update (ffaecd5)
• openai_agents: expose real usage, response_id, plumb previous_response_id, opt-in prompt_cache_key for stateful responses and prompt caching (#335) (ba5d64b)

Chores

• internal: reformat pyproject.toml (ba06702)
• internal: reformat pyproject.toml (3faf5d5)
• internal: version bump (168cc44)
• internal: version bump (5715828)

---

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

• Introduces batched span dispatch: AsyncSpanQueue._process_items now groups spans per-processor and calls on_spans_start/on_spans_end in one call, letting processors like SGPAsyncTracingProcessor send a single upsert_batch HTTP request per drain cycle instead of one request per span.
• Adds status and task_metadata filter parameters to tasks.list() (sync and async), and task_metadata to ParamsCreateTaskRequest in both RPC param types, matching an API spec update.
• Three issues flagged in prior review threads remain open in sgp_tracing_processor.py: _spans populated before the HTTP call (stale state on failure), shutdown() calling into a None client when disabled=True, and a production assert in span_queue.py.

Confidence Score: 3/5

Three P1-level issues from prior review threads remain unaddressed; this PR adds a new mutual-recursion trap in the processor interface.

The prior review identified three concrete bugs (assert stripped with -O, _spans populated before upsert, shutdown() AttributeError when disabled). None were fixed in this PR. This PR additionally introduces the mutual-recursion interface design issue. Score is pulled below the P1 ceiling due to multiple unresolved P1 findings.

src/agentex/lib/core/tracing/processors/sgp_tracing_processor.py and src/agentex/lib/core/tracing/processors/tracing_processor_interface.py

Important Files Changed

Filename	Overview
src/agentex/lib/core/tracing/processors/tracing_processor_interface.py	Adds default batched on_spans_start/on_spans_end fan-out; the fan-out calls on_span_start, creating a mutual-recursion trap when subclasses delegate on_span_start back to on_spans_start without overriding on_spans_start.
src/agentex/lib/core/tracing/processors/sgp_tracing_processor.py	Refactors single-span methods to delegate to new batch methods; _spans is populated before the disabled guard and before the HTTP call, leaving orphaned entries on failure or when disabled (flagged in prior review threads); shutdown() still lacks a disabled guard.
src/agentex/lib/core/tracing/span_queue.py	_process_items refactored to group spans per-processor and call batched methods; assert guards the same-event-type precondition (assert is stripped with -O, flagged in prior review).
src/agentex/resources/tasks.py	Adds status and task_metadata filter parameters to list() on both sync and async variants; straightforward generated-SDK change.
src/agentex/types/task_list_params.py	Adds status and task_metadata TypedDict fields aligned with the new tasks.py parameters.
tests/lib/core/tracing/processors/test_sgp_tracing_processor.py	Adds batch-path tests for on_spans_start/on_spans_end verifying single upsert_batch call and correct span counts.

Sequence Diagram

sequenceDiagram
    participant Caller
    participant AsyncSpanQueue
    participant SGPAsyncTracingProcessor

    Caller->>AsyncSpanQueue: enqueue(START, span, processors)
    AsyncSpanQueue->>AsyncSpanQueue: _drain_loop: collect batch, split START/END
    AsyncSpanQueue->>SGPAsyncTracingProcessor: on_spans_start([span1, span2, ...])
    SGPAsyncTracingProcessor->>SGPAsyncTracingProcessor: build sgp_spans, populate _spans
    SGPAsyncTracingProcessor->>SGPAsyncTracingProcessor: upsert_batch(items=[...])

    Caller->>AsyncSpanQueue: enqueue(END, span, processors)
    AsyncSpanQueue->>SGPAsyncTracingProcessor: on_spans_end([span1, span2, ...])
    SGPAsyncTracingProcessor->>SGPAsyncTracingProcessor: pop from _spans, update fields
    SGPAsyncTracingProcessor->>SGPAsyncTracingProcessor: upsert_batch(items=[...])

Loading

Prompt To Fix All With AI

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

---

### Issue 1 of 1
src/agentex/lib/core/tracing/processors/tracing_processor_interface.py:44-65
**Mutual-recursion trap between `on_span_start` and `on_spans_start`**

The base class default `on_spans_start` fans out to `self.on_span_start`. `SGPAsyncTracingProcessor` now overrides `on_span_start` to delegate to `self.on_spans_start([span])`. These two work together safely only because SGP also overrides `on_spans_start`. Any future subclass that copies the delegation pattern from `on_span_start → on_spans_start` without also overriding `on_spans_start` will recurse infinitely at runtime — and since `on_span_start` is abstract (must be implemented) while `on_spans_start` is not (silently inherits the fan-out default), the type system gives no warning. A brief note in the `on_spans_start` docstring warning that if `on_span_start` delegates to this method, `on_spans_start` must also be overridden would prevent this silent trap.

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

Greptile also left 1 inline comment on this PR.

[stainless-app]

Release version edited manually

The Pull Request version has been manually set to 0.10.5 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.5 🌻