@agent-native/core 0.92.4 → 0.92.6

package/corpus/templates/assets/changelog/2026-07-07-preset-skeleton-controls-fit-correctly-on-narrower-edit-page.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-07
+---
+
+Preset skeleton controls fit correctly on narrower edit pages.

package/corpus/templates/assets/changelog/2026-07-09-import-reference-images-from-url.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-07-09
+---
+
+Import reference images into a brand kit directly from a URL - the agent can now ingest blog or web imagery as style, logo, or subject references.

package/corpus/templates/assets/changelog/2026-07-09-preset-reference-board.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-07-09
+---
+
+Presets now have a reference board: pin annotated photos (like your usual host) and mark per-event slots to fill when generating.

package/corpus/templates/assets/server/handlers/assets.ts

@@ -18,16 +18,18 @@ import { IMAGE_CATEGORIES, MAX_ASSET_UPLOAD_FILES } from "../../shared/api.js";
 import type { ImageCategory, ImageRole } from "../../shared/api.js";
 import { getDb, schema } from "../db/index.js";
 import { createAssetFromBuffer, mediaTypeFromMime } from "../lib/assets.js";
-import {
-  hasRasterImageSignature,
-  hasVideoSignature,
-} from "../lib/image-processing.js";
 import { nowIso, parseJson, stringifyJson } from "../lib/json.js";
 import { getObject } from "../lib/storage.js";
 import {
   filterDuplicateAssetUploads,
   hashAssetBuffer,
 } from "../lib/upload-dedupe.js";
