@agent-native/core 0.172.3 → 0.172.4

package/corpus/README.md

@@ -31,4 +31,4 @@ rg -n "defineAction|useActionQuery" node_modules/@agent-native/core/corpus
 
 ## Generated Counts
 
-- template files: 8587
+- template files: 8592

package/corpus/templates/calendar/actions/get-settings.ts

@@ -1,9 +1,8 @@
 import { defineAction } from "@agent-native/core";
 import { getRequestUserEmail } from "@agent-native/core/server";
-import { getUserSetting } from "@agent-native/core/settings";
 import { z } from "zod";
 
-import { normalizeCalendarSettings } from "../shared/settings.js";
+import { readCalendarSettings } from "../server/lib/calendar-settings.js";
 
 export default defineAction({
   description: "Get calendar settings",
@@ -12,8 +11,6 @@ export default defineAction({
   run: async () => {
     const email = getRequestUserEmail();
     if (!email) throw new Error("no authenticated user");
-    return normalizeCalendarSettings(
-      await getUserSetting(email, "calendar-settings"),
-    );
+    return readCalendarSettings(email);
   },
 });

package/corpus/templates/calendar/actions/list-events.ts

@@ -13,9 +13,16 @@ import { and, gte, inArray, lte, ne } from "drizzle-orm";
 import { z } from "zod";
 
 import { getDb, schema } from "../server/db/index.js";
+import { getCalendarTimezone } from "../server/lib/calendar-settings.js";
 import * as googleCalendar from "../server/lib/google-calendar.js";
 import { fetchICalEvents } from "../server/lib/ical-fetcher.js";
 import type { CalendarEvent, ExternalCalendar } from "../shared/api.js";
+import {
+  addDaysToDateKey,
+  dateKeyInTimezone,
+  dateTimeInTimezoneToIso,
+  isCalendarTimezone,
+} from "../shared/timezone.js";
 import { calendarEventMatchesQuery } from "./event-search.js";
 
 const DATE_ONLY_RE = /^\d{4}-\d{2}-\d{2}$/;
@@ -74,6 +81,7 @@ interface ListCalendarEventsArgs {
 interface ListCalendarEventsOptions {
   ownedAccounts?: string[];
   range?: CalendarEventRange;
+  timezone?: string;
 }
 
 type CalendarInventorySource = "google" | "bookings" | "ics" | "overlays";
@@ -346,84 +354,9 @@ function compactInventoryEvent(event: CalendarEvent): CalendarInventoryItem {
   };
 }
 
-function normalizeTimezone(timezone?: string): string {
-  if (!timezone) return "UTC";
-  try {
-    new Intl.DateTimeFormat("en-US", { timeZone: timezone }).format();
-    return timezone;
-  } catch {
-    return "UTC";
-  }
-}
-
-function datePartsInTimezone(date: Date, timezone: string) {
-  const parts = new Intl.DateTimeFormat("en-US", {
-    timeZone: timezone,
-    hourCycle: "h23",
-    year: "numeric",
-    month: "2-digit",
-    day: "2-digit",
-    hour: "2-digit",
-    minute: "2-digit",
-    second: "2-digit",
-  }).formatToParts(date);
-  const get = (type: string) =>
-    Number(parts.find((part) => part.type === type)?.value ?? "0");
-  return {
-    year: get("year"),
-    month: get("month"),
-    day: get("day"),
-    hour: get("hour"),
-    minute: get("minute"),
-    second: get("second"),
-  };
-}
-
-function dateOnlyInTimezone(date: Date, timezone: string): string {
-  const parts = datePartsInTimezone(date, timezone);
-  return [
-    String(parts.year).padStart(4, "0"),
-    String(parts.month).padStart(2, "0"),
-    String(parts.day).padStart(2, "0"),
-  ].join("-");
-}
-
-function addDaysToDateOnly(dateOnly: string, days: number): string {
-  const [year, month, day] = dateOnly.split("-").map(Number);
-  const date = new Date(Date.UTC(year, month - 1, day + days));
-  return [
-    String(date.getUTCFullYear()).padStart(4, "0"),
-    String(date.getUTCMonth() + 1).padStart(2, "0"),
-    String(date.getUTCDate()).padStart(2, "0"),
-  ].join("-");
-}
-
-function offsetMsForTimezone(date: Date, timezone: string): number {
-  const parts = datePartsInTimezone(date, timezone);
-  const asUtc = Date.UTC(
-    parts.year,
-    parts.month - 1,
-    parts.day,
-    parts.hour,
-    parts.minute,
-    parts.second,
-  );
-  return asUtc - date.getTime();
-}
-
-function zonedDateOnlyToUtcIso(dateOnly: string, timezone: string): string {
-  const [year, month, day] = dateOnly.split("-").map(Number);
-  const wallClockUtc = Date.UTC(year, month - 1, day, 0, 0, 0);
-  const firstGuess = new Date(wallClockUtc);
-  const firstOffset = offsetMsForTimezone(firstGuess, timezone);
-  const secondGuess = new Date(wallClockUtc - firstOffset);
-  const secondOffset = offsetMsForTimezone(secondGuess, timezone);
-  return new Date(wallClockUtc - secondOffset).toISOString();
-}
-
 function normalizeDateBound(value: string, timezone: string): string {
   if (DATE_ONLY_RE.test(value)) {
-    return zonedDateOnlyToUtcIso(value, timezone);
+    return dateTimeInTimezoneToIso(value, "00:00", timezone);
   }
   const parsed = new Date(value);
   if (Number.isNaN(parsed.getTime())) {
@@ -437,19 +370,20 @@ export function resolveCalendarEventRange(args: {
   to?: string;
   timezone?: string;
 }): CalendarEventRange {
-  const timezone = normalizeTimezone(args.timezone ?? getRequestTimezone());
-  const today = dateOnlyInTimezone(new Date(), timezone);
+  const requested = args.timezone ?? getRequestTimezone();
+  const timezone = isCalendarTimezone(requested) ? requested : "UTC";
+  const today = dateKeyInTimezone(new Date(), timezone);
   let from = args.from?.trim();
   let to = args.to?.trim();
   let defaulted = false;
 
   if (!from && !to) {
     from = today;
-    to = addDaysToDateOnly(today, 1);
+    to = addDaysToDateKey(today, 1);
     defaulted = true;
   } else if (from && !to) {
     if (DATE_ONLY_RE.test(from)) {
-      to = addDaysToDateOnly(from, 1);
+      to = addDaysToDateKey(from, 1);
     } else {
       const start = new Date(from);
       if (Number.isNaN(start.getTime())) {
@@ -631,11 +565,13 @@ export async function listCalendarEvents(
 ): Promise<CalendarEventsResult> {
   const email = getRequestUserEmail();
   if (!email) throw new Error("no authenticated user");
+  const timezone = options.timezone ?? (await getCalendarTimezone(email));
   const range =
     options.range ??
     resolveCalendarEventRange({
       from: args.from,
       to: args.to,
+      timezone,
     });
 
   const sources = resolveInventorySources(args.sources);
@@ -882,6 +818,9 @@ export default defineAction({
       args.format === "inventory" || (ctx?.caller === "mcp" && !args.format);
     const owner = inventory ? getRequestUserEmail() : undefined;
     if (inventory && !owner) throw new Error("no authenticated user");
+    const calendarTimezone = inventory
+      ? await getCalendarTimezone(owner!)
+      : undefined;
 
     // Reject invalid, expired, owner-bound, and query-bound cursors before any
     // provider call. Omitted account filters require the cheap owned-account
@@ -895,6 +834,7 @@ export default defineAction({
       preparedRange = resolveCalendarEventRange({
         from: args.from,
         to: args.to,
+        timezone: calendarTimezone,
       });
       preparedOwnedAccounts = args.accountEmails
         ? undefined
@@ -921,6 +861,7 @@ export default defineAction({
       {
         ownedAccounts: preparedOwnedAccounts,
         range: preparedRange,
+        timezone: calendarTimezone,
       },
     );
 

package/corpus/templates/calendar/actions/update-settings.ts

@@ -1,18 +1,21 @@
 import { defineAction } from "@agent-native/core";
 import { getRequestUserEmail } from "@agent-native/core/server";
-import {
-  getUserSetting,
-  putUserSetting,
-  putSetting,
-} from "@agent-native/core/settings";
 import { z } from "zod";
 
-import { normalizeCalendarSettings } from "../shared/settings.js";
+import { saveCalendarSettings } from "../server/lib/calendar-settings.js";
+import { isCalendarTimezone } from "../shared/timezone.js";
 
 export default defineAction({
   description: "Update calendar settings",
   schema: z.object({
-    timezone: z.string().optional().describe("Timezone"),
+    timezone: z
+      .string()
+      .trim()
+      .refine(isCalendarTimezone, {
+        message: "Timezone must be a valid IANA timezone.",
+      })
+      .optional()
+      .describe("IANA timezone, e.g. Europe/Warsaw"),
     bookingPageTitle: z.string().optional().describe("Booking page title"),
     bookingPageDescription: z
       .string()
@@ -32,14 +35,6 @@ export default defineAction({
   run: async (args) => {
     const email = getRequestUserEmail();
     if (!email) throw new Error("no authenticated user");
-    const currentSettings = await getUserSetting(email, "calendar-settings");
-    const settings = normalizeCalendarSettings({
-      ...normalizeCalendarSettings(currentSettings),
-      ...args,
-    });
-    const settingsRecord = settings as unknown as Record<string, unknown>;
-    await putUserSetting(email, "calendar-settings", settingsRecord);
-    await putSetting("calendar-settings", settingsRecord);
-    return settings;
+    return saveCalendarSettings(email, args);
   },
 });

package/corpus/templates/calendar/actions/view-screen.ts

@@ -6,11 +6,17 @@ import { z } from "zod";
 
 import { getDb, schema } from "../server/db/index.js";
 import { rowToBookingLink } from "../server/lib/booking-link-utils.js";
+import { getCalendarTimezone } from "../server/lib/calendar-settings.js";
 import type { CalendarEvent, CalendarEventDraft } from "../shared/api.js";
 import {
   CALENDAR_VIEW_PREFERENCES_KEY,
   normalizeCalendarViewPreferences,
 } from "../shared/calendar-view-preferences.js";
+import {
+  addDaysToDateKey,
+  dateKeyInTimezone,
+  dateTimeInTimezoneToIso,
+} from "../shared/timezone.js";
 import { extractVideoLink } from "./event-action-helpers.js";
 import { listCalendarEvents } from "./list-events.js";
 
@@ -49,6 +55,11 @@ async function fetchEventsForRange(
   }
 }
 
+function dateKeyFromParts(date: Date): string {
+  const pad = (value: number) => String(value).padStart(2, "0");
+  return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
+}
+
 export default defineAction({
   description:
     "See what the user is currently looking at on screen. Returns the current view, date range, and visible events. Always call this first before taking any action.",
@@ -67,18 +78,22 @@ export default defineAction({
     const nav = navigation as any;
 
     if (nav?.view === "calendar" || !nav?.view) {
-      const now = new Date();
-      const viewDate = nav?.date ? new Date(nav.date) : now;
-
-      const from = new Date(viewDate);
-      from.setDate(from.getDate() - from.getDay());
-      from.setHours(0, 0, 0, 0);
-      const to = new Date(from);
-      to.setDate(to.getDate() + 7);
+      const email = getRequestUserEmail();
+      if (!email) throw new Error("no authenticated user");
+      const timezone = await getCalendarTimezone(email);
+      // Work in calendar days, then resolve the two edges to instants once.
+      const viewDay = nav?.date ?? dateKeyInTimezone(new Date(), timezone);
+      // Noon UTC so the weekday can never be shifted by an offset.
+      const weekday = new Date(`${viewDay}T12:00:00Z`).getUTCDay();
+      const weekStart = addDaysToDateKey(viewDay, -weekday);
 
       const eventResult = await fetchEventsForRange(
-        from.toISOString(),
-        to.toISOString(),
+        dateTimeInTimezoneToIso(weekStart, "00:00", timezone),
+        dateTimeInTimezoneToIso(
+          addDaysToDateKey(weekStart, 7),
+          "00:00",
+          timezone,
+        ),
       );
       const { events } = eventResult;
 

package/corpus/templates/calendar/app/components/calendar/CommandPalette.tsx

@@ -1,6 +1,7 @@
 import { useT } from "@agent-native/core/client/i18n";
 import { CommandMenu } from "@agent-native/core/client/navigation";
 import type { CalendarEvent } from "@shared/api";
+import { timezoneFormatter } from "@shared/timezone";
 import {
   IconCalendar,
   IconClock,
@@ -28,6 +29,7 @@ interface CommandPaletteProps {
   open: boolean;
   onClose: () => void;
   events: CalendarEvent[];
+  timezone?: string;
   onGoToDate: (date: Date) => void;
   onEventClick: (event: CalendarEvent) => void;
   onCreateEvent: () => void;
@@ -80,6 +82,7 @@ export function CommandPalette({
   open,
   onClose,
   events,
+  timezone,
   onGoToDate,
   onEventClick,
   onCreateEvent,
@@ -192,7 +195,10 @@ export function CommandPalette({
                 />
                 <span className="flex-1 truncate">{event.title}</span>
                 <span className="ml-2 text-xs text-muted-foreground">
-                  {format(parseISO(event.start), "MMM d")}
+                  {timezoneFormatter(event.allDay ? "UTC" : timezone, {
+                    month: "short",
+                    day: "numeric",
+                  }).format(new Date(event.start))}
                 </span>
               </CommandMenu.Item>
             ))}

package/corpus/templates/calendar/app/components/calendar/EventCard.tsx

@@ -1,5 +1,6 @@
 import { useT } from "@agent-native/core/client/i18n";
 import type { CalendarEvent } from "@shared/api";
+import { timezoneFormatter } from "@shared/timezone";
 import { IconAlertTriangleFilled, IconCalendarOff } from "@tabler/icons-react";
 
 import {
@@ -26,6 +27,7 @@ interface EventCardProps {
   onDragEnd?: () => void;
   dimmed?: boolean;
   colorPreferences?: CalendarColorPreferences;
+  timezone?: string;
 }
 
 export function EventCard({
@@ -37,6 +39,7 @@ export function EventCard({
   onDragEnd,
   dimmed = false,
   colorPreferences,
+  timezone,
 }: EventCardProps) {
   const t = useT();
   const workingLocationLabels = createWorkingLocationDisplayLabels(t);
@@ -164,10 +167,10 @@ export function EventCard({
       )}
       {!event.allDay && (
         <span className="text-foreground/70">
-          {new Date(event.start).toLocaleTimeString([], {
+          {timezoneFormatter(timezone, {
             hour: "numeric",
             minute: "2-digit",
-          })}
+          }).format(new Date(event.start))}
         </span>
       )}
       {event.ownerColor && (

package/corpus/templates/calendar/app/lib/calendar-timezone.ts

@@ -1,4 +1,5 @@
 import type { CalendarEvent } from "@shared/api";
+import { addDaysToDateKey, isCalendarTimezone } from "@shared/timezone";
 import {
   addDays,
   endOfMonth,
@@ -42,20 +43,8 @@ export function getBrowserTimezone(): string {
   }
 }
 
-export function isValidTimezone(timezone: string): boolean {
-  try {
-    new Intl.DateTimeFormat("en-US", { timeZone: timezone }).format();
-    return true;
-  } catch (error) {
-    if (error instanceof RangeError) return false;
-    throw error;
-  }
-}
-
 export function normalizeTimezone(timezone?: string): string {
-  return timezone && isValidTimezone(timezone)
-    ? timezone
-    : getBrowserTimezone();
+  return isCalendarTimezone(timezone) ? timezone : getBrowserTimezone();
 }
 
 /** Date carriers are kept at local noon so browser DST never changes their date. */
@@ -68,11 +57,7 @@ export function dateToCalendarDateKey(date: Date): string {
   return format(date, "yyyy-MM-dd");
 }
 
-export function addCalendarDays(date: string, amount: number): string {
-  const [year, month, day] = date.split("-").map(Number);
-  const next = new Date(Date.UTC(year, month - 1, day + amount));
-  return next.toISOString().slice(0, 10);
-}
+export const addCalendarDays = addDaysToDateKey;
 
 function dateTimeParts(value: Date | string, timezone: string) {
   const parsed = value instanceof Date ? value : new Date(value);

package/corpus/templates/calendar/app/lib/event-form-utils.ts

@@ -1,4 +1,7 @@
 import type { CalendarEvent, UpdateEventScope } from "@shared/api";
+import { dateTimeInTimezoneToIso } from "@shared/timezone";
+
+export { dateTimeInTimezoneToIso };
 
 export type ReminderMethod = "popup" | "email";
 export type ReminderMode = "default" | "none" | "custom";
@@ -247,68 +250,6 @@ export function resolveEventTimezone(timezone?: string | null) {
   return timezone?.trim() || getLocalTimezone();
 }
 
-function getTimezoneOffsetMs(date: Date, timezone: string) {
-  const parts = new Intl.DateTimeFormat("en-US", {
-    timeZone: timezone,
-    hourCycle: "h23",
-    year: "numeric",
-    month: "2-digit",
-    day: "2-digit",
-    hour: "2-digit",
-    minute: "2-digit",
-    second: "2-digit",
-  }).formatToParts(date);
-  const values = new Map(parts.map((part) => [part.type, part.value]));
-  const asUtc = Date.UTC(
-    Number(values.get("year")),
-    Number(values.get("month")) - 1,
-    Number(values.get("day")),
-    Number(values.get("hour")),
-    Number(values.get("minute")),
-    Number(values.get("second")),
-  );
-  return asUtc - date.getTime();
-}
-
-export function dateTimeInTimezoneToIso(
-  date: string,
-  time: string,
-  timezone: string,
-) {
-  const [year, month, day] = date.split("-").map(Number);
-  const [hour, minute] = time.split(":").map(Number);
-  const wallClockUtc = Date.UTC(year, month - 1, day, hour, minute, 0);
-  const offsets = new Set<number>();
-  for (let hours = -36; hours <= 36; hours += 6) {
-    offsets.add(
-      getTimezoneOffsetMs(
-        new Date(wallClockUtc + hours * 60 * 60 * 1000),
-        timezone,
-      ),
-    );
-  }
-
-  const candidates = [...offsets]
-    .map((offset) => new Date(wallClockUtc - offset))
-    .map((candidate) => ({
-      candidate,
-      localWallClock:
-        candidate.getTime() + getTimezoneOffsetMs(candidate, timezone),
-    }))
-    .sort((a, b) => {
-      const aDelta = a.localWallClock - wallClockUtc;
-      const bDelta = b.localWallClock - wallClockUtc;
-      if (aDelta === 0 && bDelta === 0) {
-        return a.candidate.getTime() - b.candidate.getTime();
-      }
-      if (aDelta >= 0 && bDelta < 0) return -1;
-      if (aDelta < 0 && bDelta >= 0) return 1;
-      return Math.abs(aDelta) - Math.abs(bDelta);
-    });
-
-  return candidates[0].candidate.toISOString();
-}
-
 export function formatTimezoneLabel(timezone: string) {
   const city = timezone.split("/").pop()?.replace(/_/g, " ") || timezone;
   return `${city} (${timezone})`;

package/corpus/templates/calendar/changelog/2026-07-22-calendar-grid-local-time.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-22
+---
+
+Calendar views now render, navigate, and create events in the timezone selected in Calendar settings.

package/corpus/templates/calendar/changelog/2026-08-19-the-calendar-loads-again-for-accounts-whose-saved-timezone-w.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-08-19
+---
+
+The calendar grid and settings load again for accounts whose saved timezone was stored in a format the calendar no longer understands

package/corpus/templates/calendar/server/handlers/settings.ts

@@ -1,13 +1,11 @@
 import { readBody, getSession } from "@agent-native/core/server";
-import {
-  getSetting,
-  getUserSetting,
-  putUserSetting,
-  putSetting,
-} from "@agent-native/core/settings";
 import { defineEventHandler, setResponseStatus, type H3Event } from "h3";
 
-import { normalizeCalendarSettings } from "../../shared/settings.js";
+import {
+  readCalendarSettings,
+  readPublicCalendarSettings,
+  saveCalendarSettings,
+} from "../lib/calendar-settings.js";
 
 async function uEmail(event: H3Event): Promise<string> {
   const session = await getSession(event);
@@ -20,10 +18,7 @@ async function uEmail(event: H3Event): Promise<string> {
 
 export const getSettings = defineEventHandler(async (event: H3Event) => {
   try {
-    const email = await uEmail(event);
-    return normalizeCalendarSettings(
-      await getUserSetting(email, "calendar-settings"),
-    );
+    return await readCalendarSettings(await uEmail(event));
   } catch (error: any) {
     setResponseStatus(event, 500);
     return { error: error.message };
@@ -31,24 +26,13 @@ export const getSettings = defineEventHandler(async (event: H3Event) => {
 });
 
 export const getPublicSettings = defineEventHandler(async (_event: H3Event) => {
-  return normalizeCalendarSettings(await getSetting("calendar-settings"));
+  return readPublicCalendarSettings();
 });
 
 export const updateSettings = defineEventHandler(async (event: H3Event) => {
   try {
     const email = await uEmail(event);
-    const body = await readBody<unknown>(event);
-    const settings = normalizeCalendarSettings({
-      ...normalizeCalendarSettings(
-        await getUserSetting(email, "calendar-settings"),
-      ),
-      ...(body && typeof body === "object" ? body : {}),
-    });
-    const settingsRecord = settings as unknown as Record<string, unknown>;
-    await putUserSetting(email, "calendar-settings", settingsRecord);
-    // Also write to global key so the public booking/settings page can read it
-    await putSetting("calendar-settings", settingsRecord);
-    return settings;
+    return await saveCalendarSettings(email, await readBody<unknown>(event));
   } catch (error: any) {
     setResponseStatus(event, 500);
     return { error: error.message };

package/corpus/templates/calendar/server/lib/calendar-settings.ts

@@ -0,0 +1,58 @@
+import { getRequestTimezone } from "@agent-native/core/server";
+import {
+  getSetting,
+  getUserSetting,
+  putSetting,
+  putUserSetting,
+} from "@agent-native/core/settings";
+
+import type { Settings } from "../../shared/api.js";
+import {
+  DEFAULT_SETTINGS,
+  normalizeCalendarSettings,
+} from "../../shared/settings.js";
+import { isCalendarTimezone } from "../../shared/timezone.js";
+
+const SETTINGS_KEY = "calendar-settings";
+
+function callerTimezone(): string {
+  const timezone = getRequestTimezone();
+  return isCalendarTimezone(timezone) ? timezone : DEFAULT_SETTINGS.timezone;
+}
+
+export async function readCalendarSettings(email: string): Promise<Settings> {
+  return normalizeCalendarSettings(await getUserSetting(email, SETTINGS_KEY), {
+    timezone: callerTimezone(),
+  });
+}
+
+/**
+ * Settings for the public booking page. The fixed default applies here rather
+ * than the caller's zone: a visitor must not shift the owner's booking times.
+ */
+export async function readPublicCalendarSettings(): Promise<Settings> {
+  return normalizeCalendarSettings(await getSetting(SETTINGS_KEY));
+}
+
+/** Merge a patch over the stored settings and persist the whole record. */
+export async function saveCalendarSettings(
+  email: string,
+  patch: unknown,
+): Promise<Settings> {
+  const settings = normalizeCalendarSettings({
+    ...(await readCalendarSettings(email)),
+    ...(patch && typeof patch === "object" ? patch : {}),
+  });
+  const record = settings as unknown as Record<string, unknown>;
+  await Promise.all([
+    putUserSetting(email, SETTINGS_KEY, record),
+    // Also write the global key so the public booking page can read it.
+    putSetting(SETTINGS_KEY, record),
+  ]);
+  return settings;
+}
+
+/** The timezone to compute event ranges in — always a valid IANA zone. */
+export async function getCalendarTimezone(email: string): Promise<string> {
+  return (await readCalendarSettings(email)).timezone;
+}