feat(core): implement reference support for Stateless MCP (SEP-2575) - #648

starting build "0004f68c-1774-4bb1-ab97-217694a6f109"

FETCHSOURCE
From https://github.com/googleapis/mcp-toolbox-sdk-python
 * branch            c99f6c1bb12e28384c84fbf25005ce48d4c6a54b -> FETCH_HEAD
HEAD is now at c99f6c1 chore: delint
GitCommit:
c99f6c1bb12e28384c84fbf25005ce48d4c6a54b
BUILD
Starting Step #0 - "Install requirements"
Step #0 - "Install requirements": Pulling image: python:3.11
Step #0 - "Install requirements": 3.11: Pulling from library/python
Step #0 - "Install requirements": ef1b08ddd59d: Already exists
Step #0 - "Install requirements": 8b365b6ff7b7: Already exists
Step #0 - "Install requirements": 2ca884014342: Already exists
Step #0 - "Install requirements": 442cca122a8b: Already exists
Step #0 - "Install requirements": f6fb30da281d: Pulling fs layer
Step #0 - "Install requirements": 00fb515ecb79: Pulling fs layer
Step #0 - "Install requirements": e5c164e2c953: Pulling fs layer
Step #0 - "Install requirements": e5c164e2c953: Verifying Checksum
Step #0 - "Install requirements": e5c164e2c953: Download complete
Step #0 - "Install requirements": f6fb30da281d: Verifying Checksum
Step #0 - "Install requirements": 00fb515ecb79: Verifying Checksum
Step #0 - "Install requirements": 00fb515ecb79: Download complete
Step #0 - "Install requirements": f6fb30da281d: Pull complete
Step #0 - "Install requirements": 00fb515ecb79: Pull complete
Step #0 - "Install requirements": e5c164e2c953: Pull complete
Step #0 - "Install requirements": Digest: sha256:a30c4ff1a6a474019f9b1f0d921e81a254cf420d408c09e8a8b79fd803b62ebf
Step #0 - "Install requirements": Status: Downloaded newer image for python:3.11
Step #0 - "Install requirements": docker.io/library/python:3.11
Step #0 - "Install requirements": Collecting uv
Step #0 - "Install requirements":   Downloading uv-0.11.23-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata (11 kB)
Step #0 - "Install requirements": Downloading uv-0.11.23-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (25.4 MB)
Step #0 - "Install requirements":    ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 25.4/25.4 MB 64.6 MB/s eta 0:00:00
Step #0 - "Install requirements": Installing collected packages: uv
Step #0 - "Install requirements": Successfully installed uv-0.11.23
Step #0 - "Install requirements": WARNING: Running pip as the 'root' user can result in broken permissions and conflicting behaviour with the system package manager. It is recommended to use a virtual environment instead: https://pip.pypa.io/warnings/venv
Step #0 - "Install requirements": 
Step #0 - "Install requirements": [notice] A new release of pip is available: 24.0 -> 26.1.2
Step #0 - "Install requirements": [notice] To update, run: pip install --upgrade pip
Step #0 - "Install requirements": Using CPython 3.11.15 interpreter at: /usr/local/bin/python3
Step #0 - "Install requirements": Creating virtual environment at: /workspace/venv
Step #0 - "Install requirements": Activate with: source /workspace/venv/bin/activate
Step #0 - "Install requirements": Using Python 3.11.15 environment at: /workspace/venv
Step #0 - "Install requirements": Resolved 1 package in 290ms
Step #0 - "Install requirements": Downloading uv (24.2MiB)
Step #0 - "Install requirements":  Downloaded uv
Step #0 - "Install requirements": Prepared 1 package in 421ms
Step #0 - "Install requirements": warning: Failed to hardlink files; falling back to full copy. This may lead to degraded performance.
Step #0 - "Install requirements":          If the cache and target directories are on different filesystems, hardlinking may not be supported.
Step #0 - "Install requirements":          If this is intentional, set `export UV_LINK_MODE=copy` or use `--link-mode=copy` to suppress this warning.
Step #0 - "Install requirements": Installed 1 package in 86ms
Step #0 - "Install requirements":  + uv==0.11.23
Step #0 - "Install requirements": Using Python 3.11.15 environment at: /workspace/venv
Step #0 - "Install requirements": Resolved 67 packages in 2.01s
Step #0 - "Install requirements":    Building toolbox-core @ file:///workspace/packages/toolbox-core
Step #0 - "Install requirements": Downloading nltk (1.5MiB)
Step #0 - "Install requirements": Downloading networkx (2.0MiB)
Step #0 - "Install requirements": Downloading sqlalchemy (3.2MiB)
Step #0 - "Install requirements": Downloading pydantic-core (2.0MiB)
Step #0 - "Install requirements": Downloading pillow (6.8MiB)
Step #0 - "Install requirements": Downloading tiktoken (1.1MiB)
Step #0 - "Install requirements": Downloading aiohttp (1.7MiB)
Step #0 - "Install requirements": Downloading llama-index-core (11.4MiB)
Step #0 - "Install requirements": Downloading cryptography (4.5MiB)
Step #0 - "Install requirements": Downloading numpy (16.1MiB)
Step #0 - "Install requirements":  Downloaded tiktoken
Step #0 - "Install requirements":       Built toolbox-core @ file:///workspace/packages/toolbox-core
Step #0 - "Install requirements":  Downloaded pydantic-core
Step #0 - "Install requirements":  Downloaded aiohttp
Step #0 - "Install requirements":  Downloaded cryptography
Step #0 - "Install requirements":  Downloaded pillow
Step #0 - "Install requirements":  Downloaded sqlalchemy
Step #0 - "Install requirements":  Downloaded nltk
Step #0 - "Install requirements":  Downloaded networkx
Step #0 - "Install requirements":  Downloaded llama-index-core
Step #0 - "Install requirements":  Downloaded numpy
Step #0 - "Install requirements": Prepared 66 packages in 1.38s
Step #0 - "Install requirements": warning: Failed to hardlink files; falling back to full copy. This may lead to degraded performance.
Step #0 - "Install requirements":          If the cache and target directories are on different filesystems, hardlinking may not be supported.
Step #0 - "Install requirements":          If this is intentional, set `export UV_LINK_MODE=copy` or use `--link-mode=copy` to suppress this warning.
Step #0 - "Install requirements": Installed 67 packages in 691ms
Step #0 - "Install requirements":  + aiohappyeyeballs==2.6.2
Step #0 - "Install requirements":  + aiohttp==3.14.0
Step #0 - "Install requirements":  + aiosignal==1.4.0
Step #0 - "Install requirements":  + aiosqlite==0.22.1
Step #0 - "Install requirements":  + annotated-types==0.7.0
Step #0 - "Install requirements":  + anyio==4.14.0
Step #0 - "Install requirements":  + attrs==26.1.0
Step #0 - "Install requirements":  + banks==2.4.3
Step #0 - "Install requirements":  + certifi==2026.6.17
Step #0 - "Install requirements":  + cffi==2.0.0
Step #0 - "Install requirements":  + charset-normalizer==3.4.7
Step #0 - "Install requirements":  + click==8.4.1
Step #0 - "Install requirements":  + colorama==0.4.6
Step #0 - "Install requirements":  + cryptography==49.0.0
Step #0 - "Install requirements":  + dataclasses-json==0.6.7
Step #0 - "Install requirements":  + deprecated==1.3.1
Step #0 - "Install requirements":  + dirtyjson==1.0.8
Step #0 - "Install requirements":  + filetype==1.2.0
Step #0 - "Install requirements":  + frozenlist==1.8.0
Step #0 - "Install requirements":  + fsspec==2026.6.0
Step #0 - "Install requirements":  + google-auth==2.55.0
Step #0 - "Install requirements":  + greenlet==3.5.2
Step #0 - "Install requirements":  + griffe==2.1.0
Step #0 - "Install requirements":  + griffecli==2.1.0
Step #0 - "Install requirements":  + griffelib==2.1.0
Step #0 - "Install requirements":  + h11==0.16.0
Step #0 - "Install requirements":  + httpcore==1.0.9
Step #0 - "Install requirements":  + httpx==0.28.1
Step #0 - "Install requirements":  + idna==3.18
Step #0 - "Install requirements":  + jinja2==3.1.6
Step #0 - "Install requirements":  + joblib==1.5.3
Step #0 - "Install requirements":  + llama-index-core==0.14.22
Step #0 - "Install requirements":  + llama-index-instrumentation==0.5.0
Step #0 - "Install requirements":  + llama-index-workflows==2.22.1
Step #0 - "Install requirements":  + markupsafe==3.0.3
Step #0 - "Install requirements":  + marshmallow==3.26.2
Step #0 - "Install requirements":  + multidict==6.7.1
Step #0 - "Install requirements":  + mypy-extensions==1.1.0
Step #0 - "Install requirements":  + nest-asyncio==1.6.0
Step #0 - "Install requirements":  + networkx==3.6.1
Step #0 - "Install requirements":  + nltk==3.9.4
Step #0 - "Install requirements":  + numpy==2.4.6
Step #0 - "Install requirements":  + packaging==26.2
Step #0 - "Install requirements":  + pillow==12.2.0
Step #0 - "Install requirements":  + platformdirs==4.10.0
Step #0 - "Install requirements":  + propcache==0.5.2
Step #0 - "Install requirements":  + pyasn1==0.6.3
Step #0 - "Install requirements":  + pyasn1-modules==0.4.2
Step #0 - "Install requirements":  + pycparser==3.0
Step #0 - "Install requirements":  + pydantic==2.13.4
Step #0 - "Install requirements":  + pydantic-core==2.46.4
Step #0 - "Install requirements":  + pyyaml==6.0.3
Step #0 - "Install requirements":  + regex==2026.5.9
Step #0 - "Install requirements":  + requests==2.34.2
Step #0 - "Install requirements":  + setuptools==82.0.1
Step #0 - "Install requirements":  + sqlalchemy==2.0.51
Step #0 - "Install requirements":  + tenacity==9.1.4
Step #0 - "Install requirements":  + tiktoken==0.13.0
Step #0 - "Install requirements":  + tinytag==2.2.1
Step #0 - "Install requirements":  + toolbox-core==1.1.0 (from file:///workspace/packages/toolbox-core)
Step #0 - "Install requirements":  + tqdm==4.68.3
Step #0 - "Install requirements":  + typing-extensions==4.15.0
Step #0 - "Install requirements":  + typing-inspect==0.9.0
Step #0 - "Install requirements":  + typing-inspection==0.4.2
Step #0 - "Install requirements":  + urllib3==2.7.0
Step #0 - "Install requirements":  + wrapt==2.2.2
Step #0 - "Install requirements":  + yarl==1.24.2
Step #0 - "Install requirements": Using Python 3.11.15 environment at: /workspace/venv
Step #0 - "Install requirements": Resolved 111 packages in 1.49s
Step #0 - "Install requirements":    Building toolbox-llamaindex @ file:///workspace/packages/toolbox-llamaindex
Step #0 - "Install requirements": Downloading pygments (1.2MiB)
Step #0 - "Install requirements": Downloading mypy (14.2MiB)
Step #0 - "Install requirements": Downloading ast-serialize (1.2MiB)
Step #0 - "Install requirements": Downloading grpcio (6.5MiB)
Step #0 - "Install requirements": Downloading black (1.8MiB)
Step #0 - "Install requirements": Downloading jedi (4.7MiB)
Step #0 - "Install requirements":  Downloaded ast-serialize
Step #0 - "Install requirements":       Built toolbox-llamaindex @ file:///workspace/packages/toolbox-llamaindex
Step #0 - "Install requirements":  Downloaded black
Step #0 - "Install requirements":  Downloaded grpcio
Step #0 - "Install requirements":  Downloaded pygments
Step #0 - "Install requirements":  Downloaded mypy
Step #0 - "Install requirements":  Downloaded jedi
Step #0 - "Install requirements": Prepared 44 packages in 1.54s
Step #0 - "Install requirements": warning: Failed to hardlink files; falling back to full copy. This may lead to degraded performance.
Step #0 - "Install requirements":          If the cache and target directories are on different filesystems, hardlinking may not be supported.
Step #0 - "Install requirements":          If this is intentional, set `export UV_LINK_MODE=copy` or use `--link-mode=copy` to suppress this warning.
Step #0 - "Install requirements": Installed 44 packages in 1.32s
Step #0 - "Install requirements":  + ast-serialize==0.5.0
Step #0 - "Install requirements":  + asttokens==3.0.1
Step #0 - "Install requirements":  + black==26.5.1
Step #0 - "Install requirements":  + coverage==7.14.3
Step #0 - "Install requirements":  + decorator==5.3.1
Step #0 - "Install requirements":  + executing==2.2.1
Step #0 - "Install requirements":  + google-api-core==2.31.0
Step #0 - "Install requirements":  + google-cloud-core==2.6.0
Step #0 - "Install requirements":  + google-cloud-secret-manager==2.28.0
Step #0 - "Install requirements":  + google-cloud-storage==3.10.1
Step #0 - "Install requirements":  + google-crc32c==1.8.0
Step #0 - "Install requirements":  + google-resumable-media==2.10.0
Step #0 - "Install requirements":  + googleapis-common-protos==1.75.0
Step #0 - "Install requirements":  + grpc-google-iam-v1==0.14.4
Step #0 - "Install requirements":  + grpcio==1.81.1
Step #0 - "Install requirements":  + grpcio-status==1.81.1
Step #0 - "Install requirements":  + iniconfig==2.3.0
Step #0 - "Install requirements":  + ipython==9.14.1
Step #0 - "Install requirements":  + ipython-pygments-lexers==1.1.1
Step #0 - "Install requirements":  + isort==8.0.1
Step #0 - "Install requirements":  + jedi==0.20.0
Step #0 - "Install requirements":  + librt==0.11.0
Step #0 - "Install requirements":  + matplotlib-inline==0.2.2
Step #0 - "Install requirements":  + mypy==2.1.0
Step #0 - "Install requirements":  + parso==0.8.7
Step #0 - "Install requirements":  + pathspec==1.1.1
Step #0 - "Install requirements":  + pexpect==4.9.0
Step #0 - "Install requirements":  + pluggy==1.6.0
Step #0 - "Install requirements":  + prompt-toolkit==3.0.52
Step #0 - "Install requirements":  + proto-plus==1.28.0
Step #0 - "Install requirements":  + protobuf==7.35.1
Step #0 - "Install requirements":  + psutil==7.2.2
Step #0 - "Install requirements":  + ptyprocess==0.7.0
Step #0 - "Install requirements":  + pure-eval==0.2.3
Step #0 - "Install requirements":  + pygments==2.20.0
Step #0 - "Install requirements":  + pytest==9.0.3
Step #0 - "Install requirements":  + pytest-asyncio==1.4.0
Step #0 - "Install requirements":  + pytest-cov==7.1.0
Step #0 - "Install requirements":  + pytokens==0.4.1
Step #0 - "Install requirements":  + stack-data==0.6.3
Step #0 - "Install requirements":  + tokenize-rt==6.2.0
Step #0 - "Install requirements":  + toolbox-llamaindex==0.7.0 (from file:///workspace/packages/toolbox-llamaindex)
Step #0 - "Install requirements":  + traitlets==5.15.1
Step #0 - "Install requirements":  + wcwidth==0.8.1
Finished Step #0 - "Install requirements"
Starting Step #1 - "Run integration tests"
Step #1 - "Run integration tests": Already have image (with digest): python:3.11
Step #1 - "Run integration tests": ============================= test session starts ==============================
Step #1 - "Run integration tests": platform linux -- Python 3.11.15, pytest-9.0.3, pluggy-1.6.0
Step #1 - "Run integration tests": rootdir: /workspace/packages/toolbox-llamaindex
Step #1 - "Run integration tests": configfile: pyproject.toml
Step #1 - "Run integration tests": plugins: cov-7.1.0, anyio-4.14.0, asyncio-1.4.0
Step #1 - "Run integration tests": asyncio: mode=Mode.STRICT, debug=False, asyncio_default_fixture_loop_scope=None, asyncio_default_test_loop_scope=function
Step #1 - "Run integration tests": collected 89 items
Step #1 - "Run integration tests": 
Step #1 - "Run integration tests": tests/test_async_client.py .................                             [ 19%]
Step #1 - "Run integration tests": tests/test_async_tools.py ..................                             [ 39%]
Step #1 - "Run integration tests": tests/test_client.py ................                                    [ 57%]
Step #1 - "Run integration tests": tests/test_e2e.py ............................                           [ 88%]
Step #1 - "Run integration tests": tests/test_tools.py ..........                                           [100%]
Step #1 - "Run integration tests": 
Step #1 - "Run integration tests": =============================== warnings summary ===============================
Step #1 - "Run integration tests": tests/test_e2e.py: 10 warnings
Step #1 - "Run integration tests":   /workspace/packages/toolbox-core/src/toolbox_core/utils.py:56: UserWarning: This connection is using HTTP. To prevent credential exposure, please ensure all communication is sent over HTTPS.
Step #1 - "Run integration tests":     warnings.warn(
Step #1 - "Run integration tests": 
Step #1 - "Run integration tests": -- Docs: https://docs.pytest.org/en/stable/how-to/capture-warnings.html
Step #1 - "Run integration tests": ================================ tests coverage ================================
Step #1 - "Run integration tests": _______________ coverage: platform linux, python 3.11.15-final-0 _______________
Step #1 - "Run integration tests": 
Step #1 - "Run integration tests": Name                                     Stmts   Miss  Cover
Step #1 - "Run integration tests": ------------------------------------------------------------
Step #1 - "Run integration tests": src/toolbox_llamaindex/__init__.py           3      0   100%
Step #1 - "Run integration tests": src/toolbox_llamaindex/async_client.py      49      3    94%
Step #1 - "Run integration tests": src/toolbox_llamaindex/async_tools.py       36      5    86%
Step #1 - "Run integration tests": src/toolbox_llamaindex/client.py            79      4    95%
Step #1 - "Run integration tests": src/toolbox_llamaindex/tools.py             38      3    92%
Step #1 - "Run integration tests": src/toolbox_llamaindex/version.py            1      0   100%
Step #1 - "Run integration tests": ------------------------------------------------------------
Step #1 - "Run integration tests": TOTAL                                      206     15    93%
Step #1 - "Run integration tests": Required test coverage of 90% reached. Total coverage: 92.72%
Step #1 - "Run integration tests": ======================= 89 passed, 10 warnings in 15.21s =======================
Finished Step #1 - "Run integration tests"
PUSH
DONE