@nextclaw/ui 0.24.1 → 0.24.3

package/src/features/panel-apps/components/panel-app-runtime-surface.tsx

@@ -0,0 +1,141 @@
+import { useEffect, useMemo, useRef } from "react";
+import { Boxes, RotateCcw } from "lucide-react";
+import { usePanelAppHostPresenter } from "@/features/panel-apps/providers/panel-app-host.provider";
+import { usePanelAppRuntime } from "@/features/panel-apps/hooks/use-panel-app-runtime";
+import { usePanelApp } from "@/features/panel-apps/hooks/use-panel-apps";
+import {
+  PANEL_APP_IFRAME_SANDBOX,
+  focusPanelAppIframe,
+} from "@/features/panel-apps/utils/panel-app-iframe.utils";
+import { usePanelAppScrollRestoration } from "@/shared/hooks/use-panel-app-scroll-restoration";
+import { t } from "@/shared/lib/i18n";
+
+type PanelAppUnavailableAction = {
+  label: string;
+  onAction: () => void;
+};
+
+export function PanelAppRuntimeSurface({
+  appId,
+  restorationScope,
+  unavailableAction,
+}: {
+  appId: string;
+  restorationScope: "main" | "standalone";
+  unavailableAction?: PanelAppUnavailableAction;
+}) {
+  const presenter = usePanelAppHostPresenter();
+  const panelApp = usePanelApp(appId);
+  const iframeRef = useRef<HTMLIFrameElement>(null);
+  const entry = useMemo(
+    () => panelApp.data,
+    [panelApp.data],
+  );
+  const runtime = usePanelAppRuntime(entry);
+  const restoreScroll = usePanelAppScrollRestoration({
+    currentUrl: entry?.contentPath ?? null,
+    iframeRef,
+    isEnabled: Boolean(entry),
+    restorationKey: entry
+      ? `panel-app:${restorationScope}:${entry.appId}`
+      : null,
+  });
+
+  useEffect(() => {
+    const handleMessage = (event: MessageEvent) => {
+      presenter.panelAppBridgeManager.handleIframeMessage({
+        event,
+        iframe: iframeRef.current,
+      });
+    };
+    window.addEventListener("message", handleMessage);
+    return () => window.removeEventListener("message", handleMessage);
+  }, [presenter]);
+
+  if (panelApp.isLoading) {
+    return <PanelAppRuntimeStatus message={t("panelAppsLoading")} />;
+  }
+
+  if (panelApp.isError) {
+    return (
+      <PanelAppRuntimeStatus
+        message={panelApp.error instanceof Error
+          ? panelApp.error.message
+          : t("panelAppsLoadFailed")}
+        actionLabel={t("panelAppsTryAgain")}
+        onAction={() => void panelApp.refetch()}
+      />
+    );
+  }
+
+  if (!entry) {
+    return (
+      <PanelAppRuntimeStatus
+        message={t("panelAppsMainUnavailable")}
+        actionLabel={unavailableAction?.label}
+        onAction={unavailableAction?.onAction}
+      />
+    );
+  }
+
+  if (runtime.state === "checking" || runtime.state === "idle") {
+    return <PanelAppRuntimeStatus message={t("panelAppsCheckingPermission")} />;
+  }
+
+  if (runtime.state === "denied" || runtime.state === "error") {
+    return (
+      <PanelAppRuntimeStatus
+        message={runtime.state === "denied"
+          ? t("panelAppsPermissionDenied")
+          : t("panelAppsPermissionFailed")}
+        actionLabel={t("panelAppsTryAgain")}
+        onAction={() => void runtime.retryClientGrant()}
+      />
+    );
+  }
+
+  return (
+    <div className="h-full min-h-0 bg-background">
+      <iframe
+        key={entry.appId}
+        ref={iframeRef}
+        src={entry.contentPath}
+        title={entry.title}
+        sandbox={PANEL_APP_IFRAME_SANDBOX}
+        className="block h-full w-full border-0 bg-background"
+        onLoad={restoreScroll}
+        onPointerOver={(event) => focusPanelAppIframe(event.currentTarget)}
+      />
+    </div>
+  );
+}
+
+function PanelAppRuntimeStatus({
+  actionLabel,
+  message,
+  onAction,
+}: {
+  actionLabel?: string;
+  message: string;
+  onAction?: () => void;
+}) {
+  return (
+    <div className="flex h-full min-h-0 items-center justify-center bg-background px-6 text-center">
+      <div className="max-w-sm">
+        <div className="mx-auto flex h-10 w-10 items-center justify-center rounded-lg bg-muted text-muted-foreground">
+          {onAction ? <RotateCcw className="h-5 w-5" /> : <Boxes className="h-5 w-5" />}
+        </div>
+        <p className="mt-3 text-sm leading-6 text-muted-foreground">{message}</p>
+        {actionLabel && onAction ? (
+          <button
+            type="button"
+            className="mt-4 rounded-md border border-border px-3 py-1.5 text-xs font-medium text-foreground transition-colors hover:bg-[var(--interaction-hover)] focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-border"
+            onClick={onAction}
+          >
+            {actionLabel}
+          </button>
+        ) : null}
+      </div>
+    </div>
+  );
+}

