@agent-native/core 0.90.3 → 0.90.5

package/corpus/templates/calendar/actions/event-action-helpers.ts

@@ -60,6 +60,58 @@ export const workingLocationTypeInput = z
   .enum(["homeOffice", "officeLocation", "customLocation"])
   .optional();
 
+export const attendeeObjectInput = z.object({
+  email: z.string(),
+  displayName: z.string().optional(),
+  optional: cliBoolean.optional(),
+  comment: z.string().optional(),
+  responseStatus: z
+    .enum(["accepted", "declined", "tentative", "needsAction"])
+    .optional(),
+  organizer: cliBoolean.optional(),
+  self: cliBoolean.optional(),
+});
+
+export const attendeesInput = z.union([
+  z.array(attendeeObjectInput),
+  z.string(),
+]);
+
+export type NormalizedAttendee = {
+  email: string;
+  displayName?: string;
+  optional?: boolean;
+  comment?: string;
+  responseStatus?: "accepted" | "declined" | "tentative" | "needsAction";
+  organizer?: boolean;
+  self?: boolean;
+};
+
+export function normalizeAttendees(
+  input: z.infer<typeof attendeesInput> | undefined,
+): NormalizedAttendee[] | undefined {
+  if (input === undefined) return undefined;
+  if (typeof input === "string") {
+    const emails = input
+      .split(/[\s,;]+/)
+      .map((s) => s.trim())
+      .filter((s) => s.length > 0 && s.includes("@"));
+    if (emails.length === 0) return [];
+    return emails.map((email) => ({ email }));
+  }
+  return input
+    .filter((a) => a.email && a.email.includes("@"))
+    .map((a) => ({
+      email: a.email,
+      ...(a.displayName ? { displayName: a.displayName } : {}),
+      ...(a.optional === true ? { optional: true } : {}),
+      ...(a.comment ? { comment: a.comment } : {}),
+      ...(a.responseStatus ? { responseStatus: a.responseStatus } : {}),
+      ...(a.organizer === true ? { organizer: true } : {}),
+      ...(a.self === true ? { self: true } : {}),
+    }));
+}
+
 export function requireActionUserEmail(): string {
   const email = getRequestUserEmail();
   if (!email) throw new Error("no authenticated user");

package/corpus/templates/calendar/actions/manage-event-draft.ts

@@ -11,11 +11,13 @@ import { z } from "zod";
 import type { CalendarEventDraft } from "../shared/api.js";
 import {
   attachmentsInput,
+  attendeesInput,
   availabilityInput,
   buildReminderOverrides,
   cliBoolean,
   eventTypeInput,
   googleColorIdInput,
+  normalizeAttendees,
   reminderMethodInput,
   reminderMinutesInput,
   remindersInput,
@@ -25,18 +27,6 @@ import {
 
 const DRAFT_PREFIX = "calendar-draft-";
 
-const attendeesInput = z
-  .union([
-    z.array(
-      z.object({
-        email: z.string(),
-        displayName: z.string().optional(),
-      }),
-    ),
-    z.string(),
-  ])
-  .optional();
-
 function sanitizeDraftId(id: string): string | null {
   return /^[a-zA-Z0-9_-]{1,64}$/.test(id) ? id : null;
 }
@@ -45,25 +35,6 @@ function draftKey(id: string) {
   return `${DRAFT_PREFIX}${id}`;
 }
 
-function normalizeAttendees(
-  input: z.infer<typeof attendeesInput>,
-): CalendarEventDraft["attendees"] | undefined {
-  if (input === undefined) return undefined;
-  if (typeof input === "string") {
-    const emails = input
-      .split(/[\s,;]+/)
-      .map((s) => s.trim())
-      .filter((s) => s.length > 0 && s.includes("@"));
-    return emails.map((email) => ({ email }));
-  }
-  return input
-    .filter((a) => a.email && a.email.includes("@"))
-    .map((a) => ({
-      email: a.email,
-      ...(a.displayName ? { displayName: a.displayName } : {}),
-    }));
-}
-
 /**
  * Deep link that reopens an unsent calendar event draft.
  *
@@ -166,9 +137,11 @@ export default defineAction({
       .optional()
       .describe("Preselect Google Meet for this draft"),
     addZoom: cliBoolean.optional().describe("Preselect Zoom for this draft"),
-    attendees: attendeesInput.describe(
-      "Invitees — either an array of {email, displayName?} or a comma-separated string of emails",
-    ),
+    attendees: attendeesInput
+      .optional()
+      .describe(
+        "Invitees — either an array of {email, displayName?, optional?} or a comma-separated string of emails. Set optional:true to mark a guest optional.",
+      ),
     accountEmail: z
       .string()
       .optional()

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

@@ -11,9 +11,11 @@ import type { CalendarEvent } from "../shared/api.js";
 import {
   availabilityInput,
   attachmentsInput,
+  attendeesInput,
   buildReminderOverrides,
   cliBoolean,
   googleColorIdInput,
+  normalizeAttendees,
   normalizeGoogleEventId,
   normalizeRecurrence,
   reminderMethodInput,
@@ -24,27 +26,6 @@ import {
   visibilityInput,
 } from "./event-action-helpers.js";
 
-const attendeeInput = z.object({
-  email: z.string(),
-  displayName: z.string().optional(),
-});
-
-const attendeesInput = z.union([z.array(attendeeInput), z.string()]);
-
-function normalizeAttendees(
-  input: z.infer<typeof attendeesInput> | undefined,
-): CalendarEvent["attendees"] | undefined {
-  if (input === undefined) return undefined;
-  if (typeof input === "string") {
-    const emails = input
-      .split(/[\s,;]+/)
-      .map((s) => s.trim())
-      .filter((s) => s.length > 0 && s.includes("@"));
-    return emails.map((email) => ({ email }));
-  }
-  return input.filter((a) => a.email && a.email.includes("@"));
-}
-
 function mergeAttendees(
   existing: CalendarEvent["attendees"] | undefined,
   additions: CalendarEvent["attendees"] | undefined,
@@ -71,6 +52,12 @@ function mergeAttendees(
       email,
       displayName: attendee.displayName ?? current?.displayName,
       photoUrl: attendee.photoUrl ?? current?.photoUrl,
+      optional:
+        attendee.optional === true
+          ? true
+          : attendee.optional === false
+            ? undefined
+            : current?.optional,
     });
   }
 
@@ -157,12 +144,12 @@ export default defineAction({
     attendees: attendeesInput
       .optional()
       .describe(
-        "Replace the event's attendee list. Accepts an array of {email, displayName?} or a comma-separated string of emails. Pass an empty array to clear all attendees.",
+        "Replace the event's attendee list. Accepts an array of {email, displayName?, optional?} or a comma-separated string of emails. Pass an empty array to clear all attendees. Set optional:true to mark a guest optional.",
       ),
     addAttendees: attendeesInput
       .optional()
       .describe(
-        "Add invitees without dropping or resetting existing attendees. Accepts an array of {email, displayName?} or a comma-separated string of emails.",
+        "Add invitees without dropping or resetting existing attendees. Accepts an array of {email, displayName?, optional?} or a comma-separated string of emails. Set optional:true to mark a newly added guest optional.",
       ),
     sendUpdates: z
       .enum(["all", "none"])

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

@@ -1,6 +1,7 @@
 import { useT } from "@agent-native/core/client";
 import {
   IconAddressBook,
+  IconDots,
   IconLoader2,
   IconUserCircle,
   IconUsersGroup,
@@ -18,6 +19,12 @@ import {
 } from "react";
 
 import { Button } from "@/components/ui/button";
+import {
+  DropdownMenu,
+  DropdownMenuContent,
+  DropdownMenuItem,
+  DropdownMenuTrigger,
+} from "@/components/ui/dropdown-menu";
 import {
   Popover,
   PopoverAnchor,
@@ -39,6 +46,7 @@ export interface AttendeeRecipient {
   email: string;
   displayName?: string;
   photoUrl?: string;
+  optional?: boolean;
 }
 
 export interface AttendeeAutocompleteHandle {
@@ -50,6 +58,7 @@ interface AttendeeAutocompleteProps {
   selectedEmails?: string[];
   onAdd: (attendee: AttendeeRecipient) => void;
   onRemove?: (email: string) => void;
+  onToggleOptional?: (email: string, optional: boolean) => void;
   inputId?: string;
   placeholder?: string;
   autoFocus?: boolean;
@@ -116,6 +125,7 @@ export const AttendeeAutocomplete = forwardRef<
     selectedEmails,
     onAdd,
     onRemove,
+    onToggleOptional,
     inputId,
     placeholder = "Add guests",
     autoFocus,
@@ -208,6 +218,8 @@ export const AttendeeAutocomplete = forwardRef<
         email,
         displayName,
         photoUrl: person.photoUrl,
+        optional:
+          "optional" in person && person.optional === true ? true : undefined,
       });
       setInputValue("");
       setOpen(false);
@@ -348,6 +360,41 @@ export const AttendeeAutocomplete = forwardRef<
                   <span className="truncate">
                     {attendee.displayName || attendee.email}
                   </span>
+                  {attendee.optional && (
+                    <span className="shrink-0 text-[10px] text-muted-foreground">
+                      {t("attendees.optionalBadge")}
+                    </span>
+                  )}
+                  {onToggleOptional && (
+                    <DropdownMenu>
+                      <DropdownMenuTrigger asChild>
+                        <button
+                          type="button"
+                          onClick={(event) => event.stopPropagation()}
+                          className="text-muted-foreground hover:text-foreground"
+                          aria-label={t("attendees.guestOptions", {
+                            email: attendee.email,
+                          })}
+                        >
+                          <IconDots className="h-3 w-3" />
+                        </button>
+                      </DropdownMenuTrigger>
+                      <DropdownMenuContent
+                        align="start"
+                        onClick={(event) => event.stopPropagation()}
+                      >
+                        <DropdownMenuItem
+                          onSelect={() =>
+                            onToggleOptional(attendee.email, !attendee.optional)
+                          }
+                        >
+                          {attendee.optional
+                            ? t("attendees.markRequired")
+                            : t("attendees.markOptional")}
+                        </DropdownMenuItem>
+                      </DropdownMenuContent>
+                    </DropdownMenu>
+                  )}
                   {onRemove && (
                     <button
                       type="button"

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

@@ -111,6 +111,12 @@ function uniqueAttendees(attendees: AttendeeRecipient[]) {
       email,
       displayName: existing?.displayName ?? attendee.displayName,
       photoUrl: existing?.photoUrl ?? attendee.photoUrl,
+      optional:
+        attendee.optional === true
+          ? true
+          : existing?.optional === true
+            ? true
+            : undefined,
     });
   }
   return Array.from(byEmail.values());
@@ -304,6 +310,7 @@ export function CreateEventPopover({
             email: attendee.email,
             displayName: attendee.displayName,
             photoUrl: attendee.photoUrl,
+            optional: attendee.optional === true ? true : undefined,
           })),
         ),
       );
@@ -393,6 +400,7 @@ export function CreateEventPopover({
           ? attendees.map((attendee) => ({
               email: attendee.email,
               displayName: attendee.displayName,
+              ...(attendee.optional === true ? { optional: true } : {}),
             }))
           : undefined,
       addGoogleMeet: videoProvider === "google_meet",
@@ -494,6 +502,19 @@ export function CreateEventPopover({
     );
   }
 
+  function toggleAttendeeOptional(email: string, optional: boolean) {
+    setAttendees((prev) =>
+      prev.map((attendee) =>
+        attendee.email.toLowerCase() === email.toLowerCase()
+          ? {
+              ...attendee,
+              optional: optional ? true : undefined,
+            }
+          : attendee,
+      ),
+    );
+  }
+
   const effectiveAllDay = allDay && !timedOnlyStatus;
   const currentStartISO =
     !effectiveAllDay && date && startTime
@@ -639,6 +660,7 @@ export function CreateEventPopover({
           ? finalAttendees.map((attendee) => ({
               email: attendee.email,
               displayName: attendee.displayName,
+              ...(attendee.optional === true ? { optional: true } : {}),
             }))
           : undefined,
     };
@@ -925,6 +947,7 @@ export function CreateEventPopover({
                 attendees={attendees}
                 onAdd={addAttendee}
                 onRemove={removeAttendee}
+                onToggleOptional={toggleAttendeeOptional}
                 inputId="event-attendees"
                 placeholder={t("eventForm.attendeesPlaceholder")}
                 onEmptyEnter={() => formRef.current?.requestSubmit()}

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

@@ -1,10 +1,16 @@
 import { useT } from "@agent-native/core/client";
 import type { CalendarEvent } from "@shared/api";
-import { IconMessageCircle, IconUser } from "@tabler/icons-react";
+import { IconDots, IconMessageCircle, IconUser } from "@tabler/icons-react";
 import { useEffect, useId, useMemo, useState } from "react";
 
 import { AttendeeApolloPopover } from "@/components/calendar/ApolloPanel";
 import { Button } from "@/components/ui/button";
+import {
+  DropdownMenu,
+  DropdownMenuContent,
+  DropdownMenuItem,
+  DropdownMenuTrigger,
+} from "@/components/ui/dropdown-menu";
 import { Label } from "@/components/ui/label";
 import {
   Popover,
@@ -343,6 +349,8 @@ function AttendeeRow({
   currentNote,
   onResponseChange,
   isRecurring,
+  canEditOptional,
+  onToggleOptional,
 }: {
   attendee: Attendee;
   event: Pick<CalendarEvent, "id" | "accountEmail">;
@@ -352,15 +360,19 @@ function AttendeeRow({
   currentNote?: string;
   onResponseChange?: (status: RsvpStatus, note: string) => void;
   isRecurring?: boolean;
+  canEditOptional?: boolean;
+  onToggleOptional?: (email: string, optional: boolean) => void;
 }) {
   const t = useT();
   const displayStatus = inlineRsvp ? currentStatus : attendee.responseStatus;
   const statusLabel =
     getLocalizedRsvpStatusLabel(t, displayStatus) ?? t("eventForm.awaiting");
   const comment = (inlineRsvp ? currentNote : attendee.comment)?.trim();
+  const showOptionalMenu =
+    canEditOptional && onToggleOptional && !attendee.organizer;
 
   return (
-    <div className="rounded-xl px-1 py-1 transition-colors hover:bg-muted/40">
+    <div className="group rounded-xl px-1 py-1 transition-colors hover:bg-muted/40">
       <AttendeeApolloPopover attendee={attendee}>
         <div className="flex items-center gap-2.5">
           <div className="relative shrink-0">
@@ -379,6 +391,11 @@ function AttendeeRow({
                   {t("eventForm.organizer")}
                 </span>
               )}
+              {attendee.optional && !attendee.organizer && (
+                <span className="shrink-0 rounded bg-muted px-1.5 py-0.5 text-[10px] font-medium text-muted-foreground">
+                  {t("attendees.optionalBadge")}
+                </span>
+              )}
             </div>
             {attendee.displayName && (
               <div className="truncate text-[11px] text-muted-foreground/60">
@@ -391,6 +408,38 @@ function AttendeeRow({
                 : statusLabel}
             </div>
           </div>
+          {showOptionalMenu && (
+            <DropdownMenu>
+              <DropdownMenuTrigger asChild>
+                <Button
+                  type="button"
+                  variant="ghost"
+                  size="icon"
+                  className="h-7 w-7 shrink-0 text-muted-foreground opacity-0 transition-opacity group-hover:opacity-100 focus-visible:opacity-100 data-[state=open]:opacity-100"
+                  aria-label={t("attendees.guestOptions", {
+                    email: attendee.email,
+                  })}
+                  onClick={(event) => event.stopPropagation()}
+                >
+                  <IconDots className="h-3.5 w-3.5" />
+                </Button>
+              </DropdownMenuTrigger>
+              <DropdownMenuContent
+                align="end"
+                onClick={(event) => event.stopPropagation()}
+              >
+                <DropdownMenuItem
+                  onSelect={() =>
+                    onToggleOptional(attendee.email, !attendee.optional)
+                  }
+                >
+                  {attendee.optional
+                    ? t("attendees.markRequired")
+                    : t("attendees.markOptional")}
+                </DropdownMenuItem>
+              </DropdownMenuContent>
+            </DropdownMenu>
+          )}
         </div>
         {comment && (
           <div className="ml-10 mt-1 flex items-start gap-1.5 rounded-md bg-muted/40 px-2 py-1 text-[11px] leading-relaxed text-muted-foreground">
@@ -425,6 +474,8 @@ function sortAttendees(attendees: Attendee[]) {
 
 export function EventAttendeesSection({
   event,
+  canEditOptional = false,
+  onToggleOptional,
 }: {
   event: Pick<
     CalendarEvent,
@@ -436,6 +487,8 @@ export function EventAttendeesSection({
     | "source"
     | "recurringEventId"
   >;
+  canEditOptional?: boolean;
+  onToggleOptional?: (email: string, optional: boolean) => void;
 }) {
   const t = useT();
   const attendees = event.attendees ?? [];
@@ -523,6 +576,8 @@ export function EventAttendeesSection({
                 attendee={attendee}
                 event={event}
                 photoUrl={photos?.[attendee.email.toLowerCase()]}
+                canEditOptional={canEditOptional}
+                onToggleOptional={onToggleOptional}
               />
             ))}
 
@@ -557,6 +612,8 @@ export function EventAttendeesSection({
                   currentNote={selfNote}
                   onResponseChange={handleSelfResponseChange}
                   isRecurring={!!event.recurringEventId}
+                  canEditOptional={canEditOptional}
+                  onToggleOptional={onToggleOptional}
                 />
               </>
             )}

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

@@ -185,6 +185,41 @@ export function EventDetailPanel({
     })();
   }, [event, promptGuestNotification, updateEvent]);
 
+  const handleToggleAttendeeOptional = useCallback(
+    (email: string, optional: boolean) => {
+      if (!event || updateEvent.isPending) return;
+      const existing = event.attendees || [];
+      const key = email.trim().toLowerCase();
+      if (!existing.some((attendee) => attendee.email.toLowerCase() === key)) {
+        return;
+      }
+      const attendees = existing.map((attendee) =>
+        attendee.email.toLowerCase() === key
+          ? {
+              ...attendee,
+              optional: optional ? true : undefined,
+            }
+          : attendee,
+      );
+      void (async () => {
+        const updates = { attendees };
+        const guestNotification = await promptGuestNotification({
+          event,
+          action: "update",
+          updates,
+        });
+        if (!guestNotification) return;
+        updateEvent.mutate({
+          id: event.id,
+          accountEmail: event.accountEmail,
+          ...updates,
+          ...guestNotification,
+        });
+      })();
+    },
+    [event, promptGuestNotification, updateEvent],
+  );
+
   return (
     <TooltipProvider>
       {isOpen && (
@@ -414,7 +449,11 @@ export function EventDetailPanel({
 
                 {/* Attendees */}
                 {event.attendees && event.attendees.length > 0 && (
-                  <EventAttendeesSection event={event} />
+                  <EventAttendeesSection
+                    event={event}
+                    canEditOptional={!isOverlay}
+                    onToggleOptional={handleToggleAttendeeOptional}
+                  />
                 )}
 
                 {/* Research Meeting */}

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

@@ -294,6 +294,12 @@ function mergeAttendeesForPrompt(
       email,
       displayName: attendee.displayName ?? current?.displayName,
       photoUrl: attendee.photoUrl ?? current?.photoUrl,
+      optional:
+        attendee.optional === true
+          ? true
+          : attendee.optional === false
+            ? undefined
+            : current?.optional,
     });
   }
 
