@agent-native/core 0.97.0 → 0.98.1

package/corpus/templates/plan/app/i18n/ar-SA.ts

@@ -434,6 +434,16 @@ const messages = {
       title: "لم يتم العثور على الخطة المحلية",
       message: 'تعذرت قراءة مجلد الخطة المحلية "{{slug}}".',
     },
+    localPlanConnection: {
+      promptTitle: "الاتصال بهذه الخطة المحلية",
+      promptMessage:
+        "تظل هذه الخطة على جهازك. يحتاج Plan إلى إذن المتصفح لقراءتها من الجسر المحلي.",
+      deniedTitle: "تم حظر الوصول إلى الشبكة المحلية",
+      deniedMessage:
+        "افتح إعدادات الموقع في متصفحك لـ Plan، واسمح بالوصول إلى الشبكة المحلية، ثم تحقق مرة أخرى.",
+      connect: "الاتصال بالخطة المحلية",
+      checkAgain: "التحقق مرة أخرى",
+    },
     overview: {
       title: "يخطط",
       documentCount_other: "{{count}} المستندات",

package/corpus/templates/plan/app/i18n/de-DE.ts

@@ -448,6 +448,16 @@ const messages = {
       title: "Lokaler Plan nicht gefunden",
       message: "Der lokale Planordner „{{slug}}“ konnte nicht gelesen werden.",
     },
+    localPlanConnection: {
+      promptTitle: "Mit diesem lokalen Plan verbinden",
+      promptMessage:
+        "Dieser Plan bleibt auf deinem Computer. Plan benötigt die Berechtigung des Browsers, um ihn über die lokale Verbindung zu lesen.",
+      deniedTitle: "Der Zugriff auf das lokale Netzwerk ist blockiert",
+      deniedMessage:
+        "Öffne die Website-Einstellungen deines Browsers für Plan, erlaube den Zugriff auf das lokale Netzwerk und prüfe es dann erneut.",
+      connect: "Mit lokalem Plan verbinden",
+      checkAgain: "Erneut prüfen",
+    },
     overview: {
       title: "planen",
       documentCount_other: "{{count}} Dokumente",

package/corpus/templates/plan/app/i18n/en-US.ts

@@ -433,6 +433,16 @@ const messages = {
       title: "Local plan not found",
       message: 'The local plan folder "{{slug}}" could not be read.',
     },
+    localPlanConnection: {
+      promptTitle: "Connect to this local plan",
+      promptMessage:
+        "This plan stays on your computer. Plan needs browser permission to read it from the local bridge.",
+      deniedTitle: "Local network access is blocked",
+      deniedMessage:
+        "Open your browser's site settings for Plan, allow local network access, then check again.",
+      connect: "Connect to local plan",
+      checkAgain: "Check again",
+    },
     overview: {
       title: "Plans",
       documentCount_one: "{{count}} document",

package/corpus/templates/plan/app/i18n/es-ES.ts

@@ -500,6 +500,16 @@ const messages = {
       message: 'No se pudo leer la carpeta del plan local "{{slug}}".',
       title: "Plan local no encontrado",
     },
+    localPlanConnection: {
+      promptTitle: "Conectarse a este plan local",
+      promptMessage:
+        "Este plan permanece en tu ordenador. Plan necesita permiso del navegador para leerlo desde el puente local.",
+      deniedTitle: "El acceso a la red local está bloqueado",
+      deniedMessage:
+        "Abre la configuración del sitio de Plan en el navegador, permite el acceso a la red local y vuelve a comprobarlo.",
+      connect: "Conectarse al plan local",
+      checkAgain: "Comprobar de nuevo",
+    },
     loggedOut: {
       copied: "copiado",
       copy: "Copiar",

package/corpus/templates/plan/app/i18n/fr-FR.ts

@@ -502,6 +502,16 @@ const messages = {
       message: 'Le dossier du plan local "{{slug}}" n\'a pas pu être lu.',
       title: "Plan local introuvable",
     },
+    localPlanConnection: {
+      promptTitle: "Se connecter à ce plan local",
+      promptMessage:
+        "Ce plan reste sur votre ordinateur. Plan a besoin de l’autorisation du navigateur pour le lire depuis le pont local.",
+      deniedTitle: "L’accès au réseau local est bloqué",
+      deniedMessage:
+        "Ouvrez les paramètres du site de Plan dans votre navigateur, autorisez l’accès au réseau local, puis vérifiez à nouveau.",
+      connect: "Se connecter au plan local",
+      checkAgain: "Vérifier à nouveau",
+    },
     loggedOut: {
       copied: "Copié",
       copy: "Copie",

package/corpus/templates/plan/app/i18n/hi-IN.ts

@@ -431,6 +431,16 @@ const messages = {
       title: "स्थानीय योजना नहीं मिली",
       message: 'स्थानीय योजना फ़ोल्डर "{{slug}}" पढ़ा नहीं जा सका।',
     },
+    localPlanConnection: {
+      promptTitle: "इस स्थानीय योजना से कनेक्ट करें",
+      promptMessage:
+        "यह योजना आपके कंप्यूटर पर ही रहती है। इसे स्थानीय ब्रिज से पढ़ने के लिए Plan को ब्राउज़र की अनुमति चाहिए।",
+      deniedTitle: "स्थानीय नेटवर्क की पहुँच अवरुद्ध है",
+      deniedMessage:
+        "अपने ब्राउज़र में Plan की साइट सेटिंग खोलें, स्थानीय नेटवर्क की पहुँच की अनुमति दें और फिर दोबारा जाँचें।",
+      connect: "स्थानीय योजना से कनेक्ट करें",
+      checkAgain: "फिर से जाँचें",
+    },
     overview: {
       title: "योजना",
       documentCount_other: "{{count}} दस्तावेज़",

package/corpus/templates/plan/app/i18n/ja-JP.ts

@@ -443,6 +443,16 @@ const messages = {
       title: "ローカルプランが見つかりません",
       message: "ローカル プラン フォルダー「{{slug}}」を読み取れませんでした。",
     },
+    localPlanConnection: {
+      promptTitle: "このローカルプランに接続",
+      promptMessage:
+        "このプランはコンピューター上に保存されています。ローカルブリッジから読み取るには、Plan にブラウザーの許可が必要です。",
+      deniedTitle: "ローカルネットワークへのアクセスがブロックされています",
+      deniedMessage:
+        "ブラウザーで Plan のサイト設定を開き、ローカルネットワークへのアクセスを許可してから、もう一度確認してください。",
+      connect: "ローカルプランに接続",
+      checkAgain: "もう一度確認",
+    },
     overview: {
       title: "计划",
       documentCount_other: "{{count}} 个文档",

package/corpus/templates/plan/app/i18n/ko-KR.ts

@@ -432,6 +432,16 @@ const messages = {
       title: "지역 계획을 찾을 수 없습니다.",
       message: '로컬 계획 폴더 "{{slug}}"을(를) 읽을 수 없습니다.',
     },
+    localPlanConnection: {
+      promptTitle: "이 로컬 계획에 연결",
+      promptMessage:
+        "이 계획은 컴퓨터에 그대로 보관됩니다. 로컬 브리지에서 읽으려면 Plan에 브라우저 권한이 필요합니다.",
+      deniedTitle: "로컬 네트워크 접근이 차단되었습니다",
+      deniedMessage:
+        "브라우저에서 Plan의 사이트 설정을 열고 로컬 네트워크 접근을 허용한 다음 다시 확인하세요.",
+      connect: "로컬 계획에 연결",
+      checkAgain: "다시 확인",
+    },
     overview: {
       title: "计划",
       documentCount_other: "{{count}} 个文档",

package/corpus/templates/plan/app/i18n/pt-BR.ts

@@ -445,6 +445,16 @@ const messages = {
       title: "Plano local não encontrado",
       message: 'A pasta do plano local "{{slug}}" não pôde ser lida.',
     },
+    localPlanConnection: {
+      promptTitle: "Conectar a este plano local",
+      promptMessage:
+        "Este plano permanece no seu computador. O Plan precisa da permissão do navegador para lê-lo pela ponte local.",
+      deniedTitle: "O acesso à rede local está bloqueado",
+      deniedMessage:
+        "Abra as configurações do site do Plan no navegador, permita o acesso à rede local e verifique novamente.",
+      connect: "Conectar ao plano local",
+      checkAgain: "Verificar novamente",
+    },
     overview: {
       title: "plano",
       documentCount_other: "{{count}} documentos",

package/corpus/templates/plan/app/i18n/zh-CN.ts

@@ -468,6 +468,16 @@ const messages = {
       message: "无法读取本地计划文件夹“{{slug}}”。",
       title: "未找到本地计划",
     },
+    localPlanConnection: {
+      promptTitle: "连接到此本地计划",
+      promptMessage:
+        "此计划保留在你的电脑上。Plan 需要浏览器权限才能通过本地桥接读取它。",
+      deniedTitle: "本地网络访问已被阻止",
+      deniedMessage:
+        "打开浏览器中 Plan 的网站设置，允许访问本地网络，然后再次检查。",
+      connect: "连接到本地计划",
+      checkAgain: "再次检查",
+    },
     loggedOut: {
       copied: "已复制",
       copy: "复制",

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

@@ -468,6 +468,16 @@ const messages = {
       message: "無法讀取本機計畫資料夾“{{slug}}”。",
       title: "未找到本機計畫",
     },
+    localPlanConnection: {
+      promptTitle: "連線至此本機計畫",
+      promptMessage:
+        "此計畫會保留在你的電腦上。Plan 需要瀏覽器權限，才能透過本機橋接讀取它。",
+      deniedTitle: "本機網路存取已遭封鎖",
+      deniedMessage:
+        "開啟瀏覽器中 Plan 的網站設定，允許存取本機網路，然後再次檢查。",
+      connect: "連線至本機計畫",
+      checkAgain: "再次檢查",
+    },
     loggedOut: {
       copied: "已複製",
       copy: "複製",

package/corpus/templates/plan/app/lib/plan-local-bridge.ts

@@ -46,6 +46,53 @@ type LocalPlanBridgeCommentUpdate = {
   deletedCommentIds?: string[];
 };
 
+export type LocalNetworkAccessPermissionState =
+  | "checking"
+  | "prompt"
+  | "granted"
+  | "denied"
+  | "unsupported";
+
+export class LocalPlanBridgePermissionError extends Error {
+  readonly permissionState: "prompt" | "denied";
+
+  constructor(permissionState: "prompt" | "denied") {
+    super(
+      permissionState === "denied"
+        ? "Local network access is blocked for this site. Open your browser's site settings for Plan, allow local network access, then retry."
+        : "Plan needs permission to connect to the local plan on this computer. Allow local network access in your browser, then retry.",
+    );
+    this.name = "LocalPlanBridgePermissionError";
+    this.permissionState = permissionState;
+  }
+}
+
+export async function localNetworkAccessPermissionState(): Promise<
+  Exclude<LocalNetworkAccessPermissionState, "checking">
+> {
+  if (typeof navigator === "undefined" || !navigator.permissions?.query) {
+    return "unsupported";
+  }
+  try {
+    // Chrome 145 split this permission into local-network and
+    // loopback-network, but keeps the Chrome 142 alias working for queries.
+    const status = await navigator.permissions.query({
+      name: "local-network-access",
+    } as unknown as PermissionDescriptor);
+    if (
+      status.state === "granted" ||
+      status.state === "denied" ||
+      status.state === "prompt"
+    ) {
+      return status.state;
+    }
+  } catch {
+    // Browsers without Local Network Access expose Permissions but reject the
+    // Chrome-specific permission name. Fall through to the legacy fetch path.
+  }
+  return "unsupported";
+}
+
 function assertLocalBridgeUrl(value: string): string {
   let url: URL;
   try {
@@ -92,6 +139,7 @@ export function shouldRetryLocalPlanBridgeBundle(
   failureCount: number,
   error: unknown,
 ) {
+  if (error instanceof LocalPlanBridgePermissionError) return false;
   const message = error instanceof Error ? error.message : String(error ?? "");
   if (
     message.includes("Local plan bridge URL") ||
@@ -107,6 +155,28 @@ export function localPlanBridgeRetryDelay(attemptIndex: number) {
   return Math.min(500 * 2 ** attemptIndex, 2_500);
 }
 
+export function shouldShowLocalPlanLoadError(input: {
+  localPlanMode: boolean;
+  hasBundle: boolean;
+  hasBridgeUrl: boolean;
+  bridgeFetchEnabled: boolean;
+  error: unknown;
+  loading: boolean;
+  fetching: boolean;
+  permissionState: LocalNetworkAccessPermissionState;
+}): boolean {
+  if (!input.localPlanMode || input.hasBundle) return false;
+  if (input.hasBridgeUrl && !input.bridgeFetchEnabled) return false;
+  if (
+    input.error instanceof LocalPlanBridgePermissionError &&
+    (input.permissionState === "granted" ||
+      input.permissionState === "unsupported")
+  ) {
+    return false;
+  }
+  return Boolean(input.error) || (!input.loading && !input.fetching);
+}
+
 /**
  * Decide whether the hosted-plan render should surface the retryable load
  * error card instead of the initial skeleton.
@@ -342,7 +412,16 @@ export async function fetchLocalPlanBridgeBundle(
   fallbackSlug: string,
 ): Promise<LocalPlanBundle> {
   const safeUrl = assertLocalBridgeUrl(bridgeUrl);
-  const response = await fetch(safeUrl, { cache: "no-store" });
+  let response: Response;
+  try {
+    response = await fetch(safeUrl, { cache: "no-store" });
+  } catch (error) {
+    const permissionState = await localNetworkAccessPermissionState();
+    if (permissionState === "prompt" || permissionState === "denied") {
+      throw new LocalPlanBridgePermissionError(permissionState);
+    }
+    throw error;
+  }
   const payload = (await response
     .json()
     .catch(() => null)) as LocalPlanBridgePayload | null;

package/corpus/templates/plan/app/pages/PlansPage.tsx

@@ -272,15 +272,19 @@ import {
 import { planDocumentTitle } from "@/lib/plan-document-title";
 import {
   fetchLocalPlanBridgeBundle,
+  localNetworkAccessPermissionState,
   localPlanBridgeQueryKey,
   localPlanBridgeRetryDelay,
   localPlanRoutePath,
   localPlanRouteUrl,
   mergeLocalBridgeComments,
   shouldRetryLocalPlanBridgeBundle,
+  shouldShowLocalPlanLoadError,
   shouldShowPlanLoadError,
   updateLocalPlanBridgeComments,
+  LocalPlanBridgePermissionError,
   type LocalPlanBundle,
+  type LocalNetworkAccessPermissionState,
   type PlanBundleWithHtml,
   type PlanCommentItem,
 } from "@/lib/plan-local-bridge";
@@ -2014,7 +2018,6 @@ export function PlansPage({ localPlanSlug }: { localPlanSlug?: string } = {}) {
   // Ref that signals the 3-second poll to pause while a comment mutation is
   // in-flight. Prevents poll-driven cache replacement from evicting optimistic
   // comments before the server write commits (Issue 4a).
-  const commentMutationPendingRef = useRef(false);
   const { session, isLoading: sessionLoading } = useSession();
   const localPlanMode = Boolean(localPlanSlug);
   const routeSearchParams = useMemo(
@@ -2028,12 +2031,39 @@ export function PlansPage({ localPlanSlug }: { localPlanSlug?: string } = {}) {
     ? routeSearchParams.get("path")
     : null;
   const routeSelectedId = params.id;
+  const [localNetworkPermission, setLocalNetworkPermission] =
+    useState<LocalNetworkAccessPermissionState>(
+      localPlanBridgeUrl ? "checking" : "unsupported",
+    );
+  const [localBridgeConnectionRequested, setLocalBridgeConnectionRequested] =
+    useState(false);
+  const checkLocalNetworkPermission = useCallback(async () => {
+    if (!localPlanBridgeUrl) {
+      setLocalNetworkPermission("unsupported");
+      return;
+    }
+    setLocalNetworkPermission("checking");
+    setLocalBridgeConnectionRequested(false);
+    const state = await localNetworkAccessPermissionState();
+    setLocalNetworkPermission(state);
+  }, [localPlanBridgeUrl]);
+  useEffect(() => {
+    void checkLocalNetworkPermission();
+  }, [checkLocalNetworkPermission]);
+  const localBridgeFetchEnabled = Boolean(
+    localPlanMode &&
+    localPlanSlug &&
+    localPlanBridgeUrl &&
+    (localNetworkPermission === "granted" ||
+      localNetworkPermission === "unsupported" ||
+      localBridgeConnectionRequested),
+  );
   const localPlanBridgeQuery = useQuery<LocalPlanBundle>({
     queryKey: localPlanBridgeQueryKey(
       localPlanSlug ?? "",
       localPlanBridgeUrl ?? "",
     ),
-    enabled: localPlanMode && Boolean(localPlanSlug && localPlanBridgeUrl),
+    enabled: localBridgeFetchEnabled,
     refetchOnWindowFocus: false,
     retry: shouldRetryLocalPlanBridgeBundle,
     retryDelay: localPlanBridgeRetryDelay,
@@ -2068,6 +2098,11 @@ export function PlansPage({ localPlanSlug }: { localPlanSlug?: string } = {}) {
   const localPlanError = localPlanBridgeUrl
     ? localPlanBridgeQuery.error
     : localPlanQuery.error;
+  useEffect(() => {
+    if (!(localPlanError instanceof LocalPlanBridgePermissionError)) return;
+    setLocalNetworkPermission(localPlanError.permissionState);
+    setLocalBridgeConnectionRequested(false);
+  }, [localPlanError]);
   const localPlanLoading = localPlanBridgeUrl
     ? localPlanBridgeQuery.isLoading
     : localPlanQuery.isLoading;
@@ -2181,10 +2216,7 @@ export function PlansPage({ localPlanSlug }: { localPlanSlug?: string } = {}) {
   const immersiveReader = Boolean(
     selectedId && (planFullscreen || prototypeOnly),
   );
-  const planQuery = usePlan(
-    localPlanMode ? undefined : selectedId,
-    commentMutationPendingRef,
-  );
+  const planQuery = usePlan(localPlanMode ? undefined : selectedId);
   const bundle = localPlanMode ? localPlanData : planQuery.data;
   const localPlanBundle =
     localPlanMode && bundle && "localOnly" in bundle
@@ -2225,13 +2257,30 @@ export function PlansPage({ localPlanSlug }: { localPlanSlug?: string } = {}) {
     accessStatusPaused: planAccessStatusQuery.isPaused,
     accessDenied: Boolean(planAccessStatus && !planAccessStatus.hasAccess),
   });
-  const showLocalPlanLoadError = Boolean(
+  const showLocalPlanLoadError = shouldShowLocalPlanLoadError({
+    localPlanMode,
+    hasBundle: Boolean(bundle),
+    hasBridgeUrl: Boolean(localPlanBridgeUrl),
+    bridgeFetchEnabled: localBridgeFetchEnabled,
+    error: localPlanError,
+    loading: localPlanLoading,
+    fetching: localPlanFetching,
+    permissionState: localNetworkPermission,
+  });
+  const showLocalPlanConnection = Boolean(
     localPlanMode &&
+    localPlanBridgeUrl &&
     !bundle &&
-    (Boolean(localPlanError) || (!localPlanLoading && !localPlanFetching)),
+    !localBridgeConnectionRequested &&
+    (localNetworkPermission === "prompt" ||
+      localNetworkPermission === "denied"),
   );
   const showInitialPlanSkeleton = Boolean(
-    selectedId && !bundle && !showPlanLoadError && !showLocalPlanLoadError,
+    selectedId &&
+    !bundle &&
+    !showPlanLoadError &&
+    !showLocalPlanLoadError &&
+    !showLocalPlanConnection,
   );
   const requestPlanAccessMutation = useRequestPlanAccess();
   const [accessRequestSentPlanId, setAccessRequestSentPlanId] = useState<
@@ -4497,8 +4546,7 @@ export function PlansPage({ localPlanSlug }: { localPlanSlug?: string } = {}) {
     };
     clearPendingDocumentRestore();
     pendingDocumentRestoreRef.current = documentStateRef.current;
-    commentMutationPendingRef.current = true;
-    // Await the cancel so an in-flight 3s poll can't resolve *after* our
+    // Await the cancel so an in-flight sync refresh can't resolve *after* our
     // optimistic write and revert it (the "comment lagged / didn't stick"
     // symptom). cancelQueries reverts outstanding fetches before we patch.
     await queryClient.cancelQueries({ queryKey: selectedPlanQueryKey });
@@ -4535,9 +4583,6 @@ export function PlansPage({ localPlanSlug }: { localPlanSlug?: string } = {}) {
         setInlineCommentPosition(
           getPositionFromAnchor(anchor) ?? capturedPosition,
         );
-      })
-      .finally(() => {
-        commentMutationPendingRef.current = false;
       });
   };
 
@@ -4553,7 +4598,6 @@ export function PlansPage({ localPlanSlug }: { localPlanSlug?: string } = {}) {
         annotation.anchor.resolutionTarget,
       ),
     };
-    commentMutationPendingRef.current = true;
     void writeComments(
       [
         {
@@ -4576,9 +4620,6 @@ export function PlansPage({ localPlanSlug }: { localPlanSlug?: string } = {}) {
       })
       .catch(() => {
         // The mutation hook surfaces the failure toast; just clear pending.
-      })
-      .finally(() => {
-        commentMutationPendingRef.current = false;
       });
   };
 
@@ -4616,8 +4657,7 @@ export function PlansPage({ localPlanSlug }: { localPlanSlug?: string } = {}) {
       createdAt: now,
       updatedAt: now,
     };
-    commentMutationPendingRef.current = true;
-    // Await the cancel so an in-flight 3s poll can't resolve *after* our
+    // Await the cancel so an in-flight sync refresh can't resolve *after* our
     // optimistic write and revert it (the "comment lagged / didn't stick"
     // symptom). cancelQueries reverts outstanding fetches before we patch.
     await queryClient.cancelQueries({ queryKey: selectedPlanQueryKey });
@@ -4656,8 +4696,6 @@ export function PlansPage({ localPlanSlug }: { localPlanSlug?: string } = {}) {
           current ? removePlanCommentFromBundle(current, replyId) : current,
       );
       throw new Error("Could not send reply. Try again.");
-    } finally {
-      commentMutationPendingRef.current = false;
     }
   };
 
@@ -4676,8 +4714,7 @@ export function PlansPage({ localPlanSlug }: { localPlanSlug?: string } = {}) {
     // popover update without waiting for the server round-trip (Issue 3).
     const prevBundle =
       queryClient.getQueryData<PlanBundleWithHtml>(selectedPlanQueryKey);
-    commentMutationPendingRef.current = true;
-    // Await the cancel so an in-flight 3s poll can't resolve *after* our
+    // Await the cancel so an in-flight sync refresh can't resolve *after* our
     // optimistic write and revert it (the "comment lagged / didn't stick"
     // symptom). cancelQueries reverts outstanding fetches before we patch.
     await queryClient.cancelQueries({ queryKey: selectedPlanQueryKey });
@@ -4724,9 +4761,6 @@ export function PlansPage({ localPlanSlug }: { localPlanSlug?: string } = {}) {
         if (prevBundle !== undefined) {
           queryClient.setQueryData(selectedPlanQueryKey, prevBundle);
         }
-      })
-      .finally(() => {
-        commentMutationPendingRef.current = false;
       });
   };
 
@@ -4749,8 +4783,7 @@ export function PlansPage({ localPlanSlug }: { localPlanSlug?: string } = {}) {
     const prevBundle =
       queryClient.getQueryData<PlanBundleWithHtml>(selectedPlanQueryKey);
     const commentId = request.commentId;
-    commentMutationPendingRef.current = true;
-    // Await the cancel so an in-flight 3s poll can't resolve *after* our
+    // Await the cancel so an in-flight sync refresh can't resolve *after* our
     // optimistic write and revert it (the "comment lagged / didn't stick"
     // symptom). cancelQueries reverts outstanding fetches before we patch.
     await queryClient.cancelQueries({ queryKey: selectedPlanQueryKey });
@@ -4773,8 +4806,6 @@ export function PlansPage({ localPlanSlug }: { localPlanSlug?: string } = {}) {
         queryClient.setQueryData(selectedPlanQueryKey, prevBundle);
       }
       setDeleteCommentRequest(request);
-    } finally {
-      commentMutationPendingRef.current = false;
     }
   };
 
@@ -4844,6 +4875,8 @@ export function PlansPage({ localPlanSlug }: { localPlanSlug?: string } = {}) {
             <PlansOverview
               plans={plans}
               isLoading={sessionLoading || plansQuery.isLoading}
+              isError={plansQuery.isError}
+              onRetry={() => void plansQuery.refetch()}
               viewerEmail={session?.email ?? null}
               onCreate={requestCreatePlan}
               canCreate={Boolean(session)}
@@ -4857,6 +4890,14 @@ export function PlansPage({ localPlanSlug }: { localPlanSlug?: string } = {}) {
               }
               onSignIn={() => openSignIn()}
             />
+          ) : showLocalPlanConnection ? (
+            <LocalPlanConnection
+              permissionState={
+                localNetworkPermission === "denied" ? "denied" : "prompt"
+              }
+              onConnect={() => setLocalBridgeConnectionRequested(true)}
+              onRetry={() => void checkLocalNetworkPermission()}
+            />
           ) : showLocalPlanLoadError ? (
             <LocalPlanLoadError
               error={localPlanError}
@@ -6663,6 +6704,66 @@ function LocalPlanLoadError({
   );
 }
 
+function LocalPlanConnection({
+  permissionState,
+  onConnect,
+  onRetry,
+}: {
+  permissionState: "prompt" | "denied";
+  onConnect: () => void;
+  onRetry: () => void;
+}) {
+  const t = useT();
+  const denied = permissionState === "denied";
+  return (
+    <div className="flex min-h-0 flex-1 items-center justify-center px-6 py-12">
+      <div className="w-full max-w-xl rounded-xl border border-border bg-background p-6 shadow-sm">
+        <div className="flex items-center gap-3">
+          <div className="flex size-10 items-center justify-center rounded-lg bg-muted text-muted-foreground">
+            <IconLink className="size-5" />
+          </div>
+          <div>
+            <h1 className="text-lg font-semibold tracking-tight">
+              {t(
+                denied
+                  ? "plansPage.localPlanConnection.deniedTitle"
+                  : "plansPage.localPlanConnection.promptTitle",
+              )}
+            </h1>
+            <p className="mt-1 text-sm text-muted-foreground">
+              {t(
+                denied
+                  ? "plansPage.localPlanConnection.deniedMessage"
+                  : "plansPage.localPlanConnection.promptMessage",
+              )}
+            </p>
+          </div>
+        </div>
+        <div className="mt-5 flex flex-wrap gap-2">
+          <Button
+            type="button"
+            variant={denied ? "outline" : "default"}
+            onClick={denied ? onRetry : onConnect}
+          >
+            {denied ? <IconRefresh /> : <IconLink />}
+            {t(
+              denied
+                ? "plansPage.localPlanConnection.checkAgain"
+                : "plansPage.localPlanConnection.connect",
+            )}
+          </Button>
+          <Button asChild type="button" variant="ghost">
+            <Link to="/plans">
+              <IconArrowLeft className="rtl:-scale-x-100" />
+              {t("plansPage.overview.title")}
+            </Link>
+          </Button>
+        </div>
+      </div>
+    </div>
+  );
+}
+
 function PlanLoadError({
   error,
   planId,
@@ -7374,6 +7475,8 @@ type OverviewFilter = "all" | "plans" | "recaps" | "archived" | "deleted";
 function PlansOverview({
   plans,
   isLoading,
+  isError,
+  onRetry,
   viewerEmail,
   onCreate,
   canCreate,
@@ -7384,6 +7487,8 @@ function PlansOverview({
 }: {
   plans: PlanSummary[];
   isLoading: boolean;
+  isError: boolean;
+  onRetry: () => void;
   viewerEmail?: string | null;
   onCreate: () => void;
   canCreate: boolean;
@@ -7400,6 +7505,27 @@ function PlansOverview({
   if (isLoading) {
     return <PlansOverviewSkeleton />;
   }
+  if (isError) {
+    return (
+      <div className="flex min-h-0 flex-1 items-center justify-center bg-muted/20 p-6">
+        <div className="flex max-w-sm flex-col items-center gap-3 text-center">
+          <IconAlertTriangle className="size-7 text-destructive/70" />
+          <div>
+            <h1 className="font-medium">
+              {t("plansPage.loadError.didNotLoadTitle")}
+            </h1>
+            <p className="mt-1 text-sm text-muted-foreground">
+              {t("plansPage.loadError.genericMessage")}
+            </p>
+          </div>
+          <Button type="button" variant="outline" onClick={onRetry}>
+            <IconRefresh className="size-4" />
+            {t("plansPage.loadError.retry")}
+          </Button>
+        </div>
+      </div>
+    );
+  }
   if (plans.length === 0) {
     return <EmptyPlan onCreate={onCreate} canCreate={canCreate} />;
   }