cold_chain
Analyze temperature-controlled shipments for cold-chain compliance, thermal excursion risk, and lowest-total-cost mode and packaging. Compares ocean reefer, passive packaging, and air options with expected loss assessment.
Instructions
Cold-chain / pharma (GDP) compliance for a TEMPERATURE-CONTROLLED shipment — beyond a reefer setpoint. Give the lane + the product (e.g. 'pharma vaccines 2-8°C', 'frozen seafood', 'bananas') or a sensitivity class, and it returns the temperature requirement, the THERMAL-EXCURSION risk across the transit, the recommended MODE + thermal packaging, and the GDP datalogger/chain-validation needs. The core insight: excursion risk RISES with transit DURATION. It reads the iter3 transit p90 for the ocean routing and runs a survival model per packaging option (ocean active reefer, ocean qualified-passive PCM/VIP, active air) — a long Cape-diverted reefer accumulates far more deviation exposure (and a gen-set/fuel/plug failure tail) than a 3-day air leg. Each option is totalled = freight + packaging premium + monitoring + EXPECTED THERMAL LOSS (excursion × loss-fraction × cargo value), and the lowest-total option wins. Proves: pharma 2-8°C on a long transit → high excursion risk → fly it with active cooling OR use qualified passive packaging; a frozen load on a short lane → ocean reefer is fine. For GDP cargo it mandates continuous data-logging, pre-cool, a validated lane and a documented chain. Honest (regla 7): INDICATIVE GDP/cold-chain model — excursion probabilities, MKT, packaging performance and loss fractions are modeled typicals, NOT a GDP qualification, stability statement or QA release. PREMIUM: pay per call with x402 (USDC on Base) or a prepaid key.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| origin_port | Yes | Origin port (city name, UN/LOCODE, or 'City, Country'). | |
| dest_port | Yes | Destination port. | |
| container_type | No | Container '20ft'/'40ft'/'40HC'. Optional; default '40ft'. | |
| ship_date | No | Ship date (YYYY-MM-DD) — selects the transit/diversion state. Optional; default today. | |
| product | No | Product description — 'pharma vaccines 2-8°C', 'frozen seafood', 'bananas', 'fresh produce', 'insulin'. Sets the temperature requirement & sensitivity. | |
| sensitivity | No | Explicit sensitivity class — ambient | cool | chilled | frozen | pharma | pharma-critical. Overrides the product match. Provide this OR 'product'. | |
| cargo_value_usd | No | Total cargo value (USD) — drives the expected-loss economics. Optional; a class default is used if omitted. | |
| unit_value_usd | No | Per-unit value (USD) — with 'units', an alternative to cargo_value_usd. Optional. | |
| units | No | Number of units (with unit_value_usd). Optional. | |
| ocean_freight_usd | No | Override the ocean all-in freight per container (USD). Optional — derived if omitted. | |
| air_freight_multiple | No | Air freight as a multiple of ocean (default ~6-7×). Optional. |