Skip to content

Utility Calculator

enhancedtoolkits.calculators.utility.UtilityCalculatorTools 

UtilityCalculatorTools(add_instructions: bool = True, **kwargs)

Bases: BaseCalculatorTools

Calculator for utility calculations.

Source code in src/enhancedtoolkits/calculators/utility.py 
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
def __init__(self, add_instructions: bool = True, **kwargs):
    """Initialize the utility calculator and register all methods."""
    instructions = (
        self.get_llm_usage_instructions() if add_instructions else ""
    )
    super().__init__(
        name="utility_calculator",
        add_instructions=add_instructions,
        instructions=instructions,
        **kwargs,
    )

    # Register all utility methods
    self.register(self.convert_currency)
    self.register(self.adjust_for_inflation)

Functions

convert_currency 

convert_currency(amount: float, rate: float) -> str

Convert an amount using an exchange rate.

Source code in src/enhancedtoolkits/calculators/utility.py 
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
def convert_currency(self, amount: float, rate: float) -> str:
    """Convert an amount using an exchange rate."""
    amount = self._validate_positive_amount(amount, "amount")
    rate = self._validate_positive_amount(rate, "rate")

    converted_amount = amount * rate

    result = {
        "operation": "currency_conversion",
        "result": round(converted_amount, 2),
        "inputs": {"amount": amount, "exchange_rate": rate},
        "summary": {
            "original_amount": amount,
            "converted_amount": round(converted_amount, 2),
            "exchange_rate": rate,
        },
        "metadata": self._base_metadata("simple_multiplication"),
    }

    return self._format_json_response(result)

adjust_for_inflation 

adjust_for_inflation(amount: float, rate: float, periods: int) -> str

Adjust an amount for inflation over a number of periods.

Parameters:

Name Type Description Default
amount float

Initial amount

 required
rate float

Inflation rate per period (as decimal)

 required
periods int

Number of periods

 required

Returns:

Type Description
str

JSON string containing inflation adjustment
Source code in src/enhancedtoolkits/calculators/utility.py 
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
def adjust_for_inflation(
    self, amount: float, rate: float, periods: int
) -> str:
    """
    Adjust an amount for inflation over a number of periods.

    Args:
        amount: Initial amount
        rate: Inflation rate per period (as decimal)
        periods: Number of periods

    Returns:
        JSON string containing inflation adjustment
    """
    amount = self._validate_positive_amount(amount, "amount")
    rate = self._validate_rate(rate)
    periods = self._validate_periods(periods)

    adjusted_amount = amount * ((1 + rate) ** periods)
    inflation_impact = adjusted_amount - amount

    result = {
        "operation": "inflation_adjustment",
        "result": round(adjusted_amount, 2),
        "inputs": {
            "original_amount": amount,
            "inflation_rate": rate,
            "periods": periods,
        },
        "summary": {
            "original_amount": amount,
            "adjusted_amount": round(adjusted_amount, 2),
            "inflation_impact": round(inflation_impact, 2),
            "purchasing_power_loss": round(
                (inflation_impact / amount) * 100, 2
            ),
        },
        "metadata": self._base_metadata("compound_inflation"),
    }

    return self._format_json_response(result)

get_llm_usage_instructions staticmethod 

get_llm_usage_instructions() -> str

Return short, text-first usage instructions for utility tools.

Source code in src/enhancedtoolkits/calculators/utility.py 
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
    @staticmethod
    def get_llm_usage_instructions() -> str:
        """Return short, text-first usage instructions for utility tools."""
        return """
<utility_calculator>
Simple utilities (currency conversion, inflation adjustment)

GOAL
- Convert/adjust values with simple formulas and return JSON.

Simple utilities. Tools return JSON strings.

Tools:
- convert_currency(amount, rate)
- adjust_for_inflation(amount, rate, periods)

Notes:
- `rate` is a decimal (e.g., 0.03 for 3%).

CONTEXT-SIZE RULES (IMPORTANT)
- In final user responses, present the converted/adjusted amount and assumptions; avoid dumping full JSON.
</utility_calculator>
"""