smartwatch-lm-0.1 / docs /intent-reference.md
prathamkode's picture
Self-contained gibberish cleanup docs, reply_utils and onnx_sample scripts
c9bffa5 verified

Wrist Wearable Assistant — Intent Reference

This document lists every intent the on-device model can emit. Your app parses these tags and runs the matching handler.

How intents work

Bot lines in training data and at runtime use this format:

bot: <INTENT:GET_STEPS> You're at <STEPS_TODAY> of <STEP_GOAL> — keep going!
Part Role
<INTENT:NAME> Tells the app what to do (fetch steps, start timer, etc.)
<SLOT> placeholders Names which values the app injects from sensors/settings
Text after the tag What the user sees or hears on the watch

The model never outputs real metric values — only intents and slot tokens. Your runtime replaces slots with live data.

NONE is used when the bot only acknowledges or chats with no device action.


Steps

Intent What it does Typical slots
GET_STEPS Read step metrics from the pedometer: today’s count, goals, streaks, week/month totals, comparisons. <STEPS_TODAY>, <STEPS_YESTERDAY>, <STEP_GOAL>, <STEPS_REMAINING>, <STEP_GOAL_PCT>, <STEP_STREAK_DAYS>, <STEPS_WEEK_TOTAL>, <STEPS_LAST_WEEK_TOTAL>, <STEPS_MONTH_TOTAL>, <TIME>, <DATE>, <PERCENT>
SET_STEP_GOAL Change the user’s daily step target. <STEP_GOAL>

Distance

Intent What it does Typical slots
GET_DISTANCE Read distance metrics: today’s total, last session, units, weekly progress, lifetime mileage, hourly average. <DISTANCE_TODAY>, <DISTANCE_LAST_SESSION>, <DISTANCE_UNIT>, <DISTANCE_WEEK_REMAINING>, <DISTANCE_WEEK_BEST>, <DISTANCE_LIFETIME>, <DISTANCE_HOURLY_AVG>, <TIME>, <DATE>

Heart rate

Intent What it does Typical slots
GET_HEART_RATE Read heart rate data: current BPM, resting rate, overnight low, session average, daily peak, elevated minutes, effort zone. <HR_CURRENT_BPM>, <HR_RESTING_BPM>, <HR_RESTING_OVERNIGHT_LOW>, <HR_AVG_SESSION>, <HR_PEAK_TODAY>, <HR_ELEVATED_MINUTES>, <HR_ZONE>, <DURATION>
MEASURE_HEART_RATE Trigger a live on-demand pulse reading from the optical sensor. <HR_CURRENT_BPM>

Sleep

Intent What it does Typical slots
GET_SLEEP Read sleep data: duration last night, sleep/wake times, weekly average, awake minutes, goal gap, weekend total. <SLEEP_HOURS_LAST_NIGHT>, <SLEEP_START_TIME>, <SLEEP_WAKE_TIME>, <SLEEP_AVG_WEEK>, <SLEEP_AWAKE_MINUTES>, <SLEEP_GOAL_HOURS>, <SLEEP_WEEKEND_TOTAL>, <DATE>, <DURATION>
LOG_NAP Record or confirm a short nap session. <DURATION>, <SLEEP_HOURS_LAST_NIGHT>, <TIME>

Calories

Intent What it does Typical slots
GET_CALORIES Read calorie burn: daily total, active burn, remaining to goal, yesterday comparison, per-mile estimate. <CALORIES_TODAY>, <CALORIES_ACTIVE>, <CALORIES_REMAINING>, <CALORIE_GOAL>, <CALORIE_GOAL_PCT>, <CALORIES_YESTERDAY>, <CALORIES_PER_MILE>, <DISTANCE_UNIT>, <DURATION>
SET_CALORIE_GOAL Change the user’s daily active calorie burn target. <CALORIE_GOAL>

Active minutes

Intent What it does Typical slots
GET_ACTIVE_MINUTES Read movement time: today’s active minutes, remaining to goal, weekly total, most active day. <ACTIVE_MINUTES_TODAY>, <ACTIVE_MINUTES_REMAINING>, <ACTIVE_MINUTES_GOAL>, <ACTIVE_MINUTES_WEEK>, <MOST_ACTIVE_DAY>, <DURATION>, <TIME>, <DATE>
SET_ACTIVE_GOAL Change the user’s daily active minutes target. <ACTIVE_MINUTES_GOAL>

Battery

Intent What it does Typical slots
GET_BATTERY Read power state: percentage, estimated days left, days since charge, charge complete status. <BATTERY_PCT>, <BATTERY_DAYS_LEFT>, <DAYS_SINCE_CHARGE>, <CHARGE_COMPLETE>, <DURATION>, <DATE>
ENABLE_POWER_SAVE Turn on low-power / battery saver mode on the device. <BATTERY_PCT>
DISABLE_AOD Turn off always-on display to reduce power draw. <BATTERY_PCT>

