@nextclaw/ui 0.25.3 → 0.26.0

package/src/features/chat/features/workspace/components/chat-session-workspace-panel.tsx

@@ -1,3 +1,8 @@
+import { usePageResourceActions } from '@/features/right-panel-resources';
+import { pageResourceFromTarget } from '@/features/right-panel-resources';
+import { createWorkspaceFilePanelTarget } from '@/features/chat/features/workspace/utils/workspace-file-panel-route.utils';
+import { buildSessionPanelUrl } from '@/features/chat/features/session/utils/chat-session-route.utils';
+import { sessionSurfaceManager } from '@/features/chat/managers/session-surface.manager';
 import { useEffect, useMemo, useState } from "react";
 import { useQueryClient } from "@tanstack/react-query";
 import type { CronJobView } from "@/shared/lib/api";
@@ -23,8 +28,9 @@ import {
 import { WorkspaceTabsBar } from "./chat-session-workspace-panel-nav";
 import { usePresenter } from "@/features/chat/components/providers/chat-presenter.provider";
 import { ChatSessionWorkspacePanelContent } from "@/features/chat/features/workspace/components/chat-session-workspace-panel-content";
-import { ResizableRightPanel } from "@/shared/components/resizable-right-panel/resizable-right-panel";
-import { cn } from "@/shared/lib/utils";
+import { WorkbenchSurface } from "@/shared/components/workbench/workbench-surface";
+import { getAppPresenter } from "@/app/presenters/app.presenter";
+import { t } from "@/shared/lib/i18n";
 import {
   canGoBackInNavigationHistory,
   canGoForwardInNavigationHistory,
@@ -34,6 +40,7 @@ import { buildServerPathReadQueryKey } from "@/shared/hooks/use-server-path-read
 
 type ChatSessionWorkspacePanelProps = {
   sessionKey: string | null;
+  hidden?: boolean;
   childSessionTabs: readonly ChatChildSessionTab[];
   activeChildSessionKey: string | null;
   activeSideChatDraft: ChatWorkspaceSideChatDraft | null;
@@ -55,6 +62,7 @@ type ChatSessionWorkspacePanelProps = {
 
 export function ChatSessionWorkspacePanel({
   sessionKey,
+  hidden = false,
   childSessionTabs,
   activeChildSessionKey,
   activeSideChatDraft,
@@ -74,8 +82,8 @@ export function ChatSessionWorkspacePanel({
   displayMode = "docked",
 }: ChatSessionWorkspacePanelProps) {
   const presenter = usePresenter();
+  const pageActions = usePageResourceActions();
   const queryClient = useQueryClient();
-  const [isMaximized, setIsMaximized] = useState(false);
   const [filePreviewRefreshVersion, setFilePreviewRefreshVersion] = useState(0);
   const resolvedChildTabs = useNcpChildSessionTabsView(childSessionTabs);
   const optimisticReadAtBySessionKey = useChatSessionListStore(
@@ -159,8 +167,6 @@ export function ChatSessionWorkspacePanel({
     return null;
   }
 
-  const isContainerMaximized = displayMode === "docked" && isMaximized;
-  const isOverlayPanel = displayMode === "overlay" || isContainerMaximized;
   const activeFile =
     activeSelection.kind === "file" && activeSelection.file.viewMode === "preview"
       ? activeSelection.file
@@ -185,40 +191,43 @@ export function ChatSessionWorkspacePanel({
     : undefined;
 
   return (
-    <ResizableRightPanel
-      data-testid="chat-session-workspace-panel"
-      data-theme-surface="workspace-panel"
-      className={cn(
-        isOverlayPanel
-          ? "bg-white"
-          : "hidden border-gray-200/70 bg-white/95 backdrop-blur-sm md:flex",
-        isContainerMaximized ? "shadow-xl" : null,
-      )}
-      defaultWidth={workspacePanelWidth}
-      width={workspacePanelWidth}
-      minWidth={CHAT_WORKSPACE_PANEL_MIN_WIDTH}
-      maxWidth={CHAT_WORKSPACE_PANEL_MAX_WIDTH}
+    <WorkbenchSurface
+      id={`session-workspace:${sessionKey ?? 'draft'}`} manager={getAppPresenter().workbenchSurfaceManager}
+      title={t('workbenchSessionGroup')} testId="chat-session-workspace-panel" hidden={hidden}
+      width={workspacePanelWidth} minWidth={CHAT_WORKSPACE_PANEL_MIN_WIDTH} maxWidth={CHAT_WORKSPACE_PANEL_MAX_WIDTH}
       onWidthCommit={presenter.chatThreadManager.setWorkspacePanelWidth}
-      overlay={isOverlayPanel}
-      overlayScope={isContainerMaximized ? "container" : "viewport"}
-    >
+      fullscreen={displayMode === "overlay"} onClose={presenter.chatThreadManager.closeWorkspacePanel} closeLabel={t('workbenchHideGroup')}
+      navigation={
       <WorkspaceTabsBar
-        tabs={workspaceTabs}
+        tabs={workspaceTabs.map((tab) => ({
+          ...tab,
+          menuGroups: (() => {
+            const file = workspaceFileTabs.find((item) => `file:${item.key}` === tab.key);
+            const target = file ? createWorkspaceFilePanelTarget(file, { workingDir: sessionWorkingDir, projectRoot: sessionProjectRoot })
+              : tab.sessionKey ? { kind: 'chat-session', title: tab.title, url: buildSessionPanelUrl(tab.sessionKey), resourceUri: buildSessionPanelUrl(tab.sessionKey), historyPolicy: 'none' as const } : tab.kind !== 'side-chat-draft' ? { kind: 'workspace', title: tab.title, url: `nextclaw://workspace?${new URLSearchParams({ session: sessionKey ?? '', page: tab.kind })}`, historyPolicy: 'none' as const } : null;
+            return target ? [...pageActions(pageResourceFromTarget(target), 'workspace'), ...(tab.menuGroups ?? [])] : tab.menuGroups;
+          })(),
+          onMoveGlobal: tab.kind === 'file' ? () => presenter.chatThreadManager.moveFileToGlobal(tab.key.slice('file:'.length), { workingDir: sessionWorkingDir, projectRoot: sessionProjectRoot }, getAppPresenter().docBrowserManager)
+            : tab.kind === 'child-session' && tab.sessionKey ? () => {
+              sessionSurfaceManager.dock({ sessionKey: tab.sessionKey!, title: tab.title }, getAppPresenter().docBrowserManager);
+              tab.onClose?.();
+            } : undefined,
+          onFloat: tab.kind === 'child-session' && tab.sessionKey ? () => {
+            sessionSurfaceManager.open({ sessionKey: tab.sessionKey!, title: tab.title });
+            tab.onClose?.();
+          } : undefined,
+        }))}
         canGoBack={canGoBackInNavigationHistory(workspaceHistory)}
         canGoForward={canGoForwardInNavigationHistory(workspaceHistory)}
-        isMaximized={isContainerMaximized}
         onGoBack={presenter.chatThreadManager.goBackWorkspacePanel}
         onGoForward={presenter.chatThreadManager.goForwardWorkspacePanel}
         onRefreshFile={refreshActiveFile}
-        onToggleMaximize={
-          displayMode === "docked"
-            ? () => setIsMaximized((value) => !value)
-            : undefined
-        }
-        onClose={presenter.chatThreadManager.closeWorkspacePanel}
+
       />
+      }
+    >
 
-      <div className="flex min-h-0 flex-1 flex-col bg-white">
+      <div className="flex min-h-0 flex-1 flex-col bg-card">
         <ChatSessionWorkspacePanelContent
           activeSelection={activeSelection}
           childSessionTabs={resolvedChildTabs}
@@ -232,6 +241,6 @@ export function ChatSessionWorkspacePanel({
           sessionWorkingDir={sessionWorkingDir}
         />
       </div>
-    </ResizableRightPanel>
+    </WorkbenchSurface>
   );
 }

package/src/features/chat/features/workspace/components/child-sessions/chat-session-child-sessions.tsx

@@ -2,6 +2,7 @@ import { ChevronRight, GitBranch, MessageSquarePlus } from 'lucide-react';
 
 import { usePresenter } from '@/features/chat/components/providers/chat-presenter.provider';
 import type { ResolvedChildSessionTab } from '@/features/chat/features/ncp/hooks/use-ncp-child-session-tabs-view';
+import { SessionRunBadge } from '@/features/chat/features/session/components/session-run-badge';
 import { ChatSessionMoreActionsMenu } from '@/features/chat/features/session/components/session-header/chat-session-more-actions-menu';
 import { t } from '@/shared/lib/i18n';
 
@@ -52,7 +53,10 @@ export function ChatSessionChildSessions({
                     <GitBranch className="h-4 w-4" />
                   </span>
                   <span className="min-w-0 flex-1">
-                    <span className="block truncate text-sm font-medium text-gray-900">{tab.title}</span>
+                    <span className="flex min-w-0 items-center gap-1.5 text-sm font-medium text-gray-900">
+                      <span className="truncate">{tab.title}</span>
+                      {tab.runStatus ? <SessionRunBadge status={tab.runStatus} /> : null}
+                    </span>
                     {tab.projectName || tab.sessionTypeLabel ? (
                       <span className="mt-0.5 block truncate text-xs text-gray-500">
                         {[tab.sessionTypeLabel, tab.projectName].filter(Boolean).join(' · ')}
@@ -63,6 +67,7 @@ export function ChatSessionChildSessions({
                 </button>
                 <ChatSessionMoreActionsMenu
                   sessionKey={tab.sessionKey}
+                  sessionTitle={tab.title}
                   triggerSize="sm"
                   triggerTone="strong"
                   className="absolute right-2 top-1/2 -translate-y-1/2 bg-white opacity-100 md:opacity-0 md:group-hover:opacity-100 md:group-focus-within:opacity-100"

package/src/features/chat/features/workspace/components/project-files/workspace-directory-tree.tsx

@@ -6,7 +6,7 @@ import {
   Check,
   Folder,
   FolderOpen,
-  MoreHorizontal,
+  MoreVertical,
   X,
 } from 'lucide-react';
 import type {
@@ -429,7 +429,7 @@ export function WorkspaceDirectoryTreeEntry({
             <ContextMenuTrigger>
               <IconActionButton
                 className="mr-1 opacity-0 pointer-events-none group-hover:pointer-events-auto group-hover:opacity-100 group-focus-within:pointer-events-auto group-focus-within:opacity-100 data-[context-menu-open]:pointer-events-auto data-[context-menu-open]:opacity-100"
-                icon={<MoreHorizontal className="h-3.5 w-3.5" />}
+                icon={<MoreVertical className="h-3.5 w-3.5" />}
                 label={t('chatWorkspaceMoreActionsFor').replace('{name}', entry.name)}
                 size="sm"
                 tooltipSide="left"

package/src/features/chat/features/workspace/components/project-files/workspace-project-files-toolbar.tsx

@@ -1,4 +1,4 @@
-import { ChevronsUp, FilePlus2, FolderPlus, MoreHorizontal, RefreshCw } from 'lucide-react';
+import { ChevronsUp, FilePlus2, FolderPlus, MoreVertical, RefreshCw } from 'lucide-react';
 import { IconActionButton } from '@/shared/components/ui/actions/icon-action-button';
 import { ContextMenuTrigger } from '@/shared/components/ui/context-menu/context-menu';
 import { t } from '@/shared/lib/i18n';
@@ -54,7 +54,7 @@ export function WorkspaceProjectFilesToolbar({
       />
       <ContextMenuTrigger>
         <IconActionButton
-          icon={<MoreHorizontal className="h-4 w-4" />}
+          icon={<MoreVertical className="h-4 w-4" />}
           label={t('chatWorkspaceRootMoreActions')}
           size="sm"
         />

package/src/features/chat/features/workspace/utils/__tests__/chat-workspace-panel-view-model.utils.test.ts

@@ -257,6 +257,33 @@ describe("fixed workspace tabs", () => {
   });
 });
 
+it("projects child running state onto both the collection and child tabs", () => {
+  const tabs = buildWorkspaceTabsViewModel({
+    hasSession: true,
+    resolvedChildTabs: [
+      createChildTab({ runStatus: "running" }),
+      createChildTab({ sessionKey: "child-2" }),
+    ],
+    activeSideChatDraft: null,
+    closedWorkspaceTabEntries: [],
+    workspaceFileTabs: [],
+    activeSelection: { kind: "overview" },
+    optimisticReadAtBySessionKey: {},
+    onSelectSession: vi.fn(),
+    onSelectFile: vi.fn(),
+    onOpenFileViewer: vi.fn(),
+    onCloseTab: vi.fn(),
+    onSelectOverview: vi.fn(),
+    onSelectChildSessions: vi.fn(),
+    onSelectProjectFiles: vi.fn(),
+    onSelectCronJobs: vi.fn(),
+  });
+
+  expect(tabs.find((tab) => tab.kind === "child-sessions")?.runStatus).toBe("running");
+  expect(tabs.find((tab) => tab.key === "child:child-1")?.runStatus).toBe("running");
+  expect(tabs.find((tab) => tab.key === "child:child-2")?.runStatus).toBeUndefined();
+});
+
 describe("buildWorkspaceTabsViewModel", () => {
   beforeEach(() => setLanguage("en"));
 

package/src/features/chat/features/workspace/utils/__tests__/workspace-file-panel-route.utils.test.ts

@@ -0,0 +1,94 @@
+import { expect, it } from "vitest";
+import {
+  createWorkspaceFilePanelTarget,
+  readWorkspaceFilePanelView,
+  resolveFileResourceTarget,
+} from "@/features/chat/features/workspace/utils/workspace-file-panel-route.utils";
+import { DocBrowserManager } from "@/shared/components/doc-browser/managers/doc-browser.manager";
+import { WorkbenchSurfaceManager } from "@/shared/components/workbench/managers/workbench-surface.manager";
+import { useDocBrowserStore } from "@/shared/components/doc-browser/stores/doc-browser.store";
+import { RightPanelResourceRouteResolver } from "@/features/right-panel-resources";
+
+it("carries source context and diff data through global open, dedupe and reload", async () => {
+  const file = {
+    key: "source::diff::src/a.ts",
+    parentSessionKey: "source",
+    path: "src/a.ts",
+    viewMode: "diff" as const,
+    fullLines: [
+      { kind: "add" as const, text: "const result = 1;", newLineNumber: 1 },
+    ],
+  };
+  const target = createWorkspaceFilePanelTarget(file, {
+    workingDir: "/project/a",
+    projectRoot: "/project",
+  });
+  const manager = new DocBrowserManager(
+    new WorkbenchSurfaceManager(),
+    new RightPanelResourceRouteResolver(),
+  );
+  manager.openTarget(target, { newTab: true, placement: "docked" });
+  const before = useDocBrowserStore.getState().snapshot;
+  manager.openTarget(target, { newTab: true });
+  expect(useDocBrowserStore.getState().snapshot.tabs.length).toBe(
+    before.tabs.length,
+  );
+  await useDocBrowserStore.persist.rehydrate();
+  const state = useDocBrowserStore.getState().snapshot;
+  const restored = readWorkspaceFilePanelView(
+    state.tabs.find((tab) => tab.id === state.activeTabId)!,
+  );
+  expect(restored).toMatchObject({
+    workingDir: "/project/a",
+    projectRoot: "/project",
+    file,
+  });
+  expect(target.url).not.toContain("const result");
+});
+
+it("resolves native file URIs using the source context and preserves precise location", () => {
+  const target = resolveFileResourceTarget(
+    "nextclaw://file/workspace/docs/readme.md?view=source&line=12&column=3",
+    { workingDir: "/source-project", sessionKey: "source" },
+  )!;
+  expect(target.viewState).toMatchObject({
+    workingDir: "/source-project",
+    file: {
+      path: "docs/readme.md",
+      line: 12,
+      column: 3,
+      previewViewer: "source",
+      parentSessionKey: "source",
+    },
+  });
+  const restored = readWorkspaceFilePanelView({
+    ...target,
+    currentUrl: target.url,
+  } as never);
+  expect(restored?.file.line).toBe(12);
+  expect(
+    resolveFileResourceTarget("nextclaw://file/workspace/docs/a.md"),
+  ).toBeNull();
+  expect(
+    resolveFileResourceTarget(
+      "nextclaw://file/workspace/docs/a.md?base=%2Fexplicit",
+      { workingDir: "/other" },
+    )?.viewState,
+  ).toMatchObject({ workingDir: "/explicit" });
+  expect(
+    resolveFileResourceTarget("nextclaw://file/absolute/tmp/a.md")?.viewState,
+  ).toMatchObject({ workingDir: null, file: { path: "/tmp/a.md" } });
+});
+
+it("rejects traversal and malformed file scopes without changing resource identity", () => {
+  for (const uri of [
+    "nextclaw://file/unknown/a.md",
+    "nextclaw://file/workspace/%2e%2e%2fprivate",
+    "nextclaw://file/workspace/a%5Cb",
+    "nextclaw://file/workspace/",
+  ]) {
+    expect(
+      resolveFileResourceTarget(uri, { workingDir: "/source" }),
+    ).toBeNull();
+  }
+});

package/src/features/chat/features/workspace/utils/chat-workspace-file-tab-persistence.utils.ts

@@ -70,6 +70,7 @@ export function normalizePersistedWorkspaceFileTab(
     patchText: normalizeOptionalText(value.patchText),
     oldStartLine: normalizeOptionalNumber(value.oldStartLine),
     newStartLine: normalizeOptionalNumber(value.newStartLine),
+    fullLines: Array.isArray(value.fullLines) ? value.fullLines.filter((line) => line && ['context', 'add', 'remove'].includes(line.kind) && typeof line.text === 'string' && (line.oldLineNumber === undefined || Number.isFinite(line.oldLineNumber)) && (line.newLineNumber === undefined || Number.isFinite(line.newLineNumber))) : undefined,
   };
 }
 
@@ -94,6 +95,7 @@ export function toPersistedWorkspaceFileTab(
     patchText: tab.patchText,
     oldStartLine: tab.oldStartLine,
     newStartLine: tab.newStartLine,
+    fullLines: tab.fullLines,
   };
 }
 

package/src/features/chat/features/workspace/utils/chat-workspace-file-tab.utils.ts

@@ -82,3 +82,18 @@ export function reparentWorkspaceFileTab(tab: ChatWorkspaceFileTab, parentSessio
     parentSessionKey: normalizedParentSessionKey,
   };
 }
+
+export function createWorkspaceFileViewerTab(sourceTab: ChatWorkspaceFileTab, viewer: 'source' | 'rendered'): ChatWorkspaceFileTab | null {
+  return createWorkspaceFileTab({
+    path: sourceTab.path,
+    label: sourceTab.label ?? undefined,
+    viewMode: 'preview',
+    previewViewer: viewer,
+    line: sourceTab.line ?? undefined,
+    column: sourceTab.column ?? undefined,
+    params: sourceTab.params ?? undefined,
+    rawText: sourceTab.rawText ?? undefined,
+    contentUrl: sourceTab.contentUrl ?? undefined,
+    mimeType: sourceTab.mimeType ?? undefined,
+  }, sourceTab.parentSessionKey);
+}

package/src/features/chat/features/workspace/utils/chat-workspace-panel-view-model.utils.ts

@@ -15,6 +15,7 @@ import {
 } from "@/features/chat/features/workspace/utils/chat-workspace-file-viewer.utils";
 import { areWorkspaceNavigationEntriesEqual } from "@/features/chat/features/workspace/utils/chat-thread-workspace-session.utils";
 import { resolveWorkspaceRelativePath } from "@/shared/lib/session-project";
+import type { SessionRunStatus } from "@/features/chat/types/session-run-status.types";
 
 export type WorkspaceSelection =
   | {
@@ -55,6 +56,7 @@ export type WorkspaceTabViewModel = {
   sessionKey?: string | null;
   fileName?: string | null;
   showUnreadDot?: boolean;
+  runStatus?: SessionRunStatus;
   viewMode?: "preview" | "diff";
   isRenderedPreview?: boolean;
   alternateViewerAction?: {
@@ -63,6 +65,8 @@ export type WorkspaceTabViewModel = {
     onSelect: () => void;
   } | null;
   onAddToChat?: () => void;
+  onMoveGlobal?: () => void;
+  onFloat?: () => void;
   onSelect: () => void;
   onClose?: () => void;
   menuLabel?: string;
@@ -190,6 +194,7 @@ type WorkspaceTabsViewModelParams = {
 function buildWorkspacePageTabs({
   activeSelection,
   hasSession,
+  resolvedChildTabs,
   onSelectChildSessions,
   onSelectCronJobs,
   onSelectOverview,
@@ -199,6 +204,7 @@ function buildWorkspacePageTabs({
   WorkspaceTabsViewModelParams,
   | "activeSelection"
   | "hasSession"
+  | "resolvedChildTabs"
   | "onSelectChildSessions"
   | "onSelectCronJobs"
   | "onSelectOverview"
@@ -220,6 +226,9 @@ function buildWorkspacePageTabs({
       title: t("chatWorkspaceChildSessions"),
       tooltip: t("chatWorkspaceChildSessions"),
       active: activeSelection?.kind === "child-sessions",
+      runStatus: resolvedChildTabs.some((tab) => tab.runStatus === "running")
+        ? "running"
+        : undefined,
       onSelect: onSelectChildSessions,
     },
     {
@@ -279,6 +288,7 @@ export function buildWorkspaceTabsViewModel(
   const workspacePages = buildWorkspacePageTabs({
     activeSelection,
     hasSession,
+    resolvedChildTabs,
     onSelectChildSessions,
     onSelectCronJobs,
     onSelectOverview,
@@ -340,6 +350,7 @@ export function buildWorkspaceTabsViewModel(
         readAt: effectiveReadAt,
         runStatus: tab.runStatus,
       }),
+      runStatus: tab.runStatus,
       onSelect: () => onSelectSession(tab.sessionKey),
       onClose: () => onCloseTab({
         kind: "child-session",

package/src/features/chat/features/workspace/utils/workspace-file-panel-route.utils.ts

@@ -0,0 +1,147 @@
+import { createWorkspaceFileTab } from "./chat-workspace-file-tab.utils";
+import type { ChatWorkspaceFileTab } from "@/features/chat/stores/chat-thread.store";
+import {
+  normalizePersistedWorkspaceFileTab,
+  toPersistedWorkspaceFileTab,
+} from "./chat-workspace-file-tab-persistence.utils";
+import type {
+  DocBrowserRouteTarget,
+  DocBrowserTab,
+} from "@/shared/components/doc-browser/types/doc-browser.types";
+
+export const WORKSPACE_FILE_PANEL_KIND = "workspace-file";
+export type WorkspaceFileViewContext = {
+  workingDir: string | null;
+  projectRoot: string | null;
+};
+export type WorkspaceFileView = WorkspaceFileViewContext & {
+  file: ChatWorkspaceFileTab;
+};
+
+export function createWorkspaceFilePanelTarget(
+  file: ChatWorkspaceFileTab,
+  context: WorkspaceFileViewContext,
+): DocBrowserRouteTarget {
+  const query = new URLSearchParams({
+    key: file.key,
+    path: file.path,
+    base: context.workingDir ?? "",
+    parent: file.parentSessionKey ?? "",
+    view: file.viewMode,
+    viewer: file.previewViewer ?? "",
+    line: String(file.line ?? ""),
+    column: String(file.column ?? ""),
+  });
+  const url = `nextclaw://workspace-file?${query}`;
+  return {
+    kind: WORKSPACE_FILE_PANEL_KIND,
+    title: file.label || file.path.split("/").pop() || file.path,
+    url,
+    resourceUri: url,
+    dedupeKey: url,
+    historyPolicy: "none",
+    viewState: {
+      ...context,
+      file: toPersistedWorkspaceFileTab(file),
+    } satisfies WorkspaceFileView,
+  };
+}
+
+export function readWorkspaceFilePanelView(
+  tab: DocBrowserTab,
+): WorkspaceFileView | null {
+  let value = tab.viewState;
+  if (!value) {
+    try {
+      const uri = new URL(tab.resourceUri ?? tab.currentUrl);
+      const path = uri.searchParams.get("path");
+      // A diff is a historical snapshot; a bare URI cannot substitute current file content.
+      if (
+        uri.hostname !== "workspace-file" ||
+        !path ||
+        uri.searchParams.get("view") === "diff"
+      )
+        return null;
+      value = {
+        workingDir: uri.searchParams.get("base") || null,
+        projectRoot: null,
+        file: {
+          key: uri.searchParams.get("key") || path,
+          path,
+          parentSessionKey: uri.searchParams.get("parent") || null,
+          viewMode: "preview",
+          line: Number(uri.searchParams.get("line")) || null,
+          column: Number(uri.searchParams.get("column")) || null,
+          previewViewer: uri.searchParams.get("viewer") || undefined,
+        },
+      };
+    } catch {
+      return null;
+    }
+  }
+  if (
+    !value ||
+    typeof value !== "object" ||
+    !("file" in value) ||
+    !("workingDir" in value) ||
+    !("projectRoot" in value)
+  )
+    return null;
+  const file = normalizePersistedWorkspaceFileTab(value.file);
+  if (
+    !file ||
+    (value.workingDir !== null && typeof value.workingDir !== "string") ||
+    (value.projectRoot !== null && typeof value.projectRoot !== "string")
+  )
+    return null;
+  return { file, workingDir: value.workingDir, projectRoot: value.projectRoot };
+}
+
+/** Resolve public file links with explicit source context; never borrow another conversation's cwd. */
+export function resolveFileResourceTarget(
+  uri: string,
+  context?: { workingDir?: string | null; sessionKey?: string | null },
+): DocBrowserRouteTarget | null {
+  const parsed = new URL(uri);
+  if (parsed.protocol !== "nextclaw:" || parsed.hostname !== "file")
+    return null;
+  const [scope, ...segments] = parsed.pathname
+    .split("/")
+    .filter(Boolean)
+    .map(decodeURIComponent);
+  if (
+    !segments.length ||
+    segments.some(
+      (segment) =>
+        segment === ".." || segment.includes("\\") || segment.includes("/"),
+    )
+  )
+    return null;
+  const path = segments.join("/");
+  const base = parsed.searchParams.get("base") || context?.workingDir || null;
+  if (scope !== "absolute" && (scope !== "workspace" || !base?.startsWith("/")))
+    return null;
+  const viewer =
+    parsed.searchParams.get("view") || parsed.searchParams.get("viewer");
+  const positive = (name: string) => {
+    const value = Number(parsed.searchParams.get(name));
+    return Number.isSafeInteger(value) && value > 0 ? value : undefined;
+  };
+  const file = createWorkspaceFileTab(
+    {
+      path: scope === "absolute" ? "/" + path : path,
+      viewMode: "preview",
+      previewViewer:
+        viewer === "source" || viewer === "rendered" ? viewer : undefined,
+      line: positive("line"),
+      column: positive("column"),
+    },
+    context?.sessionKey ?? null,
+  );
+  return file
+    ? createWorkspaceFilePanelTarget(file, {
+        workingDir: scope === "workspace" ? base : null,
+        projectRoot: null,
+      })
+    : null;
+}

package/src/features/chat/index.ts

@@ -1,16 +1,23 @@
+export {
+  buildSessionPath,
+  buildSessionPanelUrl,
+  CHAT_SESSION_PANEL_KIND,
+  parseSessionKeyFromPanelUrl,
+  parseSessionKeyFromRoute,
+  CHAT_DRAFT_SESSION_PATH,
+} from "./features/session/utils/chat-session-route.utils";
 export { ChatConversationPanel } from "./components/conversation/chat-conversation-panel";
 export { ChatConversationWorkspaceSection } from "./components/conversation/chat-conversation-workspace-section";
 export { ChatSidebar } from "./components/layout/chat-sidebar";
 export { ChatPresenterProvider } from "./components/providers/chat-presenter.provider";
+export { ChatRuntimeProvider } from "./components/providers/chat-runtime.provider";
+export { CHAT_SESSION_PANEL_RENDERERS } from './features/conversation/components/session-conversation-panel-tab';
 export { usePresenter } from "./components/providers/chat-presenter.provider";
 export { ChatPresenter } from "./presenters/chat.presenter";
 export { ChatDraftIntentManager } from "./managers/chat-draft-intent.manager";
 export { ChatComposerIntentManager } from "./managers/chat-composer-intent.manager";
 export { ChatCompletionNotificationManager } from "./managers/chat-completion-notification.manager";
-export {
-  buildSessionPath,
-  CHAT_DRAFT_SESSION_PATH,
-} from "./features/session/utils/chat-session-route.utils";
+
 export { useChatSessionListStore } from "./stores/chat-session-list.store";
 export { useChatThreadStore } from "./stores/chat-thread.store";
 export { useChatMessageLayoutStore } from "./stores/chat-message-layout.store";
@@ -23,3 +30,12 @@ export {
   type ChatSessionTypeOption,
 } from "./features/session-type/utils/chat-session-type.utils";
 export { ChatVoiceShortcutControl } from './features/conversation/components/chat-voice-shortcut-control';
+
+export type { ChatThreadManager } from './managers/chat-thread.manager';
+export { useFloatingSessionStore } from './stores/floating-session.store';
+export { sessionSurfaceManager } from './managers/session-surface.manager';
+export { useInfiniteNcpSessions } from './features/ncp/hooks/use-ncp-session-queries';
+export { ChatSessionWorkspaceFilePreview } from './features/workspace/components/chat-session-workspace-file-preview';
+export { createWorkspaceFileTab, createWorkspaceFileViewerTab } from './features/workspace/utils/chat-workspace-file-tab.utils';
+export { WORKSPACE_FILE_PANEL_KIND, resolveFileResourceTarget, createWorkspaceFilePanelTarget, readWorkspaceFilePanelView } from './features/workspace/utils/workspace-file-panel-route.utils';
+export { resolveAlternateWorkspaceFileViewer } from './features/workspace/utils/chat-workspace-file-viewer.utils';

package/src/features/chat/managers/__tests__/chat-completion-notification.manager.test.ts

@@ -1,3 +1,4 @@
+import { sessionSurfaceManager } from '@/features/chat/managers/session-surface.manager';
 import {
   NCP_INTERNAL_VISIBILITY_METADATA_KEY,
   NcpEventType,
@@ -8,6 +9,7 @@ import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { ChatCompletionNotificationManager } from "@/features/chat/managers/chat-completion-notification.manager";
 import { buildSessionPath } from "@/features/chat/features/session/utils/chat-session-route.utils";
 import { useChatQueryStore } from "@/features/chat/stores/ncp-chat-query.store";
+import { useFloatingSessionStore } from '@/features/chat/stores/floating-session.store';
 
 const mocks = vi.hoisted(() => ({
   eventHandler: null as ((event: NcpEndpointEvent) => void) | null,
@@ -98,7 +100,13 @@ describe("ChatCompletionNotificationManager", () => {
       description: "The requested research is complete.",
       href: buildSessionPath("session-background"),
       ariaLabel: "Open the new reply in Quarterly research",
+      action: { label: 'Chat in a floating window', onClick: expect.any(Function) },
     });
+    show.mock.calls[0][0].action.onClick();
+    expect(useFloatingSessionStore.getState().session).toEqual({
+      sessionKey: 'session-background', title: 'Quarterly research',
+    });
+    sessionSurfaceManager.close();
   });
 
   it("suppresses messages completed in any visible session, including later replays", () => {

package/src/features/chat/managers/__tests__/chat-thread-workspace.manager.test.ts

@@ -74,9 +74,14 @@ describe('ChatThreadManager workspace pages', () => {
 
     manager.toggleWorkspacePanel('parent-session-1');
     expect(useChatThreadStore.getState().snapshot).toMatchObject({
-      workspacePanelParentKey: null,
-      activeWorkspacePanelKind: null,
+      workspacePanelParentKey: 'parent-session-1',
+      activeWorkspacePanelKind: 'overview',
+      workspacePanelHidden: true,
     });
+    const history = useChatThreadStore.getState().snapshot.workspaceNavigationHistory;
+    manager.toggleWorkspacePanel('parent-session-1');
+    expect(useChatThreadStore.getState().snapshot.workspacePanelHidden).toBe(false);
+    expect(useChatThreadStore.getState().snapshot.workspaceNavigationHistory).toEqual(history);
   });
 
   it('opens project files for a draft without exposing session-only pages', () => {