Skip to content

Build AI methods with your coding agent, then run them anywhere: as an MCP for chatbots, as a webapp for people, or via API for your software.

Release v0.61.0

Louis Choquel53e24b201f2b
diff --git a/.badges/tests.json b/.badges/tests.json
index cb5a1e72a..19d2760d9 100644
--- a/.badges/tests.json
+++ b/.badges/tests.json
@@ -1,7 +1,7 @@
{
"schemaVersion": 1,
"label": "tests",
- "message": "11800",
+ "message": "11819",
"color": "blue",
"cacheSeconds": 300
}
diff --git a/.test_durations b/.test_durations
index b3711c385..b0cac14aa 100644
--- a/.test_durations
+++ b/.test_durations
@@ -3207,6 +3207,14 @@
"tests/unit/pipelex/cogt/content_generation/test_extract_generate_dry_branch.py::TestExtractGenerateDryBranch::test_dry_document_mocks_pages_without_io": 0.8999,
"tests/unit/pipelex/cogt/content_generation/test_extract_generate_dry_branch.py::TestExtractGenerateDryBranch::test_dry_image_mocks_single_page": 0.0737,
"tests/unit/pipelex/cogt/content_generation/test_extract_generate_dry_branch.py::TestExtractGenerateDryBranch::test_live_runs_provider_and_stores": 0.118,
+ "tests/unit/pipelex/cogt/content_generation/test_generated_content_factory.py::TestGeneratedContentFactoryFetchedRemoteImage::test_a_failed_fetch_degrades_to_the_remote_url": 1.8081,
+ "tests/unit/pipelex/cogt/content_generation/test_generated_content_factory.py::TestGeneratedContentFactoryFetchedRemoteImage::test_stored_object_follows_the_served_content_type[declared-type-beats-served-type]": 1.7923,
+ "tests/unit/pipelex/cogt/content_generation/test_generated_content_factory.py::TestGeneratedContentFactoryFetchedRemoteImage::test_stored_object_follows_the_served_content_type[error-page-dressed-as-a-200-is-dropped]": 1.8213,
+ "tests/unit/pipelex/cogt/content_generation/test_generated_content_factory.py::TestGeneratedContentFactoryFetchedRemoteImage::test_stored_object_follows_the_served_content_type[non-image-served-type-is-dropped]": 1.807,
+ "tests/unit/pipelex/cogt/content_generation/test_generated_content_factory.py::TestGeneratedContentFactoryFetchedRemoteImage::test_stored_object_follows_the_served_content_type[served-type-beats-requested-format]": 1.8348,
+ "tests/unit/pipelex/cogt/content_generation/test_generated_content_factory.py::TestGeneratedContentFactoryFetchedRemoteImage::test_stored_object_follows_the_served_content_type[served-type-settles-an-undeclared-image]": 1.8038,
+ "tests/unit/pipelex/cogt/content_generation/test_generated_content_factory.py::TestGeneratedContentFactoryFetchedRemoteImage::test_stored_object_follows_the_served_content_type[served-type-we-do-not-generate-is-still-stored]": 1.8223,
+ "tests/unit/pipelex/cogt/content_generation/test_generated_content_factory.py::TestGeneratedContentFactoryFetchedRemoteImage::test_stored_object_follows_the_served_content_type[silent-server-falls-back-to-default]": 1.8088,
"tests/unit/pipelex/cogt/content_generation/test_generated_content_factory.py::TestGeneratedContentFactoryStoredObject::test_stored_object_and_key_follow_resolved_mime_type[provider-mime-overrides-requested-format]": 0.4864,
"tests/unit/pipelex/cogt/content_generation/test_generated_content_factory.py::TestGeneratedContentFactoryStoredObject::test_stored_object_and_key_follow_resolved_mime_type[provider-silent-requested-format-wins]": 3.5335,
"tests/unit/pipelex/cogt/content_generation/test_img_gen_generate_dry_branch.py::TestImgGenGenerateDryBranch::test_dry_list_returns_nb_images_mocks_without_io": 0.0427,
@@ -9366,6 +9374,11 @@
"tests/unit/pipelex/providers/linkup/test_linkup_worker_error_handling.py::TestLinkupWorkerErrorHandling::test_search_user_action_uses_specific_kind[LinkupAuthenticationError-check_credentials]": 0.0015,
"tests/unit/pipelex/providers/linkup/test_linkup_worker_error_handling.py::TestLinkupWorkerErrorHandling::test_search_user_action_uses_specific_kind[LinkupInsufficientCreditError-check_billing]": 0.0016,
"tests/unit/pipelex/providers/linkup/test_linkup_worker_error_handling.py::TestLinkupWorkerErrorHandling::test_search_user_action_uses_specific_kind[LinkupTooManyRequestsError-wait_and_retry]": 0.002,
+ "tests/unit/pipelex/providers/manifold/test_extract_manifold_metadata.py::TestTheRequestIdTheManifoldPathReports::test_prefers_the_pipelex_spelling_over_the_vendor_one": 1.7865,
+ "tests/unit/pipelex/providers/manifold/test_extract_manifold_metadata.py::TestTheRequestIdTheManifoldPathReports::test_prefers_the_providers_own_request_id_over_any_trace_id": 1.8161,
+ "tests/unit/pipelex/providers/manifold/test_extract_manifold_metadata.py::TestTheRequestIdTheManifoldPathReports::test_reads_the_pipelex_spelled_trace_id": 1.7887,
+ "tests/unit/pipelex/providers/manifold/test_extract_manifold_metadata.py::TestTheRequestIdTheManifoldPathReports::test_reports_no_request_id_when_no_provider_was_reached": 1.7992,
+ "tests/unit/pipelex/providers/manifold/test_extract_manifold_metadata.py::TestTheRequestIdTheManifoldPathReports::test_still_reads_the_vendor_spelling_while_the_gateway_emits_it": 1.7843,
"tests/unit/pipelex/providers/manifold/test_manifold_clients.py::TestManifoldCompletionsClient::test_a_handle_from_another_sdk_set_is_refused": 0.0016,
"tests/unit/pipelex/providers/manifold/test_manifold_clients.py::TestManifoldCompletionsClient::test_the_client_gets_the_origin_plus_v1_and_the_token_in_the_service_header": 3.4526,
"tests/unit/pipelex/providers/manifold/test_manifold_clients.py::TestManifoldImageClient::test_debug_is_read_from_the_backend_and_from_nothing_else": 0.049,
@@ -10389,6 +10402,10 @@
"tests/unit/pipelex/tools/misc/test_diff.py::TestDiff::test_make_diff_dirs_pretty_recursive": 0.0063,
"tests/unit/pipelex/tools/misc/test_diff.py::TestDiff::test_make_diff_dirs_pretty_shows_update_direction": 0.2344,
"tests/unit/pipelex/tools/misc/test_diff.py::TestDiff::test_make_diff_dirs_pretty_with_differences": 0.0042,
+ "tests/unit/pipelex/tools/misc/test_file_fetch_utils.py::TestFetchFileAndContentTypeFromUrl::test_the_declared_content_type_is_reported_normalized[parameters-stripped]": 0.0286,
+ "tests/unit/pipelex/tools/misc/test_file_fetch_utils.py::TestFetchFileAndContentTypeFromUrl::test_the_declared_content_type_is_reported_normalized[plain]": 1.7646,
+ "tests/unit/pipelex/tools/misc/test_file_fetch_utils.py::TestFetchFileAndContentTypeFromUrl::test_the_declared_content_type_is_reported_normalized[silent-server]": 0.015,
+ "tests/unit/pipelex/tools/misc/test_file_fetch_utils.py::TestFetchFileAndContentTypeFromUrl::test_the_declared_content_type_is_reported_normalized[whitespace-and-case-normalized]": 1.8032,
"tests/unit/pipelex/tools/misc/test_file_fetch_utils.py::TestFetchFileFromUrl::test_error_status_raises_caller_facing_error[403]": 0.0168,
"tests/unit/pipelex/tools/misc/test_file_fetch_utils.py::TestFetchFileFromUrl::test_error_status_raises_caller_facing_error[404]": 0.0022,
"tests/unit/pipelex/tools/misc/test_file_fetch_utils.py::TestFetchFileFromUrl::test_error_status_raises_caller_facing_error[500]": 2.0473,
@@ -10396,6 +10413,8 @@
"tests/unit/pipelex/tools/misc/test_file_fetch_utils.py::TestFetchFileFromUrl::test_network_failure_raises_caller_facing_error[protocol]": 2.0535,
"tests/unit/pipelex/tools/misc/test_file_fetch_utils.py::TestFetchFileFromUrl::test_network_failure_raises_caller_facing_error[timeout]": 0.2443,
"tests/unit/pipelex/tools/misc/test_file_fetch_utils.py::TestFetchFileFromUrl::test_success_returns_the_bytes": 2.0289,
+ "tests/unit/pipelex/tools/misc/test_file_fetch_utils.py::TestFetchTimeout::test_an_explicit_request_timeout_is_honoured": 0.02,
+ "tests/unit/pipelex/tools/misc/test_file_fetch_utils.py::TestFetchTimeout::test_no_request_timeout_leaves_the_client_default_in_force": 1.7844,
"tests/unit/pipelex/tools/misc/test_filetype_utils.py::TestDetectFileTypeFromBase64::test_detect_file_type_from_base64_binascii_error_chain": 0.1751,
"tests/unit/pipelex/tools/misc/test_filetype_utils.py::TestDetectFileTypeFromBase64::test_detect_file_type_from_base64_bytes_success": 0.0513,
"tests/unit/pipelex/tools/misc/test_filetype_utils.py::TestDetectFileTypeFromBase64::test_detect_file_type_from_base64_data_url_no_comma": 0.0893,
diff --git a/CHANGELOG.md b/CHANGELOG.md
index e98a49864..00be6083f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,6 @@
# Changelog
-## [Unreleased]
+## [v0.61.0] - 2026-09-20
### Added
@@ -18,17 +18,11 @@
### Fixed
- **Claude Sonnet 5 is priced at its standard rate**: `claude-5-sonnet` carried the $3 / $15 per million tokens it was announced at, but its $2 / $10 introductory rate became the standard price and the scheduled increase was cancelled. The entry is corrected on the Anthropic backend and in both hosted catalogs, so cost reporting and budget ceilings no longer overstate a Sonnet 5 run.
-
-- **A failed publish can be recovered without damaging what already shipped**: `publish-pypi.yml` scopes the signature upload to `dist/*.sigstore.json` so it no longer clobbers the wheel and sdist attached just before it, turns `skip-existing` on for a re-run or a manual dispatch, and refuses to touch a release whose tag names a commit other than the one being published. A retry no longer rebuilds the dists either: the build job asks PyPI once what this version published, recovers those bytes from the first place that holds them — the build an earlier attempt of this run stored, then an artifact an earlier run stored for the same commit, then the files PyPI itself serves — and builds fresh only when PyPI answers that nothing was published under this version. Whatever it ends up holding is then checked, on every one of those paths, to be one wheel and one source tarball of the version being released and, when PyPI serves that version, to be byte-for-byte the files PyPI publishes; a divergence fails the job instead of reaching the release, so a build stored before another run published different bytes can no longer be attached and attested over them. That makes the release assets the bytes PyPI serves rather than a rebuild that probably matches them, which an unpinned build backend and an unpinned interpreter cannot promise, and it turns an expired artifact from a dead end into one more layer to fall through. The release is now tagged at the commit it ships, named explicitly with `--target`, rather than at the default branch's head.
-
+- **A failed publish can be recovered without damaging what already shipped**: `publish-pypi.yml` scopes the signature upload to `dist/*.sigstore.json` so it no longer clobbers the wheel and sdist attached just before it, turns `skip-existing` on for a re-run or a manual dispatch, and refuses to touch a release whose tag names a commit other than the one being published. A retry no longer rebuilds the dists either: the build job asks PyPI what this version published and recovers those bytes from the first place that holds them — the build an earlier attempt of this run stored, an artifact an earlier run stored for the same commit, or the files PyPI itself serves — building fresh only when PyPI answers that nothing was published under this version. Whatever it holds is then checked to be one wheel and one source tarball of the version being released and, when PyPI serves that version, byte-for-byte what PyPI publishes, so the release assets are the bytes PyPI serves rather than a rebuild that probably matches them. The release is now tagged at the commit it ships, named explicitly with `--target`, rather than at the default branch's head.
- **A generated image is stored under its own media type, so a store no longer serves it as `binary/octet-stream`**: `GeneratedContentFactory.make_image_content` resolves the effective mime type once and already used it to mint the storage key's extension, but passed no `content_type` to `StorageProviderAbstract.store` on either the direct-bytes path or the fetched-remote one. The S3 provider only sets `ContentType` when it is given one, so every generated image landed untyped and S3 answered `binary/octet-stream` on the way back out — which reached any consumer that trusts the stored type, a same-origin assets route serving the object to a browser among them. Both calls now pass the resolved mime type, so the key's extension, the object's stored type and the reported `mime_type` cannot diverge.
-
- **A generated image fetched from a remote URL is stored under the media type that URL served**: `GeneratedImageRawDetails` admits a bare URL with no mime type and no image format on the promise that the type is settled when the bytes are downloaded, and nothing kept that promise — the fetch discarded the response's `Content-Type` and the resolution fell through to the requested image format or to a hardcoded `image/jpeg`. The new `fetch_file_and_content_type_from_url_httpx` reports the declared type alongside the bytes, normalized and with its parameters stripped, and the factory stores under any `image/<subtype>` it names — not merely the formats `ImageFormat` can itself produce, since what this runtime generates is a different question from what a remote URL may serve, and a GIF or an AVIF stored as `image/jpeg` is the very error being removed. The storage key's extension follows that subtype so it keeps agreeing with the stored type. A type the caller declared still wins, and a served type that is not an image at all — the `text/html` of an error page dressed as a 200 — is dropped.
-
- **A remote image that fails to download degrades to its URL instead of failing the pipe**: `make_image_content` guarded its fetch with `except (httpx.HTTPStatusError, httpx.RequestError)`, but `fetch_file_from_url_httpx` converts every httpx failure into `RemoteFileFetchError`, so that clause caught nothing and a 404 or a timeout on a remote image propagated out and failed the whole run. The guard now names the exception the fetch actually raises, and the fallback it was written for — log the warning, keep the remote URL — runs.
-
- **A remote fetch honours a timeout again**: `fetch_file_from_url_httpx` passed its `request_timeout` straight to httpx, and httpx reads an explicit `timeout=None` — the parameter's own default — as *no timeout at all* rather than as its client default. Every caller that did not name one therefore had no timeout, so a hanging server blocked the caller indefinitely and the `TimeoutException` branch that raises a caller-facing `RemoteFileFetchError` was unreachable. The helper now passes httpx's `USE_CLIENT_DEFAULT` sentinel where no timeout was asked for.
-
- **A manifold error on the native routes keeps its request id under the gateway's pipelex-spelled trace header**: `extract_manifold_metadata` reads the gateway's trace id from `x-pipelex-trace-id` before the inherited `x-portkey-trace-id`, still preferring a provider's own `x-request-id` over both. The gateway emits the two spellings with the same value today, so nothing changes yet; once it drops the vendor one, such an error whose provider sent no `x-request-id` keeps a request id instead of reporting none. `extract_gateway_metadata` is unchanged and still reads the vendor spelling alone — it serves the Portkey cloud and the manifold image path, which travels on `portkey_ai` and keeps that spelling until it is ported off the SDK.
## [v0.60.0] - 2026-09-19
diff --git a/pyproject.toml b/pyproject.toml
index 3340b70cf..ddb5f610f 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "pipelex"
-version = "0.60.0"
+version = "0.61.0"
description = "Execute composable AI methods declared in the MTHDS open standard"
authors = [{ name = "Evotis S.A.S.", email = "[email protected]" }]
maintainers = [{ name = "Pipelex staff", email = "[email protected]" }]
diff --git a/uv.lock b/uv.lock
index 9dbb5146c..e9fb07f1f 100644
--- a/uv.lock
+++ b/uv.lock
@@ -3303,7 +3303,7 @@ wheels = [
[[package]]
name = "pipelex"
-version = "0.60.0"
+version = "0.61.0"
source = { editable = "." }
dependencies = [
{ name = "aiofiles" },