@nextclaw/ui 0.27.0 → 0.27.1

package/src/features/right-panel-resources/components/native-object-resource.tsx

@@ -0,0 +1,134 @@
+import { lazy, Suspense, useState } from "react";
+import type { DocBrowserCustomTabRenderParams } from "@/shared/components/doc-browser/doc-browser-renderer.types";
+import { t } from "@/shared/lib/i18n";
+import {
+  createPanelAppRightPanelResourceTarget,
+  type RightPanelAppsTab,
+} from "@/features/right-panel-resources/utils/right-panel-resource-uri.utils";
+
+const AgentsPage = lazy(async () => ({
+  default: (await import("@/features/agents"))
+    .AgentsPage,
+}));
+const CronJobResource = lazy(async () => ({
+  default: (await import("@/features/cron"))
+    .CronJobResource,
+}));
+const ProjectsPage = lazy(async () => ({
+  default: (await import("@/features/projects"))
+    .ProjectsPage,
+}));
+const InboxPage = lazy(async () => ({
+  default: (await import("@/features/inbox")).InboxPage,
+}));
+const AppsPanel = lazy(async () => ({
+  default: (await import("@/features/apps")).AppsPanel,
+}));
+const McpMarketplacePage = lazy(async () => ({
+  default: (
+    await import("@/features/marketplace")
+  ).McpMarketplacePage,
+}));
+const PanelAppRuntimeSurface = lazy(async () => ({
+  default: (
+    await import("@/features/panel-apps")
+  ).PanelAppRuntimeSurface,
+}));
+const PanelAppHostProvider = lazy(async () => ({
+  default: (
+    await import("@/features/panel-apps")
+  ).PanelAppHostProvider,
+}));
+
+function ServiceAppResource({
+  objectId,
+  openTarget,
+}: {
+  objectId: string;
+  openTarget: DocBrowserCustomTabRenderParams["openTarget"];
+}) {
+  const [activeTab, setActiveTab] = useState<RightPanelAppsTab>("service-apps");
+  return (
+    <AppsPanel
+      serviceResourceId={objectId}
+      activeTab={activeTab}
+      onActiveTabChange={setActiveTab}
+      onOpenPanelApp={(entry) =>
+        openTarget(createPanelAppRightPanelResourceTarget(entry))
+      }
+    />
+  );
+}
+
+/** Object identity chooses domain content; the workbench owns placement. */
+export function NativeObjectResource({
+  objectType,
+  objectId,
+  openTarget,
+}: {
+  objectType: string;
+  objectId: string;
+  openTarget: DocBrowserCustomTabRenderParams["openTarget"];
+}) {
+  let content;
+  switch (objectType) {
+    case "agent":
+      content = <AgentsPage resourceId={objectId} />;
+      break;
+    case "cron-job":
+      content = <CronJobResource jobId={objectId} />;
+      break;
+    case "project":
+      content = <ProjectsPage resourceId={objectId} />;
+      break;
+    case "project-work": {
+      let ids: unknown;
+      try {
+        ids = JSON.parse(objectId);
+      } catch {
+        ids = null;
+      }
+      if (
+        !Array.isArray(ids) ||
+        ids.length !== 2 ||
+        ids.some((id) => typeof id !== "string" || !id)
+      )
+        break;
+      content = <ProjectsPage resourceId={ids[0]} resourceWorkId={ids[1]} />;
+      break;
+    }
+    case "inbox-delivery":
+      content = <InboxPage resourceId={objectId} />;
+      break;
+    case "mcp-server":
+      content = <McpMarketplacePage resourceId={objectId} />;
+      break;
+    case "service-app":
+      content = (
+        <ServiceAppResource objectId={objectId} openTarget={openTarget} />
+      );
+      break;
+    case "panel-app":
+      content = (
+        <PanelAppHostProvider>
+          <PanelAppRuntimeSurface appId={objectId} restorationScope="main" />
+        </PanelAppHostProvider>
+      );
+      break;
+  }
+  return (
+    <Suspense
+      fallback={
+        <p role="status" className="p-4">
+          {t("loading")}
+        </p>
+      }
+    >
+      {content ?? (
+        <p role="alert" className="p-4">
+          {t("resourceInvalid")}
+        </p>
+      )}
+    </Suspense>
+  );
+}

package/src/features/right-panel-resources/components/page-resource-icon.tsx

