omni_smoking_cost
Calculates annual and lifetime smoking costs, lost investment returns, and pack-years lung cancer risk from packs per day, pack price, and years smoked.
Instructions
Smoking Cost & Pack-Years Health Calculator. Calculate lifetime financial cost, lost investment compound interest, and clinical pack-years lung cancer risk index from cigarette smoking. Discipline: HEALTH. Governing mathematical model / formula: Pack-Years = (Cigarettes per Day / 20) × Years Smoked.
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of annual_cash_cost (Annual Cash Out-of-Pocket), lifetime_spent (Lifetime Cash Spent), investment_lost (Opportunity Cost (8% S&P 500)), pack_years_index (Clinical Pack-Years Index) using packs_per_day (Packs Smoked per Day in packs/day), cost_per_pack (Cost per Pack), years_smoked (Years Smoked in yrs). Guarantees exact machine floating-point precision, eliminating LLM arithmetic mistakes and formula hallucinations.
WHEN NOT TO USE: Do not use for qualitative evaluations or unquantified reasoning. All input parameters must be valid numerical values.
DISAMBIGUATION & BOUNDARIES:
Use this dedicated specialist tool for 'Smoking Cost & Pack-Years Health Calculator' rather than generic dispatchers like omni_universal_query.
For multi-calculation chained jobs, use 'omni_batch_calculate'.
To inspect schema fields, see 'omni_describe_solver'.
BEHAVIOR & SAFETY:
Pure deterministic computation with machine floating-point precision.
Read-only, idempotent, and stateless. Zero side effects or persistent state mutations.
Input validation: All arguments are validated against physical and domain bounds. Out-of-bounds inputs return a safe diagnostic error status without throwing runtime exceptions.
RETURNS:
Structured JSON object containing:
status (string): "success" on valid execution or "error" if validation fails
calculator (string): "smoking-cost"
category (string): "health"
name (string): "Smoking Cost & Pack-Years Health Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.annual_cash_cost (Annual Cash Out-of-Pocket): Formatted display string (e.g. '$3,467.50 / yr')
metrics.lifetime_spent (Lifetime Cash Spent): Formatted display string (e.g. '$52,012.50')
metrics.investment_lost (Opportunity Cost (8% S&P 500)): Formatted display string (e.g. '$94,150.00')
metrics.pack_years_index (Clinical Pack-Years Index): Formatted display string (e.g. '15.0 Pack-Years (High Risk)')
execution_time_ms (number): Latency in milliseconds.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "omni_smoking_cost"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| years_smoked | No | Years Smoked (yrs). Total duration of smoking. Default: 15. Min: 1. Max: 60. | |
| cost_per_pack | No | Cost per Pack. Average US pack price: $8 to $14. Default: 9.5. Min: 5. Max: 20. | |
| packs_per_day | No | Packs Smoked per Day (packs/day). 1 pack = 20 cigarettes. Default: 1. Min: 0.25. Max: 4. |