@elizaos/ui 2.0.0-alpha.21 → 2.0.0-alpha.210

package/apps/app-lifeops/src/actions/calendar.js

@@ -0,0 +1,3026 @@
+import { ModelType, parseJSONObjectFromText, parseKeyValueXml, } from "@elizaos/core";
+import { resolveDefaultTimeZone } from "../lifeops/defaults.js";
+import { LifeOpsService, LifeOpsServiceError } from "../lifeops/service.js";
+import { addDaysToLocalDate, buildUtcDateFromLocalParts, getWeekdayForLocalDate, getZonedDateParts, } from "../lifeops/time.js";
+import { renderGroundedActionReply } from "@elizaos/agent/actions/grounded-action-reply";
+import { recentConversationTexts as collectRecentConversationTexts } from "./life-recent-context.js";
+import { calendarReadUnavailableMessage, calendarWriteUnavailableMessage, detailArray, detailBoolean, detailNumber, detailString, formatCalendarEventDateTime, formatCalendarFeed, formatNextEventContext, getGoogleCapabilityStatus, hasLifeOpsAccess, INTERNAL_URL, messageText, toActionData, } from "./lifeops-google-helpers.js";
+import { looksLikeCalendarObservation } from "./non-actionable-request.js";
+const CALENDAR_SUBACTION_VALUES = [
+    "feed",
+    "next_event",
+    "search_events",
+    "create_event",
+    "update_event",
+    "delete_event",
+    "trip_window",
+];
+const MIN_CREATE_EVENT_DURATION_MINUTES = 15;
+const PARAMETER_DOC_NOISE_PATTERN = /\b(?:actions?|params?|parameters?|query\?:string|subaction\?:string|details\?:object|required parameter|supported keys include|may include:|match against titles|structured calendar arguments|structured data when needed|boolean when)\b|\b\w+\?:\w+\b/i;
+const I18N_LOCALES = ["en", "zh-CN", "ko", "es", "pt", "vi", "tl"];
+function buildIntlMonthMap() {
+    const map = {};
+    for (const locale of I18N_LOCALES) {
+        for (let month = 0; month < 12; month++) {
+            const date = new Date(2024, month, 15);
+            for (const style of ["long", "short"]) {
+                const name = new Intl.DateTimeFormat(locale, { month: style })
+                    .format(date)
+                    .toLowerCase()
+                    .replace(/\.$/, "");
+                if (name.length > 0)
+                    map[name] = month + 1;
+            }
+        }
+    }
+    return map;
+}
+function buildIntlWeekdayMap() {
+    const map = {};
+    for (const locale of I18N_LOCALES) {
+        for (let dow = 0; dow < 7; dow++) {
+            const date = new Date(2024, 0, 7 + dow);
+            for (const style of ["long", "short"]) {
+                const name = new Intl.DateTimeFormat(locale, { weekday: style })
+                    .format(date)
+                    .toLowerCase()
+                    .replace(/\.$/, "");
+                if (name.length > 0)
+                    map[name] = dow;
+            }
+        }
+    }
+    return map;
+}
+const MONTH_MAP = buildIntlMonthMap();
+const WEEKDAY_MAP = buildIntlWeekdayMap();
+const MONTH_NAMES_SORTED = Object.keys(MONTH_MAP).sort((a, b) => b.length - a.length);
+const MONTH_NAME_PATTERN = new RegExp(`\\b(${MONTH_NAMES_SORTED.map((n) => n.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("|")})\\.?\\s+(\\d{1,2})(?:st|nd|rd|th)?(?:,?\\s+(\\d{4}))?\\b`, "i");
+const WEEKDAY_NAMES_SORTED = Object.keys(WEEKDAY_MAP).sort((a, b) => b.length - a.length);
+const WEEKDAY_NAME_PATTERN = new RegExp(`\\b(?:(this|next)\\s+)?(${WEEKDAY_NAMES_SORTED.map((n) => n.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("|")})\\b`, "i");
+const CALENDAR_DETAIL_ALIASES = {
+    calendarId: ["calendarid", "calendar_id"],
+    timeMin: ["timemin", "time_min"],
+    timeMax: ["timemax", "time_max"],
+    timeZone: ["timezone", "time_zone"],
+    forceSync: ["forcesync", "force_sync"],
+    windowDays: ["windowdays", "window_days"],
+    startAt: ["startat", "start_at"],
+    endAt: ["endat", "end_at"],
+    durationMinutes: ["durationminutes", "duration_minutes"],
+    windowPreset: ["windowpreset", "window_preset"],
+    eventId: [
+        "eventid",
+        "event_id",
+        "externaleventid",
+        "external_event_id",
+        "googleeventid",
+        "google_event_id",
+    ],
+    newTitle: ["newtitle", "new_title", "renameto", "rename_to"],
+    description: ["desc", "summary", "body"],
+    location: ["place", "venue"],
+};
+function normalizeCalendarSubaction(value) {
+    if (typeof value !== "string") {
+        return null;
+    }
+    const normalized = value.trim().toLowerCase();
+    switch (normalized) {
+        case "feed":
+        case "next_event":
+        case "search_events":
+        case "create_event":
+        case "update_event":
+        case "delete_event":
+        case "trip_window":
+            return normalized;
+        default:
+            return null;
+    }
+}
+function buildCalendarPlanFromParsed(parsed) {
+    const subaction = normalizeCalendarSubaction(parsed.subaction);
+    const shouldAct = normalizeShouldAct(parsed.shouldAct) ?? (subaction ? true : null);
+    if (shouldAct === null) {
+        return null;
+    }
+    if (shouldAct && subaction === null) {
+        return null;
+    }
+    const tripLocation = typeof parsed.tripLocation === "string" &&
+        parsed.tripLocation.trim().length > 0
+        ? parsed.tripLocation.trim()
+        : undefined;
+    const rawQueries = [];
+    if (typeof parsed.queries === "string" && parsed.queries.trim().length > 0) {
+        for (const q of parsed.queries.split(/\s*\|\|\s*/)) {
+            if (q.trim().length > 0)
+                rawQueries.push(q.trim());
+        }
+    }
+    else if (Array.isArray(parsed.queries)) {
+        for (const value of parsed.queries) {
+            if (typeof value === "string")
+                rawQueries.push(value);
+        }
+    }
+    if (typeof parsed.query === "string")
+        rawQueries.push(parsed.query);
+    if (typeof parsed.query1 === "string")
+        rawQueries.push(parsed.query1);
+    if (typeof parsed.query2 === "string")
+        rawQueries.push(parsed.query2);
+    if (typeof parsed.query3 === "string")
+        rawQueries.push(parsed.query3);
+    if (tripLocation)
+        rawQueries.push(tripLocation);
+    return {
+        subaction,
+        queries: dedupeCalendarQueries(rawQueries),
+        response: normalizePlannerResponse(parsed.response),
+        shouldAct,
+        title: typeof parsed.title === "string" && parsed.title.trim().length > 0
+            ? parsed.title.trim()
+            : undefined,
+        tripLocation,
+        timeMin: normalizeIsoDateTime(parsed.timeMin),
+        timeMax: normalizeIsoDateTime(parsed.timeMax),
+        windowLabel: normalizeWindowLabel(parsed.windowLabel ?? parsed.label),
+    };
+}
+function buildCalendarPlanRepairPrompt(args) {
+    return [
+        "Your last reply for the calendar planner was invalid or used the wrong schema.",
+        "Return ONLY valid JSON with exactly these fields:",
+        "  subaction: one of the allowed subactions below, or null when this should be reply-only/no-op",
+        "  shouldAct: boolean",
+        "  response: short natural-language reply when shouldAct is false, otherwise empty or null",
+        "  queries: array or ||-delimited string of up to 3 search queries",
+        "  title: optional event title",
+        "  tripLocation: optional trip location",
+        "  timeMin: optional ISO 8601 datetime",
+        "  timeMax: optional ISO 8601 datetime",
+        "  windowLabel: optional natural-language window label",
+        "",
+        "Use ONLY these exact subaction literals:",
+        `  ${CALENDAR_SUBACTION_VALUES.join(", ")}, or null`,
+        "Never invent synonyms such as edit_event, modify_event, reschedule_event, move_event, cancel_event, remove_event, agenda, or itinerary_window.",
+        "Map rename/reschedule/move/edit requests for an existing event to update_event.",
+        "Map delete/remove/cancel requests for an existing event to delete_event.",
+        "The user may speak in any language.",
+        "",
+        `Current timezone: ${args.timeZone}`,
+        `Current local datetime: ${args.localNow}`,
+        `Current ISO datetime: ${args.nowIso}`,
+        `Current request: ${JSON.stringify(args.currentMessage)}`,
+        `Resolved intent: ${JSON.stringify(args.intent)}`,
+        `Recent conversation: ${JSON.stringify(args.recentConversation)}`,
+        `Previous invalid output: ${JSON.stringify(args.rawResponse)}`,
+    ].join("\n");
+}
+function normalizeShouldAct(value) {
+    if (typeof value === "boolean") {
+        return value;
+    }
+    if (typeof value === "string") {
+        const normalized = value.trim().toLowerCase();
+        if (normalized === "true") {
+            return true;
+        }
+        if (normalized === "false") {
+            return false;
+        }
+    }
+    return null;
+}
+function normalizePlannerResponse(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function buildCalendarReplyOnlyFallback(subaction) {
+    switch (subaction) {
+        case "create_event":
+            return "What event do you want to add, and when should it happen?";
+        case "search_events":
+        case "trip_window":
+            return "What calendar event or trip do you want me to look up?";
+        case "next_event":
+        case "feed":
+            return "Do you want today's schedule, your next event, or a specific event?";
+        case "update_event":
+            return "Which calendar event do you want to change, and what should change?";
+        case "delete_event":
+            return "Which calendar event do you want to delete?";
+        default:
+            return "What do you want to do on your calendar — check your schedule, find an event, or create one?";
+    }
+}
+function normalizeCalendarReadSubaction(value) {
+    if (value === "feed" ||
+        value === "next_event" ||
+        value === "search_events" ||
+        value === "trip_window") {
+        return value;
+    }
+    return null;
+}
+function normalizeCalendarLookupReadSubaction(value) {
+    if (value === "next_event" || value === "search_events") {
+        return value;
+    }
+    return null;
+}
+function normalizeCalendarMutationSubaction(value) {
+    if (value === "create_event" ||
+        value === "update_event" ||
+        value === "delete_event") {
+        return value;
+    }
+    return null;
+}
+function normalizeCalendarReadResolution(parsed) {
+    if (!parsed) {
+        return null;
+    }
+    const subaction = normalizeCalendarReadSubaction(parsed.subaction);
+    const tripLocation = typeof parsed.tripLocation === "string" &&
+        parsed.tripLocation.trim().length > 0
+        ? parsed.tripLocation.trim()
+        : undefined;
+    return { subaction, tripLocation };
+}
+function shouldDisambiguateCalendarReadPlan(plan) {
+    if (plan === null) {
+        return true;
+    }
+    return (plan.subaction === null ||
+        plan.subaction === "feed" ||
+        plan.subaction === "next_event" ||
+        plan.subaction === "search_events");
+}
+async function disambiguateCalendarReadPlanWithLlm(args) {
+    const prompt = [
+        "Resolve this calendar read intent.",
+        "The user may speak in any language.",
+        "Choose exactly one subaction: feed, next_event, search_events, trip_window, or null.",
+        "feed means a schedule or agenda view over today, tomorrow, this week, or another time window.",
+        "next_event means only the single next upcoming meeting or appointment.",
+        "search_events means find calendar events by title, attendee, location, date, or keyword, including flights and appointments.",
+        "trip_window means show what is happening while the user is in a place or during a trip/stay in that place.",
+        "Use null only when the request is not asking for a calendar read lookup.",
+        "If you choose trip_window, also return tripLocation when the place is recoverable from the request or recent conversation.",
+        "",
+        "Examples:",
+        '  "What\'s on my calendar today?" -> {"subaction":"feed"}',
+        '  "今日の予定は何ですか？" -> {"subaction":"feed"}',
+        '  "What\'s my next meeting?" -> {"subaction":"next_event"}',
+        '  "¿Cuál es mi próxima reunión?" -> {"subaction":"next_event"}',
+        '  "find my return flight" -> {"subaction":"search_events"}',
+        '  "東京にいる間、何がありますか？" -> {"subaction":"trip_window","tripLocation":"東京"}',
+        '  "Can you help me with my calendar?" -> {"subaction":null}',
+        "",
+        "Return ONLY valid JSON with exactly these fields:",
+        "  subaction: feed, next_event, search_events, trip_window, or null",
+        "  tripLocation: optional string",
+        "",
+        `Current request: ${JSON.stringify(args.currentMessage)}`,
+        `Resolved intent: ${JSON.stringify(args.intent)}`,
+        `Recent conversation: ${JSON.stringify(args.recentConversation)}`,
+        `Current planner candidate: ${JSON.stringify(args.candidateSubaction)}`,
+    ].join("\n");
+    try {
+        const result = await args.runtime.useModel(ModelType.TEXT_LARGE, {
+            prompt,
+        });
+        const raw = typeof result === "string" ? result : "";
+        const parsed = parseKeyValueXml(raw) ??
+            parseJSONObjectFromText(raw);
+        return normalizeCalendarReadResolution(parsed);
+    }
+    catch (error) {
+        args.runtime.logger?.warn?.({
+            src: "action:calendar",
+            error: error instanceof Error ? error.message : String(error),
+        }, "Calendar read disambiguation model call failed");
+        return null;
+    }
+}
+async function resolveCalendarLookupBoundaryWithLlm(args) {
+    const prompt = [
+        "Resolve this calendar lookup intent.",
+        "The user may speak in any language.",
+        "Choose exactly one subaction: next_event or search_events.",
+        "next_event means the user wants only the single nearest upcoming meeting, appointment, or event.",
+        "search_events means the user wants to find matching calendar events by title, attendee, place, trip, keyword, or date.",
+        "If the request asks for the next upcoming meeting or appointment, prefer next_event even when the noun could also be searched.",
+        "If the request is about flights, dentists, people, trip plans, named events, or general event lookup, choose search_events.",
+        "",
+        "Examples:",
+        '  "What\'s my next meeting?" -> {"subaction":"next_event"}',
+        '  "When is my next appointment?" -> {"subaction":"next_event"}',
+        '  "次のミーティングはいつですか？" -> {"subaction":"next_event"}',
+        '  "¿Cuál es mi próxima reunión?" -> {"subaction":"next_event"}',
+        '  "find my return flight" -> {"subaction":"search_events"}',
+        '  "when is the dentist" -> {"subaction":"search_events"}',
+        '  "帰りの便を探して" -> {"subaction":"search_events"}',
+        "",
+        "Return ONLY valid JSON with exactly this field:",
+        "  subaction: next_event or search_events",
+        "",
+        `Current request: ${JSON.stringify(args.currentMessage)}`,
+        `Resolved intent: ${JSON.stringify(args.intent)}`,
+        `Recent conversation: ${JSON.stringify(args.recentConversation)}`,
+        `Current candidate: ${JSON.stringify(args.candidateSubaction)}`,
+    ].join("\n");
+    try {
+        const result = await args.runtime.useModel(ModelType.TEXT_LARGE, {
+            prompt,
+        });
+        const raw = typeof result === "string" ? result : "";
+        const parsed = parseKeyValueXml(raw) ??
+            parseJSONObjectFromText(raw);
+        return normalizeCalendarLookupReadSubaction(parsed?.subaction);
+    }
+    catch (error) {
+        args.runtime.logger?.warn?.({
+            src: "action:calendar",
+            error: error instanceof Error ? error.message : String(error),
+        }, "Calendar lookup boundary model call failed");
+        return null;
+    }
+}
+async function resolveCalendarMutationBoundaryWithLlm(args) {
+    const prompt = [
+        "Resolve whether this calendar request is a mutation.",
+        "The user may speak in any language.",
+        "Choose exactly one subaction: create_event, update_event, delete_event, or null.",
+        "create_event means schedule, add, book, or put a new event on the calendar.",
+        "update_event means rename, reschedule, move, or otherwise edit an existing event.",
+        "delete_event means delete, cancel, remove, or clear an existing event.",
+        "Use null when the request is only reading the calendar, searching events, discussing plans, or asking for general help.",
+        "Prefer create_event when the user gives a time/date and asks to add or schedule a meeting or appointment, regardless of language.",
+        "",
+        "Examples:",
+        '  "Schedule a meeting with Alex at 3pm tomorrow" -> {"subaction":"create_event"}',
+        '  "Agenda una reunión con Alex mañana a las 3pm" -> {"subaction":"create_event"}',
+        '  "明日の午後3時にアレックスとのミーティングを入れて" -> {"subaction":"create_event"}',
+        '  "Reschedule the dentist to Friday" -> {"subaction":"update_event"}',
+        '  "Cambia la cita del dentista al viernes" -> {"subaction":"update_event"}',
+        '  "Delete the team meeting tomorrow" -> {"subaction":"delete_event"}',
+        '  "今日の予定は何ですか？" -> {"subaction":null}',
+        "",
+        "Return ONLY valid JSON with exactly this field:",
+        "  subaction: create_event, update_event, delete_event, or null",
+        "",
+        `Current request: ${JSON.stringify(args.currentMessage)}`,
+        `Resolved intent: ${JSON.stringify(args.intent)}`,
+        `Recent conversation: ${JSON.stringify(args.recentConversation)}`,
+        `Current candidate: ${JSON.stringify(args.candidateSubaction)}`,
+    ].join("\n");
+    try {
+        const result = await args.runtime.useModel(ModelType.TEXT_LARGE, {
+            prompt,
+        });
+        const raw = typeof result === "string" ? result : "";
+        const parsed = parseKeyValueXml(raw) ??
+            parseJSONObjectFromText(raw);
+        return normalizeCalendarMutationSubaction(parsed?.subaction);
+    }
+    catch (error) {
+        args.runtime.logger?.warn?.({
+            src: "action:calendar",
+            error: error instanceof Error ? error.message : String(error),
+        }, "Calendar mutation boundary model call failed");
+        return null;
+    }
+}
+async function finalizeCalendarPlan(args) {
+    const { runtime, currentMessage, intent, recentConversation, plan } = args;
+    if (plan?.subaction !== "create_event" &&
+        plan?.subaction !== "update_event" &&
+        plan?.subaction !== "delete_event") {
+        const mutationSubaction = await resolveCalendarMutationBoundaryWithLlm({
+            runtime,
+            currentMessage,
+            intent,
+            recentConversation,
+            candidateSubaction: plan?.subaction ?? null,
+        });
+        if (mutationSubaction) {
+            return {
+                ...(plan ?? {
+                    queries: [],
+                    shouldAct: null,
+                }),
+                subaction: mutationSubaction,
+                shouldAct: true,
+                response: undefined,
+            };
+        }
+    }
+    if (!shouldDisambiguateCalendarReadPlan(plan)) {
+        return (plan ?? {
+            subaction: null,
+            queries: [],
+            shouldAct: null,
+        });
+    }
+    const resolvedReadPlan = await disambiguateCalendarReadPlanWithLlm({
+        runtime,
+        currentMessage,
+        intent,
+        recentConversation,
+        candidateSubaction: plan?.subaction ?? null,
+    });
+    if (resolvedReadPlan === null || resolvedReadPlan.subaction === null) {
+        return (plan ?? {
+            subaction: null,
+            queries: [],
+            shouldAct: null,
+        });
+    }
+    let finalReadSubaction = resolvedReadPlan.subaction;
+    if (finalReadSubaction === "next_event" ||
+        finalReadSubaction === "search_events") {
+        const boundarySubaction = await resolveCalendarLookupBoundaryWithLlm({
+            runtime,
+            currentMessage,
+            intent,
+            recentConversation,
+            candidateSubaction: finalReadSubaction,
+        });
+        if (boundarySubaction) {
+            finalReadSubaction = boundarySubaction;
+        }
+    }
+    if (plan) {
+        return {
+            ...plan,
+            subaction: finalReadSubaction,
+            tripLocation: resolvedReadPlan.tripLocation ?? plan.tripLocation,
+            queries: dedupeCalendarQueries([
+                ...plan.queries,
+                resolvedReadPlan.tripLocation,
+            ]),
+            shouldAct: true,
+            response: undefined,
+        };
+    }
+    return {
+        subaction: finalReadSubaction,
+        queries: dedupeCalendarQueries([resolvedReadPlan.tripLocation]),
+        shouldAct: true,
+        tripLocation: resolvedReadPlan.tripLocation,
+    };
+}
+function buildCalendarServiceErrorFallback(error, intent) {
+    const normalized = normalizeText(error.message);
+    if (normalized.includes("utc 'z' suffix") ||
+        normalized.includes("local datetime without 'z'")) {
+        return `I couldn't pin down the event time from "${intent}". Tell me the date and time again in plain language, like "Friday at 8 pm Pacific."`;
+    }
+    if (normalized.includes("startat is required") ||
+        normalized.includes("windowpreset is not provided")) {
+        return "I still need the time for that event. Tell me when it should happen.";
+    }
+    if (normalized.includes("endat must be later than startat")) {
+        return "That end time lands before the start. Give me the date and time again and I'll fix it.";
+    }
+    if (error.status === 429 || normalized.includes("rate limit")) {
+        return "Calendar is rate-limited right now. Try again in a bit.";
+    }
+    return "I couldn't finish that calendar change yet. Tell me the event and timing again, and I'll try it a different way.";
+}
+function buildCalendarEventDisambiguationFallback(args) {
+    const previewLines = args.candidates.slice(0, 3).map((candidate) => {
+        const when = formatCalendarEventDateTime(candidate, {
+            includeTimeZoneName: true,
+        });
+        return `- ${candidate.title} (${when})`;
+    });
+    const intro = args.titleHint
+        ? `I found multiple events matching "${args.titleHint}".`
+        : "I found multiple matching calendar events.";
+    const suffix = args.candidates.length > 3
+        ? ` There are ${args.candidates.length} matches total.`
+        : "";
+    return [
+        intro,
+        ...previewLines,
+        `Tell me which one to ${args.action} by giving the title and date/time.${suffix}`,
+    ].join("\n");
+}
+async function renderCalendarActionReply(args) {
+    const { runtime, message, state, intent, scenario, fallback, context } = args;
+    return renderGroundedActionReply({
+        runtime,
+        message,
+        state,
+        intent,
+        domain: "calendar",
+        scenario,
+        fallback,
+        context,
+        preferCharacterVoice: true,
+        additionalRules: [
+            "Mirror the user's phrasing for dates, times, ranges, and scheduling language when possible.",
+            "Prefer phrases like tomorrow morning, next week, later, earlier, free, busy, or the user's own wording over robotic calendar language.",
+            "Never surface raw ISO timestamps unless the user used raw ISO timestamps.",
+            "Preserve all concrete event facts from the context and canonical fallback.",
+            "If this is reply-only or a clarification, do not pretend you already changed the calendar.",
+        ],
+    });
+}
+function normalizeText(value) {
+    return value.trim().toLowerCase().replace(/\s+/g, " ");
+}
+function normalizeLookupKey(value) {
+    return value.toLowerCase().replace(/[^a-z0-9]/g, "");
+}
+function wordCount(value) {
+    const normalized = normalizeText(value);
+    if (!normalized) {
+        return 0;
+    }
+    return normalized.split(" ").filter(Boolean).length;
+}
+function tokenize(value) {
+    return normalizeText(value)
+        .split(" ")
+        .filter((token) => token.length >= 2);
+}
+function tokenVariants(token) {
+    const normalized = token.trim().toLowerCase();
+    if (!normalized) {
+        return [];
+    }
+    const variants = new Set([normalized]);
+    if (normalized.endsWith("ies") && normalized.length > 3) {
+        variants.add(`${normalized.slice(0, -3)}y`);
+    }
+    if (normalized.endsWith("es") && normalized.length > 4) {
+        variants.add(normalized.slice(0, -2));
+    }
+    if (normalized.endsWith("s") &&
+        !normalized.endsWith("ss") &&
+        normalized.length > 3) {
+        variants.add(normalized.slice(0, -1));
+    }
+    return [...variants];
+}
+function tokenizeForSearch(value) {
+    return [...new Set(tokenize(value).flatMap((token) => tokenVariants(token)))];
+}
+function normalizeCalendarSearchQueryValue(value) {
+    if (!value) {
+        return undefined;
+    }
+    if (PARAMETER_DOC_NOISE_PATTERN.test(value)) {
+        return undefined;
+    }
+    const cleaned = normalizeText(value)
+        .replace(/\b(?:actions?|params?|parameters?)\b[:;]*/g, "")
+        .replace(/\b\w+\?:\w+(?:\s+\[[^\]]+\])?\s*-\s*/g, " ")
+        .replace(/\bsupported keys include\b.*$/g, "")
+        .replace(/\bmatch against titles\b.*$/g, "")
+        .replace(/\bstructured calendar arguments\b.*$/g, "")
+        .replace(/[;:,]+/g, " ")
+        .replace(/^[^a-z0-9]+|[^a-z0-9]+$/g, "")
+        .trim();
+    if (!cleaned ||
+        ["calendar", "schedule", "event", "events"].includes(cleaned) ||
+        cleaned.length > 160 ||
+        PARAMETER_DOC_NOISE_PATTERN.test(cleaned)) {
+        return undefined;
+    }
+    return cleaned;
+}
+function dedupeCalendarQueries(queries) {
+    const normalized = queries
+        .map((query) => normalizeCalendarSearchQueryValue(query))
+        .filter((query) => Boolean(query));
+    return [...new Set(normalized)];
+}
+function normalizeCalendarDetails(details) {
+    if (!details) {
+        return undefined;
+    }
+    const normalized = { ...details };
+    const aliasMap = new Map();
+    for (const [canonical, aliases] of Object.entries(CALENDAR_DETAIL_ALIASES)) {
+        aliasMap.set(normalizeLookupKey(canonical), canonical);
+        for (const alias of aliases) {
+            aliasMap.set(normalizeLookupKey(alias), canonical);
+        }
+    }
+    for (const [key, value] of Object.entries(details)) {
+        const canonical = aliasMap.get(normalizeLookupKey(key));
+        if (!canonical) {
+            continue;
+        }
+        if (normalized[canonical] === undefined) {
+            normalized[canonical] = value;
+        }
+    }
+    return normalized;
+}
+function parseStateLine(line) {
+    const trimmed = line.trim();
+    const timestampedMatch = trimmed.match(/^\d{1,2}:\d{2}\s+\([^)]+\)\s+\[[^\]]+\]\s+(\S+)\s*:\s*(.*)/);
+    if (timestampedMatch) {
+        const role = timestampedMatch[1];
+        const text = timestampedMatch[2];
+        if (!role || text === undefined) {
+            return { role: "", text: trimmed };
+        }
+        return {
+            role: role.toLowerCase(),
+            text: text.trim(),
+        };
+    }
+    const simpleMatch = trimmed.match(/^(user|assistant|system|owner|admin|\S+)\s*:\s*(.*)/i);
+    if (simpleMatch) {
+        const role = simpleMatch[1];
+        const text = simpleMatch[2];
+        if (!role || text === undefined) {
+            return { role: "", text: trimmed };
+        }
+        return {
+            role: role.toLowerCase(),
+            text: text.trim(),
+        };
+    }
+    return { role: "", text: trimmed };
+}
+function planningConversationLines(state) {
+    if (!state || typeof state !== "object") {
+        return [];
+    }
+    const stateRecord = state;
+    const values = stateRecord.values && typeof stateRecord.values === "object"
+        ? stateRecord.values
+        : undefined;
+    const raw = typeof values?.recentMessages === "string"
+        ? values.recentMessages
+        : typeof stateRecord.text === "string"
+            ? stateRecord.text
+            : "";
+    if (!raw) {
+        return [];
+    }
+    return raw
+        .split(/\n+/)
+        .map((line) => parseStateLine(line))
+        .filter((line) => line.role.length > 0 && line.text.length > 0)
+        .map((line) => `${line.role}: ${line.text}`);
+}
+function resolveCalendarIntentInput(paramsIntent, message) {
+    return paramsIntent?.trim() || messageText(message).trim();
+}
+function resolveStructuredCalendarSubaction(params, details) {
+    if (detailString(details, "eventId")) {
+        if (detailString(details, "newTitle") ||
+            detailString(details, "title") ||
+            detailString(details, "startAt") ||
+            detailString(details, "endAt") ||
+            detailString(details, "description") ||
+            detailString(details, "location")) {
+            return "update_event";
+        }
+        return "delete_event";
+    }
+    if (detailString(details, "startAt") ||
+        detailString(details, "endAt") ||
+        detailString(details, "windowPreset") ||
+        detailNumber(details, "durationMinutes") ||
+        params.title ||
+        detailString(details, "title")) {
+        return "create_event";
+    }
+    if (params.query ||
+        detailString(details, "query") ||
+        (params.queries?.length ?? 0) > 0 ||
+        (detailArray(details, "queries")?.length ?? 0) > 0 ||
+        detailString(details, "timeMin") ||
+        detailString(details, "timeMax")) {
+        return "search_events";
+    }
+    return null;
+}
+function parseExplicitLocalDate(value, timeZone) {
+    const normalized = normalizeText(value);
+    const localToday = getZonedDateParts(new Date(), timeZone);
+    const isoMatch = normalized.match(/\b(\d{4})-(\d{1,2})-(\d{1,2})\b/);
+    if (isoMatch) {
+        return {
+            year: Number(isoMatch[1]),
+            month: Number(isoMatch[2]),
+            day: Number(isoMatch[3]),
+        };
+    }
+    const monthNameMatch = normalized.match(MONTH_NAME_PATTERN);
+    if (monthNameMatch) {
+        const monthName = monthNameMatch[1];
+        if (!monthName) {
+            return null;
+        }
+        const month = MONTH_MAP[normalizeLookupKey(monthName)];
+        if (month === undefined) {
+            return null;
+        }
+        return {
+            year: monthNameMatch[3] ? Number(monthNameMatch[3]) : localToday.year,
+            month,
+            day: Number(monthNameMatch[2]),
+        };
+    }
+    const numericMatch = normalized.match(/\b(\d{1,2})[/-](\d{1,2})(?:[/-](\d{2,4}))?\b/);
+    if (numericMatch) {
+        const yearRaw = numericMatch[3];
+        const parsedYear = yearRaw === undefined
+            ? localToday.year
+            : yearRaw.length === 2
+                ? 2000 + Number(yearRaw)
+                : Number(yearRaw);
+        return {
+            year: parsedYear,
+            month: Number(numericMatch[1]),
+            day: Number(numericMatch[2]),
+        };
+    }
+    const weekdayMatch = normalized.match(WEEKDAY_NAME_PATTERN);
+    if (weekdayMatch) {
+        const qualifier = normalizeLookupKey(weekdayMatch[1] ?? "");
+        const weekdayKey = normalizeLookupKey(weekdayMatch[2] ?? "");
+        const targetWeekday = WEEKDAY_MAP[weekdayKey];
+        if (targetWeekday !== undefined) {
+            const currentWeekday = new Date(Date.UTC(localToday.year, Math.max(0, localToday.month - 1), localToday.day, 12, 0, 0)).getUTCDay();
+            let delta = (targetWeekday - currentWeekday + 7) % 7;
+            if (qualifier === "next") {
+                delta = delta === 0 ? 7 : delta + 7;
+            }
+            return addDaysToLocalDate({
+                year: localToday.year,
+                month: localToday.month,
+                day: localToday.day,
+            }, delta);
+        }
+    }
+    return null;
+}
+function resolveCalendarTimeZone(details) {
+    return detailString(details, "timeZone") ?? resolveDefaultTimeZone();
+}
+function getLocalTodayDate(timeZone) {
+    const localNow = getZonedDateParts(new Date(), timeZone);
+    return {
+        year: localNow.year,
+        month: localNow.month,
+        day: localNow.day,
+    };
+}
+function buildLocalDateRange(timeZone, startDate, endDateExclusive, options) {
+    return {
+        timeMin: buildUtcDateFromLocalParts(timeZone, {
+            year: startDate.year,
+            month: startDate.month,
+            day: startDate.day,
+            hour: options?.startHour ?? 0,
+            minute: options?.startMinute ?? 0,
+            second: 0,
+        }).toISOString(),
+        timeMax: buildUtcDateFromLocalParts(timeZone, {
+            year: endDateExclusive.year,
+            month: endDateExclusive.month,
+            day: endDateExclusive.day,
+            hour: options?.endHour ?? 0,
+            minute: options?.endMinute ?? 0,
+            second: 0,
+        }).toISOString(),
+    };
+}
+function buildLocalDayRange(timeZone, startOffsetDays, endOffsetDaysExclusive) {
+    const localToday = getLocalTodayDate(timeZone);
+    return buildLocalDateRange(timeZone, addDaysToLocalDate(localToday, startOffsetDays), addDaysToLocalDate(localToday, endOffsetDaysExclusive));
+}
+function formatExplicitCalendarDateLabel(args) {
+    return new Intl.DateTimeFormat("en-US", {
+        timeZone: args.timeZone,
+        month: "long",
+        day: "numeric",
+        year: "numeric",
+    }).format(buildUtcDateFromLocalParts(args.timeZone, {
+        year: args.date.year,
+        month: args.date.month,
+        day: args.date.day,
+        hour: 12,
+        minute: 0,
+        second: 0,
+    }));
+}
+function resolveExplicitCalendarDateWindow(intent, timeZone) {
+    const explicitDate = parseExplicitLocalDate(intent, timeZone);
+    if (!explicitDate) {
+        return null;
+    }
+    return {
+        ...buildLocalDateRange(timeZone, explicitDate, addDaysToLocalDate(explicitDate, 1)),
+        label: `on ${formatExplicitCalendarDateLabel({
+            date: explicitDate,
+            timeZone,
+        })}`,
+    };
+}
+function compareLocalDates(left, right) {
+    if (left.year !== right.year) {
+        return left.year - right.year;
+    }
+    if (left.month !== right.month) {
+        return left.month - right.month;
+    }
+    return left.day - right.day;
+}
+function resolveCreateEventCalendarTimeZone(details, feed, fallbackTimeZone) {
+    const explicitTimeZone = detailString(details, "timeZone");
+    if (explicitTimeZone) {
+        return explicitTimeZone;
+    }
+    const counts = new Map();
+    for (const event of feed?.events ?? []) {
+        const eventTimeZone = typeof event.timezone === "string" ? event.timezone.trim() : "";
+        if (!eventTimeZone) {
+            continue;
+        }
+        counts.set(eventTimeZone, (counts.get(eventTimeZone) ?? 0) + 1);
+    }
+    let winner = fallbackTimeZone;
+    let winnerCount = 0;
+    for (const [timeZone, count] of counts.entries()) {
+        if (count > winnerCount) {
+            winner = timeZone;
+            winnerCount = count;
+        }
+    }
+    return winner;
+}
+function formatCreateEventCalendarContext(context) {
+    if (!context) {
+        return "(calendar context unavailable)";
+    }
+    const lines = [
+        `Calendar timezone: ${context.calendarTimeZone}`,
+        `Context window: ${context.feed.timeMin} to ${context.feed.timeMax}`,
+    ];
+    if (context.feed.events.length === 0) {
+        lines.push("(no upcoming events in the next 2 weeks)");
+        return lines.join("\n");
+    }
+    const visibleEvents = context.feed.events.slice(0, 40);
+    for (const event of visibleEvents) {
+        const when = event.isAllDay
+            ? formatCalendarMoment(event)
+            : formatCalendarEventDateTime(event, {
+                includeTimeZoneName: true,
+                includeYear: true,
+            });
+        lines.push(`- ${when} — ${event.title}${event.location ? ` @ ${event.location}` : ""}`);
+    }
+    if (context.feed.events.length > visibleEvents.length) {
+        lines.push(`... ${context.feed.events.length - visibleEvents.length} more upcoming events omitted`);
+    }
+    return lines.join("\n");
+}
+// Fallback default duration when neither the user nor the LLM supplies one.
+// Specialization (personal vs work vs prep) is now handled by the LLM during
+// inferCreateEventDetails — never by English keyword regex.
+function resolveSuggestedCreateEventDurationMinutes() {
+    return 60;
+}
+function roundUpToStep(value, step) {
+    return Math.ceil(value / step) * step;
+}
+function overlapsBusyWindow(startMinute, durationMinutes, busyWindows) {
+    const endMinute = startMinute + durationMinutes;
+    return busyWindows.some((window) => startMinute < window.endMinute && endMinute > window.startMinute);
+}
+function busyWindowsForLocalDate(events, targetDate, timeZone) {
+    const windows = [];
+    for (const event of events) {
+        if (event.isAllDay) {
+            continue;
+        }
+        const start = getZonedDateParts(new Date(event.startAt), timeZone);
+        const end = getZonedDateParts(new Date(event.endAt), timeZone);
+        const startDate = { year: start.year, month: start.month, day: start.day };
+        const endDate = { year: end.year, month: end.month, day: end.day };
+        if (compareLocalDates(endDate, targetDate) < 0 ||
+            compareLocalDates(startDate, targetDate) > 0) {
+            continue;
+        }
+        const startMinute = compareLocalDates(startDate, targetDate) < 0
+            ? 0
+            : start.hour * 60 + start.minute;
+        const endMinute = compareLocalDates(endDate, targetDate) > 0
+            ? 24 * 60
+            : Math.max(startMinute + 1, end.hour * 60 + end.minute);
+        windows.push({ startMinute, endMinute });
+    }
+    return windows.sort((left, right) => left.startMinute - right.startMinute);
+}
+// Preferred slot ordering for tentative event scheduling. Locale-agnostic:
+// weekdays prefer mid-morning through evening, weekends prefer late morning
+// and afternoon. Specific category preferences (personal vs work) are now
+// supplied by the LLM via inferCreateEventDetails — not by English regex.
+function resolvePreferredCreateEventMinutes(targetDate) {
+    const weekday = getWeekdayForLocalDate(targetDate);
+    return weekday === 0 || weekday === 6
+        ? [10 * 60, 13 * 60, 18 * 60]
+        : [9 * 60, 11 * 60, 14 * 60, 16 * 60, 19 * 60];
+}
+function chooseSuggestedCreateEventMinute(args) {
+    for (const minute of args.preferredMinutes) {
+        if (!overlapsBusyWindow(minute, args.durationMinutes, args.busyWindows)) {
+            return minute;
+        }
+    }
+    const latestEnd = Math.max(0, ...args.busyWindows.map((window) => window.endMinute));
+    const afterLastEvent = roundUpToStep(latestEnd + 15, 15);
+    if (afterLastEvent + args.durationMinutes <= 22 * 60 &&
+        !overlapsBusyWindow(afterLastEvent, args.durationMinutes, args.busyWindows)) {
+        return afterLastEvent;
+    }
+    for (let minute = 8 * 60; minute <= 21 * 60; minute += 30) {
+        if (!overlapsBusyWindow(minute, args.durationMinutes, args.busyWindows)) {
+            return minute;
+        }
+    }
+    return null;
+}
+function suggestCreateEventStartAt(args) {
+    if (!args.calendarContext) {
+        return null;
+    }
+    const targetDate = parseExplicitLocalDate(args.currentMessage, args.calendarContext.calendarTimeZone) ??
+        parseExplicitLocalDate(args.intent, args.calendarContext.calendarTimeZone);
+    if (!targetDate) {
+        return null;
+    }
+    const durationMinutes = resolveSuggestedCreateEventDurationMinutes();
+    const busyWindows = busyWindowsForLocalDate(args.calendarContext.feed.events, targetDate, args.calendarContext.calendarTimeZone);
+    const startMinute = chooseSuggestedCreateEventMinute({
+        busyWindows,
+        preferredMinutes: resolvePreferredCreateEventMinutes(targetDate),
+        durationMinutes,
+    });
+    if (startMinute === null) {
+        return null;
+    }
+    return {
+        startAt: buildUtcDateFromLocalParts(args.calendarContext.calendarTimeZone, {
+            year: targetDate.year,
+            month: targetDate.month,
+            day: targetDate.day,
+            hour: Math.floor(startMinute / 60),
+            minute: startMinute % 60,
+            second: 0,
+        }).toISOString(),
+        timeZone: args.calendarContext.calendarTimeZone,
+    };
+}
+async function loadCreateEventCalendarContext(service, details, hasCalendarRead) {
+    if (!hasCalendarRead) {
+        return null;
+    }
+    const requestTimeZone = resolveCalendarTimeZone(details);
+    const feed = await service.getCalendarFeed(INTERNAL_URL, {
+        mode: detailString(details, "mode"),
+        side: detailString(details, "side"),
+        grantId: detailString(details, "grantId"),
+        calendarId: detailString(details, "calendarId"),
+        timeZone: requestTimeZone,
+        forceSync: detailBoolean(details, "forceSync"),
+        ...buildLocalDayRange(requestTimeZone, 0, 14),
+    });
+    if (!feed || !Array.isArray(feed.events)) {
+        return null;
+    }
+    return {
+        calendarTimeZone: resolveCreateEventCalendarTimeZone(details, feed, requestTimeZone),
+        feed,
+    };
+}
+function normalizeIsoDateTime(value) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        return undefined;
+    }
+    const parsed = Date.parse(value.trim());
+    return Number.isFinite(parsed) ? new Date(parsed).toISOString() : undefined;
+}
+function normalizeWindowLabel(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const cleaned = value.trim();
+    return cleaned.length > 0 && cleaned.length <= 80 ? cleaned : undefined;
+}
+function resolveCalendarLlmWindow(llmPlan) {
+    const timeMin = normalizeIsoDateTime(llmPlan?.timeMin);
+    const timeMax = normalizeIsoDateTime(llmPlan?.timeMax);
+    if (!timeMin || !timeMax) {
+        return null;
+    }
+    const minMs = Date.parse(timeMin);
+    const maxMs = Date.parse(timeMax);
+    const spanMs = maxMs - minMs;
+    if (!Number.isFinite(spanMs) ||
+        spanMs <= 0 ||
+        spanMs > 370 * 24 * 60 * 60 * 1000) {
+        return null;
+    }
+    return {
+        timeMin,
+        timeMax,
+        label: normalizeWindowLabel(llmPlan?.windowLabel) ?? "for the requested window",
+    };
+}
+// Wide window used by update_event / delete_event lookups when the user
+// gave no time hint. Reaches 1 year back and 5 years forward — far enough
+// to find a future birthday or a recent past meeting without scanning the
+// entire account.
+function buildWideLookupRange(timeZone) {
+    return buildLocalDayRange(timeZone, -365, 365 * 5);
+}
+function resolveCalendarWindow(intent, details, forSearch, llmPlan) {
+    const timeMin = detailString(details, "timeMin");
+    const timeMax = detailString(details, "timeMax");
+    const calendarId = detailString(details, "calendarId");
+    const timeZone = resolveCalendarTimeZone(details);
+    const forceSync = detailBoolean(details, "forceSync");
+    if (timeMin || timeMax) {
+        return {
+            request: {
+                calendarId,
+                timeMin: timeMin ?? undefined,
+                timeMax: timeMax ?? undefined,
+                timeZone,
+                forceSync,
+            },
+            label: detailString(details, "label") ?? "for the requested window",
+            explicitWindow: true,
+        };
+    }
+    const llmWindow = resolveCalendarLlmWindow(llmPlan);
+    if (llmWindow) {
+        return {
+            request: {
+                calendarId,
+                timeZone,
+                forceSync,
+                timeMin: llmWindow.timeMin,
+                timeMax: llmWindow.timeMax,
+            },
+            label: llmWindow.label,
+            explicitWindow: true,
+        };
+    }
+    const explicitDateWindow = resolveExplicitCalendarDateWindow(intent, timeZone);
+    if (explicitDateWindow) {
+        return {
+            request: {
+                calendarId,
+                timeZone,
+                forceSync,
+                timeMin: explicitDateWindow.timeMin,
+                timeMax: explicitDateWindow.timeMax,
+            },
+            label: explicitDateWindow.label,
+            explicitWindow: true,
+        };
+    }
+    const windowDays = detailNumber(details, "windowDays");
+    if (forSearch) {
+        const days = windowDays && windowDays > 0 ? Math.min(windowDays, 90) : 30;
+        return {
+            request: {
+                calendarId,
+                timeZone,
+                forceSync,
+                ...buildLocalDayRange(timeZone, 0, days),
+            },
+            label: `across the next ${days} days`,
+            explicitWindow: false,
+        };
+    }
+    return {
+        request: {
+            calendarId,
+            timeZone,
+            forceSync,
+            ...buildLocalDayRange(timeZone, 0, 1),
+        },
+        label: "today",
+        explicitWindow: false,
+    };
+}
+function resolveTripWindowRequest(details, llmPlan) {
+    const timeMin = detailString(details, "timeMin");
+    const timeMax = detailString(details, "timeMax");
+    const calendarId = detailString(details, "calendarId");
+    const timeZone = resolveCalendarTimeZone(details);
+    const forceSync = detailBoolean(details, "forceSync");
+    if (timeMin || timeMax) {
+        return {
+            calendarId,
+            timeMin: timeMin ?? undefined,
+            timeMax: timeMax ?? undefined,
+            timeZone,
+            forceSync,
+        };
+    }
+    const llmWindow = resolveCalendarLlmWindow(llmPlan);
+    if (llmWindow) {
+        return {
+            calendarId,
+            timeZone,
+            forceSync,
+            timeMin: llmWindow.timeMin,
+            timeMax: llmWindow.timeMax,
+        };
+    }
+    const windowDays = detailNumber(details, "windowDays");
+    const days = windowDays && windowDays > 0 ? Math.min(windowDays, 120) : 60;
+    return {
+        calendarId,
+        timeZone,
+        forceSync,
+        ...buildLocalDayRange(timeZone, 0, days),
+    };
+}
+function eventDateSearchTerms(event) {
+    const formatter = (options) => new Intl.DateTimeFormat("en-US", {
+        timeZone: event.timezone || undefined,
+        ...options,
+    }).format(new Date(event.startAt));
+    const monthLong = normalizeText(formatter({ month: "long" }).replace(/\./g, ""));
+    const monthShort = normalizeText(formatter({ month: "short" }).replace(/\./g, ""));
+    const weekdayLong = normalizeText(formatter({ weekday: "long" }));
+    const weekdayShort = normalizeText(formatter({ weekday: "short" }));
+    const day = formatter({ day: "numeric" });
+    const dayPadded = day.padStart(2, "0");
+    const monthNumeric = formatter({ month: "numeric" });
+    const monthPadded = monthNumeric.padStart(2, "0");
+    const year = formatter({ year: "numeric" });
+    return new Set([
+        `${monthLong} ${day}`,
+        `${monthLong} ${day} ${year}`,
+        `${monthShort} ${day}`,
+        `${monthShort} ${day} ${year}`,
+        `${weekdayLong} ${monthLong} ${day}`,
+        `${weekdayShort} ${monthShort} ${day}`,
+        `${monthNumeric}/${day}`,
+        `${monthNumeric}/${dayPadded}`,
+        `${monthPadded}/${day}`,
+        `${monthPadded}/${dayPadded}`,
+        `${year}-${monthPadded}-${dayPadded}`,
+        weekdayLong,
+        weekdayShort,
+    ].map((term) => normalizeText(term)));
+}
+export async function extractCalendarPlanWithLlm(runtime, message, state, intent, timeZone = resolveDefaultTimeZone()) {
+    const recentConversation = formatCreateEventRecentConversation(state);
+    const currentMessage = messageText(message).trim();
+    const now = new Date();
+    const nowIso = now.toISOString();
+    const localNow = new Intl.DateTimeFormat("en-US", {
+        timeZone,
+        dateStyle: "full",
+        timeStyle: "long",
+    }).format(now);
+    const prompt = [
+        "Plan the calendar action for this request.",
+        "The user may speak in any language.",
+        "Use the current request plus recent conversation context.",
+        "If the current request is vague or a follow-up, recover the subject from recent conversation and apply the new constraint from the current request.",
+        "You are allowed to decide that the assistant should reply naturally without acting yet.",
+        "Set shouldAct=false when the user is vague, only acknowledging, brainstorming, or asking for calendar help without enough specifics to safely act.",
+        "When shouldAct=false, provide a short natural response that asks only for what is missing.",
+        "",
+        "Return a JSON object with exactly these fields:",
+        "  subaction: one of the allowed subactions below, or null when this should be reply-only/no-op",
+        "  shouldAct: boolean",
+        "  response: short natural-language reply when shouldAct is false, otherwise empty or null",
+        "  queries: array or ||-delimited string of up to 3 search queries",
+        "  title: optional event title",
+        "  tripLocation: optional trip location",
+        "  timeMin: optional ISO 8601 datetime",
+        "  timeMax: optional ISO 8601 datetime",
+        "  windowLabel: optional natural-language window label",
+        "",
+        "Subactions and when to use each:",
+        "  feed — view today's, tomorrow's, or this week's schedule (e.g. 'what's on my calendar', 'what do I have today', 'this week's agenda')",
+        "  next_event — check the next upcoming event only (e.g. 'what's my next meeting', 'when is my next appointment')",
+        "  search_events — find events by title, attendee, location, or date range (e.g. 'find my flight', 'when is the dentist', 'meetings with John')",
+        "  create_event — schedule a new event (e.g. 'schedule a meeting tomorrow at 3pm', 'add lunch with Sarah on Friday')",
+        "  update_event — rename, reschedule, move, or edit an existing event (e.g. 'rename my meeting to standup', 'reschedule the dentist to Friday', 'move the call to 3pm')",
+        "  delete_event — remove or cancel an existing event (e.g. 'delete the team meeting', 'cancel my appointment', 'remove the duplicate event')",
+        "  trip_window — query what's happening during a trip or stay in a specific place (e.g. 'what's happening while I'm in Denver', 'my Tokyo itinerary')",
+        "Use only the exact subaction literals listed above.",
+        "Do not invent aliases like edit_event, modify_event, reschedule_event, move_event, cancel_event, remove_event, agenda, or itinerary_window.",
+        "",
+        "For feed, search_events, trip_window, update_event, or delete_event, infer an exact timeMin/timeMax window when the request names or implies a date or date range.",
+        "timeMin and timeMax must be ISO 8601 datetimes that the API can use directly.",
+        "windowLabel should be a short natural-language label like on monday, this weekend, next month, or tonight.",
+        "For search_events, update_event, delete_event, or trip_window, extract up to 3 short search queries.",
+        "Preserve names, places, and keywords in their original language or script when useful.",
+        "Convert time constraints into concise searchable dates or windows even if the user phrases them in another language.",
+        "Focus on people, places, flights, itinerary, appointments, and explicit dates.",
+        "If the request is about a date, include a date query like april 12 or 2026-04-12.",
+        "If the request asks what is happening while the user is in a place, use trip_window and include tripLocation.",
+        "For update_event or delete_event, use queries to identify the existing target event and title for the new title only when the user is renaming it.",
+        "For requests like all events, full schedule, everything on my calendar, or a broad itinerary sweep, return a broad timeMin/timeMax window instead of relying on downstream heuristics.",
+        "",
+        "Examples:",
+        '  "what\'s on my calendar tomorrow" → {"subaction":"feed","shouldAct":true,"response":null}',
+        '  "今日の予定は何ですか？" → {"subaction":"feed","shouldAct":true,"response":null}',
+        '  "schedule a meeting with Alex at 3pm" → {"subaction":"create_event","shouldAct":true,"response":null,"title":"Meeting with Alex"}',
+        '  "find my return flight" → {"subaction":"search_events","shouldAct":true,"response":null,"queries":["return flight"]}',
+        '  "what do I have while I\'m in Tokyo" → {"subaction":"trip_window","shouldAct":true,"response":null,"queries":["tokyo"],"tripLocation":"Tokyo"}',
+        '  "rename my meeting to standup" → {"subaction":"update_event","shouldAct":true,"response":null,"queries":["meeting"],"title":"standup"}',
+        '  "Cambia la cita del dentista al viernes" → {"subaction":"update_event","shouldAct":true,"response":null,"queries":["cita del dentista"],"windowLabel":"el viernes"}',
+        '  "delete the team meeting tomorrow" → {"subaction":"delete_event","shouldAct":true,"response":null,"queries":["team meeting"]}',
+        '  "can you help me with my calendar?" → {"subaction":null,"shouldAct":false,"response":"What do you want to do on your calendar — check your schedule, find an event, or create one?","queries":[]}',
+        "",
+        "The user may speak any language. Detect the calendar intent regardless of language.",
+        "When the user asks about what is happening in a specific location or during a trip, detect this as trip_window and extract the location, regardless of language.",
+        "",
+        "Return ONLY valid JSON. No prose. No markdown. No XML. No <think>.",
+        "",
+        `Current timezone: ${timeZone}`,
+        `Current local datetime: ${localNow}`,
+        `Current ISO datetime: ${nowIso}`,
+        "",
+        "<current_request>",
+        currentMessage,
+        "</current_request>",
+        "<resolved_intent>",
+        intent,
+        "</resolved_intent>",
+        "<recent_conversation>",
+        recentConversation,
+        "</recent_conversation>",
+    ].join("\n");
+    let rawResponse = "";
+    const parseResponse = (raw) => {
+        const parsed = parseKeyValueXml(raw) ??
+            parseJSONObjectFromText(raw);
+        return parsed ? buildCalendarPlanFromParsed(parsed) : null;
+    };
+    try {
+        const result = await runtime.useModel(ModelType.TEXT_LARGE, {
+            prompt,
+        });
+        rawResponse = typeof result === "string" ? result : "";
+    }
+    catch (error) {
+        runtime.logger?.warn?.({
+            src: "action:calendar",
+            error: error instanceof Error ? error.message : String(error),
+        }, "Calendar action planning model call failed");
+        return {
+            subaction: null,
+            queries: [],
+            shouldAct: null,
+        };
+    }
+    const parsedPlan = parseResponse(rawResponse);
+    if (parsedPlan) {
+        return finalizeCalendarPlan({
+            runtime,
+            currentMessage,
+            intent,
+            recentConversation,
+            plan: parsedPlan,
+        });
+    }
+    try {
+        const repairResult = await runtime.useModel(ModelType.TEXT_LARGE, {
+            prompt: buildCalendarPlanRepairPrompt({
+                currentMessage,
+                intent,
+                recentConversation,
+                rawResponse,
+                timeZone,
+                nowIso,
+                localNow,
+            }),
+        });
+        const repairedRaw = typeof repairResult === "string" ? repairResult : "";
+        return finalizeCalendarPlan({
+            runtime,
+            currentMessage,
+            intent,
+            recentConversation,
+            plan: parseResponse(repairedRaw),
+        });
+    }
+    catch (error) {
+        runtime.logger?.warn?.({
+            src: "action:calendar",
+            error: error instanceof Error ? error.message : String(error),
+        }, "Calendar action repair model call failed");
+        return {
+            subaction: null,
+            queries: [],
+            shouldAct: null,
+        };
+    }
+}
+function resolveCalendarSearchQueries(args) {
+    return dedupeCalendarQueries([
+        ...args.explicitQueries,
+        ...(args.llmPlan?.queries ?? []),
+        ...(args.fallbackQueries ?? []),
+    ]);
+}
+async function recoverCalendarSearchQueriesWithLlm(args) {
+    const prompt = [
+        "Extract up to 3 short calendar search queries from this request.",
+        "Return ONLY valid JSON with this shape:",
+        '  {"queries":["query one","query two"]}',
+        "",
+        "Rules:",
+        "- Queries should be short people, places, trip labels, flight labels, appointment names, or other event lookup phrases.",
+        "- Do not return generic filler like calendar, event, schedule, search, what, tell me, or do i have.",
+        "- When the user is only asking for the agenda on a date or date range and there is no separate search target, return an empty array.",
+        "- The user may speak in any language.",
+        "",
+        "Examples:",
+        '  "do i have any flights to denver" -> {"queries":["flights to denver","denver"]}',
+        '  "puedes buscar si tengo un vuelo a denver" -> {"queries":["vuelo a denver","denver"]}',
+        '  "what event do i have on March 5" -> {"queries":[]}',
+        "",
+        `Current request: ${JSON.stringify(args.currentMessage)}`,
+        `Resolved intent: ${JSON.stringify(args.intent)}`,
+        `Recent conversation: ${JSON.stringify(args.recentConversation)}`,
+    ].join("\n");
+    try {
+        const result = await args.runtime.useModel(ModelType.TEXT_LARGE, {
+            prompt,
+        });
+        const raw = typeof result === "string" ? result : "";
+        const parsed = parseKeyValueXml(raw) ??
+            parseJSONObjectFromText(raw);
+        if (!parsed) {
+            return [];
+        }
+        const rawQueries = Array.isArray(parsed.queries)
+            ? parsed.queries
+            : typeof parsed.queries === "string"
+                ? parsed.queries.split(/\s*\|\|\s*|,|\n/)
+                : [];
+        return dedupeCalendarQueries(rawQueries.filter((value) => typeof value === "string"));
+    }
+    catch (error) {
+        args.runtime.logger?.warn?.({
+            src: "action:calendar",
+            error: error instanceof Error ? error.message : String(error),
+        }, "Calendar search query recovery model call failed");
+        return [];
+    }
+}
+function normalizeIsShortPreparationFlag(value) {
+    if (typeof value === "boolean")
+        return value;
+    if (typeof value === "string") {
+        const normalized = value.trim().toLowerCase();
+        if (normalized === "true")
+            return true;
+        if (normalized === "false")
+            return false;
+    }
+    return false;
+}
+function resolveCreateEventDurationMinutes(args) {
+    const { explicitDuration, extractedDuration, isShortPreparation, hasExplicitEndAt, hasExplicitWindowPreset, hasExplicitStartAt, } = args;
+    if (typeof explicitDuration === "number" &&
+        Number.isFinite(explicitDuration)) {
+        return explicitDuration > 0 ? explicitDuration : undefined;
+    }
+    if (typeof extractedDuration === "number" &&
+        Number.isFinite(extractedDuration)) {
+        if (extractedDuration > 0) {
+            return extractedDuration;
+        }
+        if (isShortPreparation &&
+            (hasExplicitStartAt || hasExplicitWindowPreset)) {
+            return MIN_CREATE_EVENT_DURATION_MINUTES;
+        }
+        return undefined;
+    }
+    if (!hasExplicitEndAt &&
+        isShortPreparation &&
+        (hasExplicitStartAt || hasExplicitWindowPreset)) {
+        return MIN_CREATE_EVENT_DURATION_MINUTES;
+    }
+    return undefined;
+}
+function parseCreateEventDurationValue(value) {
+    if (typeof value === "number" && Number.isFinite(value)) {
+        return value;
+    }
+    if (typeof value === "string") {
+        const parsed = Number(value);
+        return Number.isFinite(parsed) ? parsed : undefined;
+    }
+    return undefined;
+}
+function pickCreateEventStringField(args, key) {
+    const explicit = detailString(args.details, key);
+    const extracted = detailString(args.extractedDetails, key);
+    const fallback = args.fallbackRequest &&
+        typeof args.fallbackRequest[key] === "string"
+        ? args.fallbackRequest[key]
+        : undefined;
+    return args.preferExtractedDetails
+        ? (extracted ?? explicit ?? fallback)
+        : (explicit ?? extracted ?? fallback);
+}
+function buildCreateEventRequest(args) {
+    const extractedTitle = detailString(args.extractedDetails, "title");
+    const title = args.preferExtractedDetails
+        ? (extractedTitle ??
+            args.explicitTitle ??
+            args.fallbackRequest?.title ??
+            args.inferredTitle)
+        : (args.explicitTitle ??
+            extractedTitle ??
+            args.fallbackRequest?.title ??
+            args.inferredTitle);
+    const explicitStartAt = detailString(args.details, "startAt");
+    const explicitEndAt = detailString(args.details, "endAt");
+    const explicitWindowPreset = detailString(args.details, "windowPreset");
+    const extractedStartAt = detailString(args.extractedDetails, "startAt");
+    const extractedEndAt = detailString(args.extractedDetails, "endAt");
+    const extractedWindowPreset = detailString(args.extractedDetails, "windowPreset");
+    let resolvedStartAt;
+    let resolvedWindowPreset;
+    if (args.preferExtractedDetails && extractedStartAt) {
+        resolvedStartAt = extractedStartAt;
+        resolvedWindowPreset = undefined;
+    }
+    else if (args.preferExtractedDetails && extractedWindowPreset) {
+        resolvedStartAt = undefined;
+        resolvedWindowPreset = extractedWindowPreset;
+    }
+    else {
+        resolvedStartAt =
+            explicitStartAt ?? extractedStartAt ?? args.fallbackRequest?.startAt;
+        resolvedWindowPreset = resolvedStartAt
+            ? undefined
+            : (explicitWindowPreset ??
+                extractedWindowPreset ??
+                args.fallbackRequest?.windowPreset);
+    }
+    const rawEndAt = args.preferExtractedDetails &&
+        (extractedStartAt || extractedWindowPreset) &&
+        !extractedEndAt
+        ? undefined
+        : args.preferExtractedDetails
+            ? (extractedEndAt ?? explicitEndAt ?? args.fallbackRequest?.endAt)
+            : (explicitEndAt ?? extractedEndAt ?? args.fallbackRequest?.endAt);
+    const explicitDuration = detailNumber(args.details, "durationMinutes");
+    const extractedDuration = parseCreateEventDurationValue(args.extractedDetails.durationMinutes);
+    const fallbackDuration = args.fallbackRequest?.durationMinutes;
+    const durationMinutes = resolveCreateEventDurationMinutes({
+        explicitDuration: explicitDuration,
+        extractedDuration,
+        isShortPreparation: normalizeIsShortPreparationFlag(args.extractedDetails.isShortPreparation),
+        hasExplicitEndAt: Boolean(rawEndAt),
+        hasExplicitWindowPreset: Boolean(resolvedWindowPreset),
+        hasExplicitStartAt: Boolean(resolvedStartAt),
+    });
+    const resolvedDurationMinutes = explicitDuration !== undefined || extractedDuration !== undefined
+        ? durationMinutes
+        : fallbackDuration;
+    return {
+        title,
+        resolvedStartAt,
+        resolvedWindowPreset,
+        request: {
+            mode: detailString(args.details, "mode") ?? args.fallbackRequest?.mode,
+            side: (detailString(args.details, "side") ?? args.fallbackRequest?.side),
+            grantId: detailString(args.details, "grantId"),
+            calendarId: detailString(args.details, "calendarId") ??
+                args.fallbackRequest?.calendarId,
+            title: title ?? "",
+            description: pickCreateEventStringField(args, "description") ??
+                args.fallbackRequest?.description,
+            location: pickCreateEventStringField(args, "location") ??
+                args.fallbackRequest?.location,
+            startAt: resolvedStartAt,
+            endAt: rawEndAt ?? args.fallbackRequest?.endAt,
+            timeZone: pickCreateEventStringField(args, "timeZone") ??
+                args.fallbackRequest?.timeZone,
+            durationMinutes: resolvedDurationMinutes,
+            windowPreset: resolvedWindowPreset,
+            attendees: normalizeCalendarAttendees(args.details) ??
+                args.fallbackRequest?.attendees,
+        },
+    };
+}
+function createEventRequestFingerprint(request) {
+    return JSON.stringify({
+        title: request.title,
+        description: request.description ?? null,
+        location: request.location ?? null,
+        startAt: request.startAt ?? null,
+        endAt: request.endAt ?? null,
+        timeZone: request.timeZone ?? null,
+        durationMinutes: request.durationMinutes ?? null,
+        windowPreset: request.windowPreset ?? null,
+        calendarId: request.calendarId ?? null,
+        side: request.side ?? null,
+        mode: request.mode ?? null,
+        grantId: request.grantId ?? null,
+    });
+}
+function formatCreateEventRecentConversation(state) {
+    const conversation = planningConversationLines(state).join("\n").trim();
+    return conversation.length > 0 ? conversation : "(none)";
+}
+function parseCreateEventExtractionResponse(rawResponse) {
+    const parsed = parseKeyValueXml(rawResponse);
+    return parsed && typeof parsed === "object" ? parsed : {};
+}
+function formatUpdateEventTargetContext(event) {
+    if (!event) {
+        return "(unknown)";
+    }
+    const attendees = event.attendees
+        .map((attendee) => attendee.displayName ?? attendee.email ?? "")
+        .filter((value) => value.length > 0)
+        .join(", ");
+    return [
+        `title: ${event.title}`,
+        `startAt: ${event.startAt}`,
+        `endAt: ${event.endAt}`,
+        `timeZone: ${event.timezone ?? ""}`,
+        `formattedStart: ${formatCalendarEventDateTime(event, {
+            includeTimeZoneName: true,
+        })}`,
+        `location: ${event.location ?? ""}`,
+        `description: ${event.description ?? ""}`,
+        `attendees: ${attendees}`,
+    ].join("\n");
+}
+function shouldRetryCreateEventExtraction(error) {
+    const normalized = normalizeText(error.message);
+    if (error.status === 401 || error.status === 403) {
+        return false;
+    }
+    if (/\b(?:not connected|needs re-authentication|unauthorized|forbidden|permission|scope|grant)\b/.test(normalized)) {
+        return false;
+    }
+    return (error.status === 400 ||
+        error.status === 409 ||
+        /\b(?:startat|endat|duration|windowpreset|date|time|timezone|datetime|later than|invalid|bad request|parse|format)\b/.test(normalized));
+}
+async function inferCreateEventDetails(runtime, message, state, intent, calendarContext, fallbackTimeZone = resolveDefaultTimeZone()) {
+    const recentConversation = formatCreateEventRecentConversation(state);
+    const currentMessage = messageText(message).trim();
+    // Anchor the LLM in the present so relative phrases ("tomorrow", "next
+    // friday", "april 15") and explicit-but-yearless dates resolve to the
+    // correct ISO datetime instead of guessing or returning empty.
+    const now = new Date();
+    const nowIso = now.toISOString();
+    const timeZone = fallbackTimeZone;
+    const calendarTimeZone = calendarContext?.calendarTimeZone ?? fallbackTimeZone;
+    const nowReadable = new Intl.DateTimeFormat("en-US", {
+        timeZone,
+        dateStyle: "full",
+        timeStyle: "long",
+    }).format(now);
+    const prompt = [
+        "Extract calendar event creation fields from the request.",
+        "The user may speak in any language.",
+        "Use the full recent conversation below, not just the latest message.",
+        "Treat the latest user request as authoritative, but recover missing event subject, date, or location from earlier turns when needed.",
+        "If the current request is a follow-up, recover the event subject from recent conversation and apply new timing or location constraints from the current request.",
+        "Use the calendar context below to ground any timing guess.",
+        "Preserve names and places in their original language or script when useful.",
+        "Return XML only. No prose. Leave fields empty when unknown.",
+        "If a start time or window is implied but duration is not explicit, infer a reasonable positive duration.",
+        "For short prep or reminder blocks, use at least 15 minutes instead of 0.",
+        "Set isShortPreparation=true when the event is a brief prep/reminder/leave-for/get-ready block (any language) where 15 minutes is the right default.",
+        "When the user gives a concrete day or date without an exact time-of-day, use the calendar context to infer a plausible open startAt in the calendar timezone. Avoid obvious overlaps with nearby events. If the calendar context is unavailable or the timing is ambiguous, leave startAt empty.",
+        "Only use windowPreset for explicit 'tomorrow morning|afternoon|evening' phrasing — never as a fallback for arbitrary dates.",
+        "",
+        "<response>",
+        "  <title>event title</title>",
+        "  <description>optional description</description>",
+        "  <location>optional location</location>",
+        "  <startAt>ISO datetime if explicit or resolvable from a date phrase</startAt>",
+        "  <endAt>ISO datetime if explicit</endAt>",
+        "  <durationMinutes>number if implied</durationMinutes>",
+        "  <windowPreset>tomorrow_morning|tomorrow_afternoon|tomorrow_evening</windowPreset>",
+        "  <timeZone>IANA timezone if stated</timeZone>",
+        "  <isShortPreparation>true|false</isShortPreparation>",
+        "</response>",
+        "",
+        `Current timezone: ${timeZone}`,
+        `Calendar timezone for scheduling: ${calendarTimeZone}`,
+        `Current local datetime: ${nowReadable}`,
+        `Current ISO datetime: ${nowIso}`,
+        "",
+        "<current_request>",
+        currentMessage,
+        "</current_request>",
+        "<resolved_intent>",
+        intent,
+        "</resolved_intent>",
+        "<recent_conversation>",
+        recentConversation,
+        "</recent_conversation>",
+        "<calendar_context>",
+        formatCreateEventCalendarContext(calendarContext),
+        "</calendar_context>",
+    ].join("\n");
+    try {
+        const result = await runtime.useModel(ModelType.TEXT_LARGE, { prompt });
+        const rawResponse = typeof result === "string" ? result : "";
+        return parseCreateEventExtractionResponse(rawResponse);
+    }
+    catch (error) {
+        runtime.logger?.warn?.({
+            src: "action:calendar",
+            error: error instanceof Error ? error.message : String(error),
+        }, "Calendar create-event extraction model call failed");
+        return {};
+    }
+}
+async function inferUpdateEventDetails(runtime, message, state, intent, targetEvent, fallbackTimeZone = targetEvent?.timezone ?? resolveDefaultTimeZone()) {
+    const recentConversation = formatCreateEventRecentConversation(state);
+    const currentMessage = messageText(message).trim();
+    const now = new Date();
+    const nowIso = now.toISOString();
+    const timeZone = fallbackTimeZone;
+    const nowReadable = new Intl.DateTimeFormat("en-US", {
+        timeZone,
+        dateStyle: "full",
+        timeStyle: "long",
+    }).format(now);
+    const prompt = [
+        "Extract calendar event update fields from the request.",
+        "The user may speak in any language.",
+        "Use the full recent conversation below, not just the latest message.",
+        "The current event below is the source of truth for unchanged fields.",
+        "Only return fields the user is actually changing. Leave fields empty when unchanged or unknown.",
+        "If the user asks to move or reschedule the event, compute absolute ISO datetimes for the updated startAt and endAt using the current event as context.",
+        "If the user gives a relative shift like later, earlier, push back, or move forward, apply it to the current event timing.",
+        "Unless the user explicitly changes the timezone, preserve the current event timezone.",
+        "If the user only renames the event, leave startAt, endAt, location, description, and timeZone empty.",
+        "Return XML only. No prose.",
+        "",
+        "<response>",
+        "  <title>new event title if changed</title>",
+        "  <description>updated description if changed</description>",
+        "  <location>updated location if changed</location>",
+        "  <startAt>updated ISO datetime if changed</startAt>",
+        "  <endAt>updated ISO datetime if changed</endAt>",
+        "  <timeZone>IANA timezone if changed or needed to interpret the update</timeZone>",
+        "</response>",
+        "",
+        `Current timezone: ${timeZone}`,
+        `Current local datetime: ${nowReadable}`,
+        `Current ISO datetime: ${nowIso}`,
+        "",
+        "<current_request>",
+        currentMessage,
+        "</current_request>",
+        "<resolved_intent>",
+        intent,
+        "</resolved_intent>",
+        "<recent_conversation>",
+        recentConversation,
+        "</recent_conversation>",
+        "<current_event>",
+        formatUpdateEventTargetContext(targetEvent),
+        "</current_event>",
+    ].join("\n");
+    try {
+        const result = await runtime.useModel(ModelType.TEXT_LARGE, { prompt });
+        const rawResponse = typeof result === "string" ? result : "";
+        return parseCreateEventExtractionResponse(rawResponse);
+    }
+    catch (error) {
+        runtime.logger?.warn?.({
+            src: "action:calendar",
+            error: error instanceof Error ? error.message : String(error),
+        }, "Calendar update-event extraction model call failed");
+        return {};
+    }
+}
+async function repairCreateEventDetails(runtime, message, state, intent, calendarContext, failedRequest, previousExtraction, error, fallbackTimeZone = resolveDefaultTimeZone()) {
+    const recentConversation = formatCreateEventRecentConversation(state);
+    const currentMessage = messageText(message).trim();
+    const now = new Date();
+    const timeZone = fallbackTimeZone;
+    const calendarTimeZone = calendarContext?.calendarTimeZone ?? fallbackTimeZone;
+    const nowIso = now.toISOString();
+    const nowReadable = new Intl.DateTimeFormat("en-US", {
+        timeZone,
+        dateStyle: "full",
+        timeStyle: "long",
+    }).format(now);
+    const prompt = [
+        "Extract calendar event creation fields from the request.",
+        "The previous create attempt failed. Repair the extraction so the next create attempt succeeds.",
+        "Use the full recent conversation below, not just the latest message.",
+        "The latest user request is authoritative, but preserve the existing event subject, people, and places unless the user changed them.",
+        "Use the calendar context below to ground any timing repair.",
+        "Use the exact failure reason to correct only the broken fields.",
+        "Return XML only. No prose. Leave fields empty when unchanged or unknown.",
+        "",
+        "<response>",
+        "  <title>event title</title>",
+        "  <description>optional description</description>",
+        "  <location>optional location</location>",
+        "  <startAt>ISO datetime if explicit or resolvable from a date phrase</startAt>",
+        "  <endAt>ISO datetime if explicit</endAt>",
+        "  <durationMinutes>number if implied</durationMinutes>",
+        "  <windowPreset>tomorrow_morning|tomorrow_afternoon|tomorrow_evening</windowPreset>",
+        "  <timeZone>IANA timezone if stated</timeZone>",
+        "</response>",
+        "",
+        `Current timezone: ${timeZone}`,
+        `Calendar timezone for scheduling: ${calendarTimeZone}`,
+        `Current local datetime: ${nowReadable}`,
+        `Current ISO datetime: ${nowIso}`,
+        `Create failure: ${error.message}`,
+        `Previous extraction: ${JSON.stringify(previousExtraction)}`,
+        `Previous create request: ${JSON.stringify(failedRequest)}`,
+        "",
+        "<current_request>",
+        currentMessage,
+        "</current_request>",
+        "<resolved_intent>",
+        intent,
+        "</resolved_intent>",
+        "<recent_conversation>",
+        recentConversation,
+        "</recent_conversation>",
+        "<calendar_context>",
+        formatCreateEventCalendarContext(calendarContext),
+        "</calendar_context>",
+    ].join("\n");
+    try {
+        const result = await runtime.useModel(ModelType.TEXT_LARGE, { prompt });
+        const rawResponse = typeof result === "string" ? result : "";
+        return parseCreateEventExtractionResponse(rawResponse);
+    }
+    catch (repairError) {
+        runtime.logger?.warn?.({
+            src: "action:calendar",
+            error: repairError instanceof Error
+                ? repairError.message
+                : String(repairError),
+        }, "Calendar create-event repair model call failed");
+        return {};
+    }
+}
+function scoreCalendarEvent(event, query) {
+    const normalizedQuery = normalizeText(query);
+    const title = normalizeText(event.title);
+    const description = normalizeText(event.description);
+    const location = normalizeText(event.location);
+    const attendees = event.attendees
+        .flatMap((attendee) => [attendee.displayName ?? "", attendee.email ?? ""])
+        .map((value) => normalizeText(value))
+        .filter((value) => value.length > 0);
+    let score = 0;
+    const queryVariants = [
+        ...new Set([normalizedQuery, ...tokenVariants(normalizedQuery)]),
+    ];
+    if (queryVariants.some((variant) => title === variant)) {
+        score += 100;
+    }
+    else if (queryVariants.some((variant) => variant.length > 0 && title.includes(variant))) {
+        score += 75;
+    }
+    if (queryVariants.some((variant) => variant.length > 0 && description.includes(variant))) {
+        score += 35;
+    }
+    if (queryVariants.some((variant) => variant.length > 0 && location.includes(variant))) {
+        score += 30;
+    }
+    if (attendees.some((value) => queryVariants.some((variant) => variant.length > 0 && value.includes(variant)))) {
+        score += 25;
+    }
+    const queryTokens = tokenizeForSearch(normalizedQuery);
+    if (queryTokens.length > 0) {
+        const titleTokens = new Set(tokenizeForSearch(title));
+        const descriptionTokens = new Set(tokenizeForSearch(description));
+        const locationTokens = new Set(tokenizeForSearch(location));
+        const attendeeTokens = attendees.flatMap((value) => tokenizeForSearch(value));
+        const attendeeTokenSet = new Set(attendeeTokens);
+        score += queryTokens.filter((token) => titleTokens.has(token)).length * 12;
+        score +=
+            queryTokens.filter((token) => descriptionTokens.has(token)).length * 8;
+        score +=
+            queryTokens.filter((token) => locationTokens.has(token)).length * 14;
+        score +=
+            queryTokens.filter((token) => attendeeTokenSet.has(token)).length * 8;
+    }
+    // (Earlier revisions added an English-only "return/back/home" boost and a
+    // counter-penalty against generic flight/travel/trip events. Token matching
+    // above already covers any language; the boost was multilingual-hostile and
+    // produced wrong results when the user said the equivalent in another
+    // language. The grounded LLM disambiguation step picks the right match
+    // when token scores are tied.)
+    const dateTerms = eventDateSearchTerms(event);
+    if ([...dateTerms].some((term) => term === normalizedQuery ||
+        normalizedQuery.includes(term) ||
+        term.includes(normalizedQuery))) {
+        score += 90;
+    }
+    const dateTokens = new Set([...dateTerms].flatMap((term) => tokenizeForSearch(term)));
+    score += queryTokens.filter((token) => dateTokens.has(token)).length * 10;
+    return score;
+}
+function shouldGroundCalendarSearchWithLlm(query, rankedEvents) {
+    const strongestScore = rankedEvents[0]?.score ?? 0;
+    if (strongestScore <= 0) {
+        return false;
+    }
+    if (strongestScore >= 72) {
+        return false;
+    }
+    return wordCount(query) >= 2 || rankedEvents.length > 1;
+}
+function normalizeCalendarMatchIdsFromValue(value, allowedIds) {
+    const rawIds = [];
+    if (typeof value === "string") {
+        for (const token of value.split(/\s*\|\|\s*|\s*,\s*|\s+/)) {
+            if (token.trim().length > 0) {
+                rawIds.push(token.trim());
+            }
+        }
+    }
+    else if (Array.isArray(value)) {
+        for (const item of value) {
+            if (typeof item === "string" && item.trim().length > 0) {
+                rawIds.push(item.trim());
+            }
+        }
+    }
+    return [...new Set(rawIds.filter((id) => allowedIds.has(id)))];
+}
+function extractCalendarGroundedMatchIds(rawResponse, allowedIds) {
+    const parsed = parseKeyValueXml(rawResponse) ??
+        parseJSONObjectFromText(rawResponse);
+    if (!parsed) {
+        return null;
+    }
+    const possibleKeys = [
+        "matchIds",
+        "matches",
+        "ids",
+        "matchId",
+        "matchId1",
+        "matchId2",
+        "matchId3",
+    ];
+    const sawExplicitMatchField = possibleKeys.some((key) => key in parsed);
+    if (!sawExplicitMatchField) {
+        return null;
+    }
+    const ids = possibleKeys.flatMap((key) => normalizeCalendarMatchIdsFromValue(parsed[key], allowedIds));
+    return [...new Set(ids)];
+}
+function formatCalendarCandidateForGrounding(candidate) {
+    const attendees = candidate.event.attendees
+        .map((attendee) => attendee.displayName ?? attendee.email ?? "")
+        .filter((value) => value.length > 0)
+        .join(", ");
+    return [
+        `id: ${candidate.event.id}`,
+        `score: ${candidate.score}`,
+        `title: ${candidate.event.title}`,
+        `startAt: ${candidate.event.startAt}`,
+        `location: ${candidate.event.location ?? ""}`,
+        `description: ${(candidate.event.description ?? "").slice(0, 240)}`,
+        `attendees: ${attendees}`,
+    ].join("\n");
+}
+async function groundCalendarSearchMatchesWithLlm(runtime, state, intent, queries, candidates) {
+    if (candidates.length === 0) {
+        return [];
+    }
+    const recentConversation = formatCreateEventRecentConversation(state);
+    const allowedIds = new Set(candidates.map((candidate) => candidate.event.id));
+    const prompt = [
+        "Decide which candidate calendar events directly match the user's request.",
+        "Be strict.",
+        "Return NO matches when the candidate only shares a generic time window or vague travel context.",
+        "If the request names a person, company, topic, or event name, only match candidates that explicitly mention that subject in the title, description, location, or attendees.",
+        "Flights only count when the request is actually about flights/travel, or the flight text explicitly mentions the named subject.",
+        "Return TOON only. No prose. No <think>.",
+        "Use || to separate multiple ids.",
+        "",
+        "Example:",
+        "matchIds: evt_1 || evt_2",
+        "reason:",
+        "",
+        "<resolved_intent>",
+        intent,
+        "</resolved_intent>",
+        "<search_queries>",
+        queries.join(" || "),
+        "</search_queries>",
+        "<recent_conversation>",
+        recentConversation,
+        "</recent_conversation>",
+        "",
+        "Candidates:",
+        ...candidates.map((candidate, index) => `candidate ${index + 1}\n${formatCalendarCandidateForGrounding(candidate)}`),
+    ].join("\n");
+    try {
+        const result = await runtime.useModel(ModelType.TEXT_LARGE, { prompt });
+        const rawResponse = typeof result === "string" ? result : "";
+        return extractCalendarGroundedMatchIds(rawResponse, allowedIds);
+    }
+    catch (error) {
+        runtime.logger?.warn?.({
+            src: "action:calendar",
+            error: error instanceof Error ? error.message : String(error),
+        }, "Calendar search grounding model call failed");
+        return null;
+    }
+}
+function buildCalendarGroundingCandidates(events) {
+    return events.slice(0, 24).map((event, index) => ({
+        event,
+        score: Math.max(1, 24 - index),
+        matchedQueries: [],
+    }));
+}
+function eventStartMs(event) {
+    return Date.parse(event.startAt);
+}
+function eventEndMs(event) {
+    const parsed = Date.parse(event.endAt);
+    if (Number.isFinite(parsed)) {
+        return parsed;
+    }
+    return eventStartMs(event);
+}
+function resolveTripWindowEvents(events, location) {
+    // Trip-window anchoring is driven entirely by location-token matching via
+    // scoreCalendarEvent. The previous English-only "travel keyword" boost
+    // (flight/hotel/airbnb/...) was multilingual-hostile; the LLM trip_window
+    // planner already supplies a location, so location matching alone is enough.
+    const anchors = events
+        .map((event) => ({
+        event,
+        score: scoreCalendarEvent(event, location),
+    }))
+        .filter((candidate) => candidate.score > 0)
+        .sort((left, right) => eventStartMs(left.event) - eventStartMs(right.event));
+    if (anchors.length === 0) {
+        return null;
+    }
+    const windowStart = Math.min(...anchors.map((candidate) => eventStartMs(candidate.event)));
+    const windowEnd = Math.max(...anchors.map((candidate) => eventEndMs(candidate.event)));
+    return events
+        .filter((event) => eventEndMs(event) >= windowStart && eventStartMs(event) <= windowEnd)
+        .sort((left, right) => eventStartMs(left) - eventStartMs(right));
+}
+function formatCalendarMoment(event) {
+    if (event.isAllDay) {
+        return new Intl.DateTimeFormat("en-US", {
+            timeZone: event.timezone || undefined,
+            month: "short",
+            day: "numeric",
+        }).format(new Date(event.startAt));
+    }
+    return formatCalendarEventDateTime(event);
+}
+function formatTripWindowResults(events, location) {
+    if (events.length === 0) {
+        return `I couldn't find any upcoming calendar events while you're in ${location}.`;
+    }
+    const lines = [`Here's what's on your calendar while you're in ${location}:`];
+    for (const event of events.slice(0, 12)) {
+        lines.push(`- ${formatCalendarMoment(event)}: **${event.title}**`);
+    }
+    return lines.join("\n");
+}
+function formatCalendarSearchResults(events, query, label) {
+    if (events.length === 0) {
+        return `No calendar events matched "${query}" ${label}.`;
+    }
+    if (events.length === 1) {
+        const event = events.at(0);
+        if (!event) {
+            return `No calendar events matched "${query}" ${label}.`;
+        }
+        // The fallback wording is intentionally generic ("calendar event") so it
+        // is correct in any language. The grounded LLM reply renderer is what
+        // gives this string its final natural phrasing — no English keyword
+        // regex picks the noun anymore.
+        return `Your matching calendar event is **${event.title}** (${formatCalendarMoment(event)}).`;
+    }
+    const lines = [
+        `Found ${events.length} calendar event${events.length === 1 ? "" : "s"} for "${query}" ${label}:`,
+    ];
+    for (const event of events.slice(0, 8)) {
+        const when = event.isAllDay
+            ? "all day"
+            : formatCalendarEventDateTime(event);
+        lines.push(`- **${event.title}** (${when})`);
+        if (event.location) {
+            lines.push(`  Location: ${event.location}`);
+        }
+        if (event.description) {
+            lines.push(`  ${event.description.slice(0, 120)}`);
+        }
+    }
+    return lines.join("\n");
+}
+function normalizeCalendarAttendees(details) {
+    const attendees = detailArray(details, "attendees");
+    if (!attendees) {
+        return undefined;
+    }
+    const mapped = attendees.map((attendee) => {
+        if (typeof attendee === "string" && attendee.trim().length > 0) {
+            return {
+                email: attendee.trim(),
+            };
+        }
+        if (!attendee ||
+            typeof attendee !== "object" ||
+            Array.isArray(attendee)) {
+            return null;
+        }
+        const record = attendee;
+        const email = typeof record.email === "string" && record.email.trim().length > 0
+            ? record.email.trim()
+            : null;
+        if (!email) {
+            return null;
+        }
+        return {
+            email,
+            displayName: typeof record.displayName === "string" &&
+                record.displayName.trim().length > 0
+                ? record.displayName.trim()
+                : undefined,
+            optional: typeof record.optional === "boolean" ? record.optional : undefined,
+        };
+    });
+    const normalized = mapped.filter((attendee) => attendee !== null);
+    return normalized.length > 0 ? normalized : undefined;
+}
+export const calendarAction = {
+    name: "CALENDAR_ACTION",
+    similes: [
+        "CALENDAR",
+        "CHECK_CALENDAR",
+        "SHOW_CALENDAR_TODAY",
+        "TODAY_SCHEDULE",
+        "WEEK_AHEAD",
+        "WEEK_VIEW",
+        "WHATS_MY_NEXT_MEETING",
+        "SCHEDULE_EVENT",
+        "CREATE_CALENDAR_EVENT",
+        "SEARCH_CALENDAR",
+        "NEXT_MEETING",
+        "ITINERARY",
+        "TRAVEL_SCHEDULE",
+        "CHECK_SCHEDULE",
+        "BOOK_TIME_BLOCK",
+        "RECURRING_TIME_BLOCK",
+        "REBOOK_TRAVEL",
+    ],
+    tags: [
+        "always-include",
+        "calendar",
+        "schedule",
+        "meeting",
+        "event",
+        "recurring block",
+        "time block",
+        "travel itinerary",
+    ],
+    description: "Interact with Google Calendar through LifeOps. " +
+        "USE this action for: viewing today's or this week's schedule; checking the next upcoming event; " +
+        "searching events by title, attendee, location, or date range; creating new calendar events; " +
+        "requests like 'what's my next meeting?', 'show me my calendar for today', 'what does my week look like?', or 'schedule a dentist appointment next Tuesday at 3pm'; " +
+        "querying travel itineraries, flights, hotel stays, trip windows, reserving recurring time blocks, and rebooking or moving calendar-backed commitments. " +
+        "These are live calendar reads and writes, so do not answer them from provider context alone and do not fall back to NONE or REPLY when this action is available. " +
+        "DO NOT use this action when the user is only making an observation like 'my calendar has been crazy this quarter' unless they actually ask you to inspect or change calendar state. " +
+        "DO NOT use this action for email inbox work, drafting or sending emails — use GMAIL_ACTION instead. " +
+        "DO NOT use this action for personal habits, goals, routines, or reminders — use LIFE instead. " +
+        "This action provides the final grounded reply; do not pair it with a speculative REPLY action." +
+        " DO NOT use this action when the user asks to 'help schedule' / 'set up' / 'find a time for' a meeting with a person or team without a specific time — that is SCHEDULING (subaction start). DO NOT use this action to 'propose', 'suggest', or 'offer' meeting time slots — that is PROPOSE_MEETING_TIMES. Use CALENDAR_ACTION only when the user specifies (or intends to specify) a concrete date/time for the event.",
+    descriptionCompressed: "Google Calendar via LifeOps: view schedule, search events, create events, query travel. Not for email or habits.",
+    suppressPostActionContinuation: true,
+    validate: async (runtime, message) => {
+        if (looksLikeCalendarObservation(messageText(message))) {
+            return false;
+        }
+        return hasLifeOpsAccess(runtime, message);
+    },
+    handler: async (runtime, message, state, options, callback) => {
+        if (!(await hasLifeOpsAccess(runtime, message))) {
+            const text = "Calendar actions are restricted to the owner, explicitly granted users, and the agent.";
+            await callback?.({ text });
+            return {
+                success: false,
+                text,
+            };
+        }
+        const rawParams = options?.parameters;
+        const params = rawParams ?? {};
+        const intent = resolveCalendarIntentInput(params.intent, message);
+        const currentMessageText = messageText(message).trim();
+        const details = normalizeCalendarDetails(params.details);
+        const planningTimeZone = resolveCalendarTimeZone(details);
+        const llmPlan = await extractCalendarPlanWithLlm(runtime, message, state, intent, planningTimeZone);
+        const explicitSubaction = normalizeCalendarSubaction(params.subaction);
+        const explicitTitle = (typeof params.title === "string" && params.title.trim().length > 0
+            ? params.title.trim()
+            : undefined) ??
+            detailString(details, "title") ??
+            llmPlan.title;
+        const inferredTitle = explicitTitle ?? llmPlan.title;
+        const tripWindowIntent = llmPlan.tripLocation && llmPlan.tripLocation.trim().length > 0
+            ? { location: llmPlan.tripLocation.trim() }
+            : null;
+        const searchQueries = resolveCalendarSearchQueries({
+            explicitQueries: [
+                params.query,
+                detailString(details, "query"),
+                ...(params.queries ?? []),
+                ...(detailArray(details, "queries")?.map((value) => typeof value === "string" ? value : undefined) ?? []),
+            ],
+            llmPlan,
+            fallbackQueries: [tripWindowIntent?.location],
+        });
+        const structuredSubaction = resolveStructuredCalendarSubaction(params, details);
+        const hasExplicitCalendarExecutionInput = Boolean(explicitSubaction ||
+            params.title ||
+            params.query ||
+            (params.queries?.length ?? 0) > 0 ||
+            detailString(details, "query") ||
+            (detailArray(details, "queries")?.length ?? 0) > 0 ||
+            detailString(details, "eventId") ||
+            detailString(details, "startAt") ||
+            detailString(details, "endAt") ||
+            detailString(details, "location") ||
+            detailString(details, "windowPreset") ||
+            detailNumber(details, "windowDays"));
+        const subaction = explicitSubaction ??
+            llmPlan.subaction ??
+            (tripWindowIntent ? "trip_window" : null) ??
+            structuredSubaction;
+        runtime.logger?.debug?.({
+            src: "action:calendar",
+            subaction,
+            rawMessage: messageText(message).slice(0, 200),
+            resolvedIntent: intent.slice(0, 200),
+            params: {
+                subaction: params.subaction,
+                title: params.title,
+                intent: params.intent?.slice(0, 200),
+            },
+            detailKeys: details ? Object.keys(details) : [],
+        }, "calendar action dispatch");
+        const service = new LifeOpsService(runtime);
+        const respond = async (payload) => {
+            await callback?.({
+                text: payload.text,
+                source: "action",
+                action: "CALENDAR_ACTION",
+            });
+            return payload;
+        };
+        const renderReply = (scenario, fallback, context) => renderCalendarActionReply({
+            runtime,
+            message,
+            state,
+            intent,
+            scenario,
+            fallback,
+            context,
+        });
+        if (llmPlan.shouldAct === false &&
+            !hasExplicitCalendarExecutionInput &&
+            !explicitSubaction) {
+            const fallback = llmPlan.response ?? buildCalendarReplyOnlyFallback(llmPlan.subaction);
+            return respond({
+                success: true,
+                text: await renderReply("reply_only", fallback, {
+                    llmPlan,
+                    suggestedSubaction: llmPlan.subaction,
+                }),
+                data: {
+                    noop: true,
+                    ...(llmPlan.subaction
+                        ? { suggestedSubaction: llmPlan.subaction }
+                        : {}),
+                },
+            });
+        }
+        if (!subaction) {
+            const fallback = llmPlan.response ?? buildCalendarReplyOnlyFallback(llmPlan.subaction);
+            return respond({
+                success: true,
+                text: await renderReply("reply_only", fallback, {
+                    llmPlan,
+                    suggestedSubaction: llmPlan.subaction,
+                }),
+                data: {
+                    noop: true,
+                    ...(llmPlan.subaction
+                        ? { suggestedSubaction: llmPlan.subaction }
+                        : {}),
+                },
+            });
+        }
+        try {
+            const google = await getGoogleCapabilityStatus(service);
+            if (subaction === "next_event") {
+                if (!google.hasCalendarRead) {
+                    return respond({
+                        success: false,
+                        text: calendarReadUnavailableMessage(google),
+                    });
+                }
+                const context = await service.getNextCalendarEventContext(INTERNAL_URL, {
+                    calendarId: detailString(details, "calendarId"),
+                    timeZone: resolveCalendarTimeZone(details),
+                });
+                const fallback = formatNextEventContext(context);
+                return respond({
+                    success: true,
+                    text: await renderReply("next_event", fallback, {
+                        event: context,
+                    }),
+                    data: toActionData(context),
+                });
+            }
+            if (subaction === "create_event") {
+                if (!google.hasCalendarWrite) {
+                    return respond({
+                        success: false,
+                        text: calendarWriteUnavailableMessage(google),
+                    });
+                }
+                let calendarContext = null;
+                try {
+                    calendarContext = await loadCreateEventCalendarContext(service, details, google.hasCalendarRead);
+                }
+                catch (error) {
+                    runtime.logger?.warn?.({
+                        src: "action:calendar",
+                        error: error instanceof Error ? error.message : String(error),
+                    }, "Calendar create-event context fetch failed");
+                }
+                const extractedDetails = await inferCreateEventDetails(runtime, message, state, intent, calendarContext, planningTimeZone);
+                const { title, resolvedStartAt, resolvedWindowPreset, request } = buildCreateEventRequest({
+                    details,
+                    extractedDetails,
+                    explicitTitle,
+                    inferredTitle,
+                    intent,
+                });
+                if (!title) {
+                    return respond({
+                        success: false,
+                        text: await renderReply("clarify_create_event_title", "What event do you want to add?", {
+                            missing: ["title"],
+                        }),
+                    });
+                }
+                // The LifeOps service throws a raw 400 when neither startAt nor a
+                // window preset is supplied. Catch that case here so the user gets a
+                // useful prompt instead of "startAt is required when windowPreset is
+                // not provided" — and so the failure path doesn't re-trigger the
+                // action via post-action continuation.
+                if (!resolvedStartAt && !resolvedWindowPreset) {
+                    const suggestedStartAt = title
+                        ? suggestCreateEventStartAt({
+                            currentMessage: messageText(message).trim(),
+                            intent,
+                            title,
+                            calendarContext,
+                        })
+                        : null;
+                    const fallback = suggestedStartAt
+                        ? `i can tentatively put "${title}" on ${formatCalendarEventDateTime({
+                            startAt: suggestedStartAt.startAt,
+                            timezone: suggestedStartAt.timeZone,
+                        }, { includeTimeZoneName: true })}. if you want a different time, tell me what works better.`
+                        : `i need a time for "${title}" in ${calendarContext?.calendarTimeZone ??
+                            resolveCalendarTimeZone(details)}. try "tomorrow morning", "tomorrow afternoon", "tomorrow evening", or give me a specific date and time.`;
+                    return respond({
+                        success: false,
+                        text: await renderReply("clarify_create_event_time", fallback, {
+                            title,
+                            suggestedStartAt,
+                            calendarTimeZone: calendarContext?.calendarTimeZone ??
+                                resolveCalendarTimeZone(details),
+                        }),
+                    });
+                }
+                let requestToCreate = request;
+                let event;
+                try {
+                    event = await service.createCalendarEvent(INTERNAL_URL, requestToCreate);
+                }
+                catch (error) {
+                    if (error instanceof LifeOpsServiceError &&
+                        shouldRetryCreateEventExtraction(error)) {
+                        const repairedDetails = await repairCreateEventDetails(runtime, message, state, intent, calendarContext, requestToCreate, extractedDetails, error, planningTimeZone);
+                        const repaired = buildCreateEventRequest({
+                            details,
+                            extractedDetails: repairedDetails,
+                            explicitTitle,
+                            inferredTitle,
+                            intent,
+                            fallbackRequest: requestToCreate,
+                            preferExtractedDetails: true,
+                        });
+                        if (repaired.title &&
+                            (repaired.resolvedStartAt || repaired.resolvedWindowPreset) &&
+                            createEventRequestFingerprint(repaired.request) !==
+                                createEventRequestFingerprint(requestToCreate)) {
+                            runtime.logger?.info?.({
+                                src: "action:calendar",
+                                error: error.message,
+                                priorRequest: requestToCreate,
+                                repairedRequest: repaired.request,
+                            }, "Retrying calendar create-event after repair extraction");
+                            requestToCreate = repaired.request;
+                            event = await service.createCalendarEvent(INTERNAL_URL, requestToCreate);
+                        }
+                        else {
+                            throw error;
+                        }
+                    }
+                    else {
+                        throw error;
+                    }
+                }
+                const fallback = `Created calendar event "${event.title}" for ${formatCalendarEventDateTime(event, {
+                    includeTimeZoneName: true,
+                })}.`;
+                return respond({
+                    success: true,
+                    text: await renderReply("created_event", fallback, {
+                        event,
+                        request: requestToCreate,
+                    }),
+                    data: toActionData(event),
+                });
+            }
+            if (subaction === "update_event") {
+                if (!google.hasCalendarWrite) {
+                    return respond({
+                        success: false,
+                        text: calendarWriteUnavailableMessage(google),
+                    });
+                }
+                const explicitEventId = detailString(details, "eventId");
+                let resolvedEventId = explicitEventId;
+                let resolvedCalendarId = detailString(details, "calendarId");
+                let targetEvent = null;
+                if (!resolvedEventId) {
+                    const titleHint = searchQueries[0];
+                    if (!titleHint) {
+                        return respond({
+                            success: false,
+                            text: await renderReply("clarify_update_event_target", "Tell me which calendar event you want to change by title, person, place, or date.", {
+                                missing: ["target event"],
+                            }),
+                        });
+                    }
+                    const feedRequest = detailString(details, "timeMin") ||
+                        detailString(details, "timeMax") ||
+                        llmPlan.timeMin ||
+                        llmPlan.timeMax
+                        ? resolveCalendarWindow(intent, details, true, llmPlan).request
+                        : {
+                            calendarId: detailString(details, "calendarId"),
+                            timeZone: resolveCalendarTimeZone(details),
+                            ...buildWideLookupRange(resolveCalendarTimeZone(details)),
+                        };
+                    const feed = await service.getCalendarFeed(INTERNAL_URL, {
+                        mode: detailString(details, "mode"),
+                        side: detailString(details, "side"),
+                        grantId: detailString(details, "grantId"),
+                        forceSync: true,
+                        ...feedRequest,
+                    });
+                    const candidates = titleHint
+                        ? feed.events.filter((e) => normalizeText(e.title).includes(normalizeText(titleHint)))
+                        : feed.events;
+                    if (candidates.length === 0) {
+                        const fallback = titleHint
+                            ? `i couldn't find an event matching "${titleHint}" in that window.`
+                            : "i couldn't find any events to update in that window. give me a title or a date.";
+                        return respond({
+                            success: false,
+                            text: await renderReply("update_event_not_found", fallback, {
+                                titleHint,
+                            }),
+                        });
+                    }
+                    if (candidates.length > 1) {
+                        const fallback = buildCalendarEventDisambiguationFallback({
+                            action: "update",
+                            candidates,
+                            titleHint,
+                        });
+                        return respond({
+                            success: false,
+                            text: await renderReply("clarify_update_event_target", fallback, {
+                                candidateCount: candidates.length,
+                                titleHint,
+                                candidates,
+                            }),
+                        });
+                    }
+                    targetEvent = candidates.at(0) ?? null;
+                    if (!targetEvent) {
+                        return respond({
+                            success: false,
+                            text: await renderReply("update_event_not_found", "i couldn't find a unique event to update.", { titleHint }),
+                        });
+                    }
+                    resolvedEventId = targetEvent.externalId;
+                    resolvedCalendarId = targetEvent.calendarId;
+                }
+                const newTitle = detailString(details, "newTitle") ?? explicitTitle;
+                const explicitStartAtForUpdate = detailString(details, "startAt");
+                const explicitEndAtForUpdate = detailString(details, "endAt");
+                const extractedForUpdate = targetEvent
+                    ? await inferUpdateEventDetails(runtime, message, state, intent, targetEvent, targetEvent?.timezone ?? planningTimeZone)
+                    : {};
+                const extractedStartAt = typeof extractedForUpdate.startAt === "string"
+                    ? extractedForUpdate.startAt.trim()
+                    : undefined;
+                const extractedEndAt = typeof extractedForUpdate.endAt === "string"
+                    ? extractedForUpdate.endAt.trim()
+                    : undefined;
+                const extractedLocation = typeof extractedForUpdate.location === "string"
+                    ? extractedForUpdate.location.trim()
+                    : undefined;
+                const extractedDescription = typeof extractedForUpdate.description === "string"
+                    ? extractedForUpdate.description.trim()
+                    : undefined;
+                const extractedTimeZoneForUpdate = typeof extractedForUpdate.timeZone === "string"
+                    ? extractedForUpdate.timeZone.trim()
+                    : undefined;
+                const event = await service.updateCalendarEvent(INTERNAL_URL, {
+                    mode: detailString(details, "mode"),
+                    side: detailString(details, "side"),
+                    grantId: detailString(details, "grantId"),
+                    calendarId: resolvedCalendarId,
+                    eventId: resolvedEventId ?? "",
+                    title: newTitle,
+                    description: detailString(details, "description") ?? extractedDescription,
+                    location: detailString(details, "location") ?? extractedLocation,
+                    startAt: explicitStartAtForUpdate ?? extractedStartAt,
+                    endAt: explicitEndAtForUpdate ?? extractedEndAt,
+                    timeZone: detailString(details, "timeZone") ??
+                        extractedTimeZoneForUpdate ??
+                        targetEvent?.timezone ??
+                        undefined,
+                });
+                const fallback = `updated "${event.title}" — ${formatCalendarEventDateTime(event, {
+                    includeTimeZoneName: true,
+                })}.`;
+                return respond({
+                    success: true,
+                    text: await renderReply("updated_event", fallback, {
+                        event,
+                        targetEvent,
+                    }),
+                    data: toActionData(event),
+                });
+            }
+            if (subaction === "delete_event") {
+                if (!google.hasCalendarWrite) {
+                    return respond({
+                        success: false,
+                        text: calendarWriteUnavailableMessage(google),
+                    });
+                }
+                const explicitEventId = detailString(details, "eventId");
+                const calendarIdForDelete = detailString(details, "calendarId");
+                const resolvedEventId = explicitEventId;
+                let resolvedEventTitle;
+                const resolvedCalendarId = calendarIdForDelete;
+                if (!resolvedEventId) {
+                    const titleHint = searchQueries[0];
+                    if (!titleHint) {
+                        return respond({
+                            success: false,
+                            text: await renderReply("clarify_delete_event_target", "Tell me which calendar event you want to delete by title, person, place, or date.", {
+                                missing: ["target event"],
+                            }),
+                        });
+                    }
+                    const feedRequest = detailString(details, "timeMin") ||
+                        detailString(details, "timeMax") ||
+                        llmPlan.timeMin ||
+                        llmPlan.timeMax
+                        ? resolveCalendarWindow(intent, details, true, llmPlan).request
+                        : {
+                            calendarId: detailString(details, "calendarId"),
+                            timeZone: resolveCalendarTimeZone(details),
+                            ...buildWideLookupRange(resolveCalendarTimeZone(details)),
+                        };
+                    const feed = await service.getCalendarFeed(INTERNAL_URL, {
+                        mode: detailString(details, "mode"),
+                        side: detailString(details, "side"),
+                        grantId: detailString(details, "grantId"),
+                        forceSync: true,
+                        ...feedRequest,
+                    });
+                    const candidates = titleHint
+                        ? feed.events.filter((e) => normalizeText(e.title).includes(normalizeText(titleHint)))
+                        : feed.events;
+                    if (candidates.length === 0) {
+                        const fallback = titleHint
+                            ? `i couldn't find an event matching "${titleHint}" in that window.`
+                            : "i couldn't find any events to delete in that window. give me a title or a date.";
+                        return respond({
+                            success: false,
+                            text: await renderReply("delete_event_not_found", fallback, {
+                                titleHint,
+                            }),
+                        });
+                    }
+                    if (candidates.length > 1) {
+                        const fallback = buildCalendarEventDisambiguationFallback({
+                            action: "delete",
+                            candidates,
+                            titleHint,
+                        });
+                        return respond({
+                            success: false,
+                            text: await renderReply("clarify_delete_event_target", fallback, {
+                                candidateCount: candidates.length,
+                                titleHint,
+                                candidates,
+                            }),
+                        });
+                    }
+                    const targets = candidates.slice(0, 1);
+                    const deleteResults = [];
+                    for (const target of targets) {
+                        try {
+                            await service.deleteCalendarEvent(INTERNAL_URL, {
+                                mode: detailString(details, "mode"),
+                                side: detailString(details, "side"),
+                                grantId: detailString(details, "grantId"),
+                                calendarId: target.calendarId,
+                                eventId: target.externalId,
+                            });
+                            deleteResults.push({ title: target.title, ok: true });
+                        }
+                        catch (err) {
+                            deleteResults.push({
+                                title: target.title,
+                                ok: false,
+                                error: err instanceof Error ? err.message : String(err),
+                            });
+                        }
+                    }
+                    const okCount = deleteResults.filter((r) => r.ok).length;
+                    const failCount = deleteResults.length - okCount;
+                    const publicDeleteResults = deleteResults.map((result) => ({
+                        title: result.title,
+                        ok: result.ok,
+                    }));
+                    const firstDeleteResult = deleteResults.at(0);
+                    const summary = failCount === 0
+                        ? targets.length === 1
+                            ? firstDeleteResult
+                                ? `deleted "${firstDeleteResult.title}".`
+                                : "deleted that event."
+                            : `deleted ${okCount} matching events.`
+                        : okCount === 0
+                            ? `I couldn't delete those ${deleteResults.length} matching events. Try again in a bit or tell me which one to remove.`
+                            : `Deleted ${okCount} matching event${okCount === 1 ? "" : "s"}, but ${failCount} failed. Tell me which one to remove if you want me to retry individually.`;
+                    return respond({
+                        success: failCount === 0,
+                        text: await renderReply("deleted_event", summary, {
+                            deleteResults: publicDeleteResults,
+                            okCount,
+                            failCount,
+                        }),
+                    });
+                }
+                // Path: explicit eventId was given, no feed lookup needed
+                if (!resolvedEventId) {
+                    return respond({
+                        success: false,
+                        text: await renderReply("clarify_delete_event_target", "i need an event id or a title + date to delete an event.", {
+                            missing: ["event target"],
+                        }),
+                    });
+                }
+                await service.deleteCalendarEvent(INTERNAL_URL, {
+                    mode: detailString(details, "mode"),
+                    side: detailString(details, "side"),
+                    grantId: detailString(details, "grantId"),
+                    calendarId: resolvedCalendarId,
+                    eventId: resolvedEventId,
+                });
+                const fallback = resolvedEventTitle
+                    ? `deleted "${resolvedEventTitle}".`
+                    : "deleted that calendar event.";
+                return respond({
+                    success: true,
+                    text: await renderReply("deleted_event", fallback, {
+                        eventTitle: resolvedEventTitle,
+                    }),
+                });
+            }
+            if (!google.hasCalendarRead) {
+                return respond({
+                    success: false,
+                    text: calendarReadUnavailableMessage(google),
+                });
+            }
+            if (subaction === "trip_window" && tripWindowIntent) {
+                const feed = await service.getCalendarFeed(INTERNAL_URL, {
+                    mode: detailString(details, "mode"),
+                    side: detailString(details, "side"),
+                    grantId: detailString(details, "grantId"),
+                    ...resolveTripWindowRequest(details, llmPlan),
+                });
+                const itineraryEvents = resolveTripWindowEvents(feed.events, tripWindowIntent.location);
+                if (!itineraryEvents || itineraryEvents.length === 0) {
+                    const fallback = `I couldn't find a clear trip window for ${tripWindowIntent.location} in your upcoming calendar.`;
+                    return respond({
+                        success: true,
+                        text: await renderReply("trip_window_not_found", fallback, {
+                            location: tripWindowIntent.location,
+                        }),
+                        data: toActionData({
+                            ...feed,
+                            location: tripWindowIntent.location,
+                            events: [],
+                        }),
+                    });
+                }
+                const fallback = formatTripWindowResults(itineraryEvents, tripWindowIntent.location);
+                return respond({
+                    success: true,
+                    text: await renderReply("trip_window_results", fallback, {
+                        location: tripWindowIntent.location,
+                        events: itineraryEvents,
+                    }),
+                    data: toActionData({
+                        ...feed,
+                        location: tripWindowIntent.location,
+                        events: itineraryEvents,
+                    }),
+                });
+            }
+            // When the user explicitly asks for "all events" / "everything" / a
+            // multi-year span, broaden the lookup window past the default
+            // "today only" feed window. resolveCalendarWindow's default is too
+            // narrow for these queries — without this branch, "show all my
+            // events" returns "no events today" even when the calendar has
+            // dozens of upcoming items. We apply this regardless of whether the
+            // chat LLM picked feed or search_events because both subactions go
+            const baseResolved = resolveCalendarWindow(intent, details, subaction === "search_events", llmPlan);
+            const request = baseResolved.request;
+            const label = baseResolved.label;
+            const hasExplicitWindow = baseResolved.explicitWindow;
+            const feed = await service.getCalendarFeed(INTERNAL_URL, {
+                mode: detailString(details, "mode"),
+                side: detailString(details, "side"),
+                grantId: detailString(details, "grantId"),
+                ...request,
+            });
+            if (subaction === "search_events") {
+                let queriesForSearch = searchQueries;
+                const recentConversation = (await collectRecentConversationTexts({
+                    runtime,
+                    message,
+                    state,
+                    limit: 8,
+                })).join("\n");
+                if (queriesForSearch.length === 0) {
+                    queriesForSearch = await recoverCalendarSearchQueriesWithLlm({
+                        runtime,
+                        currentMessage: currentMessageText,
+                        intent,
+                        recentConversation,
+                    });
+                    if (queriesForSearch.length === 0) {
+                        const groundedFromFeed = await groundCalendarSearchMatchesWithLlm(runtime, state, intent, [], buildCalendarGroundingCandidates(feed.events));
+                        if (groundedFromFeed && groundedFromFeed.length > 0) {
+                            const groundedIdSet = new Set(groundedFromFeed);
+                            const filteredEvents = feed.events.filter((event) => groundedIdSet.has(event.id));
+                            const fallback = formatCalendarSearchResults(filteredEvents, currentMessageText || intent || "your request", label);
+                            return respond({
+                                success: true,
+                                text: await renderReply("search_results", fallback, {
+                                    query: currentMessageText || intent,
+                                    queries: [],
+                                    events: filteredEvents,
+                                    label,
+                                }),
+                                data: toActionData({
+                                    ...feed,
+                                    query: currentMessageText || intent,
+                                    queries: [],
+                                    events: filteredEvents,
+                                }),
+                            });
+                        }
+                        const recoveredReadPlan = await disambiguateCalendarReadPlanWithLlm({
+                            runtime,
+                            currentMessage: currentMessageText,
+                            intent,
+                            recentConversation,
+                            candidateSubaction: "search_events",
+                        });
+                        if (recoveredReadPlan?.subaction === "feed") {
+                            const fallback = formatCalendarFeed(feed, label);
+                            return respond({
+                                success: true,
+                                text: await renderReply("feed_results", fallback, {
+                                    label,
+                                    events: feed.events,
+                                }),
+                                data: toActionData(feed),
+                            });
+                        }
+                    }
+                }
+                const query = queriesForSearch[0];
+                if (!query || queriesForSearch.length === 0) {
+                    if (hasExplicitWindow) {
+                        const fallback = formatCalendarFeed(feed, label);
+                        return respond({
+                            success: true,
+                            text: await renderReply("feed_results", fallback, {
+                                label,
+                                events: feed.events,
+                            }),
+                            data: toActionData(feed),
+                        });
+                    }
+                    return respond({
+                        success: false,
+                        text: await renderReply("clarify_calendar_search", "I couldn't infer what to look for in your calendar yet. Try naming a person, place, trip, or date.", {
+                            missing: ["search target"],
+                        }),
+                    });
+                }
+                const rankedEvents = feed.events
+                    .map((event) => {
+                    const matchedQueries = [];
+                    let score = 0;
+                    for (const candidateQuery of queriesForSearch) {
+                        const queryScore = scoreCalendarEvent(event, candidateQuery);
+                        if (queryScore > 0) {
+                            matchedQueries.push(candidateQuery);
+                            score += queryScore;
+                        }
+                    }
+                    if (matchedQueries.length > 1) {
+                        score += (matchedQueries.length - 1) * 12;
+                    }
+                    return { event, score, matchedQueries };
+                })
+                    .filter((candidate) => candidate.score > 0 && candidate.matchedQueries.length > 0)
+                    .sort((left, right) => {
+                    if (right.score !== left.score) {
+                        return right.score - left.score;
+                    }
+                    return (Date.parse(left.event.startAt) - Date.parse(right.event.startAt));
+                });
+                const strongestScore = rankedEvents[0]?.score ?? 0;
+                const strongestThreshold = strongestScore >= 30 ? Math.max(16, strongestScore - 12) : 1;
+                let filteredEvents = rankedEvents
+                    .filter((candidate) => candidate.score >= strongestThreshold)
+                    .map((candidate) => candidate.event);
+                if (shouldGroundCalendarSearchWithLlm(query, rankedEvents)) {
+                    const groundedIds = await groundCalendarSearchMatchesWithLlm(runtime, state, intent, queriesForSearch, rankedEvents.slice(0, 6));
+                    if (groundedIds) {
+                        const groundedIdSet = new Set(groundedIds);
+                        filteredEvents = rankedEvents
+                            .filter((candidate) => groundedIdSet.has(candidate.event.id))
+                            .map((candidate) => candidate.event);
+                    }
+                }
+                if (filteredEvents.length === 0 && feed.events.length > 0) {
+                    const groundedIds = await groundCalendarSearchMatchesWithLlm(runtime, state, intent, queriesForSearch, rankedEvents.length > 0
+                        ? rankedEvents.slice(0, 12)
+                        : buildCalendarGroundingCandidates(feed.events));
+                    if (groundedIds && groundedIds.length > 0) {
+                        const groundedIdSet = new Set(groundedIds);
+                        filteredEvents = feed.events.filter((event) => groundedIdSet.has(event.id));
+                    }
+                }
+                const fallback = formatCalendarSearchResults(filteredEvents, query, label);
+                return respond({
+                    success: true,
+                    text: await renderReply("search_results", fallback, {
+                        query,
+                        queries: queriesForSearch,
+                        events: filteredEvents,
+                        label,
+                    }),
+                    data: toActionData({
+                        ...feed,
+                        query,
+                        queries: queriesForSearch,
+                        events: filteredEvents,
+                    }),
+                });
+            }
+            const fallback = formatCalendarFeed(feed, label);
+            return respond({
+                success: true,
+                text: await renderReply("feed_results", fallback, {
+                    label,
+                    events: feed.events,
+                }),
+                data: toActionData(feed),
+            });
+        }
+        catch (error) {
+            if (error instanceof LifeOpsServiceError) {
+                const fallback = buildCalendarServiceErrorFallback(error, intent);
+                return respond({
+                    success: false,
+                    text: await renderReply("service_error", fallback, {
+                        status: error.status,
+                        subaction,
+                    }),
+                });
+            }
+            throw error;
+        }
+    },
+    parameters: [
+        {
+            name: "subaction",
+            description: "Calendar operation. Use search_events for flights, itinerary, travel, appointments, or keyword lookup; feed for agenda/schedule reads; next_event for the next upcoming event; create_event only when creating a new event.",
+            required: false,
+            schema: {
+                type: "string",
+                enum: [
+                    "feed",
+                    "next_event",
+                    "search_events",
+                    "create_event",
+                    "update_event",
+                    "delete_event",
+                    "trip_window",
+                ],
+            },
+        },
+        {
+            name: "intent",
+            description: 'Natural language calendar request, especially schedule or itinerary questions. Examples: "what is on my calendar today", "do i have any flights this week", "when do i fly back from denver", "create a meeting tomorrow at 3pm".',
+            required: false,
+            schema: { type: "string" },
+        },
+        {
+            name: "title",
+            description: "Event title when creating an event. Optional for read/search actions.",
+            required: false,
+            schema: { type: "string" },
+        },
+        {
+            name: "query",
+            description: "Short search phrase for search_events, such as flight, dentist, Denver, or return flight.",
+            required: false,
+            schema: { type: "string" },
+        },
+        {
+            name: "queries",
+            description: "Optional array of search phrases for search_events. The action will combine and dedupe them.",
+            required: false,
+            schema: {
+                type: "array",
+                items: { type: "string" },
+            },
+        },
+        {
+            name: "details",
+            description: "Optional structured calendar fields such as time bounds, timezone, calendar id, create-event timing, location, and attendees.",
+            required: false,
+            schema: { type: "object" },
+        },
+    ],
+    examples: [
+        [
+            {
+                name: "{{name1}}",
+                content: { text: "What's on my calendar today?" },
+            },
+            {
+                name: "{{agentName}}",
+                content: {
+                    text: "Events today:\n- **Team sync** (10:00 AM – 10:30 AM)",
+                },
+            },
+        ],
+        [
+            {
+                name: "{{name1}}",
+                content: { text: "What is my next meeting?" },
+            },
+            {
+                name: "{{agentName}}",
+                content: {
+                    text: "**Next event: Product review** (2:00 PM – 3:00 PM) — in 45 min",
+                },
+            },
+        ],
+        [
+            {
+                name: "{{name1}}",
+                content: { text: "What does my week look like?" },
+            },
+            {
+                name: "{{agentName}}",
+                content: {
+                    text: "This week's calendar includes 4 events, starting with a dentist appointment on Tuesday at 3:00 PM.",
+                },
+            },
+        ],
+        [
+            {
+                name: "{{name1}}",
+                content: { text: "Create a dentist appointment for tomorrow at 3pm." },
+            },
+            {
+                name: "{{agentName}}",
+                content: {
+                    text: 'Created calendar event "Dentist appointment" for tomorrow at 3:00 PM.',
+                },
+            },
+        ],
+        [
+            {
+                name: "{{name1}}",
+                content: {
+                    text: "Put a 1:1 with Alex on my calendar Thursday at 10am for 30 minutes.",
+                },
+            },
+            {
+                name: "{{agentName}}",
+                content: {
+                    text: 'Created calendar event "1:1 with Alex" for Thursday at 10:00 AM for 30 minutes.',
+                },
+            },
+        ],
+        [
+            {
+                name: "{{name1}}",
+                content: {
+                    text: "Need to book 1 hour per day for time with Jill. Any time is fine, ideally before sleep.",
+                },
+            },
+            {
+                name: "{{agentName}}",
+                content: {
+                    text: "I'll create a recurring daily one-hour block with Jill, placed before your sleep window when possible.",
+                },
+            },
+        ],
+        [
+            {
+                name: "{{name1}}",
+                content: {
+                    text: "Flag the conflict before my flight later and, if needed, help rebook the other thing.",
+                },
+            },
+            {
+                name: "{{agentName}}",
+                content: {
+                    text: "I'll check the flight against your calendar, flag the conflict, and help move the other commitment if it collides.",
+                },
+            },
+        ],
+    ],
+};