release: 0.11.0

[stainless-app]

Automated Release PR

0.11.0 (2026-04-28)

Full Changelog: v0.10.2...v0.11.0

Features

• api: api update (cd7c9b7)
• support setting headers via env (57a862c)

Bug Fixes

• use correct field name format for multipart file arrays (44078f4)

Chores

• internal: more robust bootstrap script (dd59283)

---

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.11.0 release PR, generated by Stainless. It includes three functional changes: removal of the task_id field from span create/update/list APIs (a breaking change aligned with an upstream API update), a bug fix for multipart file array field names that adds a configurable array_format parameter to extract_files, and a new feature allowing custom headers to be injected via the AGENTEX_CUSTOM_HEADERS environment variable.

Confidence Score: 5/5

Safe to merge — all changes are auto-generated from the updated OpenAPI spec with no blocking issues.

All three functional changes (task_id removal, array_format fix, env-headers feature) are correct and well-tested. The task_id removal is a deliberate breaking change aligned with the upstream API spec update. No P0/P1 issues found.

No files require special attention.

Important Files Changed

Filename	Overview
src/agentex/_client.py	Adds AGENTEX_CUSTOM_HEADERS env-var parsing to both sync and async clients; newline-delimited key: value pairs are merged with lower precedence than programmatically-set headers.
src/agentex/_utils/_utils.py	Bug fix: extract_files now accepts a configurable array_format parameter (default "brackets" for backward compat); adds _array_suffix helper to generate per-element field suffixes for brackets, indices, repeat, and comma modes.
src/agentex/resources/spans.py	Removes task_id parameter from create, update, and list methods in both sync/async span resources; updates list docstring from filtering by both trace_id/task_id to just trace_id.
src/agentex/types/span.py	Removes the task_id optional field from the Span model to align with updated API spec.
src/agentex/_qs.py	Moves ArrayFormat and NestedFormat type aliases to _types.py for reuse; imports them from there instead.
src/agentex/_types.py	New home for ArrayFormat and NestedFormat Literal type aliases previously defined in _qs.py.
tests/test_extract_files.py	Adds parametrized test test_array_format_controls_file_field_names covering all four array_format values for both top-level and nested file arrays.
scripts/bootstrap	Robustness fix: uses ${SKIP_BREW:-} instead of $SKIP_BREW to avoid unbound-variable errors under set -e with strict shell options.

Sequence Diagram

sequenceDiagram
    participant Caller
    participant AgentexClient
    participant OS as os.environ
    participant BaseClient

    Caller->>AgentexClient: __init__(default_headers=..., ...)
    AgentexClient->>OS: get("AGENTEX_CUSTOM_HEADERS")
    alt env var present
        OS-->>AgentexClient: "Key1: val1\nKey2: val2"
        AgentexClient->>AgentexClient: parse lines → {Key1:val1, Key2:val2}
        AgentexClient->>AgentexClient: merge: {**parsed, **default_headers} (programmatic headers win)
    else not set
        OS-->>AgentexClient: None
    end
    AgentexClient->>BaseClient: super().__init__(custom_headers=merged)

Loading

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

[stainless-app]

🧪 Testing

To try out this version of the SDK:

pip install 'https://pkg.stainless.com/s/agentex-sdk-python/57a862c8543f67a6cdc62dc9da623467676d2c53/agentex_sdk-0.10.2-py3-none-any.whl'

Expires at: Wed, 27 May 2026 22:27:04 GMT
Updated at: Mon, 27 Apr 2026 22:27:04 GMT