Smelt

smelt

SmeltTool — MCP entry point for axm-smelt.

SmeltTool

Bases: AXMTool

Compact text/data for LLM consumption.

Input is resolved in order: caller-provided data, input_path, then non-interactive standard input.

Registered as smelt via axm.tools entry point.

Source code in packages/axm-smelt/src/axm_smelt/tools/smelt.py

class SmeltTool(AXMTool):
    """Compact text/data for LLM consumption.

    Input is resolved in order: caller-provided data, ``input_path``, then
    non-interactive standard input.

    Registered as ``smelt`` via axm.tools entry point.
    """

    agent_hint: str = (
        "Compact text/JSON data for LLM consumption — apply minify, tabular, "
        "strip_quotes, and other strategies to reduce token count"
    )

    @property
    def name(self) -> str:
        """Return tool name for registry lookup."""
        return "smelt"

    def execute(
        self,
        *,
        data: JsonValue = "",
        input_path: str | None = None,
        strategies: list[str] | None = None,
        preset: str | None = None,
        **kwargs: object,
    ) -> ToolResult:
        """Run the smelt compaction pipeline.

        Args:
            data: Text or JSON data to compact.
            input_path: Optional UTF-8 input file used when data is empty.
            strategies: Optional list of strategy names.
            preset: Optional preset name.

        Returns:
            ToolResult with compacted output and metrics.
        """
        try:
            if data is None:
                msg = "data must not be None"
                raise ValueError(msg)

            if isinstance(data, str):
                data = resolve_text_source(data, input_path, stdin=sys.stdin)

            from axm_smelt.core.pipeline import smelt

            if not isinstance(data, str):
                parsed = cast("dict[str, JsonValue] | list[JsonValue]", data)
                report = smelt(parsed=parsed, strategies=strategies, preset=preset)
            else:
                report = smelt(data, strategies=strategies, preset=preset)

            savings_pct = round(report.savings_pct, 2)
            applied = ", ".join(report.strategies_applied) or "none"
            header = (
                f"smelt | {report.format.value} | "
                f"{report.original_tokens}->{report.compacted_tokens} tok "
                f"(-{savings_pct}%) | {applied} | {report.counter_backend.value}"
            )
            return ToolResult(
                success=True,
                data={
                    "compacted": report.compacted,
                    "format": report.format.value,
                    "original_tokens": report.original_tokens,
                    "compacted_tokens": report.compacted_tokens,
                    "savings_pct": savings_pct,
                    "strategies_applied": report.strategies_applied,
                    "counter_backend": report.counter_backend.value,
                },
                text=f"{header}\n{report.compacted}",
            )
        except Exception as exc:  # noqa: BLE001
            return ToolResult(success=False, error=str(exc))

name property

Return tool name for registry lookup.

execute(*, data='', input_path=None, strategies=None, preset=None, **kwargs)

Run the smelt compaction pipeline.

Parameters:

Name	Type	Description	Default
data	JsonValue	Text or JSON data to compact.	''
input_path	str | None	Optional UTF-8 input file used when data is empty.	None
strategies	list[str] | None	Optional list of strategy names.	None
preset	str | None	Optional preset name.	None

Returns:

Type	Description
ToolResult	ToolResult with compacted output and metrics.

Source code in packages/axm-smelt/src/axm_smelt/tools/smelt.py

def execute(
    self,
    *,
    data: JsonValue = "",
    input_path: str | None = None,
    strategies: list[str] | None = None,
    preset: str | None = None,
    **kwargs: object,
) -> ToolResult:
    """Run the smelt compaction pipeline.

    Args:
        data: Text or JSON data to compact.
        input_path: Optional UTF-8 input file used when data is empty.
        strategies: Optional list of strategy names.
        preset: Optional preset name.

    Returns:
        ToolResult with compacted output and metrics.
    """
    try:
        if data is None:
            msg = "data must not be None"
            raise ValueError(msg)

        if isinstance(data, str):
            data = resolve_text_source(data, input_path, stdin=sys.stdin)

        from axm_smelt.core.pipeline import smelt

        if not isinstance(data, str):
            parsed = cast("dict[str, JsonValue] | list[JsonValue]", data)
            report = smelt(parsed=parsed, strategies=strategies, preset=preset)
        else:
            report = smelt(data, strategies=strategies, preset=preset)

        savings_pct = round(report.savings_pct, 2)
        applied = ", ".join(report.strategies_applied) or "none"
        header = (
            f"smelt | {report.format.value} | "
            f"{report.original_tokens}->{report.compacted_tokens} tok "
            f"(-{savings_pct}%) | {applied} | {report.counter_backend.value}"
        )
        return ToolResult(
            success=True,
            data={
                "compacted": report.compacted,
                "format": report.format.value,
                "original_tokens": report.original_tokens,
                "compacted_tokens": report.compacted_tokens,
                "savings_pct": savings_pct,
                "strategies_applied": report.strategies_applied,
                "counter_backend": report.counter_backend.value,
            },
            text=f"{header}\n{report.compacted}",
        )
    except Exception as exc:  # noqa: BLE001
        return ToolResult(success=False, error=str(exc))