Hyponatremia (syndrome aggregator)
Severe symptomatic Rx delegated to protocol.severe_hyponatremia (registry id) — 3% NaCl 100–150 mL bolus per ESE 2014; aim 4–6 mmol/L acute rise. Tolvaptan RxCUI (358257) and urea (11002) sourced from neph.aki.core.v1 / chronic SIAD axis; both need re-validation via scripts/research/rxnav-validate.ts before final promotion. Hypertonic saline 3% (rxcui 9863), 0.9% NaCl (7407), DDAVP (3992), furosemide (4603), D5W (4850) reuse RxCUIs already validated elsewhere. Calculator gaps to flag to C.4 calc-quality chat: calc.osmolality (calculated serum osmolality 2*Na + glucose/18 + BUN/2.8), calc.osmolal_gap, calc.tbw (Watson — sex-specific), calc.corrected_sodium (Hillier formula for hyperglycemia — +2.4 mmol/L per 100 mg/dL glucose >100; Katz +1.6 is historical) not yet registered in clinical-tools-registry. Adrogué-Madias (calc.na_correction) and free water deficit (calc.fw_deficit) ARE registered. CSW vs SIAD ambiguity now encoded as severity_trigger with FEurate threshold (>11% after correction = CSW; <11% = SIAD; Maesaka 2009). Workup id workup:fractional_excretion_urate referenced but not yet a registered workup id; orchestrator must register if not present. Beer-potomania / low-solute-diet ODS-prone phenotype added 2026-05-12 — high ODS risk requires correction ceiling ≤6 mmol/L/24h with DDAVP-clamp prophylaxis on standby. Exercise-associated hyponatremia trigger added per 2015 International Consensus (PMID 25647058). No targeted disease test file (covered by tests/dossiers/integration/syndrome-hyponatremia-integration.test.ts + dossier-contract).
Entry points (3)
- lab_abnormalitySerum Na <135 mmol/L mild / <130 moderate / <125 severe (Spasovski 2014 ESC severity tiers)na_low
- symptomAltered mental status / seizure / coma (Spasovski 2014 ESC — severely symptomatic)altered_mental_status
- symptomHeadache, nausea, vomiting (Spasovski 2014 ESC — moderately symptomatic)headache_nausea
Required inputs (12)
- agerequireddemographic • used at CONTEXTElderly + women + premenopausal women at higher ODS risk (Sterns NEJM 2015)
- sodiumrequiredlab • used at ENTRYSeverity tier and correction ceiling calculation (Spasovski 2014 ESC)
- glucoserequiredlab • used at CONTEXTPseudohyponatremia from hyperglycemia — Hillier corrected sodium formula in this runtime (Spasovski 2014 ESC)
- serum_osmrequiredlab • used at INITIAL_WORKUPTonicity classification: hypotonic <275 vs isotonic vs hypertonic (Spasovski 2014 ESC)
- urine_osmrequiredlab • used at INITIAL_WORKUPHigh UOsm → ADH-driven (SIAD/HF/cirrhosis); low → primary polydipsia/low-solute diet (Verbalis AJM 2013; Spasovski 2014 ESC)
- urine_sodiumrequiredlab • used at INITIAL_WORKUPUNa <20 → hypovolemic; UNa >40 → SIAD/CSW/diuretic (Verbalis AJM 2013; Spasovski 2014 ESC)
- volume_statusrequiredvital • used at CONTEXTHypovolemic / euvolemic / hypervolemic branches treatment (Spasovski 2014 ESC — Algorithm 1)
- current_medsrequiredmedication • used at CONTEXTThiazides, SSRIs, desmopressin, MDMA, NSAIDs as drivers (Verbalis AJM 2013; Spasovski 2014 ESC)
- cirrhosishistory • used at CONTEXTHypervolemic subtype; tolvaptan contraindicated (FDA boxed warning; Schrier NEJM 2006 SALT)
- heart_failurehistory • used at CONTEXTHypervolemic subtype; tolvaptan candidacy (Schrier NEJM 2006 SALT-1/2)
- tshlab • used at INITIAL_WORKUPHypothyroidism rare cause of euvolemic hyponatremia (Spasovski 2014 ESC — exclude before diagnosing SIAD)
- cortisollab • used at INITIAL_WORKUPAdrenal insufficiency rare but reversible cause (Spasovski 2014 ESC — exclude before diagnosing SIAD)
12-phase flow (12)
- 1FRAMEConfirm hypotonic hyponatremia: tonicity assessment first to rule out pseudo + translocational (Spasovski 2014 ESC — Algorithm 1 step 1)inputs: sodium, glucose, serum_osmactions: calc.na_correctionadvance: Hypotonic confirmed (Spasovski 2014 ESC)
- 2ENTRYStratify severity by symptoms (severe = AMS/seizure) and Na+ level (Spasovski 2014 ESC — symptom-based severity tiers)inputs: sodiumadvance: Severity tier assigned (Spasovski 2014 ESC)
- 3CONTEXTVolume status (hypo/eu/hyper), full med list, HF / cirrhosis / nephrotic / SIAD risk factors (Spasovski 2014 ESC — Algorithm 1; Verbalis AJM 2013)inputs: volume_status, current_meds, cirrhosis, heart_failureadvance: Volume status + risk factors documented (Spasovski 2014 ESC; Verbalis AJM 2013)
- 4RED_FLAGSSevere symptoms (seizure / coma / herniation) → STAT 3% NaCl 100–150 mL bolus (Spasovski 2014 ESC — recommendation 6.3.1)inputs: sodiumactions: protocol.severe_hyponatremiaadvance: Severe symptoms reversed or protocol active (Spasovski 2014 ESC)
- 5INITIAL_WORKUPSerum osm, urine osm, urine Na, TSH, cortisol, BMP, glucose, lipid + protein for pseudo (Spasovski 2014 ESC — diagnostic algorithm; Verbalis AJM 2013)inputs: serum_osm, urine_osm, urine_sodium, tsh, cortisolactions: panel.renaladvance: Tonicity + volume + ADH state mapped (Spasovski 2014 ESC; Verbalis AJM 2013)
- 6BRANCHING_WORKUPCSW vs SIAD distinction in CNS injury (Maesaka 2009 — FEurate >11% = CSW); oral free water trial for primary polydipsia; CT head if AMS (Sterns NEJM 2015)advance: Subtype localized (Sterns NEJM 2015; Maesaka 2009)
- 7DIFFERENTIALPseudo / translocational / hypovolemic (GI, diuretic, salt-wasting, CSW) / euvolemic (SIAD, hypothyroid, AI, primary polydipsia, beer potomania, exercise, MDMA) / hypervolemic (HF, cirrhosis, nephrotic, advanced CKD) (Spasovski 2014 ESC — Algorithm 1; Verbalis AJM 2013)advance: Subtype assigned (Spasovski 2014 ESC; Verbalis AJM 2013)
- 8RISK_STRATIFICATIONODS risk factors (Na <105, alcoholism, hypokalemia, malnutrition, liver disease) gate correction ceiling ≤8 vs ≤10/24h (Sterns NEJM 2015 — ODS risk factor hierarchy)inputs: sodiumadvance: ODS risk + correction ceiling set (Sterns NEJM 2015)
- 9TREATMENTSevere sx → 3% NaCl bolus (Spasovski 2014 ESC); chronic SIAD → fluid restriction → urea → tolvaptan (Schrier NEJM 2006 SALT) → salt+loop; hypovolemic → isotonic NS; hypervolemic → fluid restriction + loop ± tolvaptan HF only (Spasovski 2014 ESC — treatment algorithm)inputs: sodium, volume_statusactions: protocol.severe_hyponatremia, calc.na_correctionadvance: Plan executed at appropriate rate (Spasovski 2014 ESC; Sterns NEJM 2015)
- 10DISPOSITIONICU/HDU if 3% NaCl or severe sx; floor with Q4–6h Na monitoring otherwise; outpatient for chronic stable (Spasovski 2014 ESC; Verbalis AJM 2013)advance: Disposition set (Spasovski 2014 ESC; Verbalis AJM 2013)
- 11MONITORINGNa q2h while titrating then q4–6h; correction ceiling ≤10 mmol/24h (≤8 if high-risk); DDAVP clamp + D5W if overcorrecting (Spasovski 2014 ESC; Sterns NEJM 2015)inputs: sodiumadvance: Stable correction trajectory (Spasovski 2014 ESC; Sterns NEJM 2015)
- 12FOLLOWUPAddress cause (med review, HF/cirrhosis treatment); educate on fluid intake; outpatient BMP (Verbalis AJM 2013; Spasovski 2014 ESC)advance: Follow-up scheduled (Verbalis AJM 2013; Spasovski 2014 ESC)