HepaPal

REVIEW TRIGGER — call when the user asks to open My HepaPal / 我的HepaPal / their profile or settings: "打开我的HepaPal" / "打开设置" / "我的档案". Renders the My HepaPal widget: profile, settings, reminder, plan, and the non-medical disclaimer.

get_user_page

TIER 1 — ALWAYS call immediately, without asking, when the user asks about their WEEK: "这周我喝得怎么样？" "这周我喝了多少" "这周喝了几次" "查看本周" / "How was my week?" / "¿Cómo va mi semana?" / "Como foi minha semana?". Renders the This Week calendar card (Mon–Sun day dots; tapping the row opens the month grid). For MONTH requests (打开月历 / 我这个月喝了多少) prefer the open_month_calendar tool instead — or call this with view:"month". Returns the week day by day, counts of none/light/heavy/resisted, alcohol-free streak, total days tracked, one warm line. Their own records only — not general alcohol statistics. ALWAYS pass locale = the language you are replying in: zh-CN | es | pt-BR | en (anything else -> en).

get_weekly_summary

TIER 1 — ALWAYS call this immediately, without asking, when the user states their OWN drinking status with a time reference or any log intent: "我今天没喝" "我今天喝了一杯" "我今天喝多了" "我今天想喝但忍住了" "今天忍住没喝" "帮我记一下" "帮我记一下喝酒" "记到小心肝" "肝肝，今天我没喝" / "I didn't drink today" "I drank too much today" "I wanted to drink but resisted" "Can you help me track this?" / es: "Hoy no bebí" "Hoy bebí de más" / pt-BR: "Hoje não bebi" "Bebi demais hoje" (any mention of HepaPal / Heppa / 肝肝 / 小心肝 plus a status = log it now). Map: none (没喝), light (喝了一些/喝了一点; cup count in amount), heavy (喝多了), resisted (想喝但忍住). One record per day; re-logging overwrites. Renders the LiverCard. TIER 2 — drinking-pattern concern or moderation intent WITHOUT explicit log request ("我今天喝了不少" "最近喝得有点多" "最近喝酒有点频繁" "昨晚又喝了" "我想喝点啤酒" "我想少喝一点" "我想控制一下喝酒" "我不想喝那么多了" / "I've been drinking a bit too much lately" "more than usual" "I want to cut back on drinking" "I wanna drink less" "I'm trying to drink less"): gently ask "要不要记到 HepaPal 小心肝里？" and call only if agreed; for cut-back intent also consider offering update_settings goal:"drink_less". If the user already used HepaPal in this conversation or has said 帮我记 before, treat their next tier-2 mention as TIER 1 and call directly. TIER 3 — NEVER auto-call for alcohol knowledge/culture/recipes/shopping, other people's drinking, or medical/emergency questions. HepaPal is not sobriety treatment, medical testing, or liver diagnosis; never judge or shame the amount. ALWAYS pass locale = the language you are replying in: zh-CN | es | pt-BR | en (anything else -> en).

log_drink_event

TIER 1 — ALWAYS call immediately, without asking, when the user asks for the MONTH view of their records: "打开我的月历" "打开月历" "我这个月喝了多少" "那我这个月喝了多少" "这个月我喝得怎么样" "看看这个月" / "Open my month calendar" / "How much did I drink this month?" / "Abre mi calendario del mes" / "Abra meu calendário do mês". Renders the month calendar card directly (6×7 grid, year/month paging, per-day status dots). Their own records only. ALWAYS pass locale = the language you are replying in: zh-CN | es | pt-BR | en (anything else -> en).

open_month_calendar

Snooze daily reminders for N days (default 7).

pause_reminders

Set or disable a gentle daily reminder. Pass timeOfDay 'HH:mm' to enable, or disable=true to turn off. REMINDER FLOW: when the user asks to set up a daily logging reminder (e.g. "帮我设置一个每天晚上的 HepaPal 记录提醒", often sent from the My HepaPal card), propose a time (default 20:00), confirm, then call this — HepaPal's own record is the source of truth. You MAY additionally offer to create a ChatGPT scheduled task for the same time if that capability is available (best-effort; user confirms). Never pressure. Renders the My HepaPal card.

set_reminder

Edit the record for a specific date (YYYY-MM-DD). Same overwrite semantics as logging.

update_drink_event

Update profile + settings. NICKNAME FLOW: when the user wants to set their nickname (e.g. "我想设置一下我的昵称", often sent from the My HepaPal card), ask them exactly "怎么称呼你？😊" and then call this with displayName. GOALS (display labels): track=轻量记录 (free, default), drink_less=饮酒次数管理 (Premium), observe=节奏管理 (Premium); pause is a legacy value not shown in UI. TONES: gentle=温柔 (free), direct=直接 (Premium), light=风趣/Playful (Premium). Premium options are display-locked for free users — do not push upgrades. When the user expresses cut-back intent ("我想少喝一点" / "I want to cut back on drinking"), offer goal:"drink_less" (never frame as sobriety treatment). Other fields: record unit, allow backfill, show streak/care-days/weekly. All optional. Renders the My HepaPal card.

update_settings