package/src/features/{service-apps/components/service-action-authorization-dialog.tsx → panel-apps/components/panel-app-service-action-authorization-dialog.tsx}

@@ -9,11 +9,11 @@ import {
 } from '@/shared/components/ui/dialog';
 import { Button } from '@/shared/components/ui/button';
 import { t } from '@/shared/lib/i18n';
-import { useServiceActionAuthorizationStore } from '@/features/service-apps/stores/service-action-authorization.store';
+import { usePanelAppServiceActionAuthorizationStore } from '@/features/panel-apps/stores/panel-app-service-action-authorization.store';
 
-export function ServiceActionAuthorizationDialog() {
-  const pending = useServiceActionAuthorizationStore((state) => state.pending);
-  const resolveAuthorization = useServiceActionAuthorizationStore(
+export function PanelAppServiceActionAuthorizationDialog() {
+  const pending = usePanelAppServiceActionAuthorizationStore((state) => state.pending);
+  const resolveAuthorization = usePanelAppServiceActionAuthorizationStore(
     (state) => state.resolveAuthorization,
   );
 

package/src/features/panel-apps/components/panel-app-toolbar.tsx

@@ -1,6 +1,7 @@
 import { useMemo, useState } from 'react';
 import { MoreVertical, RefreshCw } from 'lucide-react';
 import { PanelAppMainSidebarMenuItem } from '@/features/panel-apps/components/panel-app-main-sidebar-menu-item';
+import { PanelAppOpenStandaloneMenuItem } from '@/features/panel-apps/components/panel-app-open-standalone-menu-item';
 import { usePanelApps } from '@/features/panel-apps/hooks/use-panel-apps';
 import { readPanelAppIdFromTab } from '@/features/right-panel-resources';
 import { IconActionButton } from '@/shared/components/ui/actions/icon-action-button';
@@ -39,6 +40,10 @@ export function PanelAppToolbar({
             />
           </PopoverTrigger>
           <PopoverContent align="end" className="w-48 rounded-xl p-1.5">
+            <PanelAppOpenStandaloneMenuItem
+              entry={entry}
+              onSelect={() => setIsMenuOpen(false)}
+            />
             <PanelAppMainSidebarMenuItem
               entry={entry}
               onSelect={() => setIsMenuOpen(false)}

package/src/features/panel-apps/hooks/use-panel-app-client-grant.ts

@@ -1,11 +1,11 @@
 import { useCallback, useRef } from "react";
-import { useAppPresenter } from "@/app/components/app-presenter-provider";
+import { usePanelAppHostPresenter } from "@/features/panel-apps/providers/panel-app-host.provider";
 import { useGrantPanelAppClient } from "@/features/panel-apps/hooks/use-panel-apps";
 import type { PanelAppEntryView } from "@/shared/lib/api";
 import { t } from "@/shared/lib/i18n";
 
 export function usePanelAppClientGrant() {
-  const presenter = useAppPresenter();
+  const presenter = usePanelAppHostPresenter();
   const { isPending, mutateAsync: grantPanelAppClient } = useGrantPanelAppClient();
   const pendingGrantsRef = useRef(new Map<string, Promise<boolean>>());
 

package/src/features/panel-apps/hooks/{use-panel-app-main-runtime.ts → use-panel-app-runtime.ts}

@@ -2,6 +2,7 @@ import { useId } from "react";
 import { useQuery, useQueryClient } from "@tanstack/react-query";
 import { usePanelAppClientGrant } from "@/features/panel-apps/hooks/use-panel-app-client-grant";
 import {
+  PANEL_APP_QUERY_KEY,
   PANEL_APPS_QUERY_KEY,
   replacePanelAppListEntry,
 } from "@/features/panel-apps/hooks/use-panel-apps";
@@ -11,9 +12,9 @@ import {
   type PanelAppListView,
 } from "@/shared/lib/api";
 
-export type PanelAppMainRuntimeState = "allowed" | "checking" | "denied" | "error" | "idle";
+export type PanelAppRuntimeState = "allowed" | "checking" | "denied" | "error" | "idle";
 
-export function usePanelAppMainRuntime(entry: PanelAppEntryView | undefined) {
+export function usePanelAppRuntime(entry: PanelAppEntryView | undefined) {
   const queryClient = useQueryClient();
   const runtimeInstanceId = useId();
   const { ensurePanelAppClientGrant } = usePanelAppClientGrant();
@@ -22,7 +23,7 @@ export function usePanelAppMainRuntime(entry: PanelAppEntryView | undefined) {
   );
   const grantQuery = useQuery({
     queryKey: [
-      "panel-app-main-client-grant",
+      "panel-app-client-grant",
       entry?.appId ?? "none",
       entry?.clientGranted ?? false,
     ],
@@ -32,7 +33,7 @@ export function usePanelAppMainRuntime(entry: PanelAppEntryView | undefined) {
     retry: false,
     staleTime: Number.POSITIVE_INFINITY,
   });
-  const state: PanelAppMainRuntimeState = !entry
+  const state: PanelAppRuntimeState = !entry
     ? "idle"
     : !requiresClientGrant
       ? "allowed"
@@ -45,13 +46,14 @@ export function usePanelAppMainRuntime(entry: PanelAppEntryView | undefined) {
             : "denied";
 
   useQuery({
-    queryKey: ["panel-app-main-open", runtimeInstanceId, entry?.appId ?? "none"],
+    queryKey: ["panel-app-open", runtimeInstanceId, entry?.appId ?? "none"],
     queryFn: async () => {
       const opened = await nextclawClient.panelApps.recordPanelAppOpened(entry!.id);
       queryClient.setQueryData<PanelAppListView>(
         PANEL_APPS_QUERY_KEY,
         (current) => replacePanelAppListEntry(current, opened),
       );
+      queryClient.setQueryData([...PANEL_APP_QUERY_KEY, opened.appId], opened);
       return opened;
     },
     enabled: Boolean(entry && state === "allowed"),

package/src/features/panel-apps/hooks/use-panel-apps.ts

@@ -9,6 +9,7 @@ import type {
 import { t } from '@/shared/lib/i18n';
 
 export const PANEL_APPS_QUERY_KEY = ['panel-apps'] as const;
+export const PANEL_APP_QUERY_KEY = ['panel-app'] as const;
 
 type PanelAppPreferencesMutation = {
   id: string;
@@ -75,6 +76,15 @@ export function usePanelApps(options: { enabled?: boolean } = {}) {
   });
 }
 
+export function usePanelApp(id: string, options: { enabled?: boolean } = {}) {
+  return useQuery({
+    queryKey: [...PANEL_APP_QUERY_KEY, id],
+    queryFn: () => nextclawClient.panelApps.getPanelApp(id),
+    enabled: Boolean(id) && (options.enabled ?? true),
+    staleTime: 5_000,
+  });
+}
+
 export function useUpdatePanelAppPreferences() {
   const queryClient = useQueryClient();
   return useMutation({
@@ -96,6 +106,7 @@ export function useUpdatePanelAppPreferences() {
         PANEL_APPS_QUERY_KEY,
         (current) => replacePanelAppListEntry(current, entry),
       );
+      queryClient.setQueryData([...PANEL_APP_QUERY_KEY, entry.appId], entry);
     },
     onError: (error, mutation, context) => {
       const previousEntry = context?.previousEntry;
@@ -124,6 +135,7 @@ export function useRecordPanelAppOpened() {
         PANEL_APPS_QUERY_KEY,
         (current) => replacePanelAppListEntry(current, entry),
       );
+      queryClient.setQueryData([...PANEL_APP_QUERY_KEY, entry.appId], entry);
     },
   });
 }
@@ -134,6 +146,7 @@ export function useGrantPanelAppClient() {
     mutationFn: (appId: string) => nextclawClient.panelApps.grantClient(appId),
     onSuccess: () => {
       void queryClient.invalidateQueries({ queryKey: PANEL_APPS_QUERY_KEY });
+      void queryClient.invalidateQueries({ queryKey: PANEL_APP_QUERY_KEY });
     },
   });
 }
@@ -144,6 +157,7 @@ export function useDeletePanelApp() {
     mutationFn: (id: string) => nextclawClient.panelApps.deletePanelApp(id),
     onSuccess: () => {
       void queryClient.invalidateQueries({ queryKey: PANEL_APPS_QUERY_KEY });
+      void queryClient.invalidateQueries({ queryKey: PANEL_APP_QUERY_KEY });
     },
   });
 }

package/src/features/panel-apps/index.ts

@@ -1,7 +1,12 @@
 export { PanelAppsList } from './components/panel-apps-list';
 export { PanelAppMainSidebarNav } from './components/panel-app-main-sidebar-nav';
 export { PanelAppMainPage } from './pages/panel-app-main-page';
+export { PanelAppStandalonePage } from './pages/panel-app-standalone-page';
+export { PanelAppServiceActionAuthorizationDialog } from './components/panel-app-service-action-authorization-dialog';
+export { PanelAppHostPresenter } from './presenters/panel-app-host.presenter';
+export { PanelAppHostProvider } from './providers/panel-app-host.provider';
 export {
+  usePanelApp,
   useGrantPanelAppClient,
   usePanelApps,
   useRecordPanelAppOpened,

package/src/features/panel-apps/managers/__tests__/panel-app-bridge.manager.test.ts

@@ -2,7 +2,7 @@ import { NextClawClientError } from '@nextclaw/client-sdk';
 import { waitFor } from '@testing-library/react';
 import { afterEach, describe, expect, it, vi } from 'vitest';
 import { PanelAppBridgeManager } from '@/features/panel-apps/managers/panel-app-bridge.manager';
-import type { ServiceActionAuthorizationManager } from '@/features/service-apps';
+import type { PanelAppServiceActionAuthorizationManager } from '@/features/panel-apps/managers/panel-app-service-action-authorization.manager';
 
 const mocks = vi.hoisted(() => ({
   generateAgentObject: vi.fn(),
@@ -45,7 +45,7 @@ afterEach(() => {
 function createManager(): PanelAppBridgeManager {
   return new PanelAppBridgeManager({
     requestAuthorization: mocks.requestAuthorization,
-  } as unknown as ServiceActionAuthorizationManager);
+  } as unknown as PanelAppServiceActionAuthorizationManager);
 }
 
 function createIframeHarness(manager: PanelAppBridgeManager) {

package/src/features/panel-apps/managers/panel-app-bridge.manager.ts

@@ -13,7 +13,7 @@ import type {
   PortableRuntimeAcceptanceStatusApiView,
   RuntimeVerificationRecordListView,
 } from '@nextclaw/client-sdk';
-import type { ServiceActionAuthorizationManager } from '@/features/service-apps';
+import type { PanelAppServiceActionAuthorizationManager } from '@/features/panel-apps/managers/panel-app-service-action-authorization.manager';
 import { nextclawClient } from '@/shared/lib/api';
 
 export type PanelAppIframeMessageParams = {
@@ -71,7 +71,7 @@ type PanelAppBridgeResponse =
     };
 
 export class PanelAppBridgeManager {
-  constructor(private readonly authorizationManager: ServiceActionAuthorizationManager) {}
+  constructor(private readonly authorizationManager: PanelAppServiceActionAuthorizationManager) {}
 
   handleIframeMessage = ({ event, iframe }: PanelAppIframeMessageParams): void => {
     if (!this.isBridgeRequest(event.data)) {

package/src/features/panel-apps/managers/panel-app-service-action-authorization.manager.ts

@@ -0,0 +1,10 @@
+import { usePanelAppServiceActionAuthorizationStore } from '@/features/panel-apps/stores/panel-app-service-action-authorization.store';
+import type { PanelAppServiceActionAuthorizationRequest } from '@/features/panel-apps/stores/panel-app-service-action-authorization.store';
+
+export class PanelAppServiceActionAuthorizationManager {
+  requestAuthorization = async (
+    request: Omit<PanelAppServiceActionAuthorizationRequest, 'id'>,
+  ): Promise<boolean> => {
+    return await usePanelAppServiceActionAuthorizationStore.getState().requestAuthorization(request);
+  };
+}

package/src/features/panel-apps/pages/__tests__/panel-app-main-page.test.tsx

@@ -19,8 +19,8 @@ const mocks = vi.hoisted(() => ({
   updatePreferences: vi.fn(),
 }));
 
-vi.mock("@/app/components/app-presenter-provider", () => ({
-  useAppPresenter: () => ({
+vi.mock("@/features/panel-apps/providers/panel-app-host.provider", () => ({
+  usePanelAppHostPresenter: () => ({
     panelAppBridgeManager: { handleIframeMessage: mocks.bridgeMessage },
   }),
 }));
@@ -33,6 +33,15 @@ vi.mock("@/features/panel-apps/hooks/use-panel-app-client-grant", () => ({
 }));
 
 vi.mock("@/features/panel-apps/hooks/use-panel-apps", () => ({
+  PANEL_APP_QUERY_KEY: ["panel-app"],
+  PANEL_APPS_QUERY_KEY: ["panel-apps"],
+  usePanelApp: (appId: string) => ({
+    data: mocks.entries.find((entry) => entry.appId === appId),
+    error: null,
+    isError: false,
+    isLoading: false,
+    refetch: mocks.refetch,
+  }),
   usePanelApps: () => ({
     data: { entries: mocks.entries },
     error: null,
@@ -161,7 +170,7 @@ describe("PanelAppMainPage", () => {
 
     first.unmount();
     await waitFor(() => expect(queryClient.getQueryData([
-      "panel-app-main-client-grant",
+      "panel-app-client-grant",
       "publisher.todo",
       false,
     ])).toBeUndefined());

package/src/features/panel-apps/pages/__tests__/panel-app-standalone-page.test.tsx

@@ -0,0 +1,63 @@
+import { render, screen } from "@testing-library/react";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { PanelAppStandalonePage } from "@/features/panel-apps/pages/panel-app-standalone-page";
+import type { PanelAppEntryView } from "@/shared/lib/api";
+
+const entry: PanelAppEntryView = {
+  appId: "publisher.todo",
+  clientDeclared: false,
+  clientGranted: false,
+  contentPath: "/api/panel-apps/publisher.todo/content",
+  createdAt: "2026-09-03T00:00:00.000Z",
+  favorite: false,
+  fileName: "todo.panel.html",
+  id: "todo",
+  kind: "single-file",
+  mainSidebar: false,
+  openCount: 0,
+  sizeBytes: 10,
+  title: "Rust Todo",
+  updatedAt: "2026-09-03T00:00:00.000Z",
+};
+
+vi.mock("@/features/panel-apps/hooks/use-panel-apps", () => ({
+  usePanelApp: () => ({
+    data: entry,
+  }),
+}));
+
+vi.mock("@/features/panel-apps/components/panel-app-runtime-surface", () => ({
+  PanelAppRuntimeSurface: ({
+    appId,
+    restorationScope,
+  }: {
+    appId: string;
+    restorationScope: string;
+  }) => (
+    <div
+      data-testid="panel-app-runtime-surface"
+      data-app-id={appId}
+      data-restoration-scope={restorationScope}
+    />
+  ),
+}));
+
+describe("PanelAppStandalonePage", () => {
+  const originalTitle = document.title;
+
+  afterEach(() => {
+    document.title = originalTitle;
+  });
+
+  it("renders only the standalone runtime surface and sets the tab title", () => {
+    const { container } = render(
+      <PanelAppStandalonePage appId="publisher.todo" />,
+    );
+
+    const surface = screen.getByTestId("panel-app-runtime-surface");
+    expect(surface.getAttribute("data-app-id")).toBe("publisher.todo");
+    expect(surface.getAttribute("data-restoration-scope")).toBe("standalone");
+    expect(document.title).toBe("Rust Todo · NextClaw");
+    expect(container.querySelector("main")?.children).toHaveLength(1);
+  });
+});

package/src/features/panel-apps/pages/panel-app-main-page.tsx

@@ -1,133 +1,21 @@
-import { useEffect, useMemo, useRef } from "react";
-import { Boxes, RotateCcw } from "lucide-react";
 import { useParams } from "react-router-dom";
-import { useAppPresenter } from "@/app/components/app-presenter-provider";
-import { usePanelAppMainRuntime } from "@/features/panel-apps/hooks/use-panel-app-main-runtime";
-import {
-  usePanelApps,
-} from "@/features/panel-apps/hooks/use-panel-apps";
-import {
-  PANEL_APP_IFRAME_SANDBOX,
-  focusPanelAppIframe,
-} from "@/features/panel-apps/utils/panel-app-iframe.utils";
+import { PanelAppRuntimeSurface } from "@/features/panel-apps/components/panel-app-runtime-surface";
 import { openApps } from "@/features/panel-apps/utils/panel-app-doc-browser.utils";
 import { useDocBrowser } from "@/shared/components/doc-browser";
-import { usePanelAppScrollRestoration } from "@/shared/hooks/use-panel-app-scroll-restoration";
 import { t } from "@/shared/lib/i18n";
 
 export function PanelAppMainPage() {
   const { appId = "" } = useParams<{ appId: string }>();
-  const presenter = useAppPresenter();
   const docBrowser = useDocBrowser();
-  const panelApps = usePanelApps();
-  const iframeRef = useRef<HTMLIFrameElement>(null);
-  const entry = useMemo(
-    () => panelApps.data?.entries.find((candidate) => candidate.appId === appId),
-    [appId, panelApps.data?.entries],
-  );
-  const runtime = usePanelAppMainRuntime(entry);
-  const restoreScroll = usePanelAppScrollRestoration({
-    currentUrl: entry?.contentPath ?? null,
-    iframeRef,
-    isEnabled: Boolean(entry),
-    restorationKey: entry ? `panel-app:main:${entry.appId}` : null,
-  });
-
-  useEffect(() => {
-    const handleMessage = (event: MessageEvent) => {
-      presenter.panelAppBridgeManager.handleIframeMessage({
-        event,
-        iframe: iframeRef.current,
-      });
-    };
-    window.addEventListener("message", handleMessage);
-    return () => window.removeEventListener("message", handleMessage);
-  }, [presenter]);
-
-  if (panelApps.isLoading) {
-    return <PanelAppMainStatus message={t("panelAppsLoading")} />;
-  }
-
-  if (panelApps.isError) {
-    return (
-      <PanelAppMainStatus
-        message={panelApps.error instanceof Error
-          ? panelApps.error.message
-          : t("panelAppsLoadFailed")}
-        actionLabel={t("panelAppsTryAgain")}
-        onAction={() => void panelApps.refetch()}
-      />
-    );
-  }
-
-  if (!entry) {
-    return (
-      <PanelAppMainStatus
-        message={t("panelAppsMainUnavailable")}
-        actionLabel={t("panelAppsOpenApps")}
-        onAction={() => openApps(docBrowser)}
-      />
-    );
-  }
-
-  if (runtime.state === "checking" || runtime.state === "idle") {
-    return <PanelAppMainStatus message={t("panelAppsCheckingPermission")} />;
-  }
-
-  if (runtime.state === "denied" || runtime.state === "error") {
-    return (
-      <PanelAppMainStatus
-        message={runtime.state === "denied"
-          ? t("panelAppsPermissionDenied")
-          : t("panelAppsPermissionFailed")}
-        actionLabel={t("panelAppsTryAgain")}
-        onAction={() => void runtime.retryClientGrant()}
-      />
-    );
-  }
-
-  return (
-    <div className="h-full min-h-0 bg-background">
-      <iframe
-        key={entry.appId}
-        ref={iframeRef}
-        src={entry.contentPath}
-        title={entry.title}
-        sandbox={PANEL_APP_IFRAME_SANDBOX}
-        className="block h-full w-full border-0 bg-background"
-        onLoad={restoreScroll}
-        onPointerOver={(event) => focusPanelAppIframe(event.currentTarget)}
-      />
-    </div>
-  );
-}
 
-function PanelAppMainStatus({
-  actionLabel,
-  message,
-  onAction,
-}: {
-  actionLabel?: string;
-  message: string;
-  onAction?: () => void;
-}) {
   return (
-    <div className="flex h-full min-h-0 items-center justify-center bg-background px-6 text-center">
-      <div className="max-w-sm">
-        <div className="mx-auto flex h-10 w-10 items-center justify-center rounded-lg bg-muted text-muted-foreground">
-          {onAction ? <RotateCcw className="h-5 w-5" /> : <Boxes className="h-5 w-5" />}
-        </div>
-        <p className="mt-3 text-sm leading-6 text-muted-foreground">{message}</p>
-        {actionLabel && onAction ? (
-          <button
-            type="button"
-            className="mt-4 rounded-md border border-border px-3 py-1.5 text-xs font-medium text-foreground transition-colors hover:bg-[var(--interaction-hover)] focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-border"
-            onClick={onAction}
-          >
-            {actionLabel}
-          </button>
-        ) : null}
-      </div>
-    </div>
+    <PanelAppRuntimeSurface
+      appId={appId}
+      restorationScope="main"
+      unavailableAction={{
+        label: t("panelAppsOpenApps"),
+        onAction: () => openApps(docBrowser),
+      }}
+    />
   );
 }

package/src/features/panel-apps/pages/panel-app-standalone-page.tsx

@@ -0,0 +1,29 @@
+import { useEffect, useMemo } from "react";
+import { PanelAppRuntimeSurface } from "@/features/panel-apps/components/panel-app-runtime-surface";
+import { usePanelApp } from "@/features/panel-apps/hooks/use-panel-apps";
+import { t } from "@/shared/lib/i18n";
+
+export function PanelAppStandalonePage({ appId }: { appId: string }) {
+  const panelApp = usePanelApp(appId);
+  const entry = useMemo(
+    () => panelApp.data,
+    [panelApp.data],
+  );
+
+  useEffect(() => {
+    const previousTitle = document.title;
+    document.title = `${entry?.title ?? t("panelAppsTitle")} · NextClaw`;
+    return () => {
+      document.title = previousTitle;
+    };
+  }, [entry?.title]);
+
+  return (
+    <main className="h-dvh min-h-0 w-full overflow-hidden bg-background">
+      <PanelAppRuntimeSurface
+        appId={appId}
+        restorationScope="standalone"
+      />
+    </main>
+  );
+}

package/src/features/panel-apps/presenters/panel-app-host.presenter.ts

@@ -0,0 +1,9 @@
+import { PanelAppBridgeManager } from "@/features/panel-apps/managers/panel-app-bridge.manager";
+import { PanelAppServiceActionAuthorizationManager } from "@/features/panel-apps/managers/panel-app-service-action-authorization.manager";
+
+export class PanelAppHostPresenter {
+  readonly serviceActionAuthorizationManager = new PanelAppServiceActionAuthorizationManager();
+  readonly panelAppBridgeManager = new PanelAppBridgeManager(
+    this.serviceActionAuthorizationManager,
+  );
+}