Medication Reminder

When to useCopy Anchor Link

• The user wants to track or be reminded about medicines or supplements they already take: "remind me to take vitamin D three times a week", "did I take my antibiotics today?", "set up reminders for my prescription".
• You have the schedule from the user's own words or their prescription data.

When not to useCopy Anchor Link

• The user asks what to take, how much, or when. Don't answer with a schedule; suggest they ask their pharmacist or clinician.
• You'd have to guess any part of the schedule. Ask the user instead.
• The question is about side effects, interactions or symptoms. This is a log, not advice.

How the agent should use itCopy Anchor Link

• Use only the schedule the user or their prescription gave. Never suggest or fill in doses, times, strengths or medicines. Every schedule field is data-bound.
• Copy strength and instructions exactly as written on the label, and leave them out when unknown. The card shows nothing else about dosing, and always ends with "Follow your prescription."
• Never put dosing advice or a diagnosis in the props. The card only renders the listed fields.
• log comes from stored history. Never invent past doses.
• Set reminders only when your host can actually send them.
• Lifecycle: none of expiresAt, fetchedAt or supersede is needed: the card is a daily tool that stays usable, and it works out "today" from the clock. When the agent shows an updated schedule (a new prescription), supersede the old card so two schedules don't disagree.

InteractionCopy Anchor Link

• Week strip: seven day pills in the user's week order, each with the weekday, the date and one mark per dose. Taken days are tinted green, missed days (past only) red, scheduled and skipped days grey, and unscheduled days have no fill. Marks: a filled dot for taken, a hollow dot for due, a dash for skipped, an ✕ for missed. Today is filled solid.
• Today: each of today's doses has Mark taken and Skip. A logged dose shows "Taken at 8:05 AM" with Undo for 5 minutes.
• Course and supply: one quiet line, such as "Ends Oct 16, 6 days left · 40 pills left · refill by Oct 15", from endDate and refill. With refill, a warning appears when the supply lasts 7 days or less at this schedule (unless the course ends first), with a Request refill button.
• Never locks. It's used every day, so it stays live after every result.

AccessibilityCopy Anchor Link

• Each day has a full screen-reader label, such as "Monday, scheduled, taken at 8:05 AM", and today carries aria-current="date". State is never shown by color alone: taken, missed, skipped, today and scheduled each have an icon or ring too.
• Dose buttons name the dose and the medication ("Mark 2:00 PM dose of Amoxicillin taken").
• Marks, undos, refill requests and the reminders switch are announced in a polite live region.

Two kinds of historyCopy Anchor Link

Like the Checklist, the card is used over a day, so there are two ways to restore it:

<MedicationReminder
  {...part.input}
  progress={savedDoses}
  onProgress={(changes) => saveDoses(part.toolCallId, changes)}
  result={part.state === "output-available" ? part.output : undefined}
/>

InstallationCopy Anchor Link

npx shadcn@latest add https://your-site.com/r/medication-reminder.json

UsageCopy Anchor Link

import { tool } from "ai"
import { medicationReminderTool } from "@/components/genui/medication-reminder.schema"

const tools = {
  [medicationReminderTool.name]: tool({
    description: medicationReminderTool.description,
    inputSchema: medicationReminderTool.inputSchema,
  }),
}

The agent receives one of:

// 1 s after the last mark, skip or undo: every dose logged in this card so far
{ action: "log", entries: [{ medId: "amoxicillin", scheduledFor: "2026-10-10T18:00:00.000Z", status: "taken", at: "2026-10-10T18:04:12.000Z" }] }
// The reminders switch (only with `reminders`)
{ action: "reminders", enabled: true }
// Hand off to the pharmacy flow; don't order anything yourself
{ action: "refill", medId: "iron" }

Treat each log result as the full set for this card: store new entries and remove ones that dropped out (an undo).

With LangGraphCopy Anchor Link

Push it from a graph node with ui.push({ name: "show_medication_schedule", props: { toolCallId, ...args } }, { message }), and render the thread's UI messages with the Renderer.

SchemaCopy Anchor Link

Medication

Host props: status (streaming or ready), now, onResult, onProgress, progress, result and className. now fixes the moment "today" is measured from; it still advances while the card is open.

SourceCopy Anchor Link