Skip to content

Business Calculator

enhancedtoolkits.calculators.business.BusinessAnalysisCalculatorTools 

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

Bases: BaseCalculatorTools

Calculator for business analysis calculations.

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

    # Register all business analysis methods
    self.register(self.calculate_break_even_point)

Functions

calculate_break_even_point 

calculate_break_even_point(fixed_costs: float, price_per_unit: float, variable_cost_per_unit: float) -> str

Calculate the break-even point in units and sales.

Source code in src/enhancedtoolkits/calculators/business.py 
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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
def calculate_break_even_point(
    self,
    fixed_costs: float,
    price_per_unit: float,
    variable_cost_per_unit: float,
) -> str:
    """Calculate the break-even point in units and sales."""
    fixed_costs = self._validate_positive_amount(
        fixed_costs, "fixed_costs"
    )
    price_per_unit = self._validate_positive_amount(
        price_per_unit, "price_per_unit"
    )
    variable_cost_per_unit = max(0, variable_cost_per_unit)  # Can be zero

    if price_per_unit <= variable_cost_per_unit:
        raise FinancialValidationError(
            "Price per unit must be greater than variable cost per unit"
        )

    contribution_margin = price_per_unit - variable_cost_per_unit
    break_even_units = fixed_costs / contribution_margin
    break_even_sales = break_even_units * price_per_unit

    result = {
        "operation": "break_even_point",
        "result": round(break_even_units, 2),
        "inputs": {
            "fixed_costs": fixed_costs,
            "price_per_unit": price_per_unit,
            "variable_cost_per_unit": variable_cost_per_unit,
        },
        "summary": {
            "break_even_units": round(break_even_units, 2),
            "break_even_sales": round(break_even_sales, 2),
            "contribution_margin": round(contribution_margin, 2),
            "contribution_margin_ratio": round(
                (contribution_margin / price_per_unit) * 100, 2
            ),
        },
        "metadata": self._base_metadata("contribution_margin_analysis"),
    }

    return self._format_json_response(result)

get_llm_usage_instructions staticmethod 

get_llm_usage_instructions() -> str

Return short, text-first usage instructions for business analysis tools.

Source code in src/enhancedtoolkits/calculators/business.py 
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
    @staticmethod
    def get_llm_usage_instructions() -> str:
        """Return short, text-first usage instructions for business analysis tools."""
        return """
<business_analysis_calculator>
Break-even analysis

GOAL
- Compute break-even units and sales and return JSON.

Break-even analysis. Tools return JSON strings.

Tools:
- calculate_break_even_point(fixed_costs, price_per_unit, variable_cost_per_unit)

CONTEXT-SIZE RULES (IMPORTANT)
- In final user responses, report break-even units + sales and key assumptions; avoid dumping full JSON.
</business_analysis_calculator>
"""