langchain-dynamic-tools-middleware 0.2.0__tar.gz

langchain_dynamic_tools_middleware-0.2.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,31 @@
+---
+name: Bug report
+about: Something is broken
+labels: bug
+---
+
+**What happened**
+
+A clear description of the bug.
+
+**What you expected**
+
+What should have happened instead.
+
+**How to reproduce**
+
+Steps, a code snippet, or a small script that shows the problem. If it
+involves tools, include the tool definitions and the message the agent was
+handling.
+
+**Environment**
+
+- Package version:
+- Python version:
+- Operating system:
+- How the agent is built (model, other middleware in the stack):
+
+**Logs**
+
+Anything printed to the console, especially warnings from
+`langchain_dynamic_tools`.

langchain_dynamic_tools_middleware-0.2.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,17 @@
+---
+name: Feature request
+about: An idea to make this better
+labels: enhancement
+---
+
+**The problem you are solving**
+
+What are you trying to do that the middleware does not support yet?
+
+**Your suggestion**
+
+What you would like to exist, and how you would use it.
+
+**Alternatives you considered**
+
+Anything else you tried or thought about.

langchain_dynamic_tools_middleware-0.2.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,16 @@
+## What this pull request does
+
+One or two sentences describing the change.
+
+## How it was tested
+
+Commands you ran (tests, lint, benchmarks) and what you saw. New behavior
+needs a test; changed benchmark claims need fresh numbers from the harness.
+
+## Checklist
+
+- [ ] Tests pass: `uv run pytest`
+- [ ] Lint passes: `uv run ruff check .`
+- [ ] Types pass: `uv run mypy`
+- [ ] Documentation updated where needed
+- [ ] No em-dashes in docs or comments (project style)

langchain_dynamic_tools_middleware-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,37 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Lint
+        run: uv run ruff check .
+
+      - name: Type check
+        run: uv run mypy
+
+      - name: Test
+        run: uv run pytest
+
+      - name: Build check
+        run: uv build

langchain_dynamic_tools_middleware-0.2.0/.github/workflows/publish.yml

@@ -0,0 +1,26 @@
+name: Publish
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Build sdist and wheel
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          attestations: true

langchain_dynamic_tools_middleware-0.2.0/.gitignore

@@ -0,0 +1,34 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+build/
+dist/
+
+# Virtual environments
+.venv/
+venv/
+
+# Tooling caches
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+coverage.xml
+htmlcov/
+
+# zvec collections created by examples and benchmarks
+.dynamicToolsMiddleware/
+*.zvec/
+
+# Downloaded benchmark datasets (refetched by the harness as needed)
+benchmarks/bfcl/data/
+
+# Editors and OS
+.idea/
+.vscode/
+.DS_Store
+
+# Environment
+.env

langchain_dynamic_tools_middleware-0.2.0/.python-version

@@ -0,0 +1 @@
+3.10

langchain_dynamic_tools_middleware-0.2.0/CHANGELOG.md

@@ -0,0 +1,45 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/).
+
+## [0.2.0] - 2026-09-13
+
+### Added
+
+- `LangChainDenseEmbedder`, an adapter that lets any standard LangChain
+  `Embeddings` object (e.g. `OpenAIEmbeddings`) be used as `dense_embedder`.
+  `ToolVectorIndex` applies it automatically; `dense_dim` doubles as the
+  explicit dimension so no probing API call is needed.
+- `dense_dim` parameter on `DynamicToolSelectorMiddleware`, forwarded to the
+  index.
+- Multi-turn aware search query: the latest user message is used, plus the
+  previous one when the latest is a very short follow-up. Queries are capped
+  at 2000 characters.
+
+### Fixed
+
+- Benchmark harness: set the missing category on shared args (every BFCL
+  entry used to fail), unique index directory per parallel entry (zvec lock
+  collisions), per-block checkpointing for token runs, `--configs` filter for
+  rerunning single blocks, and per-block error samples in saved results.
+
+## [0.1.0] - 2026-09-11
+
+### Added
+
+- `DynamicToolSelectorMiddleware`, a LangChain agent middleware that indexes
+  every tool into a local zvec collection with hybrid dense and sparse
+  embeddings and hands the model only the top-k most relevant tools per step.
+- `ToolVectorIndex`, the zvec-backed index with incremental sync, reciprocal
+  rank fusion of dense and sparse rankings, and collection lifecycle handling.
+- `DefaultDenseEmbedder` and `DefaultSparseEmbedder`, thin wrappers around the
+  local models that ship with zvec (all-MiniLM-L6-v2 and SPLADE), plus
+  protocols for plugging in any embedding backend.
+- `render_tool_text`, the compact tool representation used for embedding.
+- Graceful degradation: search failures fall back to all tools unless the
+  caller opts into raising.
+- Benchmark suite: BFCL accuracy harness, selection latency at scale, and
+  token reduction measurements with committed, reproducible results.

