@agent-native/core 0.172.2 → 0.172.4

package/corpus/templates/calendar/server/lib/find-time.ts

@@ -3,6 +3,12 @@ import type {
   FindTimeParticipant,
   FindTimeSlot,
 } from "../../shared/api.js";
+import {
+  addDaysToDateKey,
+  dateKeyInTimezone,
+  dateTimeInTimezoneToIso,
+  isCalendarTimezone,
+} from "../../shared/timezone.js";
 
 export interface AvailabilitySchedule {
   timezone: string;
@@ -37,108 +43,24 @@ const DEFAULT_SCHEDULE: AvailabilitySchedule["schedule"] = {
   sunday: [],
 };
 
+/**
+ * These live in shared/timezone.ts so the grid, the actions, and this module
+ * cannot drift on DST edges. Kept under their original names because callers
+ * across the template import them from here.
+ */
 export 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"),
-  };
+  return isCalendarTimezone(timezone) ? timezone : "UTC";
 }
 
-export 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("-");
-}
-
-export 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();
-}
+export const dateOnlyInTimezone = dateKeyInTimezone;
+export const addDaysToDateOnly = addDaysToDateKey;
 
 export function zonedDateTimeToUtcIso(
   dateOnly: string,
   time: string,
   timezone: string,
 ): string {
-  const [year, month, day] = dateOnly.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(
-      offsetMsForTimezone(
-        new Date(wallClockUtc + hours * 60 * 60 * 1000),
-        timezone,
-      ),
-    );
-  }
-
-  const candidates = [...offsets]
-    .map((offset) => new Date(wallClockUtc - offset))
-    .map((candidate) => ({
-      candidate,
-      localWallClock:
-        candidate.getTime() + offsetMsForTimezone(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();
+  return dateTimeInTimezoneToIso(dateOnly, time, timezone);
 }
 
 function normalizeDateBound(value: string, timezone: string): string {

package/corpus/templates/calendar/shared/settings.ts

@@ -3,6 +3,7 @@ import {
   DEFAULT_CALENDAR_WEEK_START,
   isCalendarWeekStart,
 } from "./calendar-week.js";
+import { isCalendarTimezone } from "./timezone.js";
 
 export const DEFAULT_SETTINGS: Settings = {
   timezone: "America/New_York",
@@ -12,33 +13,38 @@ export const DEFAULT_SETTINGS: Settings = {
   weekStart: DEFAULT_CALENDAR_WEEK_START,
 };
 
-export function normalizeCalendarSettings(input: unknown): Settings {
+export function normalizeCalendarSettings(
+  input: unknown,
+  fallbacks?: Partial<Settings>,
+): Settings {
+  const defaults = fallbacks
+    ? normalizeCalendarSettings(fallbacks)
+    : DEFAULT_SETTINGS;
   const raw =
     input && typeof input === "object"
       ? (input as Partial<Settings>)
       : ({} as Partial<Settings>);
 
   return {
-    timezone:
-      typeof raw.timezone === "string"
-        ? raw.timezone
-        : DEFAULT_SETTINGS.timezone,
+    timezone: isCalendarTimezone(raw.timezone)
+      ? raw.timezone
+      : defaults.timezone,
     bookingPageTitle:
       typeof raw.bookingPageTitle === "string"
         ? raw.bookingPageTitle
-        : DEFAULT_SETTINGS.bookingPageTitle,
+        : defaults.bookingPageTitle,
     bookingPageDescription:
       typeof raw.bookingPageDescription === "string"
         ? raw.bookingPageDescription
-        : DEFAULT_SETTINGS.bookingPageDescription,
+        : defaults.bookingPageDescription,
     defaultEventDuration:
       typeof raw.defaultEventDuration === "number" &&
       Number.isFinite(raw.defaultEventDuration) &&
       raw.defaultEventDuration > 0
         ? raw.defaultEventDuration
-        : DEFAULT_SETTINGS.defaultEventDuration,
+        : defaults.defaultEventDuration,
     weekStart: isCalendarWeekStart(raw.weekStart)
       ? raw.weekStart
-      : DEFAULT_SETTINGS.weekStart,
+      : defaults.weekStart,
   };
 }

package/corpus/templates/calendar/shared/timezone.ts

@@ -0,0 +1,127 @@
+/**
+ * Constructing an `Intl.DateTimeFormat` costs ~45µs, and resolving one wall
+ * clock probes the zone a dozen times — so formatters are cached per zone and
+ * option set. Only the date varies per call, and that is an argument to
+ * `format`/`formatToParts`, never part of the formatter.
+ */
+const formatterCache = new Map<string, Intl.DateTimeFormat>();
+
+export function timezoneFormatter(
+  timezone: string | undefined,
+  options: Intl.DateTimeFormatOptions,
+  locale?: string,
+): Intl.DateTimeFormat {
+  const key = `${locale ?? ""}\u0000${timezone ?? ""}\u0000${JSON.stringify(options)}`;
+  let formatter = formatterCache.get(key);
+  if (!formatter) {
+    formatter = new Intl.DateTimeFormat(locale, {
+      ...options,
+      timeZone: timezone,
+    });
+    formatterCache.set(key, formatter);
+  }
+  return formatter;
+}
+
+/**
+ * Whether a value names a zone this calendar can use. Only a `RangeError` means
+ * Intl rejected the zone; any other failure is a real fault and must surface
+ * instead of being reported as "invalid".
+ *
+ * Several older helpers around the template still run their own version of this
+ * check with a bare `catch`; prefer this one and delete those as you touch them.
+ */
+export function isCalendarTimezone(value: unknown): value is string {
+  if (typeof value !== "string" || !value.trim()) return false;
+  try {
+    new Intl.DateTimeFormat("en-US", { timeZone: value }).format();
+    return true;
+  } catch (error) {
+    if (error instanceof RangeError) return false;
+    throw error;
+  }
+}
+
+const OFFSET_PROBE_OPTIONS: Intl.DateTimeFormatOptions = {
+  hourCycle: "h23",
+  year: "numeric",
+  month: "2-digit",
+  day: "2-digit",
+  hour: "2-digit",
+  minute: "2-digit",
+  second: "2-digit",
+};
+
+function offsetMsInTimezone(date: Date, timezone: string): number {
+  const parts = timezoneFormatter(
+    timezone,
+    OFFSET_PROBE_OPTIONS,
+    "en-US",
+  ).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,
+): 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(
+      offsetMsInTimezone(
+        new Date(wallClockUtc + hours * 60 * 60 * 1000),
+        timezone,
+      ),
+    );
+  }
+
+  const candidates = [...offsets]
+    .map((offset) => new Date(wallClockUtc - offset))
+    .map((candidate) => ({
+      candidate,
+      localWallClock:
+        candidate.getTime() + offsetMsInTimezone(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 dateKeyInTimezone(date: Date, timezone: string): string {
+  const parts = timezoneFormatter(
+    timezone,
+    { year: "numeric", month: "2-digit", day: "2-digit" },
+    "en-CA",
+  ).formatToParts(date);
+  const value = (type: string) =>
+    parts.find((part) => part.type === type)!.value;
+  return `${value("year")}-${value("month")}-${value("day")}`;
+}
+
+export function addDaysToDateKey(date: string, amount: number): string {
+  const [year, month, day] = date.split("-").map(Number);
+  const shifted = new Date(Date.UTC(year, month - 1, day + amount));
+  return shifted.toISOString().slice(0, 10);
+}

package/corpus/templates/clips/actions/lib/finalize-ended-meetings.ts

@@ -0,0 +1,37 @@
+import { and, eq, inArray, isNotNull } from "drizzle-orm";
+
+import { getDb, schema } from "../../server/db/index.js";
+import finalizeMeeting from "../finalize-meeting.js";
+
+/** Finalize meeting notes once a linked recording's transcript is ready. */
+export async function finalizeEndedMeetingsForRecording(
+  db: ReturnType<typeof getDb>,
+  recordingId: string,
+): Promise<void> {
+  const meetings = await db
+    .select({ id: schema.meetings.id })
+    .from(schema.meetings)
+    .where(
+      and(
+        eq(schema.meetings.recordingId, recordingId),
+        isNotNull(schema.meetings.actualEnd),
+        inArray(schema.meetings.transcriptStatus, ["ready", "failed"]),
+        eq(schema.meetings.summaryMd, ""),
+      ),
+    );
+
+  await Promise.all(
+    meetings.map(async (meeting) => {
+      try {
+        await finalizeMeeting.run({ meetingId: meeting.id });
+      } catch (error) {
+        // Transcript delivery must remain successful even when the separate
+        // notes model is unavailable; a later transcript retry can try again.
+        console.warn(
+          `[clips] meeting notes finalization failed for ${meeting.id}:`,
+          (error as Error)?.message ?? String(error),
+        );
+      }
+    }),
+  );
+}

package/corpus/templates/clips/actions/request-transcript.ts

@@ -80,6 +80,7 @@ import {
   clearBuilderCreditsExhausted,
   noteBuilderCreditsExhausted,
 } from "./lib/builder-credits-state.js";
+import { finalizeEndedMeetingsForRecording } from "./lib/finalize-ended-meetings.js";
 import {
   fetchLoomTranscript,
   loomTranscriptUnavailableMessage,
@@ -739,6 +740,7 @@ export async function importLoomTranscriptForRecording({
           now,
         });
         await writeAppState("refresh-signal", { ts: Date.now() });
+        await finalizeEndedMeetingsForRecording(db, recordingId);
         await queueBrainExport(recordingId);
         return {
           recordingId,
@@ -1177,6 +1179,7 @@ async function completeReadyTranscript({
   // (`transcript-cleanup-${recordingId}`) before its next 2s tick lands —
   // otherwise the "Cleaning up…" badge can lag for one full poll interval.
   await writeAppState("refresh-signal", { ts: Date.now() });
+  await finalizeEndedMeetingsForRecording(db, recordingId);
   await queueBrainExport(recordingId);
 
   return {
@@ -1580,6 +1583,7 @@ const requestTranscriptAction = defineAction({
             now,
           });
           await writeAppState("refresh-signal", { ts: Date.now() });
+          await finalizeEndedMeetingsForRecording(db, args.recordingId);
           await queueBrainExport(args.recordingId);
           await clearBuilderCreditsExhausted();
 

package/corpus/templates/clips/actions/save-browser-transcript.ts

@@ -24,6 +24,7 @@ import { dispatchPostFinalizeJob } from "../server/lib/post-finalize-dispatch.js
 import { getCurrentOwnerEmail } from "../server/lib/recordings.js";
 import { buildCaptionSegmentsFromText } from "../shared/transcript-segments.js";
 import { booleanParam } from "./lib/cli-params.js";
+import { finalizeEndedMeetingsForRecording } from "./lib/finalize-ended-meetings.js";
 import { isAutoTitleReplaceable } from "./lib/title-source.js";
 
 // web-speech and macos-native are both mic-only engines — see
@@ -226,6 +227,9 @@ export default defineAction({
     );
 
     await writeAppState("refresh-signal", { ts: Date.now() });
+    if (savedStatus === "ready") {
+      await finalizeEndedMeetingsForRecording(db, args.recordingId);
+    }
 
     const [rec] = await db
       .select({