release: 0.12.1

[stainless-app]

Automated Release PR

0.12.1 (2026-06-05)

Full Changelog: v0.12.0...v0.12.1

Bug Fixes

• api: remove agent_id and task_id parameters from states update method (a7cbaae)

Documentation

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

---

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 automated patch release removes the now-unnecessary agent_id and task_id parameters from the states.update() method (both sync and async), and improves docstrings across task-creation param types to clarify the get-or-create semantics of the name field.

• states.update() signature fix: agent_id and task_id are removed from method signatures, StateUpdateParams, and the PUT request body; state_id in the URL path is the only identifier needed.
• Documentation clarifications: Docstrings for name and params in ParamsCreateTaskRequest (across three RPC param files and the ADK acp.py module) now explicitly describe get-or-create behavior and warn that providing a params value on a name-collision overwrites the existing task's params.
• Tests updated: All eight states.update() test call-sites are updated in lockstep with the signature change.

Confidence Score: 5/5

Safe to merge — the change is a focused API cleanup that removes two parameters the server no longer expects, with consistent updates to the type definitions and tests.

All three layers (method signatures, TypedDict, and tests) are updated in sync. The doc-string changes are additive and accurate. No logic beyond parameter removal was touched.

No files require special attention.

Important Files Changed

Filename	Overview
src/agentex/resources/states.py	Removes required agent_id and task_id parameters from both sync and async update() method signatures and the request body transformation; method now only sends state in the body.
src/agentex/types/state_update_params.py	Removes agent_id and task_id from StateUpdateParams TypedDict, leaving only the state required field — aligned with the states.py method signature change.
src/agentex/lib/adk/_modules/acp.py	Doc-string update to create_task clarifying the get-or-create semantics of the name parameter and the implications of omitting vs. providing a unique name.
src/agentex/types/agent_rpc_params.py	Documentation-only change: expands docstrings for name and params in ParamsCreateTaskRequest to clarify get-or-create behavior.
src/agentex/types/agent_rpc_by_name_params.py	Documentation-only change: same docstring expansions as agent_rpc_params.py for the parallel ParamsCreateTaskRequest type.
src/agentex/types/agents/deployment_preview_rpc_params.py	Documentation-only change: same docstring expansions for ParamsCreateTaskRequest in the deployment-preview RPC params type.
tests/api_resources/test_states.py	Removes agent_id and task_id from all eight states.update() test call-sites (both sync and async variants) to match the updated method signature.
pyproject.toml	Version bump from 0.12.0 to 0.12.1.

Sequence Diagram

sequenceDiagram
    participant Caller
    participant StatesResource
    participant API

    Note over Caller,API: Before (0.12.0)
    Caller->>StatesResource: update(state_id, agent_id, state, task_id)
    StatesResource->>API: "PUT /states/{state_id} body: {agent_id, state, task_id}"

    Note over Caller,API: After (0.12.1)
    Caller->>StatesResource: update(state_id, state)
    StatesResource->>API: "PUT /states/{state_id} body: {state}"

Loading

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