Alarms and reminders

Intent What it does Typical slots
SET_ALARM Create or update a wake alarm at a given time. <ALARM_TIME>, <ALARM_LABEL>, <DATE>, <TIME>
LIST_ALARMS Show all alarms currently stored on the device. <ALARM_TIME>, <ALARM_LABEL>
DELETE_ALARM Remove one or all alarms. <ALARM_LABEL>, <ALARM_TIME>
SNOOZE_ALARM Snooze the currently firing alarm for a short period. <ALARM_TIME>, <DURATION>, <ALARM_LABEL>
SET_REMINDER Schedule a recurring reminder (water, bedtime wind-down, move prompts). <ALARM_TIME>, <ALARM_LABEL>, <REMINDER_INTERVAL>, <TIME>
MUTE_REMINDERS Disable hourly move reminders or similar nudges. (none)
EXPLAIN_NUDGE Explain why the watch just vibrated (e.g. sedentary move nudge). <NUDGE_REASON>, <DURATION>, <TIME>

Timers and stopwatch

Intent What it does Typical slots
START_TIMER Start a countdown timer (cooking, stretch, etc.). <DURATION>, <TIME>
PAUSE_TIMER Pause an active countdown. <TIMER_REMAINING>, <DURATION>
CANCEL_TIMER Stop and clear a running timer. <TIMER_REMAINING>, <DURATION>
GET_TIMER_REMAINING Report time left on a timer or whether it has finished. <TIMER_REMAINING>, <DURATION>
START_STOPWATCH Open or start the stopwatch app. (none)
LAP_STOPWATCH Record a lap split on the stopwatch. <LAP_TIME>, <DURATION>
RESET_STOPWATCH Reset stopwatch to zero. <DURATION>, <LAP_TIME>

Workout toggles

Intent What it does Typical slots
START_WORKOUT Begin tracking a workout (walk, run, cycle, indoor cardio). <WORKOUT_TYPE>
PAUSE_WORKOUT Pause the active workout session. <WORKOUT_ELAPSED>, <WORKOUT_STATE>, <WORKOUT_TYPE>
RESUME_WORKOUT Resume a paused workout. <WORKOUT_ELAPSED>, <WORKOUT_STATE>, <WORKOUT_TYPE>
STOP_WORKOUT End the workout and save the session. <WORKOUT_ELAPSED>, <WORKOUT_TYPE>, <WORKOUT_STATE>
DISCARD_WORKOUT End the workout without saving data. <WORKOUT_TYPE>, <WORKOUT_STATE>
GET_WORKOUT_STATUS Check if a workout is running, paused, or left on by mistake; report elapsed time. <WORKOUT_ELAPSED>, <WORKOUT_STATE>, <WORKOUT_TYPE>
GET_WORKOUT_SUMMARY Show the post-workout summary screen (duration, distance, calories, HR). <WORKOUT_TYPE>, <WORKOUT_ELAPSED>, <DISTANCE_TODAY>, <DISTANCE_UNIT>, <CALORIES_ACTIVE>, <HR_AVG_SESSION>

Non-action

Intent What it does Typical slots
NONE Pure conversational reply — thanks, encouragement, clarification — with no sensor fetch or device command. (none)

Summary

Category Intents Count
Steps GET_STEPS, SET_STEP_GOAL 2
Distance GET_DISTANCE 1
Heart rate GET_HEART_RATE, MEASURE_HEART_RATE 2
Sleep GET_SLEEP, LOG_NAP 2
Calories GET_CALORIES, SET_CALORIE_GOAL 2
Active minutes GET_ACTIVE_MINUTES, SET_ACTIVE_GOAL 2
Battery GET_BATTERY, ENABLE_POWER_SAVE, DISABLE_AOD 3
Alarms / reminders SET_ALARM, LIST_ALARMS, DELETE_ALARM, SNOOZE_ALARM, SET_REMINDER, MUTE_REMINDERS, EXPLAIN_NUDGE 7
Timers / stopwatch START_TIMER, PAUSE_TIMER, CANCEL_TIMER, GET_TIMER_REMAINING, START_STOPWATCH, LAP_STOPWATCH, RESET_STOPWATCH 7
Workout START_WORKOUT, PAUSE_WORKOUT, RESUME_WORKOUT, STOP_WORKOUT, DISCARD_WORKOUT, GET_WORKOUT_STATUS, GET_WORKOUT_SUMMARY 7
Non-action NONE 1
Total 35

Each wearable product may implement only a subset of these intents depending on hardware and firmware.