From 6437fc71474b803fa5182d9d990fba701333446c Mon Sep 17 00:00:00 2001 From: Ivan Despot <66276597+g-despot@users.noreply.github.com> Date: Thu, 13 Aug 2026 18:30:48 +0200 Subject: [PATCH 1/3] chore: upgrade weaviate-agents to 1.8.0 The search_mode.py snippet passes effort= to QueryAgent.search(), which 1.7.0 does not accept. 1.8.0 adds it. The pin already allowed the newer release; the lockfile was simply resolved before it existed. --- uv.lock | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/uv.lock b/uv.lock index 876adf00..bb6093c5 100644 --- a/uv.lock +++ b/uv.lock @@ -1826,16 +1826,16 @@ wheels = [ [[package]] name = "weaviate-agents" -version = "1.7.0" +version = "1.8.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "httpx-sse" }, { name = "rich" }, { name = "weaviate-client" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/b8/99/750d7d2e33f610bad0d4b1d77e2a7f0c73dbab5459876fa51c7a4a440a3a/weaviate_agents-1.7.0.tar.gz", hash = "sha256:f033085cbde7123424f5579dfab553df5e0128d395dfea3b58c5aea6602340cb", size = 111884, upload-time = "2026-07-27T08:31:58.622Z" } +sdist = { url = "https://files.pythonhosted.org/packages/6c/fa/c392cbad0cd088070e9200e12a13d6cb3b8f33ee68e2afddec405c58e24d/weaviate_agents-1.8.0.tar.gz", hash = "sha256:878a4e0892ba028417389abf1caaea5947e8b76c6edcd706946c06093239bcfa", size = 112358, upload-time = "2026-08-11T13:46:50.144Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/5e/d3/30952e1a4ca1556beb73e756d1f514c0bd62db53c21bdc65cdd6c5c6b78e/weaviate_agents-1.7.0-py3-none-any.whl", hash = "sha256:052e37ad9114424149b29deb8ba96159fce69f54e45874a4d6e42b1831643931", size = 54505, upload-time = "2026-07-27T08:31:57.755Z" }, + { url = "https://files.pythonhosted.org/packages/65/71/97060d755c6e88b65371a13791704497841543b2267c27feef597e468d34/weaviate_agents-1.8.0-py3-none-any.whl", hash = "sha256:40b93991bba26f3931c105e3d6f2c71604f3d74f7801a6e9382562751cc9b3b3", size = 54972, upload-time = "2026-08-11T13:46:49.059Z" }, ] [[package]] From 4df7b25ece2b67aba299a92fd1570355caab6016 Mon Sep 17 00:00:00 2001 From: Ivan Despot <66276597+g-despot@users.noreply.github.com> Date: Thu, 13 Aug 2026 18:51:49 +0200 Subject: [PATCH 2/3] fix(docs-tests): wait for the async geo index in manage-data.create The Python lane failed on a bare AssertionError at the geo-range check in _includes/code/howto/manage-data.create.py (CI run 31718384134). The rendered example is correct; the test scaffolding after the WithGeoCoordinates markers was racing the index. A geo property is backed by its own index, and the test instances run with ASYNC_INDEXING enabled, so that index is filled in the background. Measured against local servers with ASYNC_INDEXING=true, the just-inserted object becomes visible to a within_geo_range filter after roughly 0.5 to 1.3 seconds: immediate on 1.38.0, 1.38.3 and 1.38.4, delayed from 1.38.5 onward, including 1.38.7 and 1.39.0. With ASYNC_INDEXING=false it is immediate on every version tested. main pins the test server at 1.38.0 and this branch pins 1.39.0, which is why the race only surfaces here. Add a bounded readiness wait before the assertion, mirroring the pattern already used in _includes/code/howto/search.filters.py, and clear the Publication collection first so the exact count cannot pick up an object left behind by an earlier failed run. The assertion stays exact and the rendered block is unchanged. Co-Authored-By: Claude Opus 5 (1M context) --- _includes/code/howto/manage-data.create.py | 37 +++++++++++++++------- 1 file changed, 26 insertions(+), 11 deletions(-) diff --git a/_includes/code/howto/manage-data.create.py b/_includes/code/howto/manage-data.create.py index b758b4ce..6204c8d6 100644 --- a/_includes/code/howto/manage-data.create.py +++ b/_includes/code/howto/manage-data.create.py @@ -182,6 +182,10 @@ # WithGeoCoordinates # ======================================== +# Test scaffolding; not rendered in the docs. Start from an empty collection so +# the exact count asserted below cannot pick up an object left by an earlier run. +client.collections.delete("Publication") + # START WithGeoCoordinates publications = client.collections.use("Publication") @@ -196,23 +200,34 @@ # END WithGeoCoordinates # TEST - Confirm insert & delete object +# Test scaffolding below; not rendered in the docs. +# A geo property is backed by its own index, and that index is filled in the +# background when the server runs with ASYNC_INDEXING enabled (the test +# instance does), so a geo filter does not see the object the moment insert +# returns. Wait (bounded) for the write to become visible, so the assertion +# tests the geo range and not index visibility. The assertion stays exact. +import time from weaviate.classes.data import GeoCoordinate from weaviate.classes.query import Filter -response = publications.query.fetch_objects( - filters=( - Filter - .by_property("headquartersGeoLocation") - .within_geo_range( - coordinate=GeoCoordinate( - latitude=52.39, - longitude=4.84 - ), - distance=1000 # In meters - ) +geo_range_filter = ( + Filter + .by_property("headquartersGeoLocation") + .within_geo_range( + coordinate=GeoCoordinate( + latitude=52.39, + longitude=4.84 + ), + distance=1000 # In meters ) ) +for _ in range(30): + response = publications.query.fetch_objects(filters=geo_range_filter) + if len(response.objects) >= 1: + break + time.sleep(1) + assert len(response.objects) == 1 obj_uuid = response.objects[0].uuid publications.data.delete_by_id(obj_uuid) From 11a41a05ea67753437f15f30802e0607644f0690 Mon Sep 17 00:00:00 2001 From: Ivan Despot <66276597+g-despot@users.noreply.github.com> Date: Thu, 13 Aug 2026 18:51:57 +0200 Subject: [PATCH 3/3] docs(release-history): set the Java cell for 1.39.x to 6.3.1 java-client 6.3.1 (tag 6.3.1, no v prefix, published 2026-08-13) adds the AND_CROSS BM25 operator, hybrid diversity selection and multi2vec-twelvelabs support. multi2vec-twelvelabs is served by Weaviate 1.39.0 and is absent from 1.38.7, and AND_CROSS needs 1.37.15, 1.38.8 or 1.39.0, so 6.3.1 is the 1.39 client. Link built like the neighbouring 1.38.x cell. Co-Authored-By: Claude Opus 5 (1M context) --- _includes/release-history.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_includes/release-history.md b/_includes/release-history.md index a0651898..ba65becc 100644 --- a/_includes/release-history.md +++ b/_includes/release-history.md @@ -2,7 +2,7 @@ This table lists recent Weaviate Database versions and corresponding client libr | Weaviate Database
([GitHub][cWeaviate]) | First
release date | Python
([GitHub][cPython]) | TypeScript/
JavaScript
([GitHub][cTypeScript]) | Go
([GitHub][cGo]) | Java
([GitHub][cJava]) | C#
([GitHub][cCSharp]) | | :------------------------------------------------------------------ | :---------------------- | :-------------------------------------------------------------------------------: | :--------------------------------------------------------------------------: | :-------------------------------------------------------------------------: | :-----------------------------------------------------------------: | :-----------------------------------------------------------------------------: | -| [1.39.x](https://github.com/weaviate/weaviate/releases/tag/v1.39.0) | 2026-08-04 | [4.23.x](https://github.com/weaviate/weaviate-python-client/releases/tag/v4.23.0) | - | - | - | - | +| [1.39.x](https://github.com/weaviate/weaviate/releases/tag/v1.39.0) | 2026-08-04 | [4.23.x](https://github.com/weaviate/weaviate-python-client/releases/tag/v4.23.0) | - | - | [6.3.1](https://github.com/weaviate/java-client/releases/tag/6.3.1) | - | | [1.38.x](https://github.com/weaviate/weaviate/releases/tag/v1.38.0) | 2026-06-05 | [4.22.x](https://github.com/weaviate/weaviate-python-client/releases/tag/v4.22.0) | [3.14.x](https://github.com/weaviate/typescript-client/releases/tag/v3.14.0) | - | [6.3.0](https://github.com/weaviate/java-client/releases/tag/6.3.0) | - | | [1.37.x](https://github.com/weaviate/weaviate/releases/tag/v1.37.0) | 2026-04-16 | [4.21.x](https://github.com/weaviate/weaviate-python-client/releases/tag/v4.21.0) | [3.13.x](https://github.com/weaviate/typescript-client/releases/tag/v3.13.0) | [5.7.3](https://github.com/weaviate/weaviate-go-client/releases/tag/v5.7.3) | [6.2.0](https://github.com/weaviate/java-client/releases/tag/6.2.0) | N/A | | [1.36.x](https://github.com/weaviate/weaviate/releases/tag/v1.36.0) | 2026-02-24 | [4.20.x](https://github.com/weaviate/weaviate-python-client/releases/tag/v4.20.0) | [3.12.x](https://github.com/weaviate/typescript-client/releases/tag/v3.12.0) | [5.7.x](https://github.com/weaviate/weaviate-go-client/releases/tag/v5.7.0) | [6.1.0](https://github.com/weaviate/java-client/releases/tag/6.1.0) | [1.0.1](https://github.com/weaviate/weaviate-dotnet-client/releases/tag/v1.0.1) |