chunk-your-tools 2.0.2

MCP tool schema decomposition and recomposition
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

"""Catalog disk I/O and builder (Rust-backed)."""

from __future__ import annotations

from pathlib import Path
from typing import Any

from chunk_your_tools._native import CatalogBuilder as _NativeCatalogBuilder
from chunk_your_tools._native import write_catalog_index as _write_catalog_index


def write_catalog_index(
    index: dict[str, Any],
    output_dir: str | Path | None = None,
    *,
    prune: bool | None = None,
) -> None:
    """Write a catalog index payload to disk (Rust defaults when args omitted)."""
    _write_catalog_index(
        index,
        str(output_dir) if output_dir is not None else None,
        prune,
    )


class CatalogBuilder:
    """Accumulates tool entries and writes decomposed catalog files."""

    def __init__(
        self,
        memory_only: bool | None = None,
        output_dir: Path | None = None,
    ) -> None:
        out = str(output_dir) if output_dir is not None else None
        self._inner = _NativeCatalogBuilder(memory_only, out)

    def add_tool(self, entry: dict[str, Any]) -> None:
        self._inner.add_tool(entry)

    def get_tool_info(self, server_name: str, tool_name: str) -> dict[str, Any] | None:
        return self._inner.get_tool_info(server_name, tool_name)

    def build_index(self) -> dict[str, Any]:
        return self._inner.build_index()

    def write_catalog(self) -> dict[str, Any]:
        return self._inner.write_catalog()

    def to_catalog_dict(
        self,
        catalog_prefix: str | None = None,
    ) -> dict[str, list[dict[str, Any]]]:
        """Return decomposed catalog in rerank/llm input format (Rust-backed)."""
        return self._inner.to_catalog_dict(catalog_prefix)