langchain_dynamic_tools_middleware-0.2.0/CONTRIBUTING.md

@@ -0,0 +1,86 @@
+# Contributing
+
+Thanks for wanting to help. This guide covers setup, the workflow, and the
+house style.
+
+## Setup
+
+You need Python 3.10 or newer and [uv](https://docs.astral.sh/uv/).
+
+```bash
+git clone https://github.com/RauhanAhmed/langchain-dynamic-tools-middleware.git
+cd langchain-dynamic-tools-middleware
+uv sync --all-extras
+```
+
+That installs the package (editable), the dev tools, the local embedding
+models, and the benchmark extras.
+
+### A note on platforms
+
+zvec, the vector engine underneath this package, publishes wheels for Linux
+(x86_64 and aarch64), macOS ARM64, and Windows x86_64. If you are on one of
+those, `uv sync` just works. On an Intel Mac there are no zvec wheels, so run
+everything through the Linux dev container instead:
+
+```bash
+./scripts/dev-container.sh uv sync --all-extras
+./scripts/dev-container.sh uv run pytest
+```
+
+The container mounts the repository and keeps its virtual environment and
+model caches in Docker volumes, so nothing pollutes your checkout.
+
+## Everyday commands
+
+```bash
+uv run pytest                 # fast tests, no model downloads
+uv run pytest -m local         # adds the real local model smoke test
+uv run ruff check .            # lint
+uv run mypy                    # strict type check of the package
+uv build                       # sdist and wheel
+```
+
+## Tests
+
+Fast tests use deterministic fake embedders so they run offline in seconds.
+The `local` marker runs the real embedding models once; keep anything that
+downloads a model or calls an API behind that marker.
+
+New behavior needs a test. If you touch the middleware, cover both the sync
+and async paths.
+
+## Benchmarks
+
+The benchmark suite lives in `benchmarks/` and produces the numbers committed
+in `benchmarks/RESULTS.md`. Runs use real components: the real zvec engine,
+the real local embedding models, and live model calls.
+
+```bash
+uv run python -m benchmarks.latency.run_latency
+uv run python -m benchmarks.token_reduction.run_tokens
+uv run python -m benchmarks.bfcl.run_bfcl --categories simple --limit 50
+```
+
+API keys come from environment variables or a `.env` file (never committed).
+If your change affects selection quality, latency, or token usage, rerun the
+relevant benchmark and update `RESULTS.md` with the fresh numbers and the
+exact command you ran.
+
+## House style
+
+- No em-dashes anywhere: README, docstrings, comments, changelog entries.
+  Use commas, colons, or parentheses instead.
+- Plain, direct prose. Short sentences. Say what the code does.
+- Every public function and class gets a docstring with one short example.
+- Type hints everywhere; `mypy --strict` runs on the package.
+- Keep the public API small. Internal modules start with an underscore.
+
+## Pull requests
+
+1. Fork, branch, make the change with tests.
+2. Run the full check locally: `uv run ruff check .`, `uv run mypy`,
+   `uv run pytest`.
+3. Open a pull request describing what changed and how you verified it.
+
+Small, focused pull requests get reviewed faster.

langchain_dynamic_tools_middleware-0.2.0/Dockerfile.dev

@@ -0,0 +1,12 @@
+# Development container for platforms without native zvec wheels, such as
+# Intel macOS. zvec ships wheels for Linux x86_64 and aarch64, macOS ARM64,
+# and Windows x86_64. Everything (tests, lint, benchmarks) runs fine in here.
+FROM python:3.10-slim
+
+ENV UV_PROJECT_ENVIRONMENT=/opt/venv \
+    UV_LINK_MODE=copy \
+    PYTHONUNBUFFERED=1
+
+COPY --from=ghcr.io/astral-sh/uv:0.11.14 /uv /uvx /bin/
+
+WORKDIR /workspace

langchain_dynamic_tools_middleware-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rauhan Ahmed Siddiqui
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.