v0.2.0-alpha

Semantic Tool Router 0.2.0-alpha

Adds an optional two-stage CrossEncoder reranker to the router and ships the open-source rebrand prep (community files, license attribution, lint and type-check configuration, refreshed integration examples).

Added

• Optional two-stage Reranker on ToolRouter. When provided, the cheap embedding-similarity ranking produces a small candidate pool and the reranker rescores it before the final top_k is returned. The router re-sorts the reranker output defensively, so any Reranker implementation can rely on a score-descending final result.
• CrossEncoderReranker, a sentence-transformers CrossEncoder-backed implementation of the new Reranker protocol.
• CLI flags --reranker cross-encoder and --reranker-model on all four subcommands (discover, benchmark, mcp-discover, mcp-benchmark).
• examples/reranker_demo.py end-to-end walkthrough.
• CODE_OF_CONDUCT.md, CONTRIBUTING.md, and SECURITY.md.
• Project URLs (Homepage, Issues, Changelog) and a real author record in pyproject.toml.
• Ruff and mypy configuration in pyproject.toml with a strict type-check profile scoped to the source package.

Changed

• Tightened LICENSE holder attribution.
• Refreshed the LangChain and LlamaIndex integration examples with a graceful import-error fallback so the routing path runs on any Python version.
• Tidied docstrings and module headers across the source package and tests.

Install

pip install semantic-tool-router

For the optional CrossEncoder reranker:

pip install "semantic-tool-router[sentence-transformers]"

Status

Early alpha. APIs may change. See the v0.1.0-alpha release for the previous version.

v0.1.0-alpha

Semantic Tool Router 0.1.0-alpha

The first alpha research prototype. Runtime semantic discovery for agent tools, with first-class MCP support.

Highlights

• Runtime semantic discovery for agent tools, backed by a dependency-light local hashing embedder.
• JSON tool registry loading and validation.
• CLI commands for discovery and benchmarking, with JSON output for both.
• Reusable rank-aware benchmark evaluation: hit rate, top-1 accuracy, MRR, mean recall, mean precision.
• Live stdio MCP server import and ranking, guarded tool execution, and a real filesystem-server demo.
• A reproducible four-server live MCP benchmark and baseline report.
• GitHub Actions CI for Python 3.10-3.12.

Install

pip install semantic-tool-router

For the optional OpenAI embedder:

pip install "semantic-tool-router[openai]"

Status

Early alpha, intended for research and demo use. APIs may change.