Stress Platform: Health Coach

Retrieve all available personal health metrics and the self-reported Daily Check-in for one recent local calendar day, including available seven-day personal baselines for measured metrics. Prefer this tool for questions such as "how was yesterday?" or "how did I sleep last night?". Use get_health_data instead for a multi-day trend. date must be within the most recent 14 local calendar days, including today. A metric group or an individual optional field is absent when the corresponding reading is unavailable; absence never means zero. baseline_observed_days states how many of the seven preceding local dates contributed to that metric's personal baseline. Heart-rate, activity, and sleep stage values are rounded to whole practical units. Sleep hours retain two decimal places and include display labels such as "7h 42m" for natural-language replies. sleep_efficiency_percent is the percentage of the recorded sleep session classified as asleep; its seven-day baseline follows the same definition. Sleep is associated with the local date on which the user woke up; its start time may be on the preceding calendar date. A daily_check_in contains four subjective 1-5 ratings: physical_condition, energy, mood, and calmness. The endpoints are very poor to great, exhausted to high, very low to great, and very tense to very calm, respectively; 3 is the middle response. It is not sensor-measured, does not have a combined score in this response, and is not a medical assessment. Wearable measurements are not a medical diagnosis.

get_daily_summary

Check whether the user is set up to access their personal Stress Platform health metrics. Call this tool before the first personal-health request in a conversation, or whenever the user needs help with account setup, data connection, billing, or access. Returns whether the user has a Stress Platform profile, the sign-in method associated with their account (`google`, `apple`, or `email`), subscription plan and status, subscription source and expiry date, and whether a health-data source is connected. Important: the user must use the same sign-in method they used when joining Stress Platform and connecting their health-data source. Using a different sign-in method, even with the same email address, may open a different account. Personal health metrics require, in order: a Stress Platform profile, effective Premium access, and a connected health-data source. Follow `requirements`, which contains only the user's next setup action; do not skip ahead or infer access from the provider billing status. `can_read_metrics` is the final access decision and accounts for supported trials and billing grace periods. If no profile exists, guide the user to join Stress Platform at stress-platform.com using the sign-in method shown by this tool. If Premium access is required, explain neutrally that personal metrics are unavailable under the current account entitlement. Do not initiate checkout, facilitate a purchase, or promote an upgrade. If no health-data source is connected after the account and Premium steps are complete, guide them to download Stress Platform iOS app from the App Store. They can complete a subjective Daily Check-in, and may also connect Apple Health to start syncing Apple Watch data. A past-due or cancelled billing status may explain limited access even during a grace period; report the status without initiating renewal or payment actions.

get_platform_status

Retrieve the authenticated user's recent daily health measurements, activity, and self-reported Daily Check-ins. Call this tool after get_platform_status confirms that personal health data is available, when a question about the user's own sleep, recovery, fatigue, heart rate, activity, exercise, reported state, stress patterns, or recent trends would benefit from personal data. Do not use it for general health education that does not require the user's data. Each requested metric group contains available daily values and coverage. Measured metric groups also contain summary statistics. Heart-rate variability is RMSSD in milliseconds; resting heart rate is in beats per minute. Sleep durations are in hours and sleep stages are in minutes. sleep_efficiency_percent is the percentage of the recorded sleep session classified as asleep: it uses time in bed when the source provides it, otherwise recorded asleep and awake stages. Activity fields identify their own units. DAILY_CHECK_IN is subjective reported state rather than a sensor measurement. Its physical_condition, energy, mood, and calmness ratings are required integers on a 1-5 scale, where 1 is the most negative response, 3 is the middle response, and 5 is the most positive response. Specifically: physical_condition ranges from very poor to great, energy from exhausted to high, mood from very low to great, and calmness from very tense to very calm. Keep the four dimensions separate; do not invent an aggregate score or treat them as physiological recovery. A metric group's days list contains only local calendar dates with available data, ordered oldest to newest. coverage.observed_days shows how many of the coverage.requested_days have a usable value. Missing dates have an unknown cause (for example no check-in, device non-wear, unavailable permissions, delayed syncing, or another source issue) and are never represented as zero. A requested metric group is absent when it has no usable values in the selected period. Statistics are calculated only from the returned available days. Values are rounded to whole practical units for conversation, except sleep hours, which retain two decimal places. The current day may be partial. For sleep, date is the local wake-up/reported date, so sleep_start_time may be on the preceding calendar date. Sleep statistics can include typical bedtime and wake time. Wearable measurements are not a medical diagnosis.

