@agent-native/core 0.90.2 → 0.90.4

package/corpus/templates/brain/app/routes/settings.tsx

@@ -10,12 +10,12 @@ import {
 import { TeamPage } from "@agent-native/core/client/org";
 import {
   IconAdjustments,
-  IconBuilding,
   IconDeviceFloppy,
   IconFileText,
   IconGauge,
   IconMessageCircle,
   IconShieldCheck,
+  IconUsersGroup,
 } from "@tabler/icons-react";
 import { useEffect, useMemo, useState } from "react";
 
@@ -152,7 +152,7 @@ export default function SettingsRoute() {
               <Card>
                 <CardHeader>
                   <CardTitle className="flex items-center gap-2 text-base">
-                    <IconBuilding className="size-4 text-primary" />
+                    <IconUsersGroup className="size-4 text-primary" />
                     {t("settings.identityTitle")}
                   </CardTitle>
                   <CardDescription>

package/corpus/templates/calendar/.agents/skills/event-management/SKILL.md

@@ -125,6 +125,16 @@ Use only one generated video provider per event: `--addGoogleMeet=true` or `--ad
 
 `--attendees` accepts a comma- or space-separated list of email addresses. When attendees are provided, Google sends email invitations automatically (`sendUpdates=all`). Use `--sendUpdates=none` to suppress emails.
 
+To mark a guest optional, pass attendees as a JSON array with `optional: true`:
+
+```bash
+pnpm action create-event \
+  --title "Q2 planning" \
+  --start 2026-04-03T14:00:00 \
+  --end 2026-04-03T15:00:00 \
+  --attendees '[{"email":"alice@example.com"},{"email":"bob@example.com","optional":true}]'
+```
+
 Use `--startTimeZone` / `--endTimeZone` with IANA timezone names when the event should be anchored to a specific timezone, e.g. `--startTimeZone America/Los_Angeles`.
 
 Use `--reminders '[{"method":"popup","minutes":10},{"method":"email","minutes":1440}]'` for multiple alerts. Use `--remindersUseDefault false --reminders '[]'` for no alerts.
@@ -174,6 +184,17 @@ pnpm action update-event \
   --id google-event-id \
   --attendees "alice@example.com,bob@example.com,carol@example.com"
 
+# Prefer addAttendees when inviting more people so existing RSVP metadata is preserved
+pnpm action update-event \
+  --id google-event-id \
+  --addAttendees '[{"email":"dana@example.com","optional":true}]'
+
+# Mark an existing guest optional without resetting RSVPs — fetch via get-event,
+# then pass the full attendees list with optional:true on that guest
+pnpm action update-event \
+  --id google-event-id \
+  --attendees '[{"email":"alice@example.com"},{"email":"bob@example.com","optional":true}]'
+
 # Suppress invitation emails
 pnpm action update-event --id google-event-id --attendees "alice@example.com" --sendUpdates none
 
@@ -189,7 +210,7 @@ pnpm action update-event \
   --attachments '[{"fileUrl":"https://drive.google.com/...","title":"Agenda"}]'
 ```
 
-`--attendees` REPLACES the entire attendee list — to add someone, fetch the existing attendees first via `get-event` and pass the merged list. Pass an empty string to clear all attendees.
+`--attendees` REPLACES the entire attendee list — to add someone, prefer `addAttendees` so existing RSVP notes/statuses are preserved. To change whether a guest is optional or required after the fact, fetch the current list via `get-event` and pass the full `attendees` array with `optional: true` or omit/false for required. Pass an empty string to clear all attendees.
 
 For "add Zoom to this meeting", fetch or use the visible event id and call `update-event --addZoom=true`. Do not create an extension for Zoom; Zoom is a first-party calendar integration handled by the event actions and the Settings page.
 
@@ -246,7 +267,8 @@ Events require a connected Google Calendar account. Check with `GET /_agent-nati
   "location": "Conference Room A",
   "allDay": false,
   "attendees": [
-    { "email": "alice@example.com", "displayName": "Alice", "responseStatus": "accepted" }
+    { "email": "alice@example.com", "displayName": "Alice", "responseStatus": "accepted" },
+    { "email": "bob@example.com", "displayName": "Bob", "responseStatus": "needsAction", "optional": true }
   ],
   "conferenceData": { ... },
   "hangoutLink": "https://meet.google.com/...",

package/corpus/templates/calendar/AGENTS.md

@@ -50,6 +50,9 @@ Detailed event, availability, booking, storage, and UI rules live in
   `addAttendees` so existing RSVP notes/statuses are preserved. Use
   `scope: "all"` only when the user wants a recurring-event guest change applied
   to the whole series.
+- Pass `optional: true` on an attendee object to mark someone optional when
+  creating, drafting, or adding guests. To change optional/required after the
+  fact, replace the full `attendees` list with `optional` set on that guest.
 
 ## Application State
 

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

@@ -13,11 +13,13 @@ import type { CalendarEvent } from "../shared/api.js";
 import {
   availabilityInput,
   attachmentsInput,
+  attendeesInput,
   buildReminderOverrides,
   buildStatusEventFields,
   cliBoolean,
   eventTypeInput,
   googleColorIdInput,
+  normalizeAttendees,
   reminderMethodInput,
   reminderMinutesInput,
   remindersInput,
@@ -25,36 +27,6 @@ import {
   workingLocationTypeInput,
 } from "./event-action-helpers.js";
 
-// Accept attendees as either an array of {email, displayName?} objects (when
-// invoked via JSON) or a comma/whitespace-separated string of emails (when
-// invoked from the CLI as `--attendees alice@x.com,bob@y.com`).
-const attendeesInput = z
-  .union([
-    z.array(
-      z.object({
-        email: z.string(),
-        displayName: z.string().optional(),
-      }),
-    ),
-    z.string(),
-  ])
-  .optional();
-
-function normalizeAttendees(
-  input: z.infer<typeof attendeesInput>,
-): Array<{ email: string; displayName?: string }> | undefined {
-  if (!input) 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 undefined;
-    return emails.map((email) => ({ email }));
-  }
-  return input.filter((a) => a.email && a.email.includes("@"));
-}
-
 export default defineAction({
   description: "Create a calendar event on Google Calendar",
   schema: z.object({
@@ -118,9 +90,11 @@ export default defineAction({
       .describe(
         "Create and attach a Zoom meeting link to the event. Requires Zoom to be connected in Settings.",
       ),
-    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.",
+      ),
     sendUpdates: z
       .enum(["all", "externalOnly", "none"])
       .optional()
@@ -214,7 +188,7 @@ export default defineAction({
 
     const result = await googleCalendar.createEvent(calEvent, {
       addGoogleMeet: args.addGoogleMeet,
-      sendUpdates: args.sendUpdates ?? (attendees ? "all" : undefined),
+      sendUpdates: args.sendUpdates ?? (attendees?.length ? "all" : undefined),
     });
     if (result.id) {
       calEvent.id = `google-${result.id}`;

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,9 +1,10 @@
 import { useT } from "@agent-native/core/client";
 import {
   IconAddressBook,
-  IconBuilding,
+  IconDots,
   IconLoader2,
   IconUserCircle,
+  IconUsersGroup,
   IconX,
 } from "@tabler/icons-react";
 import {
@@ -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,
@@ -25,7 +32,9 @@ import {
 } from "@/components/ui/popover";
 import {
   filterPeopleResults,
+  mergePeopleResults,
   usePeopleContacts,
+  usePeopleSearch,
   type PeopleSearchResult,
 } from "@/hooks/use-people";
 import { isMcpEmbedSurface } from "@/lib/mcp-embed";
@@ -37,6 +46,7 @@ export interface AttendeeRecipient {
   email: string;
   displayName?: string;
   photoUrl?: string;
+  optional?: boolean;
 }
 
 export interface AttendeeAutocompleteHandle {
@@ -48,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;
@@ -87,7 +98,7 @@ function sourceLabel(
 
 function SourceIcon({ source }: { source?: PeopleSearchResult["source"] }) {
   if (source === "directory") {
-    return <IconBuilding className="h-3 w-3" />;
+    return <IconUsersGroup className="h-3 w-3" />;
   }
   return <IconAddressBook className="h-3 w-3" />;
 }
@@ -114,6 +125,7 @@ export const AttendeeAutocomplete = forwardRef<
     selectedEmails,
     onAdd,
     onRemove,
+    onToggleOptional,
     inputId,
     placeholder = "Add guests",
     autoFocus,
@@ -129,10 +141,15 @@ export const AttendeeAutocomplete = forwardRef<
 ) {
   const t = useT();
   const [inputValue, setInputValue] = useState("");
+  const [searchQuery, setSearchQuery] = useState("");
   const [open, setOpen] = useState(false);
   const [activeIndex, setActiveIndex] = useState(0);
   const inputRef = useRef<HTMLInputElement>(null);
   const contacts = usePeopleContacts();
+  const peopleSearch = usePeopleSearch(
+    searchQuery,
+    inputValue.trim().length > 0,
+  );
 
   const selectedEmailSet = useMemo(
     () =>
@@ -144,19 +161,38 @@ export const AttendeeAutocomplete = forwardRef<
     [attendees, selectedEmails],
   );
 
+  useEffect(() => {
+    const timeout = window.setTimeout(
+      () => setSearchQuery(inputValue),
+      inputValue.trim() ? 300 : 0,
+    );
+    return () => window.clearTimeout(timeout);
+  }, [inputValue]);
+
   const visibleResults = useMemo(
     () =>
       filterPeopleResults(
-        contacts.data?.results ?? [],
+        mergePeopleResults(contacts.data?.results, peopleSearch.data?.results),
         inputValue,
         selectedEmailSet,
       ),
-    [contacts.data?.results, inputValue, selectedEmailSet],
+    [
+      contacts.data?.results,
+      inputValue,
+      peopleSearch.data?.results,
+      selectedEmailSet,
+    ],
   );
 
   const canAddManual = parseEmails(inputValue).length > 0;
-  const searching = contacts.isLoading || contacts.isFetching;
-  const scopeRequired = Boolean(contacts.data?.scopeRequired);
+  const searching =
+    contacts.isLoading ||
+    contacts.isFetching ||
+    peopleSearch.isLoading ||
+    peopleSearch.isFetching;
+  const scopeRequired = Boolean(
+    contacts.data?.scopeRequired || peopleSearch.data?.scopeRequired,
+  );
   const shouldShowPopover =
     open &&
     inputValue.trim().length > 0 &&
@@ -182,6 +218,8 @@ export const AttendeeAutocomplete = forwardRef<
         email,
         displayName,
         photoUrl: person.photoUrl,
+        optional:
+          "optional" in person && person.optional === true ? true : undefined,
       });
       setInputValue("");
       setOpen(false);
@@ -322,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()}