@agent-native/core 0.101.7 → 0.101.11

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

@@ -43,6 +43,11 @@ import {
   partitionAllDayEvents,
 } from "@/lib/all-day-layout";
 import { getEventDisplayColor, allOtherDeclined } from "@/lib/event-colors";
+import {
+  getFirstVisibleOutOfOfficeDayIndex,
+  getOutOfOfficeSegment,
+  isOutOfOfficeEvent,
+} from "@/lib/out-of-office";
 import {
   shouldSuppressAfterPopoverClose,
   shouldSuppressCreatePointerDown,
@@ -56,6 +61,7 @@ import {
 } from "@/lib/working-location";
 
 import { EventDetailPopover } from "./EventDetailPopover";
+import { OutOfOfficeEvent } from "./OutOfOfficeEvent";
 import { shouldRenderWeekDragSegment } from "./week-drag-segment";
 
 interface WeekViewProps {
@@ -285,6 +291,7 @@ interface WeekEventCardProps {
   onDraftUpdate?: WeekViewProps["onDraftUpdate"];
   onDraftCreate?: WeekViewProps["onDraftCreate"];
   onDraftDiscard?: WeekViewProps["onDraftDiscard"];
+  onPopoverOpenChange: (event: CalendarEvent, open: boolean) => void;
 }
 
 /**
@@ -320,6 +327,7 @@ const WeekEventCard = memo(function WeekEventCard({
   onDraftUpdate,
   onDraftCreate,
   onDraftDiscard,
+  onPopoverOpenChange,
 }: WeekEventCardProps) {
   const t = useT();
   const li = layout.get(event.id) ?? {
@@ -558,6 +566,7 @@ const WeekEventCard = memo(function WeekEventCard({
       onDraftUpdate={onDraftUpdate}
       onDraftCreate={onDraftCreate}
       onDraftDiscard={onDraftDiscard}
+      onOpenChange={(open) => onPopoverOpenChange(event, open)}
     >
       {eventButton}
     </EventDetailPopover>
@@ -618,6 +627,7 @@ export const WeekView = memo(function WeekView({
   const GUTTER_WIDTH = isMobile ? MOBILE_GUTTER_WIDTH : DESKTOP_GUTTER_WIDTH;
   const [now, setNow] = useState(new Date());
   const [focusedEventId, setFocusedEventId] = useState<string | null>(null);
+  const focusedEventIdRef = useRef<string | null>(null);
   const currentTimeRef = useRef<HTMLDivElement>(null);
   const scrollContainerRef = useRef<HTMLDivElement>(null);
   const allDayContainerRef = useRef<HTMLDivElement>(null);
@@ -628,6 +638,7 @@ export const WeekView = memo(function WeekView({
   useEffect(() => {
     function handleKey(e: KeyboardEvent) {
       if (e.key === "Escape") {
+        focusedEventIdRef.current = null;
         setFocusedEventId(null);
         setFocusedEvent(null);
       }
@@ -675,7 +686,15 @@ export const WeekView = memo(function WeekView({
   // Separate all-day and timed events
   const allDayEvents = useMemo(() => events.filter((e) => e.allDay), [events]);
 
-  const timedEvents = useMemo(() => events.filter((e) => !e.allDay), [events]);
+  const outOfOfficeEvents = useMemo(
+    () => events.filter((event) => !event.allDay && isOutOfOfficeEvent(event)),
+    [events],
+  );
+
+  const timedEvents = useMemo(
+    () => events.filter((event) => !event.allDay && !isOutOfOfficeEvent(event)),
+    [events],
+  );
 
   const { workingLocations, regularEvents } = useMemo(
     () => partitionAllDayEvents(allDayEvents),
@@ -849,6 +868,22 @@ export const WeekView = memo(function WeekView({
 
   const canDrag = !!onEventTimeChange;
 
+  const handleEventPopoverOpenChange = useCallback(
+    (event: CalendarEvent, open: boolean) => {
+      if (open) {
+        focusedEventIdRef.current = event.id;
+        setFocusedEventId(event.id);
+        setFocusedEvent(event);
+        return;
+      }
+      if (focusedEventIdRef.current !== event.id) return;
+      focusedEventIdRef.current = null;
+      setFocusedEventId(null);
+      setFocusedEvent(null);
+    },
+    [setFocusedEvent],
+  );
+
   const handleEventPointerDown = useCallback(
     (
       e: React.PointerEvent,
@@ -856,6 +891,7 @@ export const WeekView = memo(function WeekView({
       isStart: boolean,
       dayIndex: number,
     ) => {
+      focusedEventIdRef.current = event.id;
       setFocusedEventId(event.id);
       setFocusedEvent(event);
       if (
@@ -1262,6 +1298,16 @@ export const WeekView = memo(function WeekView({
               }
             }
 
+            const visibleOutOfOfficeEvents = outOfOfficeEvents.filter(
+              (event) => {
+                const overrides = getDragOverrides(event.id);
+                return (
+                  getOutOfOfficeSegment(event, day) !== null ||
+                  (dragEventId === event.id && overrides?.dayIndex === dayIndex)
+                );
+              },
+            );
+
             return (
               <div
                 key={day.toISOString()}
@@ -1338,6 +1384,73 @@ export const WeekView = memo(function WeekView({
                   </div>
                 )}
 
+                {/* Native Google out-of-office context sits behind meetings. */}
+                {!isLoading &&
+                  visibleOutOfOfficeEvents.map((event, markerIndex) => {
+                    const isBeingDragged = dragEventId === event.id;
+                    const overrides = getDragOverrides(event.id);
+                    const canonicalDayIndex =
+                      getFirstVisibleOutOfOfficeDayIndex(event, days);
+                    return (
+                      <OutOfOfficeEvent
+                        key={`${event._tempId ?? event.id}:${day.toISOString()}`}
+                        event={event}
+                        day={day}
+                        hourHeight={HOUR_HEIGHT}
+                        color={
+                          getEventDisplayColor(event, prefs) ??
+                          "hsl(var(--primary))"
+                        }
+                        label={t("eventForm.outOfOffice")}
+                        markerIndex={markerIndex}
+                        compactMarker
+                        canDrag={canDrag}
+                        isBeingDragged={isBeingDragged}
+                        isDragging={isDragging}
+                        isDragTargetDay={overrides?.dayIndex === dayIndex}
+                        overrideTop={overrides?.top ?? null}
+                        overrideHeight={overrides?.height ?? null}
+                        onMovePointerDown={(pointerEvent, startsOnDay) =>
+                          handleEventPointerDown(
+                            pointerEvent,
+                            event,
+                            startsOnDay,
+                            dayIndex,
+                          )
+                        }
+                        onResizeTopPointerDown={(pointerEvent) =>
+                          handleResizeTopPointerDown(
+                            pointerEvent,
+                            event.id,
+                            dayIndex,
+                          )
+                        }
+                        onResizeBottomPointerDown={(pointerEvent) =>
+                          handleResizeBottomPointerDown(
+                            pointerEvent,
+                            event.id,
+                            dayIndex,
+                          )
+                        }
+                        shouldSuppressClick={shouldSuppressClick}
+                        onDelete={onDeleteEvent}
+                        isDraft={draftEventIds.includes(event.id)}
+                        defaultOpen={
+                          quickEditEventId === event.id &&
+                          dayIndex === canonicalDayIndex
+                        }
+                        onTitleSave={onQuickEditSave}
+                        onDismissNew={onQuickEditCancel}
+                        onDraftUpdate={onDraftUpdate}
+                        onDraftCreate={onDraftCreate}
+                        onDraftDiscard={onDraftDiscard}
+                        onOpenChange={(open) =>
+                          handleEventPopoverOpenChange(event, open)
+                        }
+                      />
+                    );
+                  })}
+
                 {/* Skeleton events when loading */}
                 {isLoading &&
                   WEEK_SKELETONS[dayIndex]?.map(
@@ -1402,6 +1515,7 @@ export const WeekView = memo(function WeekView({
                         onDraftUpdate={onDraftUpdate}
                         onDraftCreate={onDraftCreate}
                         onDraftDiscard={onDraftDiscard}
+                        onPopoverOpenChange={handleEventPopoverOpenChange}
                       />
                     );
                   })}

package/corpus/templates/calendar/app/lib/out-of-office.ts

@@ -0,0 +1,45 @@
+import type { CalendarEvent } from "@shared/api";
+import { addDays, differenceInMinutes, parseISO, startOfDay } from "date-fns";
+
+export interface OutOfOfficeSegment {
+  topMinutes: number;
+  durationMinutes: number;
+  startsOnDay: boolean;
+  endsOnDay: boolean;
+}
+
+export function isOutOfOfficeEvent(
+  event: Pick<CalendarEvent, "eventType">,
+): boolean {
+  return event.eventType === "outOfOffice";
+}
+
+/** Return the portion of a timed out-of-office event visible on one day. */
+export function getOutOfOfficeSegment(
+  event: Pick<CalendarEvent, "start" | "end">,
+  day: Date,
+): OutOfOfficeSegment | null {
+  const eventStart = parseISO(event.start);
+  const eventEnd = parseISO(event.end);
+  const dayStart = startOfDay(day);
+  const dayEnd = addDays(dayStart, 1);
+
+  if (eventStart >= dayEnd || eventEnd <= dayStart) return null;
+
+  const segmentStart = eventStart > dayStart ? eventStart : dayStart;
+  const segmentEnd = eventEnd < dayEnd ? eventEnd : dayEnd;
+
+  return {
+    topMinutes: Math.max(0, differenceInMinutes(segmentStart, dayStart)),
+    durationMinutes: Math.max(1, differenceInMinutes(segmentEnd, segmentStart)),
+    startsOnDay: eventStart >= dayStart && eventStart < dayEnd,
+    endsOnDay: eventEnd > dayStart && eventEnd <= dayEnd,
+  };
+}
+
+export function getFirstVisibleOutOfOfficeDayIndex(
+  event: Pick<CalendarEvent, "start" | "end">,
+  days: Date[],
+): number {
+  return days.findIndex((day) => getOutOfOfficeSegment(event, day) !== null);
+}

package/corpus/templates/calendar/changelog/2026-07-14-out-of-office-blocks-now-sit-behind-meetings-and-event-stack.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-14
+---
+
+Out-of-office blocks now sit behind meetings, and event stacking resets after closing details.

package/corpus/templates/content/.agents/skills/document-editing/SKILL.md

@@ -145,6 +145,29 @@ Always run this after any document modification to update the sidebar.
 
 Documents use **markdown** for content. The editor renders markdown in real time.
 
+### Math
+
+Content renders LaTeX with KaTeX while preserving the source in NFM. Use the
+canonical Content delimiters when an agent creates or edits math:
+
+```md
+Inline math: The relationship is $`E = mc^2`$ in this example.
+
+Block math:
+
+$$
+\int_0^1 x^2 dx = \frac{1}{3}
+$$
+```
+
+- Inline math uses ``$`...`$``. Do not substitute ordinary `$...$`; dollar
+  amounts in prose are intentionally not interpreted as equations.
+- Block equations use `$$` on their own lines before and after the LaTeX.
+- Keep the raw LaTeX intact when editing around an equation. Invalid or
+  unsupported expressions remain visible as source so they can be repaired.
+- Markdown exports preserve these delimiters. HTML and PDF-ready exports render
+  the equation.
+
 ## Parent-Child Hierarchy
 
 Documents form a tree via `parent_id`:

package/corpus/templates/content/AGENTS.md

@@ -123,13 +123,14 @@ cd templates/content && pnpm action <name> [args]
 | `change-content-database-source-role`       | `--databaseId <id>` or `--documentId <id> --sourceId <id> --relationshipMode items\|details [--join <json>]`                                                                                       | Change an attached source between adding rows and adding matched detail columns without removing the source                                                                       |
 | `refresh-content-database-source`           | `--databaseId <id>` or `--documentId <id>`                                                                                                                                                         | Refresh the read-only source status envelope; large Builder CMS sources may return a partial fetch, and another refresh continues loading remaining rows                          |
 | `process-builder-body-hydration`            | `--sourceId <id> [--documentId <id>] [--limit <n>]`                                                                                                                                                | Hydrate queued Builder article bodies into readable Content markdown with preserved source-component markers                                                                      |
-| `set-content-database-source-write-mode`    | `--databaseId <id>` or `--documentId <id> --liveWritesEnabled true\|false [--allowedWriteModes <json>]`                                                                                            | Enable/disable per-source Builder live writes; enabling is allowed only for `agent-native-blog-article-test` with explicit modes                                                  |
+| `set-content-database-source-write-mode`    | `--databaseId <id>` or `--documentId <id> [--sourceId <id>] --writeMode read_only\|stage_only\|publish_updates [--allowPublicationTransitions true\|false]`                                        | Set the per-source Builder write tier; requires page admin access and remains read-only by default                                                                                |
 | `stage-builder-revision`                    | `--databaseId <id>` or `--documentId <id>`                                                                                                                                                         | Stage pending local Builder CMS changes as a local-only save-revision record; never calls Builder                                                                                 |
 | `review-content-database-source-change-set` | `--databaseId <id>` or `--documentId <id> --changeSetId <id> --decision approve\|reject [--note]`                                                                                                  | Approve or reject a local source change-set review record without provider writes                                                                                                 |
 | `stage-builder-source-bulk-update`          | `--databaseId <id>` or `--documentId <id> --itemIds <json-array>` or `--documentIds <json-array> --field <json> [--sourceId <id>] [--dryRun true\|false]`                                          | Preview or stage one bounded field update across selected source-backed Builder rows; apply still goes through Builder review/execution                                           |
 | `prepare-builder-source-execution`          | `--databaseId <id>` or `--documentId <id> --changeSetId <id> [--pushModeConfirmation autosave\|draft\|publish]`                                                                                    | Prepare a dry-run Builder execution gate for approved field/body changes with request semantics/idempotency key; never calls Builder                                              |
 | `validate-builder-source-execution`         | `--databaseId <id>` or `--documentId <id> --changeSetId <id> [--idempotencyKey <key>]`                                                                                                             | Validate/replay a prepared Builder execution gate locally as a dry run; never calls Builder                                                                                       |
-| `execute-builder-source-execution`          | `--databaseId <id>` or `--documentId <id> --changeSetId <id> [--idempotencyKey <key>] [--pushModeConfirmation autosave\|draft\|publish]`                                                           | Execute a guarded live Builder write only when approved, validated, enabled, idempotent, and targeting `agent-native-blog-article-test`                                           |
+| `execute-builder-source-execution`          | `--databaseId <id>` or `--documentId <id> --changeSetId <id> [--idempotencyKey <key>] [--pushModeConfirmation autosave\|draft\|publish]`                                                           | Execute a guarded live Builder write only when approved, validated, enabled for that source, and idempotent                                                                       |
+| `cancel-prepared-builder-source-update`     | `--databaseId <id>` or `--documentId <id> --sourceId <id> --changeSetId <id> [--note <text>]`                                                                                                      | Cancel an exact prepared Builder update only when every associated execution is provably pre-dispatch; preserves review and execution history and never calls Builder             |
 | `add-database-item`                         | `--databaseId <id> [--title <text>] [--propertyValues <json>]`                                                                                                                                     | Add a page row to a database, optionally seeding property values                                                                                                                  |
 | `submit-content-database-form`              | `--databaseId <id> [--viewId <form-view-id>] [--title <text>] [--propertyValues <json>]`                                                                                                           | Submit one form response atomically; validates required questions, resolves option labels/IDs, writes Blocks correctly, verifies persistence, and returns the exact row page link |
 | `duplicate-database-item`                   | `--itemId <id>` or `--documentId <id> [--title <text>]`                                                                                                                                            | Duplicate exactly one database row page and its stored property values; for two or more rows, use `duplicate-database-items` once                                                 |

package/corpus/templates/content/actions/_builder-cms-intent-lookup.ts

@@ -0,0 +1,87 @@
+import { isDeepStrictEqual } from "node:util";
+
+import { BUILDER_CMS_SAFE_WRITE_MODEL } from "../shared/api.js";
+import { readBuilderCmsContentEntries } from "./_builder-cms-read-client.js";
+import type { BuilderCmsSourceEntry } from "./_builder-cms-source-adapter.js";
+import { BUILDER_CMS_EXECUTION_MARKER_FIELD } from "./_builder-cms-write-adapter.js";
+
+export interface BuilderCmsIntentMatch {
+  id: string;
+  title: string;
+  lastUpdated: string | null;
+  published: string | null;
+}
+
+export function matchBuilderCmsSafeModelIntentEntries(
+  entries: BuilderCmsSourceEntry[],
+  args: {
+    marker?: string;
+    exactTitle?: string;
+    intendedFields?: Record<string, unknown>;
+  },
+) {
+  const identityMatches = entries.filter((entry) => {
+    const data = rawRecord(entry.rawEntry?.data);
+    if (args.marker) {
+      return data?.[BUILDER_CMS_EXECUTION_MARKER_FIELD] === args.marker;
+    }
+    const title = data?.title;
+    return (
+      typeof title === "string" && title.trim() === args.exactTitle?.trim()
+    );
+  });
+  const matchingIntent = identityMatches.filter((entry) => {
+    const data = rawRecord(entry.rawEntry?.data);
+    return Object.entries(args.intendedFields ?? {}).every(([key, value]) =>
+      isDeepStrictEqual(data?.[key], value),
+    );
+  });
+  return {
+    count: identityMatches.length,
+    matchingIntentCount: matchingIntent.length,
+    matches: identityMatches.map(compactMatch),
+  };
+}
+
+function rawRecord(value: unknown): Record<string, unknown> | null {
+  return value && typeof value === "object" && !Array.isArray(value)
+    ? (value as Record<string, unknown>)
+    : null;
+}
+
+function compactMatch(entry: BuilderCmsSourceEntry): BuilderCmsIntentMatch {
+  const raw = rawRecord(entry.rawEntry);
+  return {
+    id: entry.id,
+    title: entry.title,
+    lastUpdated:
+      typeof raw?.lastUpdated === "string" ||
+      typeof raw?.lastUpdated === "number"
+        ? String(raw.lastUpdated)
+        : entry.updatedAt || null,
+    published: typeof raw?.published === "string" ? raw.published : null,
+  };
+}
+
+export async function lookupBuilderCmsSafeModelIntent(args: {
+  marker?: string;
+  exactTitle?: string;
+  intendedFields?: Record<string, unknown>;
+}) {
+  if (!args.marker && !args.exactTitle) {
+    throw new Error("Provide an exact execution marker or exact title.");
+  }
+  const result = await readBuilderCmsContentEntries({
+    model: BUILDER_CMS_SAFE_WRITE_MODEL,
+    rawData: true,
+    requirePrivateKey: true,
+    limit: 10_000,
+  });
+  if (result.state !== "live" || result.progress.partial) {
+    throw new Error(
+      result.message ??
+        "Builder safe-model lookup was incomplete; reconciliation cannot proceed.",
+    );
+  }
+  return matchBuilderCmsSafeModelIntentEntries(result.entries, args);
+}