get_health_data

Retrieve the user's physiological recovery score and its HRV, resting-heart-rate, and sleep components compared with their personal 14-day baseline. Use when the user asks about recovery, fatigue, or training readiness. components_used identifies the inputs that contributed to the score and components_missing identifies the inputs that could not. quality is FULL when all three inputs contributed and PARTIAL otherwise. A component may contain its baseline and unit but omit value and change_percent when today's reading is not yet available; that component was not included in the score. A missing component means no usable data for it. HRV and resting-heart-rate values are rounded to whole units; sleep hours retain two decimal places. change_percent is calculated before display rounding, so do not recompute it from displayed values. The result supports a cautious, personalized discussion of activity intensity; it is not a medical diagnosis. If data is insufficient, the response explicitly reports that instead of presenting a score. An optional daily_check_in contains the user's four subjective 1-5 ratings as separate context. It never contributes to score, quality, components_used, or components_missing, and may be present even when physiological recovery data is insufficient. Its absence is normal and never makes recovery status INSUFFICIENT_DATA or quality PARTIAL.

get_recovery_status

Retrieve the authenticated user's personalized wellness recommendations for today from their personalized seven-day Stress Platform health plan. Use it when the user asks what to focus on today, discusses their health plan, wants help following their recommended sleep schedule or activity targets, or asks about progress against the plan. Plan targets are already personalized from the user's real historical patterns, model insights, selected focus area, and the effort level they were willing to make for this week. They may intentionally be incremental steps toward the user's longer-term optimal zone. Treat these as the user's active personalized targets for the current week: do not replace them with generic population goals, increase them toward an assumed ideal, or criticize them for being lower than a universal recommendation. ACTIVE returns only today's phase, daily tip, recommended sleep schedule, and actionable targets. Tips are recommendations for this exact plan day; numbers that describe a usual or average pattern are historical context, not today's live measurement. sleep_hours, bedtime, and wake_up_time are recommended schedule values. To assess live adherence, also call get_daily_summary for the same local date and compare only corresponding available measurements. Today's readings may be partial; absence is unknown, not zero. Do not overwrite the plan's recommendation with the observed value. SCHEDULED means the plan starts on start_date. NO_ACTIVE_PLAN means there is no current active week; guide the user to manage_plan_url to start a plan. If focus_area is absent, the user has not configured one: do not infer a default area or tags, and explain that plan setup on the portal will establish it. If focus_area is present, it is the user's stored selection. The portal will handle whether this is a first plan or a continuation after an earlier or expired plan, including any required data analysis. WEEK_FINISHED means an active seven-day plan has passed its final day; guide the user to manage_plan_url to review results and explicitly start the next week. Never imply that the plan automatically renews or continues. The plan supports general wellness behavior and is not a medical diagnosis.

get_todays_health_plan

Compare two consecutive seven-day local-date periods: the most recent seven days including today, and the seven days immediately before them. Use for questions about recent progress or whether the last week differs from the previous week. The response includes the exact inclusive date range for each period. The current day may be partial. A metric is absent when neither period has data. If only one period has data, a measured metric returns its available value and unit while its missing value and percent change are absent; absence never means zero. recent_observed_days and previous_observed_days state how many dates with usable data contributed to each average; a missing date has an unknown cause and is not zero. Values are rounded to whole practical units except sleep hours, which retain two decimal places. change_percent is calculated by the platform before display rounding, so do not recompute it from the displayed values. sleep.sleep_efficiency_percent, when available, compares the percentage of each recorded sleep session classified as asleep. daily_check_in compares each subjective 1-5 dimension separately. change_points is the absolute difference between the recent and previous averages on that scale; it is not a percentage change. Use the reported observed-day counts before describing a trend. Use get_daily_summary for one day and get_health_data for a detailed trend.

get_weekly_comparison