@agent-native/core 0.171.0 → 0.171.3

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

@@ -13,16 +13,18 @@ export interface PeopleSearchResponse {
   scopeRequired?: boolean;
 }
 
+export type PeopleSearchScope = "all" | "directory";
+
 const PEOPLE_CONTACTS_STALE_TIME = 10 * 60_000;
 const PEOPLE_CONTACTS_GC_TIME = 30 * 60_000;
 const PEOPLE_SEARCH_STALE_TIME = 60_000;
 const PEOPLE_SEARCH_GC_TIME = 5 * 60_000;
 
-export const PEOPLE_CONTACTS_QUERY_KEY = [
-  "action",
-  "search-people",
-  { scope: "all" },
-] as const;
+export function peopleContactsQueryKey(scope: PeopleSearchScope = "all") {
+  return ["action", "search-people", { scope }] as const;
+}
+
+export const PEOPLE_CONTACTS_QUERY_KEY = peopleContactsQueryKey();
 
 function sourceRank(source?: PeopleSearchResult["source"]) {
   switch (source) {
@@ -115,13 +117,14 @@ export function filterPeopleResults(
 
 export function prefetchPeopleContacts(
   queryClient: ReturnType<typeof useQueryClient>,
+  scope: PeopleSearchScope = "all",
 ) {
   return queryClient.prefetchQuery({
-    queryKey: PEOPLE_CONTACTS_QUERY_KEY,
+    queryKey: peopleContactsQueryKey(scope),
     queryFn: () =>
       callAction<PeopleSearchResponse>(
         "search-people",
-        { scope: "all" },
+        { scope },
         { method: "GET" },
       ),
     staleTime: PEOPLE_CONTACTS_STALE_TIME,
@@ -129,13 +132,16 @@ export function prefetchPeopleContacts(
   });
 }
 
-export function usePeopleContacts(enabled = true) {
+export function usePeopleContacts(
+  scope: PeopleSearchScope = "all",
+  enabled = true,
+) {
   return useQuery({
-    queryKey: PEOPLE_CONTACTS_QUERY_KEY,
+    queryKey: peopleContactsQueryKey(scope),
     queryFn: () =>
       callAction<PeopleSearchResponse>(
         "search-people",
-        { scope: "all" },
+        { scope },
         { method: "GET" },
       ),
     enabled,
@@ -145,14 +151,18 @@ export function usePeopleContacts(enabled = true) {
   });
 }
 
-export function usePeopleSearch(query: string, enabled = true) {
+export function usePeopleSearch(
+  query: string,
+  enabled = true,
+  scope: PeopleSearchScope = "all",
+) {
   const q = query.trim();
   return useQuery({
-    queryKey: ["action", "search-people", { q, scope: "all" }],
+    queryKey: ["action", "search-people", { q, scope }],
     queryFn: () =>
       callAction<PeopleSearchResponse>(
         "search-people",
-        { q, scope: "all" },
+        { q, scope },
         { method: "GET" },
       ),
     enabled: enabled && q.length > 0,

package/corpus/templates/calendar/app/lib/event-layout.ts

@@ -112,18 +112,33 @@ export function computeTimedEventLayout(
     }
 
     const totalCols = overlapLayers.length;
-    // Give every overlap column a proportional slice of the day column so an
-    // event's right edge stays visible instead of being covered by whichever
-    // card renders on top of it.
-    const width = 100 / totalCols;
+    const sameStartGroups = new Map<number, EventEntry[]>();
+    const sameStartIndexes = new Map<EventEntry, number>();
+    for (const entry of group) {
+      const entries = sameStartGroups.get(entry.bounds.start) ?? [];
+      sameStartIndexes.set(entry, entries.length);
+      entries.push(entry);
+      sameStartGroups.set(entry.bounds.start, entries);
+    }
 
     for (const entry of group) {
       const col = eventColumns.get(entry.event)!;
+      const sameStartEntries = sameStartGroups.get(entry.bounds.start)!;
+      const sameStartIndex = sameStartIndexes.get(entry)!;
+      const sameStartWidth = 100 / sameStartEntries.length;
+      const isGroupStart = entry.bounds.start === group[0].bounds.start;
+      const useStartLanes = sameStartEntries.length > 1;
+
+      // Later events sit over the earlier event instead of forcing both cards
+      // into equal columns. Events with the same start time still get lanes so
+      // their titles remain independently readable.
+      const left = useStartLanes ? sameStartIndex * sameStartWidth : 0;
+      const width = 100 - left;
 
       result.set(entry.event.id, {
-        left: col * width,
+        left,
         width,
-        indent: col * OVERLAP_INDENT_PX,
+        indent: isGroupStart && sameStartIndex === 0 ? 0 : OVERLAP_INDENT_PX,
         col,
         totalCols,
         stackOrder: stackOrder++,

package/corpus/templates/calendar/app/pages/CalendarView.tsx

@@ -896,6 +896,9 @@ export default function CalendarView() {
       createEvent.mutate(payload, {
         onSuccess: (result) => {
           discardedCommittingDraftsRef.current.delete(draftId);
+          if (result?.videoConferenceError === "zoom") {
+            toast.error(t("eventForm.zoomAddFailed"));
+          }
           const createdEventId = result?.id;
           if (createdEventId) {
             const undo = () => {

package/corpus/templates/calendar/changelog/2026-08-24-overlapping-events-use-space-better.md

@@ -0,0 +1,5 @@
+---
+type: improved
+date: 2026-08-24
+---
+Overlapping calendar events now use more of the available width while keeping same-time meetings readable.

package/corpus/templates/calendar/server/lib/google-api.ts

@@ -130,6 +130,14 @@ export function isGoogleNotFoundError(error: unknown): boolean {
   );
 }
 
+export function isGoogleEventAbsentError(error: unknown): boolean {
+  return (
+    isGoogleNotFoundError(error) ||
+    (error instanceof GoogleApiError && error.status === 410) ||
+    (error instanceof Error && /^Google API error \(410\):/.test(error.message))
+  );
+}
+
 export async function googleFetch(
   url: string,
   accessToken: string,
@@ -364,6 +372,7 @@ export function calendarListEvents(
     timeMax?: string;
     q?: string;
     singleEvents?: boolean;
+    showDeleted?: boolean;
     orderBy?: string;
     maxResults?: number;
     pageToken?: string;

package/corpus/templates/calendar/server/lib/google-calendar.ts

@@ -30,6 +30,7 @@ import {
   calendarDeleteEvent,
   calendarPatchEvent,
   calendarUpdateEvent,
+  isGoogleEventAbsentError,
   peopleGetProfile,
 } from "./google-api.js";
 import { getCalendarProviderApiRuntime } from "./provider-api.js";
@@ -1707,8 +1708,14 @@ export async function deleteEvent(
     return;
   }
 
-  const instanceStart = instance.start?.dateTime || instance.start?.date || "";
-  const isAllDay = !instance.start?.dateTime;
+  const instanceStart =
+    instance.originalStartTime?.dateTime ||
+    instance.originalStartTime?.date ||
+    instance.start?.dateTime ||
+    instance.start?.date ||
+    "";
+  const isAllDay =
+    !instance.originalStartTime?.dateTime && !instance.start?.dateTime;
 
   // Compute UNTIL value (day before this instance)
   const cutoff = new Date(instanceStart);
@@ -1748,6 +1755,56 @@ export async function deleteEvent(
     { recurrence: updatedRecurrence },
     { sendUpdates },
   );
+
+  // Truncating the master does not remove materialized exceptions after the
+  // cutoff, so remove those exceptions as well.
+  const instanceStartMs = Date.parse(instanceStart);
+  const exceptionIds = new Set<string>([googleEventId]);
+  let pageToken: string | undefined;
+  do {
+    const response = await calendarListEvents(client.accessToken, "primary", {
+      singleEvents: false,
+      showDeleted: true,
+      maxResults: 2500,
+      pageToken,
+    });
+    for (const event of response?.items || []) {
+      if (event.recurringEventId !== recurringEventId) continue;
+      const originalStart =
+        event.originalStartTime?.dateTime ||
+        event.originalStartTime?.date ||
+        event.start?.dateTime ||
+        event.start?.date;
+      const originalStartMs =
+        typeof originalStart === "string" ? Date.parse(originalStart) : NaN;
+      if (
+        event.id &&
+        Number.isFinite(instanceStartMs) &&
+        Number.isFinite(originalStartMs) &&
+        originalStartMs >= instanceStartMs
+      ) {
+        exceptionIds.add(event.id);
+      }
+    }
+    pageToken =
+      typeof response?.nextPageToken === "string"
+        ? response.nextPageToken
+        : undefined;
+  } while (pageToken);
+
+  for (const eventId of exceptionIds) {
+    try {
+      await calendarDeleteEvent(
+        client.accessToken,
+        "primary",
+        eventId,
+        sendUpdates,
+      );
+    } catch (error) {
+      // A generated occurrence may already be gone once the master is trimmed.
+      if (!isGoogleEventAbsentError(error)) throw error;
+    }
+  }
 }
 
 /**

package/corpus/templates/calendar/server/lib/people-search.ts

@@ -36,6 +36,7 @@ interface ContactCacheEntry {
 
 const CONTACT_CACHE_TTL = 10 * 60 * 1000;
 const contactCache = new Map<string, ContactCacheEntry>();
+const contactCacheLoads = new Map<string, Promise<ContactCacheEntry>>();
 
 const GENERIC_EMAIL_DOMAINS = new Set([
   "gmail.com",
@@ -255,36 +256,50 @@ async function loadCachedContactPeople(
     return cached;
   }
 
-  const people = new Map<string, PersonResult>();
-  let contactsLimited = false;
-
-  await Promise.all(
-    clients.map(async (client) => {
-      try {
-        const [connections, otherContacts] = await Promise.all([
-          listConnectionPages(client.accessToken, "connections"),
-          listConnectionPages(client.accessToken, "otherContacts"),
-        ]);
-
-        for (const person of extractPeople(connections, "contact")) {
-          mergeCachedContact(people, person);
-        }
-        for (const person of extractPeople(otherContacts, "otherContact")) {
-          mergeCachedContact(people, person);
+  const pending = contactCacheLoads.get(cacheKey);
+  if (pending) return pending;
+
+  const load = (async () => {
+    const people = new Map<string, PersonResult>();
+    let contactsLimited = false;
+
+    await Promise.all(
+      clients.map(async (client) => {
+        try {
+          const [connections, otherContacts] = await Promise.all([
+            listConnectionPages(client.accessToken, "connections"),
+            listConnectionPages(client.accessToken, "otherContacts"),
+          ]);
+
+          for (const person of extractPeople(connections, "contact")) {
+            mergeCachedContact(people, person);
+          }
+          for (const person of extractPeople(otherContacts, "otherContact")) {
+            mergeCachedContact(people, person);
+          }
+        } catch (error) {
+          if (permissionLimited(error)) contactsLimited = true;
         }
-      } catch (error) {
-        if (permissionLimited(error)) contactsLimited = true;
-      }
-    }),
-  );
+      }),
+    );
 
-  const entry: ContactCacheEntry = {
-    people: Array.from(people.values()),
-    contactsLimited,
-    expiresAt: Date.now() + CONTACT_CACHE_TTL,
-  };
-  contactCache.set(cacheKey, entry);
-  return entry;
+    const entry: ContactCacheEntry = {
+      people: Array.from(people.values()),
+      contactsLimited,
+      expiresAt: Date.now() + CONTACT_CACHE_TTL,
+    };
+    contactCache.set(cacheKey, entry);
+    return entry;
+  })();
+
+  contactCacheLoads.set(cacheKey, load);
+  try {
+    return await load;
+  } finally {
+    if (contactCacheLoads.get(cacheKey) === load) {
+      contactCacheLoads.delete(cacheKey);
+    }
+  }
 }
 
 export async function searchPeopleForUser(

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

@@ -66,6 +66,8 @@ export interface CalendarEvent {
   hangoutLink?: string; // Google Meet link
   /** Meeting URL stored in location/description for non-Google providers such as Zoom */
   meetingLink?: string;
+  /** Action-result warning when optional video conferencing could not be provisioned. */
+  videoConferenceError?: "zoom";
   conferenceData?: {
     entryPoints?: Array<{
       entryPointType: string;

package/corpus/templates/clips/app/components/player/playback-comment-overlay.tsx

@@ -103,9 +103,9 @@ export function PlaybackCommentOverlay({
             </p>
             <InlineMarkdown
               content={comment.content}
-              className="line-clamp-3 text-sm leading-5 text-primary-foreground"
-              linkClassName="text-primary-foreground underline decoration-primary-foreground/60 hover:decoration-primary-foreground"
-              codeClassName="bg-primary-foreground/15 text-primary-foreground"
+              className="line-clamp-3 text-sm leading-5 text-background dark:text-foreground"
+              linkClassName="text-background underline decoration-background/60 hover:decoration-background dark:text-foreground dark:decoration-foreground/60 dark:hover:decoration-foreground"
+              codeClassName="bg-background/15 text-background dark:bg-foreground/15 dark:text-foreground"
             />
           </div>
         </div>

package/corpus/templates/mail/app/root.tsx

@@ -14,6 +14,11 @@ import {
   type LocaleCode,
 } from "@agent-native/core/client/i18n";
 import {
+  isDynamicImportFailureMessage,
+  recoverFromStaleChunkError,
+} from "@agent-native/core/client/route-chunk-recovery";
+import {
+  DefaultSpinner,
   ErrorReportActions,
   getThemeInitScript,
 } from "@agent-native/core/client/ui";
@@ -90,6 +95,7 @@ const MAIL_ERROR_COPY: Record<
     fallback: string;
     back: string;
     reload: string;
+    loading: string;
     sendFeedback: string;
     feedbackPlaceholder: string;
     openGitHubIssue: string;
@@ -100,6 +106,7 @@ const MAIL_ERROR_COPY: Record<
     fallback: "Something went wrong while loading Mail.",
     back: "Back",
     reload: "Reload",
+    loading: "Reloading Mail...",
     sendFeedback: "Send feedback",
     feedbackPlaceholder:
       "Describe what happened before this Mail error appeared.",
@@ -110,6 +117,7 @@ const MAIL_ERROR_COPY: Record<
     fallback: "加载 Mail 时出现问题。",
     back: "返回",
     reload: "重新加载",
+    loading: "正在重新加载 Mail...",
     sendFeedback: "发送反馈",
     feedbackPlaceholder: "描述此 Mail 错误出现前发生了什么。",
     openGitHubIssue: "打开 GitHub issue",
@@ -119,6 +127,7 @@ const MAIL_ERROR_COPY: Record<
     fallback: "載入 Mail 時發生問題。",
     back: "返回",
     reload: "重新載入",
+    loading: "正在重新載入 Mail...",
     sendFeedback: "傳送意見回饋",
     feedbackPlaceholder: "描述此 Mail 錯誤出現前發生了什麼。",
     openGitHubIssue: "開啟 GitHub issue",
@@ -128,6 +137,7 @@ const MAIL_ERROR_COPY: Record<
     fallback: "Algo salió mal al cargar Mail.",
     back: "Atrás",
     reload: "Recargar",
+    loading: "Recargando Mail...",
     sendFeedback: "Enviar comentarios",
     feedbackPlaceholder:
       "Describe qué pasó antes de que apareciera este error de Mail.",
@@ -138,6 +148,7 @@ const MAIL_ERROR_COPY: Record<
     fallback: "Un problème est survenu lors du chargement de Mail.",
     back: "Retour",
     reload: "Recharger",
+    loading: "Rechargement de Mail...",
     sendFeedback: "Envoyer un retour",
     feedbackPlaceholder:
       "Décrivez ce qui s'est passé avant cette erreur de Mail.",
@@ -148,6 +159,7 @@ const MAIL_ERROR_COPY: Record<
     fallback: "Beim Laden von Mail ist ein Fehler aufgetreten.",
     back: "Zurück",
     reload: "Neu laden",
+    loading: "Mail wird neu geladen...",
     sendFeedback: "Feedback senden",
     feedbackPlaceholder:
       "Beschreiben Sie, was vor diesem Mail-Fehler passiert ist.",
@@ -158,6 +170,7 @@ const MAIL_ERROR_COPY: Record<
     fallback: "Mail の読み込み中に問題が発生しました。",
     back: "戻る",
     reload: "再読み込み",
+    loading: "Mail を再読み込み中...",
     sendFeedback: "フィードバックを送信",
     feedbackPlaceholder:
       "この Mail エラーの直前に起きたことを説明してください。",
@@ -168,6 +181,7 @@ const MAIL_ERROR_COPY: Record<
     fallback: "Mail을 불러오는 중 문제가 발생했습니다.",
     back: "뒤로",
     reload: "새로고침",
+    loading: "Mail 새로고침 중...",
     sendFeedback: "피드백 보내기",
     feedbackPlaceholder:
       "이 Mail 오류가 나타나기 전에 무슨 일이 있었는지 적어 주세요.",
@@ -178,6 +192,7 @@ const MAIL_ERROR_COPY: Record<
     fallback: "Algo deu errado ao carregar o Mail.",
     back: "Voltar",
     reload: "Recarregar",
+    loading: "Recarregando o Mail...",
     sendFeedback: "Enviar feedback",
     feedbackPlaceholder:
       "Descreva o que aconteceu antes deste erro do Mail aparecer.",
@@ -188,6 +203,7 @@ const MAIL_ERROR_COPY: Record<
     fallback: "Mail लोड करते समय कुछ गलत हुआ।",
     back: "वापस",
     reload: "रीलोड",
+    loading: "Mail रीलोड हो रहा है...",
     sendFeedback: "फ़ीडबैक भेजें",
     feedbackPlaceholder: "इस Mail त्रुटि से पहले क्या हुआ, उसका वर्णन करें।",
     openGitHubIssue: "GitHub issue खोलें",
@@ -197,6 +213,7 @@ const MAIL_ERROR_COPY: Record<
     fallback: "حدث خطأ أثناء تحميل Mail.",
     back: "رجوع",
     reload: "إعادة التحميل",
+    loading: "جارٍ إعادة تحميل Mail...",
     sendFeedback: "إرسال الملاحظات",
     feedbackPlaceholder: "صف ما حدث قبل ظهور خطأ Mail هذا.",
     openGitHubIssue: "فتح مشكلة في GitHub",
@@ -469,6 +486,18 @@ export function ErrorBoundary() {
   const copy =
     MAIL_ERROR_COPY[activeErrorLocale()] ?? MAIL_ERROR_COPY[DEFAULT_LOCALE];
   const message = routeErrorMessage(error, copy.fallback);
+  const staleChunk = isDynamicImportFailureMessage(message);
+  const [recovering, setRecovering] = useState(staleChunk);
+
+  useEffect(() => {
+    if (!staleChunk) {
+      setRecovering(false);
+      return;
+    }
+    if (!recoverFromStaleChunkError(error)) setRecovering(false);
+  }, [error, staleChunk]);
+
+  if (recovering) return <DefaultSpinner ariaLabel={copy.loading} />;
 
   return (
     <div className="flex min-h-screen items-center justify-center bg-background px-6 text-foreground">

package/dist/action.d.ts

@@ -130,8 +130,10 @@ export interface ActionRunContext {
  */
 export type ActionAuthorize<TArgs> = (args: TArgs, ctx?: ActionRunContext) => void | boolean | Promise<void | boolean>;
 export interface AgentActionStopOptions {
-    /** Optional stable code surfaced in run metadata and tests. */
+    /** Optional stable code safe to surface in run metadata and action transports. */
     errorCode?: string;
+    /** Safe structured context for callers. Never include secrets or raw driver errors. */
+    details?: Record<string, unknown>;
     /** Optional short tool-result text. Defaults to the user-facing message. */
     toolResult?: string;
 }
@@ -164,6 +166,7 @@ export declare function isActionContractError(error: unknown): error is ActionCo
 export declare class AgentActionStopError extends Error {
     readonly agentNativeStop = true;
     readonly errorCode?: string;
+    readonly details?: Record<string, unknown>;
     readonly toolResult?: string;
     constructor(message: string, options?: AgentActionStopOptions);
 }

package/dist/action.js

@@ -34,11 +34,13 @@ export function isActionContractError(error) {
 export class AgentActionStopError extends Error {
     agentNativeStop = true;
     errorCode;
+    details;
     toolResult;
     constructor(message, options = {}) {
         super(message);
         this.name = "AgentActionStopError";
         this.errorCode = options.errorCode;
+        this.details = options.details;
         this.toolResult = options.toolResult;
     }
 }

package/dist/client/DefaultSpinner.d.ts

@@ -1 +1,3 @@
-export declare function DefaultSpinner(): import("react").JSX.Element;
+export declare function DefaultSpinner({ ariaLabel, }: {
+    ariaLabel?: string;
+}): import("react").JSX.Element;

package/dist/client/DefaultSpinner.js

@@ -23,7 +23,7 @@ function isDevelopmentBuild() {
         return false;
     return viteEnv?.DEV === true;
 }
-export function DefaultSpinner() {
+export function DefaultSpinner({ ariaLabel = "Loading", }) {
     const [showStallHint, setShowStallHint] = useState(false);
     useEffect(() => {
         setShowStallHint(isDevelopmentBuild());
@@ -36,7 +36,7 @@ export function DefaultSpinner() {
             gap: 16,
             height: "100vh",
             width: "100%",
-        }, children: [_jsx("svg", { role: "status", "aria-label": "Loading", width: 24, height: 24, viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: 2, strokeLinecap: "round", strokeLinejoin: "round", style: { animation: "an-spin 1s linear infinite", opacity: 0.7 }, children: _jsx("path", { d: "M21 12a9 9 0 1 1-6.219-8.56" }) }), showStallHint && (_jsx("p", { className: "an-stall-hint", children: "Still loading. A first run compiles dependencies and can take a minute \u2014 if it does not finish, check the terminal running the dev server for errors." })), _jsx("style", { children: `
+        }, children: [_jsx("svg", { role: "status", "aria-label": ariaLabel, width: 24, height: 24, viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: 2, strokeLinecap: "round", strokeLinejoin: "round", style: { animation: "an-spin 1s linear infinite", opacity: 0.7 }, children: _jsx("path", { d: "M21 12a9 9 0 1 1-6.219-8.56" }) }), showStallHint && (_jsx("p", { className: "an-stall-hint", children: "Still loading. A first run compiles dependencies and can take a minute \u2014 if it does not finish, check the terminal running the dev server for errors." })), _jsx("style", { children: `
         @keyframes an-spin { to { transform: rotate(360deg) } }
         ${showStallHint
                     ? `

package/dist/client/chat-first/apps-rail.d.ts

@@ -1,3 +1,3 @@
 import type { ChatFirstAppRailProps } from "./types.js";
 export declare const CHAT_FIRST_APP_RAIL_SHOW_ALL_STORAGE_KEY = "agent-native:chat-first-app-rail-show-all:v1";
-export declare const ChatFirstAppsRail: import("react").MemoExoticComponent<({ apps, defaultAppIds, activeAppId, loading, error, collapsed, layout: controlledLayout, onLayoutChange, onLayoutError, onRetry, onOpenApp, onRemoveApp, onOpenAllApps, onCreateApp, createAppTrigger, renderIcon, copy, }: ChatFirstAppRailProps) => import("react").JSX.Element>;
+export declare const ChatFirstAppsRail: import("react").MemoExoticComponent<({ apps, defaultAppIds, activeAppId, loading, error, collapsed, layout: controlledLayout, onLayoutChange, onLayoutError, onRetry, onOpenApp, onReloadApp, onRemoveApp, onOpenAllApps, onCreateApp, createAppTrigger, renderIcon, copy, }: ChatFirstAppRailProps) => import("react").JSX.Element>;

package/dist/client/chat-first/apps-rail.js

@@ -1,6 +1,6 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { ContextMenu, ContextMenuContent, ContextMenuItem, ContextMenuSeparator, ContextMenuTrigger, Skeleton, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, } from "@agent-native/toolkit/ui";
-import { IconApps, IconChevronDown, IconChevronUp, IconPin, IconPlus, IconTrash, } from "@tabler/icons-react";
+import { IconApps, IconChevronDown, IconChevronUp, IconPin, IconPlus, IconRefresh, IconTrash, } from "@tabler/icons-react";
 import { memo, useEffect, useMemo, useState } from "react";
 import { CHAT_FIRST_DEFAULT_APP_IDS, orderChatFirstAppIds, readChatFirstAppLayout, writeChatFirstAppLayout, } from "../chat-first.js";
 import { cn } from "../utils.js";
@@ -33,7 +33,10 @@ function ChatFirstRailAppIcon({ app, activeAppId, renderIcon, }) {
     const isInactive = activeAppId !== undefined && !isActive;
     return (_jsx("span", { "data-chat-first-app-icon": true, className: cn("transition-[filter]", isInactive && "grayscale"), children: renderIcon(app, { isActive, isInactive }) }));
 }
-function AppRows({ apps, defaultAppIds, activeAppId, layout, onDragStart, onDrop, onDragEnd, onOpenApp, onRemoveApp, onTogglePinned, onMove, renderIcon, copy, }) {
+function AppContextMenuContent({ app, copy, index, onMove, onReloadApp, onRemoveApp, onTogglePinned, pinned, total, }) {
+    return (_jsxs(ContextMenuContent, { children: [_jsxs(ContextMenuItem, { onSelect: () => onTogglePinned(app.id), children: [_jsx(IconPin, { size: 14, "aria-hidden": "true" }), pinned ? copy("removePinned") : copy("pinTop")] }), onReloadApp ? (_jsxs(ContextMenuItem, { onSelect: () => onReloadApp(app), children: [_jsx(IconRefresh, { size: 14, "aria-hidden": "true" }), copy("reloadApp")] })) : null, _jsx(ContextMenuSeparator, {}), _jsxs(ContextMenuItem, { disabled: index === 0, onSelect: () => onMove(app.id, -1), children: [_jsx(IconChevronUp, { size: 14, "aria-hidden": "true" }), copy("moveUp")] }), _jsxs(ContextMenuItem, { disabled: index === total - 1, onSelect: () => onMove(app.id, 1), children: [_jsx(IconChevronDown, { size: 14, "aria-hidden": "true" }), copy("moveDown")] }), onRemoveApp ? (_jsxs(_Fragment, { children: [_jsx(ContextMenuSeparator, {}), _jsxs(ContextMenuItem, { onSelect: () => onRemoveApp(app), className: "text-destructive focus:text-destructive", children: [_jsx(IconTrash, { size: 14, "aria-hidden": "true" }), copy("removeApp")] })] })) : null] }));
+}
+function AppRows({ apps, defaultAppIds, activeAppId, layout, onDragStart, onDrop, onDragEnd, onOpenApp, onReloadApp, onRemoveApp, onTogglePinned, onMove, renderIcon, copy, }) {
     const orderedIds = orderChatFirstAppIds(apps.map((app) => app.id), layout, defaultAppIds);
     const appsById = new Map(apps.map((app) => [app.id, app]));
     const orderedApps = orderedIds
@@ -61,10 +64,10 @@ function AppRows({ apps, defaultAppIds, activeAppId, layout, onDragStart, onDrop
                                         }
                                     }, "aria-keyshortcuts": "Alt+ArrowUp Alt+ArrowDown", "aria-label": copy("openApp", { name: app.name }), children: [_jsx(ChatFirstRailAppIcon, { app: app, activeAppId: activeAppId, renderIcon: renderIcon }), _jsx("span", { className: "truncate", children: app.name })] }), _jsx("button", { type: "button", className: cn("flex size-6 shrink-0 items-center justify-center rounded text-sidebar-foreground/45 opacity-0 hover:bg-sidebar-accent hover:text-sidebar-foreground group-hover:opacity-100 focus-visible:opacity-100", pinned && "text-sidebar-foreground/70 opacity-100"), "aria-label": copy(pinned ? "unpinApp" : "pinApp", {
                                         name: app.name,
-                                    }), "aria-pressed": pinned, onClick: () => onTogglePinned(app.id), children: _jsx(IconPin, { size: 13, strokeWidth: pinned ? 2.2 : 1.6, "aria-hidden": "true" }) }), _jsx("span", { className: "sr-only", children: `${index + 1} of ${orderedApps.length}` })] }) }), _jsxs(ContextMenuContent, { children: [_jsxs(ContextMenuItem, { onSelect: () => onTogglePinned(app.id), children: [_jsx(IconPin, { size: 14, "aria-hidden": "true" }), pinned ? copy("removePinned") : copy("pinTop")] }), _jsx(ContextMenuSeparator, {}), _jsxs(ContextMenuItem, { disabled: index === 0, onSelect: () => onMove(app.id, -1), children: [_jsx(IconChevronUp, { size: 14, "aria-hidden": "true" }), copy("moveUp")] }), _jsxs(ContextMenuItem, { disabled: index === orderedApps.length - 1, onSelect: () => onMove(app.id, 1), children: [_jsx(IconChevronDown, { size: 14, "aria-hidden": "true" }), copy("moveDown")] }), onRemoveApp ? (_jsxs(_Fragment, { children: [_jsx(ContextMenuSeparator, {}), _jsxs(ContextMenuItem, { onSelect: () => onRemoveApp(app), className: "text-destructive focus:text-destructive", children: [_jsx(IconTrash, { size: 14, "aria-hidden": "true" }), copy("removeApp")] })] })) : null] })] }, app.id));
+                                    }), "aria-pressed": pinned, onClick: () => onTogglePinned(app.id), children: _jsx(IconPin, { size: 13, strokeWidth: pinned ? 2.2 : 1.6, "aria-hidden": "true" }) }), _jsx("span", { className: "sr-only", children: `${index + 1} of ${orderedApps.length}` })] }) }), _jsx(AppContextMenuContent, { app: app, copy: copy, index: index, onMove: onMove, onReloadApp: onReloadApp, onRemoveApp: onRemoveApp, onTogglePinned: onTogglePinned, pinned: pinned, total: orderedApps.length })] }, app.id));
         }) }));
 }
-export const ChatFirstAppsRail = memo(function ChatFirstAppsRail({ apps, defaultAppIds, activeAppId, loading = false, error, collapsed = false, layout: controlledLayout, onLayoutChange, onLayoutError, onRetry, onOpenApp, onRemoveApp, onOpenAllApps, onCreateApp, createAppTrigger, renderIcon, copy = defaultChatFirstCopy, }) {
+export const ChatFirstAppsRail = memo(function ChatFirstAppsRail({ apps, defaultAppIds, activeAppId, loading = false, error, collapsed = false, layout: controlledLayout, onLayoutChange, onLayoutError, onRetry, onOpenApp, onReloadApp, onRemoveApp, onOpenAllApps, onCreateApp, createAppTrigger, renderIcon, copy = defaultChatFirstCopy, }) {
     const [localLayout, setLocalLayout] = useState(() => readChatFirstAppLayout());
     const layout = controlledLayout ?? localLayout;
     const [draggedAppId, setDraggedAppId] = useState(null);
@@ -135,9 +138,9 @@ export const ChatFirstAppsRail = memo(function ChatFirstAppsRail({ apps, default
     if (collapsed) {
         return (_jsx(TooltipProvider, { children: _jsxs("section", { "data-chat-first-apps-rail": true, className: "flex flex-col items-center gap-1 px-1.5 pt-2", "aria-label": copy("workspaceApps"), children: [loading && apps.length === 0
                         ? [0, 1, 2].map((index) => (_jsx(Skeleton, { className: "size-9 rounded-md" }, index)))
-                        : visibleApps.map((app) => (_jsxs(Tooltip, { delayDuration: 0, children: [_jsx(TooltipTrigger, { asChild: true, children: _jsx("button", { type: "button", "data-chat-first-app": true, "data-app-id": app.id, className: cn("flex size-9 items-center justify-center rounded-md", activeAppId === app.id
-                                            ? "bg-sidebar-accent text-sidebar-accent-foreground"
-                                            : "text-sidebar-foreground/70 hover:bg-sidebar-accent hover:text-sidebar-accent-foreground"), onClick: () => onOpenApp(app), "aria-label": copy("openApp", { name: app.name }), children: _jsx(ChatFirstRailAppIcon, { app: app, activeAppId: activeAppId, renderIcon: renderIcon }) }) }), _jsx(TooltipContent, { side: "right", children: app.name })] }, app.id))), onOpenAllApps ? (_jsxs(Tooltip, { delayDuration: 0, children: [_jsx(TooltipTrigger, { asChild: true, children: _jsx("button", { type: "button", "data-chat-first-all-apps": true, className: "flex size-9 items-center justify-center rounded-md text-sidebar-foreground/70 hover:bg-sidebar-accent hover:text-sidebar-accent-foreground", onClick: onOpenAllApps, "aria-label": copy("allApps"), children: _jsx(IconApps, { size: 16, "aria-hidden": "true" }) }) }), _jsx(TooltipContent, { side: "right", children: copy("allApps") })] })) : null, error ? (_jsx("span", { className: "size-1.5 rounded-full bg-destructive", title: error, "aria-label": error })) : null] }) }));
+                        : visibleApps.map((app) => (_jsxs(ContextMenu, { children: [_jsxs(Tooltip, { delayDuration: 0, children: [_jsx(TooltipTrigger, { asChild: true, children: _jsx(ContextMenuTrigger, { asChild: true, children: _jsx("button", { type: "button", "data-chat-first-app": true, "data-app-id": app.id, className: cn("flex size-9 items-center justify-center rounded-md", activeAppId === app.id
+                                                        ? "bg-sidebar-accent text-sidebar-accent-foreground"
+                                                        : "text-sidebar-foreground/70 hover:bg-sidebar-accent hover:text-sidebar-accent-foreground"), onClick: () => onOpenApp(app), "aria-label": copy("openApp", { name: app.name }), children: _jsx(ChatFirstRailAppIcon, { app: app, activeAppId: activeAppId, renderIcon: renderIcon }) }) }) }), _jsx(TooltipContent, { side: "right", children: app.name })] }), _jsx(AppContextMenuContent, { app: app, copy: copy, index: orderedApps.indexOf(app), onMove: moveApp, onReloadApp: onReloadApp, onRemoveApp: onRemoveApp, onTogglePinned: togglePinned, pinned: layout.pinnedIds.includes(app.id), total: orderedApps.length })] }, app.id))), onOpenAllApps ? (_jsxs(Tooltip, { delayDuration: 0, children: [_jsx(TooltipTrigger, { asChild: true, children: _jsx("button", { type: "button", "data-chat-first-all-apps": true, className: "flex size-9 items-center justify-center rounded-md text-sidebar-foreground/70 hover:bg-sidebar-accent hover:text-sidebar-accent-foreground", onClick: onOpenAllApps, "aria-label": copy("allApps"), children: _jsx(IconApps, { size: 16, "aria-hidden": "true" }) }) }), _jsx(TooltipContent, { side: "right", children: copy("allApps") })] })) : null, error ? (_jsx("span", { className: "size-1.5 rounded-full bg-destructive", title: error, "aria-label": error })) : null] }) }));
     }
-    return (_jsxs("section", { "data-chat-first-apps-rail": true, className: "mt-3 px-2 pb-2 pt-2", "aria-label": copy("workspaceApps"), children: [_jsxs("div", { className: "mb-1 flex items-center gap-1.5 px-2 text-[11px] font-medium text-sidebar-foreground/50", children: [_jsx("span", { children: copy("workspaceApps") }), _jsx("span", { className: "ml-auto", children: createTrigger })] }), loading && apps.length === 0 ? (_jsx("div", { className: "space-y-0.5 px-2", children: [0, 1, 2].map((index) => (_jsx(Skeleton, { className: "h-8 w-full rounded-md" }, index))) })) : apps.length === 0 ? (_jsxs("div", { className: "px-2", children: [_jsx("p", { className: "text-xs text-sidebar-foreground/55", children: copy("noWorkspaceApps") }), createAppTrigger ? (createTrigger) : onCreateApp ? (_jsxs("button", { type: "button", className: "mt-1 inline-flex h-6 items-center gap-1.5 rounded-md border border-sidebar-border px-2 text-xs text-sidebar-foreground/75 hover:bg-sidebar-accent hover:text-sidebar-foreground", onClick: onCreateApp, children: [_jsx(IconPlus, { size: 13, "aria-hidden": "true" }), copy("createApp")] })) : (createTrigger)] })) : (_jsx(AppRows, { apps: visibleApps, defaultAppIds: defaultAppIds, activeAppId: activeAppId, layout: layout, onDragStart: setDraggedAppId, onDrop: reorderApps, onDragEnd: () => setDraggedAppId(null), onOpenApp: onOpenApp, onRemoveApp: onRemoveApp, onTogglePinned: togglePinned, onMove: moveApp, renderIcon: renderIcon, copy: copy })), hasMoreApps || showAllApps ? (_jsxs("button", { type: "button", className: "mt-0.5 flex h-8 w-full items-center gap-2 rounded-md px-2 text-xs text-sidebar-foreground/50 hover:bg-sidebar-accent hover:text-sidebar-foreground", onClick: () => setShowAllApps((value) => !value), children: [showAllApps ? (_jsx(IconChevronUp, { size: 14, "aria-hidden": "true" })) : (_jsx(IconChevronDown, { size: 14, "aria-hidden": "true" })), showAllApps ? copy("showLess") : copy("showMore")] })) : null, onOpenAllApps ? (_jsx("div", { className: "mt-1 border-t border-sidebar-border/60 pt-1", children: _jsxs("button", { type: "button", "data-chat-first-all-apps": true, className: "flex h-8 w-full items-center gap-2 rounded-md px-2 text-xs text-sidebar-foreground/55 hover:bg-sidebar-accent hover:text-sidebar-foreground", onClick: onOpenAllApps, children: [_jsx(IconApps, { size: 14, "aria-hidden": "true" }), _jsx("span", { children: copy("allApps") })] }) })) : null, error ? (_jsxs(Tooltip, { children: [_jsx(TooltipTrigger, { asChild: true, children: _jsxs("button", { type: "button", className: "mt-1 flex items-center gap-1 px-2 text-[10px] text-destructive/80", onClick: onRetry, "aria-label": error, children: [_jsx("span", { className: "size-1.5 rounded-full bg-destructive" }), onRetry ? copy("retry") : copy("appsLoadError")] }) }), _jsx(TooltipContent, { side: "right", children: error })] })) : null] }));
+    return (_jsxs("section", { "data-chat-first-apps-rail": true, className: "mt-3 px-2 pb-2 pt-2", "aria-label": copy("workspaceApps"), children: [_jsxs("div", { className: "mb-1 flex items-center gap-1.5 px-2 text-[11px] font-medium text-sidebar-foreground/50", children: [_jsx("span", { children: copy("workspaceApps") }), _jsx("span", { className: "ml-auto", children: createTrigger })] }), loading && apps.length === 0 ? (_jsx("div", { className: "space-y-0.5 px-2", children: [0, 1, 2].map((index) => (_jsx(Skeleton, { className: "h-8 w-full rounded-md" }, index))) })) : apps.length === 0 ? (_jsxs("div", { className: "px-2", children: [_jsx("p", { className: "text-xs text-sidebar-foreground/55", children: copy("noWorkspaceApps") }), createAppTrigger ? (createTrigger) : onCreateApp ? (_jsxs("button", { type: "button", className: "mt-1 inline-flex h-6 items-center gap-1.5 rounded-md border border-sidebar-border px-2 text-xs text-sidebar-foreground/75 hover:bg-sidebar-accent hover:text-sidebar-foreground", onClick: onCreateApp, children: [_jsx(IconPlus, { size: 13, "aria-hidden": "true" }), copy("createApp")] })) : (createTrigger)] })) : (_jsx(AppRows, { apps: visibleApps, defaultAppIds: defaultAppIds, activeAppId: activeAppId, layout: layout, onDragStart: setDraggedAppId, onDrop: reorderApps, onDragEnd: () => setDraggedAppId(null), onOpenApp: onOpenApp, onReloadApp: onReloadApp, onRemoveApp: onRemoveApp, onTogglePinned: togglePinned, onMove: moveApp, renderIcon: renderIcon, copy: copy })), hasMoreApps || showAllApps ? (_jsxs("button", { type: "button", className: "mt-0.5 flex h-8 w-full items-center gap-2 rounded-md px-2 text-xs text-sidebar-foreground/50 hover:bg-sidebar-accent hover:text-sidebar-foreground", onClick: () => setShowAllApps((value) => !value), children: [showAllApps ? (_jsx(IconChevronUp, { size: 14, "aria-hidden": "true" })) : (_jsx(IconChevronDown, { size: 14, "aria-hidden": "true" })), showAllApps ? copy("showLess") : copy("showMore")] })) : null, onOpenAllApps ? (_jsx("div", { className: "mt-1 border-t border-sidebar-border/60 pt-1", children: _jsxs("button", { type: "button", "data-chat-first-all-apps": true, className: "flex h-8 w-full items-center gap-2 rounded-md px-2 text-xs text-sidebar-foreground/55 hover:bg-sidebar-accent hover:text-sidebar-foreground", onClick: onOpenAllApps, children: [_jsx(IconApps, { size: 14, "aria-hidden": "true" }), _jsx("span", { children: copy("allApps") })] }) })) : null, error ? (_jsxs(Tooltip, { children: [_jsx(TooltipTrigger, { asChild: true, children: _jsxs("button", { type: "button", className: "mt-1 flex items-center gap-1 px-2 text-[10px] text-destructive/80", onClick: onRetry, "aria-label": error, children: [_jsx("span", { className: "size-1.5 rounded-full bg-destructive" }), onRetry ? copy("retry") : copy("appsLoadError")] }) }), _jsx(TooltipContent, { side: "right", children: error })] })) : null] }));
 });

package/dist/client/chat-first/copy.js

@@ -14,6 +14,7 @@ const DEFAULT_COPY = {
     dismiss: "Dismiss",
     unpinApp: "Unpin this app",
     pinApp: "Pin this app",
+    reloadApp: "Reload app",
     removePinned: "Remove from pinned apps",
     pinTop: "Pin app to the top",
     moveUp: "Move up",

package/dist/client/chat-first/types.d.ts

@@ -56,6 +56,7 @@ export interface ChatFirstAppRailProps {
     onLayoutError?: (reason: "unavailable" | "write-failed") => void;
     onRetry?: () => void;
     onOpenApp: (app: ChatFirstAppItem) => void;
+    onReloadApp?: (app: ChatFirstAppItem) => void;
     onRemoveApp?: (app: ChatFirstAppItem) => void;
     onOpenAllApps?: () => void;
     onCreateApp?: () => void;