@@ -939,6 +945,7 @@ export function EventDetailPopover({
           email: attendee.email,
           displayName: attendee.displayName,
           photoUrl: attendee.photoUrl,
+          optional: attendee.optional === true ? true : undefined,
         })),
     [event.accountEmail, event.attendees],
   );
@@ -1004,6 +1011,7 @@ export function EventDetailPopover({
         email,
         displayName: attendee.displayName,
         photoUrl: attendee.photoUrl,
+        ...(attendee.optional === true ? { optional: true as const } : {}),
       };
 
       if (isDraft) {
@@ -1015,6 +1023,27 @@ export function EventDetailPopover({
     [event.attendees, isDraft, saveField],
   );
 
+  const handleToggleAttendeeOptional = useCallback(
+    (email: string, optional: boolean) => {
+      const existing = event.attendees || [];
+      const key = email.trim().toLowerCase();
+      if (!existing.some((attendee) => attendee.email.toLowerCase() === key)) {
+        return;
+      }
+      saveField({
+        attendees: existing.map((attendee) =>
+          attendee.email.toLowerCase() === key
+            ? {
+                ...attendee,
+                optional: optional ? true : undefined,
+              }
+            : attendee,
+        ),
+      });
+    },
+    [event.attendees, saveField],
+  );
+
   const handleSaveMeetingLink = useCallback(() => {
     const url = editMeetingLink.trim();
     let saved = false;
@@ -1606,7 +1635,11 @@ export function EventDetailPopover({
 
             {/* Attendees — always shown */}
             {event.attendees && event.attendees.length > 0 ? (
-              <EventAttendeesSection event={event} />
+              <EventAttendeesSection
+                event={event}
+                canEditOptional={!isOverlay}
+                onToggleOptional={handleToggleAttendeeOptional}
+              />
             ) : !isOverlay ? (
               <div className="px-4 py-1">
                 <div className="flex items-start gap-3">

package/corpus/templates/calendar/app/hooks/use-events.ts

@@ -136,6 +136,12 @@ export function mergeAttendeeLists(
       email,
       displayName: attendee.displayName ?? current?.displayName,
       photoUrl: attendee.photoUrl ?? current?.photoUrl,
+      optional:
+        attendee.optional === true
+          ? true
+          : attendee.optional === false
+            ? undefined
+            : current?.optional,
     });
   }
 

package/corpus/templates/calendar/app/i18n/zh-TW.ts

@@ -126,7 +126,11 @@ const messages = {
     contacts: "聯絡人",
     contactsReconnect: "需要重新連線聯絡人或目錄存取權限。",
     directory: "目錄",
+    guestOptions: "{{email}} 的來賓選項",
     inviteEmail: "邀請 {{email}}",
+    markOptional: "標為可選",
+    markRequired: "標為必選",
+    optionalBadge: "可選",
     otherContacts: "其他聯絡人",
     removeAttendee: "移除 {{email}}",
     searchingPeople: "正在搜尋人員",