diff --git a/.release-please-manifest.json b/.release-please-manifest.json index 8032c17e8..38acea670 100644 --- a/.release-please-manifest.json +++ b/.release-please-manifest.json @@ -1,3 +1,3 @@ { - ".": "0.12.0" + ".": "0.12.1" } diff --git a/.stats.yml b/.stats.yml index 3c1b3e0e6..8e163a3b3 100644 --- a/.stats.yml +++ b/.stats.yml @@ -1,4 +1,4 @@ configured_endpoints: 64 -openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/sgp/agentex-sdk-46769b729d89151fb7e7ae15725678af99f55ef32d283e34a1e143057aa87b23.yml -openapi_spec_hash: 9115c9f283257e0636aba67fadfeda0a +openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/sgp/agentex-sdk-550d6a4f6985887b66c29240e495469cc0a74e2c966175364321ae2eb15595d8.yml +openapi_spec_hash: a93e0b4ee276d29ebd1c2f2a4c798f36 config_hash: 82cb83ac175dbf40265128506294218b diff --git a/CHANGELOG.md b/CHANGELOG.md index 7e27e7132..5e90770f4 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,15 @@ * **tracing:** emit OTel metrics for async span queue depth, batch drain, and SGP export success/failure (HTTP status labels). Disable SDK-side recording with ``AGENTEX_TRACING_METRICS=0``. +## 0.12.1 (2026-06-03) + +Full Changelog: [v0.12.0...v0.12.1](https://github.com/scaleapi/scale-agentex-python/compare/v0.12.0...v0.12.1) + +### Documentation + +* **api:** clarify name parameter behavior in agent task creation ([ce5af72](https://github.com/scaleapi/scale-agentex-python/commit/ce5af729cc3a0f05905d0cebfe2ef18c16d8563e)) +* clarify task name is optional in adk.acp.create_task ([#392](https://github.com/scaleapi/scale-agentex-python/issues/392)) ([bd41d9b](https://github.com/scaleapi/scale-agentex-python/commit/bd41d9bb10f08a354f02f982e6507847c19d2ad9)) + ## 0.12.0 (2026-06-02) Full Changelog: [v0.11.9...v0.12.0](https://github.com/scaleapi/scale-agentex-python/compare/v0.11.9...v0.12.0) diff --git a/pyproject.toml b/pyproject.toml index 13b6c016c..9753c0c86 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,6 +1,6 @@ [project] name = "agentex-sdk" -version = "0.12.0" +version = "0.12.1" description = "The official Python library for the agentex API" dynamic = ["readme"] license = "Apache-2.0" diff --git a/src/agentex/_version.py b/src/agentex/_version.py index 80a336119..26834d559 100644 --- a/src/agentex/_version.py +++ b/src/agentex/_version.py @@ -1,4 +1,4 @@ # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details. __title__ = "agentex" -__version__ = "0.12.0" # x-release-please-version +__version__ = "0.12.1" # x-release-please-version diff --git a/src/agentex/lib/adk/_modules/acp.py b/src/agentex/lib/adk/_modules/acp.py index 0c8cff05a..8a8e89236 100644 --- a/src/agentex/lib/adk/_modules/acp.py +++ b/src/agentex/lib/adk/_modules/acp.py @@ -68,7 +68,11 @@ async def create_task( Create a new task. Args: - name: The name of the task. + name: Optional human-readable name for the task. task/create is + get-or-create by name: omit it (or make it unique, e.g. append a + UUID) for a fresh task on each call; passing a name that already + exists returns that task with its prior history instead of + creating a new one. Keep it globally unique when set. agent_id: The ID of the agent to create the task for. agent_name: The name of the agent to create the task for. params: The parameters for the task. diff --git a/src/agentex/types/agent_rpc_by_name_params.py b/src/agentex/types/agent_rpc_by_name_params.py index 65bcc65c5..5189926fe 100644 --- a/src/agentex/types/agent_rpc_by_name_params.py +++ b/src/agentex/types/agent_rpc_by_name_params.py @@ -30,10 +30,20 @@ class AgentRpcByNameParams(TypedDict, total=False): class ParamsCreateTaskRequest(TypedDict, total=False): name: Optional[str] - """The name of the task to create""" + """Optional human-readable name for the task. + + When set it must be globally unique. task/create is get-or-create by name: + reusing an existing name returns the existing task (with its prior history) + instead of creating a new one, so omit name (or make it unique, e.g. by + appending a UUID) whenever each call should produce a fresh task. + """ params: Optional[Dict[str, object]] - """The parameters for the task""" + """The parameters for the task. + + On a get-or-create by name, providing params overwrites the existing task's + params (it is not a pure read). + """ task_metadata: Optional[Dict[str, object]] """Caller-provided metadata to persist on the task row. diff --git a/src/agentex/types/agent_rpc_params.py b/src/agentex/types/agent_rpc_params.py index 9129dc166..bf13912fd 100644 --- a/src/agentex/types/agent_rpc_params.py +++ b/src/agentex/types/agent_rpc_params.py @@ -30,10 +30,20 @@ class AgentRpcParams(TypedDict, total=False): class ParamsCreateTaskRequest(TypedDict, total=False): name: Optional[str] - """The name of the task to create""" + """Optional human-readable name for the task. + + When set it must be globally unique. task/create is get-or-create by name: + reusing an existing name returns the existing task (with its prior history) + instead of creating a new one, so omit name (or make it unique, e.g. by + appending a UUID) whenever each call should produce a fresh task. + """ params: Optional[Dict[str, object]] - """The parameters for the task""" + """The parameters for the task. + + On a get-or-create by name, providing params overwrites the existing task's + params (it is not a pure read). + """ task_metadata: Optional[Dict[str, object]] """Caller-provided metadata to persist on the task row. diff --git a/src/agentex/types/agents/deployment_preview_rpc_params.py b/src/agentex/types/agents/deployment_preview_rpc_params.py index 61112956a..ba8e20c71 100644 --- a/src/agentex/types/agents/deployment_preview_rpc_params.py +++ b/src/agentex/types/agents/deployment_preview_rpc_params.py @@ -32,10 +32,20 @@ class DeploymentPreviewRpcParams(TypedDict, total=False): class ParamsCreateTaskRequest(TypedDict, total=False): name: Optional[str] - """The name of the task to create""" + """Optional human-readable name for the task. + + When set it must be globally unique. task/create is get-or-create by name: + reusing an existing name returns the existing task (with its prior history) + instead of creating a new one, so omit name (or make it unique, e.g. by + appending a UUID) whenever each call should produce a fresh task. + """ params: Optional[Dict[str, object]] - """The parameters for the task""" + """The parameters for the task. + + On a get-or-create by name, providing params overwrites the existing task's + params (it is not a pure read). + """ task_metadata: Optional[Dict[str, object]] """Caller-provided metadata to persist on the task row.