@@ -81,6 +81,7 @@ function resourceTypeIcon(
       ? (kind as keyof typeof RESOURCE_ICONS)
       : "page";
   }
+  if (parseSessionKeyFromPanelUrl(uri)) return "session";
   const object = parseSystemObjectReferenceUri(uri);
   if (object) return OBJECT_TYPE_ICONS[object.objectType] ?? "generic";
   if (
@@ -89,7 +90,6 @@ function resourceTypeIcon(
   )
     return "skill";
   if (uri.startsWith("nextclaw://page?")) return "page";
-  if (uri.startsWith("nextclaw://chat-session")) return "session";
   if (
     uri.startsWith("nextclaw://workspace-file") ||
     uri.startsWith("file:") ||

package/src/features/right-panel-resources/components/system-object-resource.tsx

@@ -9,11 +9,63 @@ import type {
   DocBrowserCustomTabRenderers,
 } from "@/shared/components/doc-browser/doc-browser-renderer.types";
 import { t } from "@/shared/lib/i18n";
+import { useAppPresenter } from "@/app/components/app-presenter-provider";
+import { useLocation, useNavigate } from "react-router-dom";
+import { parseSystemObjectReferenceUri } from "@nextclaw/shared";
+import { NativeObjectResource } from "./native-object-resource";
+import { ChatTextSelectionAction } from "@nextclaw/agent-chat-ui";
+import { WORKSPACE_TEXT_EXCERPT_MAX_CHARACTERS } from "@/features/chat";
 
 function SystemObjectResource({
   tab,
   openTarget,
 }: DocBrowserCustomTabRenderParams) {
+  const app = useAppPresenter();
+  const { pathname } = useLocation();
+  const navigate = useNavigate();
+  const uri = tab.resourceUri ?? tab.currentUrl;
+  const identity = parseSystemObjectReferenceUri(uri);
+  if (!identity)
+    return (
+      <p role="alert" className="p-4">
+        {t("resourceInvalid")}
+      </p>
+    );
+  if (identity.objectType !== "skill") {
+    return (
+      <ChatTextSelectionAction
+        actionLabel={t("chatWorkspaceAddToChat")}
+        className="h-full min-h-0"
+        maxCharacters={WORKSPACE_TEXT_EXCERPT_MAX_CHARACTERS}
+        selectionTooLongLabel={t("chatWorkspaceExcerptSelectionTooLong")}
+        onAddToChat={({ text }) =>
+          app.pageResourceManager.addExcerptToChat(
+            {
+              path: uri,
+              label: tab.title,
+              excerpt: text,
+              startLine: null,
+              endLine: null,
+            },
+            pathname,
+            navigate,
+          )
+        }
+      >
+        <NativeObjectResource key={uri} {...identity} openTarget={openTarget} />
+      </ChatTextSelectionAction>
+    );
+  }
+  return <SystemObjectDocument tab={tab} openTarget={openTarget} />;
+}
+
+function SystemObjectDocument({
+  tab,
+  openTarget,
+}: Pick<DocBrowserCustomTabRenderParams, "tab" | "openTarget">) {
+  const app = useAppPresenter();
+  const { pathname } = useLocation();
+  const navigate = useNavigate();
   const uri = tab.resourceUri ?? tab.currentUrl;
   const query = useQuery({
     queryKey: ["resource-object-snapshot", uri],
@@ -22,7 +74,7 @@ function SystemObjectResource({
         await nextclawClient.systemObjectReferences.resolve(uri);
       const response = await fetch(
         buildNcpAssetContentUrl(reference.assetUri),
-        { signal },
+        { signal: AbortSignal.any([signal, AbortSignal.timeout(30_000)]) },
       );
       if (!response.ok)
         throw new Error(`Unable to read resource (${response.status})`);
@@ -77,6 +129,19 @@ function SystemObjectResource({
       file={{ ...file, key: uri }}
       sessionWorkingDir={null}
       sessionProjectRoot={null}
+      onTextExcerptAdd={(excerpt) =>
+        app.pageResourceManager.addExcerptToChat(
+          {
+            ...excerpt,
+            path: uri,
+            label: reference.label,
+            startLine: null,
+            endLine: null,
+          },
+          pathname,
+          navigate,
+        )
+      }
       onFileOpen={(action) => {
         const next = createWorkspaceFileTab(action, null);
         if (next)

package/src/features/right-panel-resources/components/workspace-file-resource.tsx

@@ -11,11 +11,16 @@ import {
 } from "@/features/chat";
 import { createWorkspaceFileTab } from "@/features/chat";
 import { t } from "@/shared/lib/i18n";
+import { useAppPresenter } from "@/app/components/app-presenter-provider";
+import { useLocation, useNavigate } from "react-router-dom";
 
 function WorkspaceFilePanelContent({
   tab,
   openTarget,
 }: DocBrowserCustomTabRenderParams) {
+  const app = useAppPresenter();
+  const { pathname } = useLocation();
+  const navigate = useNavigate();
   const view = readWorkspaceFilePanelView(tab);
   if (!view)
     return (
@@ -32,6 +37,10 @@ function WorkspaceFilePanelContent({
         file={view.file}
         sessionWorkingDir={view.workingDir}
         sessionProjectRoot={view.projectRoot}
+        onTextExcerptAdd={(excerpt) => app.pageResourceManager.addExcerptToChat({
+          ...excerpt,
+          path: tab.resourceUri ?? tab.currentUrl,
+        }, pathname, navigate)}
         onFileOpen={(action) => {
           const file = createWorkspaceFileTab(
             action,

package/src/features/right-panel-resources/configs/right-panel-resource-routes.config.ts

@@ -33,7 +33,8 @@ function isUrlWithPrefix(url: string, prefix: string): boolean {
 function resolveNextclawDocsUrl(uri: ParsedResourceUri): string {
   const docsPath = uri.pathSegments.join('/');
   const rawPath = docsPath ? `/${docsPath}` : '/';
-  return normalizeUrlByKind(rawPath, 'docs');
+  const parsed = new URL(uri.raw);
+  return normalizeUrlByKind(`${rawPath}${parsed.search}${parsed.hash}`, 'docs');
 }
 
 function createDocsResourceUriFromSegments(pathSegments: string[]): string {
@@ -45,20 +46,9 @@ function createDocsResourceUriFromSegments(pathSegments: string[]): string {
 }
 
 function createDocsResourceUriFromUrl(url: string): string {
-  const normalized = normalizeDocUrl(url);
-  const pathname = normalized.startsWith('/')
-    ? normalized
-    : (() => {
-        try {
-          return new URL(url).pathname;
-        } catch {
-          return '';
-        }
-      })();
-  if (!pathname) {
-    return 'nextclaw://docs';
-  }
-  return createDocsResourceUriFromSegments(pathname.split('/'));
+  const parsed = new URL(url);
+  const pathname = parsed.pathname.replace(/\.html$/, '').replace(/\/$/, '');
+  return `${createDocsResourceUriFromSegments(pathname.split('/'))}${parsed.search}${parsed.hash}`;
 }
 
 function isPanelAppContentUri(uri: ParsedResourceUri): boolean {
@@ -97,7 +87,7 @@ function arePanelAppUrlsEquivalent(left: string, right: string): boolean {
 export const RIGHT_PANEL_RESOURCE_ROUTE_DEFINITIONS: RightPanelResourceRouteDefinition[] = [
   {
     id: 'system-object', kind: 'system-object', defaultUrl: () => 'nextclaw://objects',
-    match: (uri) => Boolean(parseSystemObjectReferenceUri(uri.raw)),
+    match: (uri) => !parseSessionKeyFromPanelUrl(uri.raw) && Boolean(parseSystemObjectReferenceUri(uri.raw)),
     resolve: (uri) => ({ kind: 'system-object', title: parseSystemObjectReferenceUri(uri.raw)!.objectId, url: uri.raw, resourceUri: uri.raw, historyPolicy: 'none' }),
     areEquivalent: (left, right) => left === right,
   },
@@ -120,10 +110,10 @@ export const RIGHT_PANEL_RESOURCE_ROUTE_DEFINITIONS: RightPanelResourceRouteDefi
     areEquivalent: (left, right) => left === right,
   },
   {
-    defaultUrl: () => 'nextclaw://chat-session/',
+    defaultUrl: () => 'nextclaw://sessions/',
     id: CHAT_SESSION_PANEL_KIND,
     kind: CHAT_SESSION_PANEL_KIND,
-    match: (uri) => uri.scheme === 'nextclaw' && uri.authority === 'chat-session',
+    match: (uri) => parseSessionKeyFromPanelUrl(uri.raw) !== null,
     resolve: (uri) => {
       const sessionKey = parseSessionKeyFromPanelUrl(uri.raw);
       const url = sessionKey ? buildSessionPanelUrl(sessionKey) : uri.raw;
@@ -136,7 +126,7 @@ export const RIGHT_PANEL_RESOURCE_ROUTE_DEFINITIONS: RightPanelResourceRouteDefi
         historyPolicy: 'none',
       };
     },
-    areEquivalent: (left, right) => left === right,
+    areEquivalent: (left, right) => parseSessionKeyFromPanelUrl(left) === parseSessionKeyFromPanelUrl(right),
   },
   {
     defaultUrl: () => RIGHT_PANEL_HOME_URL,
@@ -179,7 +169,7 @@ export const RIGHT_PANEL_RESOURCE_ROUTE_DEFINITIONS: RightPanelResourceRouteDefi
       return {
         historyPolicy: 'managed',
         kind: 'docs',
-        resourceUri: createDocsResourceUriFromSegments(uri.pathSegments),
+        resourceUri: `${createDocsResourceUriFromSegments(uri.pathSegments)}${new URL(uri.raw).search}${new URL(uri.raw).hash}`,
         title: t('docBrowserHelp'),
         url,
       };
@@ -198,7 +188,7 @@ export const RIGHT_PANEL_RESOURCE_ROUTE_DEFINITIONS: RightPanelResourceRouteDefi
         historyPolicy: 'managed',
         kind: RIGHT_PANEL_APPS_TAB_KIND,
         resourceUri: url,
-        title: t('appsTitle'),
+        title: t(new URL(url).searchParams.get('tab') === 'service-apps' ? 'serviceAppsTitle' : 'appsTitle'),
         url,
       };
     },

package/src/features/right-panel-resources/managers/__tests__/page-resource.manager.test.ts

@@ -17,7 +17,7 @@ import {
 function setup() {
   const app = {
     rightPanelResourceRouteResolver: new RightPanelResourceRouteResolver(),
-    docBrowserManager: { openTarget: vi.fn() },
+    docBrowserManager: { openTarget: vi.fn(), setActiveTab: vi.fn() },
     workbenchSurfaceManager: {
       restore: vi.fn(),
       toggleMaximize: vi.fn(),
@@ -28,6 +28,7 @@ function setup() {
       requestUiResourceReference: vi.fn(),
       requestFileReference: vi.fn(),
       requestSystemObjectReference: vi.fn(),
+      requestExcerptReference: vi.fn(),
     },
   };
   return {
@@ -38,6 +39,16 @@ function setup() {
 }
 
 describe("shared resource opening policy", () => {
+  it.each(["/chat/current-session", "/chat", "/agents"])("routes a selected resource excerpt from %s to its chat composer", (pathname) => {
+    const { manager, app, navigate } = setup();
+    const excerpt = { path: "nextclaw://objects/agent/philosopher", label: "灵魂哲学家", excerpt: "Runtime: native", startLine: null, endLine: null };
+    manager.addExcerptToChat(excerpt, pathname, navigate);
+    expect(app.chatComposerIntentManager.requestExcerptReference).toHaveBeenCalledWith({
+      ...excerpt, targetSessionKey: pathname === "/chat/current-session" ? "current-session" : null,
+    });
+    if (pathname === "/agents") expect(navigate).toHaveBeenCalledWith("/chat");
+    else expect(navigate).not.toHaveBeenCalled();
+  });
   beforeEach(() => {
     usePageNavigationStore.setState({ pinned: [] });
     useDocBrowserStore.setState({ snapshot: createDefaultDocBrowserState() });
@@ -74,9 +85,8 @@ describe("shared resource opening policy", () => {
       },
     });
     manager.open(page, "default", navigate);
-    expect(app.docBrowserManager.openTarget).toHaveBeenCalledWith(page.target, {
-      newTab: true,
-    });
+    expect(app.docBrowserManager.setActiveTab).toHaveBeenCalledWith(page.uri);
+    expect(app.docBrowserManager.openTarget).not.toHaveBeenCalled();
     expect(navigate).not.toHaveBeenCalled();
     manager.open(page, "main", navigate);
     expect(navigate).toHaveBeenCalledWith("/apps/panel/example-notes");

package/src/features/right-panel-resources/managers/page-resource.manager.ts

@@ -6,6 +6,7 @@ import { GLOBAL_WORKBENCH_SURFACE } from "@/shared/components/workbench/types/wo
 import { useChatThreadStore } from "@/features/chat";
 import type { ChatThreadManager } from "@/features/chat";
 import type { AppPresenter } from "@/app/presenters/app.presenter";
+import type { WorkspaceTextExcerpt } from "@/features/chat";
 import { useDocBrowserStore } from "@/shared/components/doc-browser/stores/doc-browser.store";
 import { useFloatingSessionStore } from "@/features/chat";
 import { sessionSurfaceManager } from "@/features/chat";
@@ -61,29 +62,28 @@ export class PageResourceManager {
   };
 
   resolve = (
-    uri: string,
+    rawUri: string,
     context?: { workingDir?: string | null; sessionKey?: string | null },
   ): PageResource | null => {
-    if (!/^(nextclaw:\/\/|https?:\/\/)/i.test(uri)) return null;
-    if (uri.startsWith("nextclaw://file/")) {
-      try {
+    if (!/^(nextclaw:\/\/|https?:\/\/)/i.test(rawUri)) return null;
+    try {
+      const uri = this.app.rightPanelResourceRouteResolver.normalize(rawUri);
+      if (uri.startsWith("nextclaw://file/")) {
         const target = resolveFileResourceTarget(uri, context);
         return target ? pageResourceFromTarget(target) : null;
-      } catch {
-        return null;
       }
-    }
-    const saved =
-      this.remembered.get(uri) ??
-      usePageNavigationStore.getState().pinned.find((page) => page.uri === uri);
-    if (saved) return saved;
-    const tab = useDocBrowserStore
-      .getState()
-      .snapshot.tabs.find(
-        (item) => (item.resourceUri ?? item.currentUrl) === uri,
-      );
-    if (tab) return pageResourceFromTab(tab);
-    try {
+      const saved =
+        this.remembered.get(uri) ??
+        usePageNavigationStore
+          .getState()
+          .pinned.find((page) => page.uri === uri);
+      if (saved) return saved;
+      const tab = useDocBrowserStore
+        .getState()
+        .snapshot.tabs.find(
+          (item) => (item.resourceUri ?? item.currentUrl) === uri,
+        );
+      if (tab) return pageResourceFromTab(tab);
       if (uri.startsWith("nextclaw://page?")) {
         const path = new URL(uri).searchParams.get("path");
         if (
@@ -190,7 +190,9 @@ export class PageResourceManager {
         location === "floating" ? "floating" : "docked",
       );
       if (location === "main")
-        this.app.workbenchSurfaceManager.toggleMaximize(`session-workspace:${parent ?? "draft"}`);
+        this.app.workbenchSurfaceManager.toggleMaximize(
+          `session-workspace:${parent ?? "draft"}`,
+        );
       return;
     }
     const sessionKey = parseSessionKeyFromPanelUrl(page.uri);
@@ -208,7 +210,7 @@ export class PageResourceManager {
         (item) => (item.resourceUri ?? item.currentUrl) === page.uri,
       );
       if (existing.isOpen && tab) {
-        this.app.docBrowserManager.openTarget(page.target, { newTab: true });
+        this.app.docBrowserManager.setActiveTab(tab.id);
         this.app.workbenchSurfaceManager.restore(GLOBAL_WORKBENCH_SURFACE);
         return;
       }
@@ -216,7 +218,9 @@ export class PageResourceManager {
     if (
       location === "main" ||
       page.target.kind === "route" ||
-      (location === "default" && page.mainPath && page.target.kind !== "panel-app")
+      (location === "default" &&
+        page.mainPath &&
+        page.target.kind !== "panel-app")
     ) {
       navigate(pageResourceMainPath(page));
     } else if (location === "floating" && sessionKey) {
@@ -295,6 +299,19 @@ export class PageResourceManager {
     } else this.open(next, "default", navigate);
   };
 
+  addExcerptToChat = (
+    excerpt: WorkspaceTextExcerpt,
+    pathname: string,
+    navigate: (path: string) => void,
+  ): void => {
+    const isChat = pathname === "/chat" || pathname.startsWith("/chat/");
+    this.app.chatComposerIntentManager.requestExcerptReference({
+      ...excerpt,
+      targetSessionKey: isChat ? parseSessionKeyFromRoute(pathname.slice("/chat/".length)) : null,
+    });
+    if (!isChat) navigate("/chat");
+  };
+
   addToChat = (
     page: PageResource,
     pathname: string,

package/src/features/right-panel-resources/utils/__tests__/right-panel-resource-route-resolver.utils.test.ts

@@ -2,6 +2,18 @@ import { describe, expect, it } from 'vitest';
 import { RightPanelResourceRouteResolver } from '@/features/right-panel-resources';
 
 describe('RightPanelResourceRouteResolver', () => {
+  it('does not treat different document sections as the same destination', () => {
+    const resolver = new RightPanelResourceRouteResolver();
+    expect(resolver.areUrlsEquivalent('https://docs.nextclaw.io/en/guide/commands#one',
+      'https://docs.nextclaw.io/en/guide/commands#two', 'docs', 'docs')).toBe(false);
+  });
+  it.each(['nextclaw://docs/guide/commands?source=chat#sessions', 'https://docs.nextclaw.io/zh/guide/commands?source=chat#sessions'])(
+    'keeps document query and anchor in the resource and final destination: %s', (uri) => {
+      const target = new RightPanelResourceRouteResolver().resolve(uri);
+      expect(target.url).toContain('?source=chat#sessions');
+      expect(target.resourceUri).toContain('?source=chat#sessions');
+    },
+  );
   it('preserves the app marketplace through resource normalization', () => {
     expect(new RightPanelResourceRouteResolver().resolve('nextclaw://apps?tab=marketplace')).toMatchObject({
       kind: 'apps', dedupeKey: 'apps', url: 'nextclaw://apps?tab=marketplace', resourceUri: 'nextclaw://apps?tab=marketplace',

package/src/features/service-apps/components/service-apps-panel.tsx

@@ -31,8 +31,10 @@ type ServiceActionView = ServiceActionListView["actions"][number];
 
 export function ServiceAppsPanel({
   onManagePackage,
+  resourceId,
 }: {
   onManagePackage: (packageId: string) => void;
+  resourceId?: string;
 }) {
   const serviceApps = useServiceApps();
   const appData = useAppData();
@@ -84,7 +86,8 @@ export function ServiceAppsPanel({
     );
   }
 
-  const apps: ServiceAppRecordView[] = serviceApps.data?.entries ?? [];
+  const apps: ServiceAppRecordView[] = (serviceApps.data?.entries ?? []).filter((app) => !resourceId || app.id === resourceId);
+  if (resourceId && !apps.length) return <p role="alert" className="p-4">{t("resourceNotFound")}</p>;
   const diagnostics = serviceApps.data?.diagnostics ?? [];
   const actions: ServiceActionView[] = serviceActions.data?.actions ?? [];
   const grants: ServiceActionGrantView[] =
@@ -165,7 +168,7 @@ export function ServiceAppsPanel({
                   discoveredActionsByApp[app.id] ??
                   actions.filter((action) => action.appId === app.id)
                 }
-                actionsOpen={Boolean(expandedActionsByApp[app.id])}
+                actionsOpen={expandedActionsByApp[app.id] ?? Boolean(resourceId)}
                 grants={grants}
                 agents={agents.data?.agents ?? []}
                 deletePending={deleteServiceApp.isPending}

package/src/shared/components/doc-browser/__tests__/doc-browser-context.test.tsx

@@ -55,6 +55,22 @@ async function resetMemoryThenRehydrate(savedState: string | null) {
 }
 
 describe('DocBrowserManager layout notifications', () => {
+  it.each(['nextclaw://objects/chat-session/example', 'nextclaw://chat-session/sid_ZXhhbXBsZQ'])(
+    'restores historical conversation tabs as real session views: %s', async (uri) => {
+      window.localStorage.setItem(docBrowserStorageKey, JSON.stringify({ version: 1, state: { snapshot: {
+        isOpen: true, activeTabId: 'old',
+        tabs: [{ id: 'old', kind: 'system-object', title: 'Conversation', currentUrl: uri, resourceUri: uri }],
+        activeHistory: [{ tabId: 'old', kind: 'system-object', url: uri, resourceUri: uri }],
+      } } }));
+      await rehydrateDocBrowserFromStorage();
+      expect(useDocBrowserStore.getState().snapshot.tabs[0]).toMatchObject({
+        kind: 'chat-session', currentUrl: 'nextclaw://sessions/example', resourceUri: 'nextclaw://sessions/example',
+      });
+      expect(useDocBrowserStore.getState().snapshot.activeHistory[0]).toMatchObject({
+        kind: 'chat-session', url: 'nextclaw://sessions/example',
+      });
+    },
+  );
   it('notifies the app layout coordinator after opening the docked browser', () => {
     const onRightPanelOpened = vi.fn();
     const manager = new DocBrowserManager(new WorkbenchSurfaceManager(),

package/src/shared/components/doc-browser/__tests__/doc-browser.test.tsx

@@ -505,7 +505,7 @@ describe("DocBrowser", () => {
 
     render(<DocBrowser />);
 
-    expect(screen.getByTitle("Local App").getAttribute("tabindex")).toBeNull();
+    expect(screen.getAllByTitle("Local App").find((element) => element.tagName === 'IFRAME')!.getAttribute("tabindex")).toBeNull();
   });
 });
 
@@ -875,7 +875,7 @@ describe("DocBrowser content tabs", () => {
     render(<DocBrowser />);
 
     const addressInput = screen.getByRole("textbox", { name: "Address" }) as HTMLInputElement;
-    const iframe = screen.getByTitle("Local App") as HTMLIFrameElement;
+    const iframe = screen.getAllByTitle("Local App").find((element) => element.tagName === 'IFRAME') as HTMLIFrameElement;
     const externalLink = screen.getByRole("link", { name: /Open in Browser/i }) as HTMLAnchorElement;
 
     expect(addressInput.value).toBe("http://127.0.0.1:5173/dashboard");

package/src/shared/components/doc-browser/__tests__/resource-link-interceptor.test.tsx

@@ -54,7 +54,7 @@ describe("ordinary Markdown resource links end to end", () => {
       </QueryClientProvider>,
     );
   }
-  it.each(["cron-job", "skill", "agent", "project", "inbox-delivery"])(
+  it.each(["cron-job", "skill", "agent", "project", "inbox-delivery", "panel-app", "service-app", "mcp-server", "project-work"])(
     "opens a normal Markdown %s object link in the shared resource viewer",
     (kind) => {
       const uri = "nextclaw://objects/" + kind + "/existing-object";
@@ -72,6 +72,34 @@ describe("ordinary Markdown resource links end to end", () => {
       expect(screen.getByTestId("route").textContent).toBe("/chat");
     },
   );
+  it.each(['sessions/ncp-mu2x4zdy-9wzl0otb', 'chat-session/ncp-mu2x4zdy-9wzl0otb',
+    'chat-session/sid_bmNwLW11Mng0emR5LTl3emwwb3Ri', 'objects/chat-session/ncp-mu2x4zdy-9wzl0otb',
+    'objects/chat-sessions/ncp-mu2x4zdy-9wzl0otb'])(
+    'opens the actual conversation route from %s', (path) => {
+      setup(`[Conversation](nextclaw://${path})`);
+      fireEvent.click(screen.getByRole('link', { name: 'Conversation' }));
+      expect(screen.getByTestId('route').textContent).toBe('/chat/ncp-mu2x4zdy-9wzl0otb');
+      expect(useDocBrowserStore.getState().snapshot.isOpen).toBe(false);
+    },
+  );
+  it.each([
+    ['nextclaw://docs/guide/getting-started', 'docs'],
+    ['nextclaw://apps?tab=service-apps', 'apps'],
+    ['nextclaw://marketplace-detail/skill%3Aexample', 'marketplace-detail'],
+    ['nextclaw://file/absolute/tmp/readme.md', 'workspace-file'],
+  ])('opens the %s resource family through ordinary Markdown', (uri, kind) => {
+    setup(`[Resource](${uri})`);
+    fireEvent.click(screen.getByRole('link', { name: 'Resource' }));
+    const { snapshot } = useDocBrowserStore.getState();
+    expect(snapshot.tabs.find((item) => item.id === snapshot.activeTabId)?.kind).toBe(kind);
+  });
+  it.each([['nextclaw://marketplace', '/skills'], ['nextclaw://page?path=%2Fagents', '/agents']])(
+    'navigates built-in page %s', (uri, path) => {
+      setup(`[Page](${uri})`);
+      fireEvent.click(screen.getByRole('link', { name: 'Page' }));
+      expect(screen.getByTestId('route').textContent).toBe(path);
+    },
+  );
   it("opens a normal Panel App link in the global sidebar without a catalog lookup", () => {
     setup();
     const link = screen.getByRole("link", { name: "Notes" });