route66 0.1.1__py3-none-any.whl

route66/__init__.py

@@ -0,0 +1,24 @@
+"""route66 - Python SDK.
+
+Public entry point for the route66 package. Version is sourced from the
+installed distribution metadata so that provider-specific builds report
+the version that was actually published.
+"""
+
+from __future__ import annotations
+
+from importlib import metadata as _metadata
+
+from ._version import __version__ as _stamped_version
+
+try:
+    __version__ = _metadata.version("route66")
+except _metadata.PackageNotFoundError:  # pragma: no cover - local checkout
+    __version__ = _stamped_version
+
+__all__ = ["__version__", "hello"]
+
+
+def hello(name: str = "world") -> str:
+    """Return a friendly greeting. Placeholder SDK surface."""
+    return f"Hello from route66, {name}!"

route66/__main__.py

@@ -0,0 +1,13 @@
+"""Allow `python -m route66`."""
+
+from __future__ import annotations
+
+from . import hello
+
+
+def main() -> None:
+    print(hello())
+
+
+if __name__ == "__main__":
+    main()

route66/_version.py

@@ -0,0 +1,3 @@
+"""Version stamp for route66. Managed by ci/scripts/bump_version.py."""
+
+__version__ = "0.1.1"

route66/py.typed

@@ -0,0 +1 @@
+# Marker file so type checkers (mypy, pyright) treat route66 as a typed package.

route66-0.1.1.dist-info/METADATA

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: route66
+Version: 0.1.1
+Summary: route66 Python SDK
+Author: route66 maintainers
+License: Proprietary
+Keywords: route66,sdk
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Requires-Dist: twine>=5.1; extra == 'dev'
+Provides-Extra: semantic
+Requires-Dist: sentence-transformers>=3.0; extra == 'semantic'
+Description-Content-Type: text/markdown
+
+# route66
+
+**Intelligent Tool Router for LLM Agents** — a catalog-in library that,
+given a query and a large tool catalog, returns only the relevant tools,
+deduplicated, in an ordered execution plan, with policy-aware defaults.
+
+Built against the **`router-testkit`** hackathon grading contract
+(single-tool routing, ordered multi-tool plans, near-duplicate
+resolution, capability-based fallback widening, deprecation policy,
+out-of-scope refusal, and clarify-on-vague-destructive).
+
+## Layout
+
+```
+route66/
+├── tool_router/          # The POC library (facade + retrievers + dedup)
+├── testkit_adapter.py    # Bridges tool_router to the harness contract
+├── demo.py               # Toy 60-tool catalog demo of the POC
+├── metrics.py            # Recall/precision/token-savings eval on the toy set
+├── router-testkit/       # Hackathon input kit — DO NOT MODIFY
+│   ├── catalog/          #   64 mock tools · 13 clusters · dup/version metadata
+│   ├── test_cases/       #   29 scored cases across 11 categories
+│   ├── registry_guardrail/#  Intake validator fixtures
+│   └── harness/          #   run_benchmark.py (scorer) + baseline_router.py
+├── bench/                # Additional benchmarks (baseline, mutations, guardrail)
+├── specs/                # Spec-driven-development plan (SPEC-001..011)
+├── docs/                 # PRDs and the hackathon problem statement
+└── tests/                # Unit tests (populated as specs are executed)
+```
+
+## Baseline
+
+| Router                                | Cases passed | Token savings |
+|---------------------------------------|--------------|----------------|
+| Testkit reference `baseline_router`   | 7 / 29 (24%) | 94% |
+| `tool_router` (this repo, current)    | 5 / 29 (17%) | 90% |
+
+The gap is deliberate and mapped in `specs/`. See
+[`specs/README.md`](./specs/README.md) for the priority-ordered plan
+(P0 → P1 → P2) with acceptance criteria pinned to specific `TC-*`
+cases. Target after P0: ≥ 20/29. After P1: ≥ 24/29.
+
+## Quick start
+
+```bash
+# Install (uv-managed)
+uv sync
+
+# Score the reference baseline
+cd router-testkit/harness
+python run_benchmark.py --verbose
+
+# Score this project's router
+python run_benchmark.py --router testkit_adapter:MyRouter --verbose
+```
+
+The harness has no third-party dependencies; standard-library only.
+The router itself can run on `HashingEmbedder` (zero deps) or opt-in
+`SentenceTransformerEmbedder` via `uv sync --extra semantic`.
+
+## Where to read next
+
+1. **`specs/README.md`** — the executable plan. Every spec is pickable
+   independently and has acceptance criteria tied to testkit case IDs.
+2. **`router-testkit/README.md`** — the grading contract (authoritative).
+3. **`tool_router/README.md`** (below `tool_router/`) — the current POC
+   library docs. Will be reframed in SPEC-011.
+4. **`docs/hackathon-definition.md`** — the problem statement.
+5. **`docs/PRD.md`** — the initial PRD.
+
+## Toolchain
+
+- Python ≥ 3.14 (pinned in `.python-version`, managed by uv)
+- Ruff for lint + format
+- Pytest for unit tests (see `pyproject.toml`'s `[dev]` extra)
+
+## Dev
+
+```bash
+uv run ruff check .
+uv run ruff format .
+uv run pytest
+```

route66-0.1.1.dist-info/RECORD

@@ -0,0 +1,8 @@
+route66/__init__.py,sha256=lnQSL6BFkta02Q5XZHnqLvFC1qyjFQBVJpbnX4LwI60,697
+route66/__main__.py,sha256=UmBDpGVu6o_fXUl7wK8QGJmXSJ9bqiLXhaqk7bV2NkY,171
+route66/_version.py,sha256=h1_lIE1uWQTVNUpWnfpDD7zwv10idyHIrZPiOI4rV5c,95
+route66/py.typed,sha256=aW-bxALOYSoObmrYNqB2CEtE6Y_iLP1d3ruzPOYxK7c,81
+route66-0.1.1.dist-info/METADATA,sha256=X88ehc-pBodE32aoQKMsUWtkmULEy2onUGPDl_T8Sxc,3904
+route66-0.1.1.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+route66-0.1.1.dist-info/entry_points.txt,sha256=2eVewj_12O_kZIS-zlo6upa4ud_zRFb-Itdi5Yr38BU,50
+route66-0.1.1.dist-info/RECORD,,

route66-0.1.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.31.0
+Root-Is-Purelib: true
+Tag: py3-none-any

route66-0.1.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+route66 = route66.__main__:main