omni_caffeine_half_life
Calculate remaining bloodstream caffeine, sleep disruption, and trace-level clearance time from dose and hours elapsed using a deterministic half-life formula.
Instructions
Caffeine Half-Life & Sleep Clearance Calculator. Calculate remaining active bloodstream caffeine (mg) and clearance timeline based on CYP1A2 liver enzyme pharmacokinetics. Discipline: HEALTH. Governing mathematical model / formula: Remaining Caffeine = Initial Dose × (0.5)^(Hours Elapsed / 5.0).
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of remaining_caffeine (Active Circulating Caffeine), sleep_disruption (Adenosine Receptor Blockade), hours_to_trace (Time to Trace Level (<20mg)), quarter_life (Quarter-Life (25% Remaining)) using coffee_cups (Initial Caffeine Dose in mg), hours_elapsed (Hours Since Consumption in hrs). 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 'Caffeine Half-Life & Sleep Clearance 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): "caffeine-half-life"
category (string): "health"
name (string): "Caffeine Half-Life & Sleep Clearance Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.remaining_caffeine (Active Circulating Caffeine): Formatted display string (e.g. '87.1 mg')
metrics.sleep_disruption (Adenosine Receptor Blockade): Formatted display string (e.g. 'Moderate disruption (Over 50mg active)')
metrics.hours_to_trace (Time to Trace Level (<20mg)): Formatted display string (e.g. '16.6 Hours from Intake')
metrics.quarter_life (Quarter-Life (25% Remaining)): Formatted display string (e.g. '10.0 Hours')
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_caffeine_half_life"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| coffee_cups | No | Initial Caffeine Dose (mg). Mug of drip coffee ~150-200mg; Espresso shot ~65mg; Energy drink ~200mg. Default: 200. Min: 20. Max: 1000. | |
| hours_elapsed | No | Hours Since Consumption (hrs). Hours since your last sip of coffee/energy drink. Default: 6. Min: 1. Max: 24. |