+import {
+  hasAllowedSignature,
+  IMAGE_MIME_TYPES,
+  maxUploadBytesForMediaType,
+  VIDEO_MIME_TYPES,
+} from "../lib/upload-validation.js";
 
 const MIME_BY_EXT: Record<string, string> = {
   png: "image/png",
@@ -41,20 +43,6 @@ const MIME_BY_EXT: Record<string, string> = {
   webm: "video/webm",
 };
 
-const IMAGE_MIME_TYPES = new Set([
-  "image/png",
-  "image/jpeg",
-  "image/webp",
-  "image/avif",
-]);
-
-const VIDEO_MIME_TYPES = new Set([
-  "video/mp4",
-  "video/x-m4v",
-  "video/quicktime",
-  "video/webm",
-]);
-
 const UPLOAD_CONCURRENCY = 3;
 
 /**
@@ -117,13 +105,6 @@ function defaultUploadTitle(
   return mediaType === "video" ? "Reference video" : "Reference image";
 }
 
-function hasAllowedSignature(mimeType: string, data: Uint8Array): boolean {
-  if (IMAGE_MIME_TYPES.has(mimeType))
-    return hasRasterImageSignature(mimeType, data);
-  if (VIDEO_MIME_TYPES.has(mimeType)) return hasVideoSignature(mimeType, data);
-  return false;
-}
-
 async function assertCollectionBelongsToLibrary(
   collectionId: string,
   libraryId: string,
@@ -213,8 +194,7 @@ export const uploadAssets = defineEventHandler(async (event) =>
     for (const part of files) {
       const mimeType = cleanMime(part.type, part.filename);
       const mediaType = mediaTypeFromMime(mimeType);
-      const maxBytes =
-        mediaType === "video" ? 250 * 1024 * 1024 : 25 * 1024 * 1024;
+      const maxBytes = maxUploadBytesForMediaType(mediaType);
       if (part.data.byteLength > maxBytes) {
         setResponseStatus(event, 413);
         return {

package/corpus/templates/assets/server/lib/generation.ts

@@ -16,6 +16,7 @@ import type {
   ImageModel,
   ImageQualityTier,
   ImageSize,
+  PresetReferenceRole,
   StyleStrength,
   StyleBrief,
 } from "../../shared/api.js";
@@ -29,7 +30,13 @@ export interface ReferenceForGeneration {
   category?: string;
   mimeType: string;
   data: string;
-  selectionReason?: "subject" | "source" | "anchor" | "scored" | "explicit";
+  selectionReason?:
+    | "subject"
+    | "source"
+    | "anchor"
+    | "scored"
+    | "explicit"
+    | `preset-ref:${string}`;
 }
 
 // Keep automatic reference context compact for Gemini. Explicit
@@ -56,6 +63,7 @@ export interface GenerateProviderInput {
   collectionId?: string | null;
   source?: "chat" | "ui" | "a2a";
   callerAppId?: string;
+  hasBoardReferences?: boolean;
 }
 
 export interface GenerateProviderOutput {
@@ -645,6 +653,7 @@ export async function generateWithManagedImageProvider(
     if (
       shouldFallback &&
       input.mode !== "edit" &&
+      !(input.hasBoardReferences && input.model.startsWith("gpt-")) &&
       (await isManualImageGenerationConfigured())
     ) {
       logGeneration("builder.fallback_to_manual", {
@@ -939,9 +948,30 @@ async function generateWithManualImageProvider(
         "Mask inpainting runs need Builder-managed image generation because the manual fallback cannot pass the image-edit mask.",
     });
   }
+  // Board-reference runs on gpt-* models must not reroute into the Gemini
+  // fallback: Gemini rejects GPT model ids, which would surface a cryptic
+  // provider error instead of this setup guidance.
+  if (input.hasBoardReferences && input.model.startsWith("gpt-")) {
+    throw new FeatureNotConfiguredError({
+      requiredCredential: "BUILDER_PRIVATE_KEY",
+      builderConnectUrl: "/_agent-native/builder/connect",
+      byokDocsUrl: "https://aistudio.google.com/apikey",
+      message:
+        "This preset attaches reference board images, which the manual OpenAI fallback cannot pass. Connect Builder.io managed generation, or switch the preset to a Gemini model with a GEMINI_API_KEY.",
+    });
+  }
   if (await isGeminiImageGenerationConfigured()) {
     return generateWithGemini(input);
   }
+  if (input.hasBoardReferences) {
+    throw new FeatureNotConfiguredError({
+      requiredCredential: "BUILDER_PRIVATE_KEY or GEMINI_API_KEY",
+      builderConnectUrl: "/_agent-native/builder/connect",
+      byokDocsUrl: "https://aistudio.google.com/apikey",
+      message:
+        "This preset attaches reference board images, which the manual OpenAI fallback cannot pass. Connect Builder.io managed generation, or switch the preset to a Gemini model with a GEMINI_API_KEY.",
+    });
+  }
   if (input.intent === "restyle" || input.intent === "edit") {
     throw new FeatureNotConfiguredError({
       requiredCredential: "GEMINI_API_KEY",
@@ -957,6 +987,15 @@ async function generateWithManualImageProvider(
 export async function generateWithOpenAI(
   input: GenerateProviderInput,
 ): Promise<GenerateProviderOutput> {
+  if (input.hasBoardReferences) {
+    throw new FeatureNotConfiguredError({
+      requiredCredential: "BUILDER_PRIVATE_KEY or GEMINI_API_KEY",
+      builderConnectUrl: "/_agent-native/builder/connect",
+      byokDocsUrl: "https://aistudio.google.com/apikey",
+      message:
+        "This preset attaches reference board images, which the manual OpenAI fallback cannot pass. Connect Builder.io managed generation, or switch the preset to a Gemini model with a GEMINI_API_KEY.",
+    });
+  }
   const startedAt = Date.now();
   const model = openAIImageModelForInput(input.model);
   logGeneration("openai.request", {
@@ -1211,6 +1250,12 @@ export function compilePrompt(input: {
   category?: ImageCategory;
   intent?: GenerationIntent;
   styleStrength?: StyleStrength;
+  referenceBoard?: Array<{
+    label: string;
+    role: PresetReferenceRole;
+    count: number;
+    description?: string;
+  }>;
 }): string {
   const style = input.styleBrief;
   const intent = input.intent ?? "generate";
@@ -1257,6 +1302,7 @@ export function compilePrompt(input: {
         : input.referenceCount > 0
           ? `Use the ${input.referenceCount} attached reference image${input.referenceCount === 1 ? "" : "s"} as visual evidence. Treat them by role: style references define visual language, logo/product references define accurate brand/product appearance, background references define fixed composition plates/layout only, mask references define editable regions only, subject/source references provide content or composition only, and prior candidates define continuity. Subject/source/background/mask references must not override the library style brief or custom instructions.`
           : "No reference images are attached for this run. Use the style brief and custom instructions as the source of truth.";
+  const referenceBoardBlock = formatReferenceBoardBlock(input.referenceBoard);
 
   if (intent === "edit") {
     const editTypographyInstruction =
@@ -1270,6 +1316,7 @@ export function compilePrompt(input: {
     return `Edit the attached image for the "${input.libraryTitle}" asset library.
 
 ${referenceInstruction}
+${referenceBoardBlock}
 ${editTypographyInstruction}
 
 Make only this change:
@@ -1282,6 +1329,7 @@ ${editConstraint}`;
   return `Create a brand-consistent image for the "${input.libraryTitle}" asset library.
 
 ${referenceInstruction}
+${referenceBoardBlock}
 
 Style brief:
 ${style.description || "Infer the style from the references."}${palette}
@@ -1300,6 +1348,39 @@ User request:
 ${input.prompt}`;
 }
 
+function formatReferenceBoardBlock(
+  entries?: Array<{
+    label: string;
+    role: PresetReferenceRole;
+    count: number;
+    description?: string;
+  }>,
+): string {
+  const visibleEntries = (entries ?? []).filter((entry) => entry.count > 0);
+  if (!visibleEntries.length) return "";
+  const lines = visibleEntries.map((entry) => {
+    const description =
+      entry.description?.trim() || presetReferenceRoleDefault(entry.role);
+    return `- "${entry.label}" (${entry.count} image(s), role: ${entry.role}): ${description}`;
+  });
+  return `\nPreset reference board attached to this run:\n${lines.join("\n")}`;
+}
+
+function presetReferenceRoleDefault(role: PresetReferenceRole): string {
+  switch (role) {
+    case "subject":
+      return "This is the actual person/object for this piece. Render them faithfully and recognizably; do not replace them with a generic subject.";
+    case "style":
+      return "Match this visual style; do not copy its content.";
+    case "product":
+      return "Reproduce this product accurately; do not invent variants.";
+    case "background":
+      return "Use as fixed backdrop/setting context only; do not treat it as a subject.";
+    case "composition":
+      return "Imitate this image's layout, arrangement, and framing; do not copy its content or style.";
+  }
+}
+
 function hasEmbeddedText(value?: string | null): boolean {
   return typeof value === "string" && !!value.trim();
 }
@@ -1568,7 +1649,7 @@ export function compareReferenceCandidates(
   );
 }
 
-async function loadReferenceData(
+export async function loadReferenceData(
   selected: Array<{
     id: string;
     role: string;

package/corpus/templates/assets/server/lib/preset-chat-context.ts

@@ -4,6 +4,7 @@ import { inArray } from "drizzle-orm";
 import type { StyleBrief } from "../../shared/api.js";
 import { getDb, schema } from "../db/index.js";
 import { parseJson } from "./json.js";
+import { normalizePresetReferences } from "./preset-references.js";
 
 const PRESET_REF_TYPE = "preset";
 
@@ -67,10 +68,12 @@ export async function preparePresetChatContext(args: {
 }
 
 function describePreset(preset: PresetRow, library?: LibraryRow): string {
-  const settings = parseJson<{ tier?: string; includeLogo?: boolean }>(
-    preset.settings,
-    {},
-  );
+  const settings = parseJson<{
+    tier?: string;
+    includeLogo?: boolean;
+    presetReferences?: unknown;
+  }>(preset.settings, {});
+  const presetReferences = normalizePresetReferences(settings.presetReferences);
   const style = library
     ? parseJson<StyleBrief>(library.styleBrief, {})
     : ({} as StyleBrief);
@@ -109,6 +112,16 @@ function describePreset(preset: PresetRow, library?: LibraryRow): string {
   if (style.doNot?.length) {
     lines.push(`- Avoid: ${style.doNot.join("; ")}.`);
   }
+  for (const entry of presetReferences) {
+    lines.push(
+      `- Reference "${entry.label}" (id: ${entry.id}): role ${entry.role}, ${entry.variable ? "variable" : "fixed"}${entry.required ? ", required" : ""}, ${entry.assetIds.length ? `${entry.assetIds.length} pinned image(s)` : "no images yet"}.${entry.description ? ` ${entry.description}` : ""}`,
+    );
+  }
+  if (presetReferences.some((entry) => entry.variable)) {
+    lines.push(
+      "- Before generating, collect images for required variable references (from the user's attachments or the library) and pass presetReferenceFills to generate-image / generate-image-batch. Fixed references attach automatically.",
+    );
+  }
   const customInstructions = library?.customInstructions?.trim();
   if (customInstructions) {
     lines.push(`- Brand custom instructions: ${customInstructions}`);

package/corpus/templates/assets/server/lib/preset-references.ts

@@ -0,0 +1,182 @@
+import {
+  PRESET_REFERENCE_ROLES,
+  type ImageRole,
+  type PresetReference,
+  type PresetReferenceRole,
+} from "../../shared/api.js";
+
+export const PRESET_REFERENCE_MAX_ENTRIES = 6;
+export const PRESET_REFERENCE_MAX_IMAGES_PER_ENTRY = 4;
+export const PRESET_REFERENCE_MAX_TOTAL_IMAGES = 8;
+export const PRESET_REFERENCE_MAX_SUBJECT_IMAGES = 4;
+export const PRESET_REFERENCE_TOTAL_IMAGES_ERROR =
+  "The reference board may attach at most 8 images total.";
+export const PRESET_REFERENCE_SUBJECT_IMAGES_ERROR =
+  "Subject reference entries may attach at most 4 images total.";
+
+export const PRESET_REFERENCE_ROLE_MAP: Record<PresetReferenceRole, ImageRole> =
+  {
+    subject: "subject_reference",
+    style: "style_reference",
+    product: "product_reference",
+    background: "background_reference",
+    composition: "background_reference",
+  };
+
+const ROLE_SET = new Set<string>(PRESET_REFERENCE_ROLES);
+const ENTRY_ID_RE = /^[a-z0-9][a-z0-9-]*$/;
+
+export function normalizePresetReferences(value: unknown): PresetReference[] {
+  if (!Array.isArray(value) || value.length === 0) return [];
+
+  const seenIds = new Set<string>();
+  const entries: PresetReference[] = [];
+  for (const item of value) {
+    if (!item || typeof item !== "object") continue;
+    const raw = item as Record<string, unknown>;
+    const id = typeof raw.id === "string" ? raw.id.trim() : "";
+    const label = typeof raw.label === "string" ? raw.label.trim() : "";
+    const role = raw.role;
+    if (
+      !id ||
+      !ENTRY_ID_RE.test(id) ||
+      id.length > 40 ||
+      seenIds.has(id) ||
+      !label ||
+      label.length > 60 ||
+      typeof role !== "string" ||
+      !ROLE_SET.has(role)
+    ) {
+      continue;
+    }
+    seenIds.add(id);
+    const description =
+      typeof raw.description === "string"
+        ? raw.description.trim().slice(0, 400)
+        : undefined;
+    const assetIds = Array.isArray(raw.assetIds)
+      ? uniqueStrings(raw.assetIds).slice(
+          0,
+          PRESET_REFERENCE_MAX_IMAGES_PER_ENTRY,
+        )
+      : [];
+    entries.push({
+      id,
+      label,
+      role: role as PresetReferenceRole,
+      ...(description ? { description } : {}),
+      assetIds,
+      variable: coerceBoolean(raw.variable),
+      required: coerceBoolean(raw.required),
+    });
+    if (entries.length >= PRESET_REFERENCE_MAX_ENTRIES) break;
+  }
+
+  return trimToPinnedImageCaps(entries);
+}
+
+export type ResolvedPresetReference = {
+  entry: PresetReference;
+  assetIds: string[];
+  filled: boolean;
+};
+
+export function resolvePresetReferenceFills(input: {
+  entries: PresetReference[];
+  fills?: Array<{ referenceId: string; assetIds: string[] }>;
+  presetTitle: string;
+}): ResolvedPresetReference[] {
+  const byId = new Map(input.entries.map((entry) => [entry.id, entry]));
+  const fillsById = new Map<string, string[]>();
+  for (const fill of input.fills ?? []) {
+    const entry = byId.get(fill.referenceId);
+    if (!entry) {
+      const available = input.entries.map((item) => item.id).join(", ");
+      throw new Error(
+        `Unknown reference entry "${fill.referenceId}" for preset "${input.presetTitle}". Available entries: ${available || "none"}.`,
+      );
+    }
+    if (!entry.variable) {
+      throw new Error(
+        `Reference entry "${entry.id}" is fixed by the preset designer. Edit the preset to change it, or mark it as variable.`,
+      );
+    }
+    const assetIds = uniqueStrings(fill.assetIds);
+    if (assetIds.length > PRESET_REFERENCE_MAX_IMAGES_PER_ENTRY) {
+      throw new Error(
+        `Reference entry "${entry.id}" accepts at most 4 images; got ${assetIds.length}.`,
+      );
+    }
+    fillsById.set(entry.id, assetIds);
+  }
+
+  const resolved = input.entries.map((entry) => {
+    const hasFill = fillsById.has(entry.id);
+    const assetIds = hasFill
+      ? (fillsById.get(entry.id) ?? [])
+      : uniqueStrings(entry.assetIds).slice(
+          0,
+          PRESET_REFERENCE_MAX_IMAGES_PER_ENTRY,
+        );
+    if (entry.required && assetIds.length === 0) {
+      throw new Error(
+        `Preset "${input.presetTitle}" requires image(s) for reference entry "${entry.label}" (${entry.id}). Pass them via presetReferenceFills (up to 4).`,
+      );
+    }
+    return { entry, assetIds, filled: hasFill };
+  });
+
+  assertPresetReferenceImageCaps(resolved);
+  return resolved.filter((item) => item.assetIds.length > 0);
+}
+
+export function assertPresetReferenceImageCaps(
+  entries: Array<{ entry: Pick<PresetReference, "role">; assetIds: string[] }>,
+) {
+  const total = entries.reduce((sum, item) => sum + item.assetIds.length, 0);
+  if (total > PRESET_REFERENCE_MAX_TOTAL_IMAGES) {
+    throw new Error(PRESET_REFERENCE_TOTAL_IMAGES_ERROR);
+  }
+  const subjectTotal = entries
+    .filter((item) => item.entry.role === "subject")
+    .reduce((sum, item) => sum + item.assetIds.length, 0);
+  if (subjectTotal > PRESET_REFERENCE_MAX_SUBJECT_IMAGES) {
+    throw new Error(PRESET_REFERENCE_SUBJECT_IMAGES_ERROR);
+  }
+}
+
+function trimToPinnedImageCaps(entries: PresetReference[]): PresetReference[] {
+  const trimmed = [...entries];
+  while (trimmed.length && exceedsPinnedImageCaps(trimmed)) {
+    trimmed.pop();
+  }
+  return trimmed;
+}
+
+function exceedsPinnedImageCaps(entries: PresetReference[]) {
+  const total = entries.reduce((sum, entry) => sum + entry.assetIds.length, 0);
+  const subjectTotal = entries
+    .filter((entry) => entry.role === "subject")
+    .reduce((sum, entry) => sum + entry.assetIds.length, 0);
+  return (
+    total > PRESET_REFERENCE_MAX_TOTAL_IMAGES ||
+    subjectTotal > PRESET_REFERENCE_MAX_SUBJECT_IMAGES
+  );
+}
+
+function uniqueStrings(value: unknown[]): string[] {
+  const seen = new Set<string>();
+  const output: string[] = [];
+  for (const item of value) {
+    if (typeof item !== "string") continue;
+    const trimmed = item.trim();
+    if (!trimmed || seen.has(trimmed)) continue;
+    seen.add(trimmed);
+    output.push(trimmed);
+  }
+  return output;
+}
+
+function coerceBoolean(value: unknown): boolean {
+  return value === true || value === 1 || value === "true" || value === "1";
+}

package/corpus/templates/assets/server/lib/upload-validation.ts

@@ -0,0 +1,38 @@
+import type { AssetMediaType } from "../../shared/api.js";
+import {
+  hasRasterImageSignature,
+  hasVideoSignature,
+} from "./image-processing.js";
+
+export const IMAGE_MIME_TYPES = new Set([
+  "image/png",
+  "image/jpeg",
+  "image/webp",
+  "image/avif",
+]);
+
+export const VIDEO_MIME_TYPES = new Set([
+  "video/mp4",
+  "video/x-m4v",
+  "video/quicktime",
+  "video/webm",
+]);
+
+export const MAX_IMAGE_UPLOAD_BYTES = 25 * 1024 * 1024;
+export const MAX_VIDEO_UPLOAD_BYTES = 250 * 1024 * 1024;
+
+export function maxUploadBytesForMediaType(mediaType: AssetMediaType): number {
+  return mediaType === "video"
+    ? MAX_VIDEO_UPLOAD_BYTES
+    : MAX_IMAGE_UPLOAD_BYTES;
+}
+
+export function hasAllowedSignature(
+  mimeType: string,
+  data: Uint8Array,
+): boolean {
+  if (IMAGE_MIME_TYPES.has(mimeType))
+    return hasRasterImageSignature(mimeType, data);
+  if (VIDEO_MIME_TYPES.has(mimeType)) return hasVideoSignature(mimeType, data);
+  return false;
+}

package/corpus/templates/assets/shared/api.ts

@@ -166,6 +166,26 @@ export interface PresetSkeletonSpec {
   foreground?: PresetSkeletonForegroundLayer[];
 }
 
+export const PRESET_REFERENCE_ROLES = [
+  "subject",
+  "style",
+  "product",
+  "background",
+  "composition",
+] as const;
+
+export type PresetReferenceRole = (typeof PRESET_REFERENCE_ROLES)[number];
+
+export interface PresetReference {
+  id: string;
+  label: string;
+  role: PresetReferenceRole;
+  description?: string;
+  assetIds: string[];
+  variable: boolean;
+  required: boolean;
+}
+
 export interface ImageLibrarySummary {
   id: string;
   title: string;

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

@@ -87,6 +87,12 @@ pnpm action create-event \
 Required: `--title`, `--start`, `--end` (all ISO datetime format).
 Optional: `--description`, `--location`, `--attendees`, `--addGoogleMeet`, `--addZoom`, `--sendUpdates`.
 
+When attendees are invited and no video link/provider is supplied, Calendar
+automatically adds a Google Meet link by default. Pass `--addGoogleMeet=false`
+only when the user explicitly wants no video conferencing. If the user provides
+a Zoom/Meet/Teams link in the location or description, or asks for
+`--addZoom=true`, do not add Google Meet too.
+
 Native Google Calendar status events are supported:
 
 ```bash

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

@@ -7,7 +7,10 @@ import {
 } from "@agent-native/core/server";
 import { z } from "zod";
 
-import { prepareZoomMeetingPatch } from "../server/lib/event-video-conferencing.js";
+import {
+  prepareZoomMeetingPatch,
+  shouldAutoAddGoogleMeet,
+} from "../server/lib/event-video-conferencing.js";
 import * as googleCalendar from "../server/lib/google-calendar.js";
 import type { CalendarEvent } from "../shared/api.js";
 import {
@@ -191,7 +194,10 @@ export default defineAction({
     }
 
     const result = await googleCalendar.createEvent(calEvent, {
-      addGoogleMeet: args.addGoogleMeet,
+      addGoogleMeet: shouldAutoAddGoogleMeet(calEvent, {
+        addGoogleMeet: args.addGoogleMeet,
+        addZoom: args.addZoom,
+      }),
       sendUpdates: args.sendUpdates ?? (attendees?.length ? "all" : undefined),
     });
     if (result.id) {

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

@@ -122,6 +122,16 @@ function uniqueAttendees(attendees: AttendeeRecipient[]) {
   return Array.from(byEmail.values());
 }
 
+function buildVideoProviderPatch(
+  provider: VideoProvider,
+  explicitChoice: boolean,
+): { addGoogleMeet?: boolean; addZoom?: boolean } {
+  if (provider === "google_meet")
+    return { addGoogleMeet: true, addZoom: false };
+  if (provider === "zoom") return { addGoogleMeet: false, addZoom: true };
+  return explicitChoice ? { addGoogleMeet: false, addZoom: false } : {};
+}
+
 function dateTimePartsInTimezone(value: string, timezone: string) {
   const parsed = new Date(value);
   if (Number.isNaN(parsed.getTime())) return null;
@@ -240,6 +250,7 @@ export function CreateEventPopover({
   const [workingLocationType, setWorkingLocationType] =
     useState<WorkingLocationType>("customLocation");
   const [videoProvider, setVideoProvider] = useState<VideoProvider>("none");
+  const [videoProviderTouched, setVideoProviderTouched] = useState(false);
   const [attendees, setAttendees] = useState<AttendeeRecipient[]>([]);
   const [findTimeOpen, setFindTimeOpen] = useState(false);
   const timedOnlyStatus =
@@ -304,6 +315,9 @@ export function CreateEventPopover({
       setVideoProvider(
         draft.addGoogleMeet ? "google_meet" : draft.addZoom ? "zoom" : "none",
       );
+      setVideoProviderTouched(
+        draft.addGoogleMeet !== undefined || draft.addZoom !== undefined,
+      );
       setAttendees(
         uniqueAttendees(
           (draft.attendees ?? []).map((attendee) => ({
@@ -335,6 +349,7 @@ export function CreateEventPopover({
     setAttachments([createAttachmentDraft()]);
     setWorkingLocationType("customLocation");
     setVideoProvider("none");
+    setVideoProviderTouched(false);
     setAttendees([]);
   }, [
     open,
@@ -403,8 +418,7 @@ export function CreateEventPopover({
               ...(attendee.optional === true ? { optional: true } : {}),
             }))
           : undefined,
-      addGoogleMeet: videoProvider === "google_meet",
-      addZoom: videoProvider === "zoom",
+      ...buildVideoProviderPatch(videoProvider, videoProviderTouched),
       accountEmail: draft?.accountEmail,
       workingLocationType,
       workingLocationLabel:
@@ -449,6 +463,7 @@ export function CreateEventPopover({
     attachments,
     attendees,
     videoProvider,
+    videoProviderTouched,
     workingLocationType,
     timedOnlyStatus,
     onDraftChange,
@@ -647,8 +662,6 @@ export function CreateEventPopover({
       visibility: eventType === "workingLocation" ? "public" : visibility,
       ...reminderPatch,
       ...statusPatch,
-      addGoogleMeet: videoProvider === "google_meet",
-      addZoom: videoProvider === "zoom",
       color: colorId ? getGoogleEventColorHex(colorId) : undefined,
       colorId,
       attachments:
@@ -663,6 +676,7 @@ export function CreateEventPopover({
               ...(attendee.optional === true ? { optional: true } : {}),
             }))
           : undefined,
+      ...buildVideoProviderPatch(videoProvider, videoProviderTouched),
     };
 
     onOpenChange(false);
@@ -979,9 +993,10 @@ export function CreateEventPopover({
               </Label>
               <Select
                 value={videoProvider}
-                onValueChange={(value) =>
-                  setVideoProvider(value as VideoProvider)
-                }
+                onValueChange={(value) => {
+                  setVideoProvider(value as VideoProvider);
+                  setVideoProviderTouched(true);
+                }}
               >
                 <SelectTrigger
                   id="event-video-provider"

package/corpus/templates/calendar/changelog/2026-07-09-calendar-events-with-guests-now-automatically-get-a-google-m.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-09
+---
+
+Calendar events with guests now automatically get a Google Meet link when no video link is provided.