@nextclaw/ui 0.25.4 → 0.26.1

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', () => {

package/src/features/chat/managers/__tests__/session-surface.manager.test.ts

@@ -0,0 +1,45 @@
+import { WorkbenchSurfaceManager } from '@/shared/components/workbench/managers/workbench-surface.manager';
+import { beforeEach, expect, it } from 'vitest';
+import { sessionSurfaceManager } from '@/features/chat/managers/session-surface.manager';
+import { useFloatingSessionStore } from '@/features/chat/stores/floating-session.store';
+import { useDocBrowserStore } from '@/shared/components/doc-browser/stores/doc-browser.store';
+import { DocBrowserManager } from '@/shared/components/doc-browser/managers/doc-browser.manager';
+import { createDefaultDocBrowserState } from '@/shared/components/doc-browser/utils/doc-browser-state.utils';
+import { RightPanelResourceRouteResolver } from '@/features/right-panel-resources';
+import { parseSessionKeyFromPanelUrl } from '@/features/chat/features/session/utils/chat-session-route.utils';
+
+const docBrowser = new DocBrowserManager(new WorkbenchSurfaceManager(), new RightPanelResourceRouteResolver());
+const session = { sessionKey: 'session:中文/path', title: 'Review' };
+
+beforeEach(() => {
+  sessionSurfaceManager.close();
+  useDocBrowserStore.getState().setSnapshot(createDefaultDocBrowserState());
+});
+
+it('docks and deduplicates a session without replacing unrelated tabs', () => {
+  docBrowser.open('nextclaw://apps', { newTab: true });
+  const existingIds = useDocBrowserStore.getState().snapshot.tabs.map(tab => tab.id);
+  docBrowser.toggleMode();
+  sessionSurfaceManager.open(session);
+  sessionSurfaceManager.dock(session, docBrowser);
+  const state = useDocBrowserStore.getState().snapshot;
+  const tab = state.tabs.find(item => item.id === state.activeTabId)!;
+  expect(new WorkbenchSurfaceManager().get('global-resources').placement).toBe('docked');
+  expect(state.isOpen).toBe(true);
+  expect(tab.kind).toBe('chat-session');
+  expect(tab.title).toBe(session.title);
+  expect(parseSessionKeyFromPanelUrl(tab.currentUrl)).toBe(session.sessionKey);
+  expect(state.tabs.map(item => item.id)).toEqual(expect.arrayContaining(existingIds));
+  expect(useFloatingSessionStore.getState().session).toBeNull();
+  sessionSurfaceManager.dock(session, docBrowser);
+  expect(useDocBrowserStore.getState().snapshot.tabs).toHaveLength(state.tabs.length);
+  sessionSurfaceManager.popOut(tab, docBrowser);
+  expect(useFloatingSessionStore.getState().session).toEqual(session);
+  expect(useDocBrowserStore.getState().snapshot.tabs.map(item => item.id)).toEqual(existingIds);
+});
+
+it('keeps an unrelated floating session when docking another session', () => {
+  sessionSurfaceManager.open(session);
+  sessionSurfaceManager.dock({ sessionKey: 'other', title: 'Other' }, docBrowser);
+  expect(useFloatingSessionStore.getState().session).toEqual(session);
+});

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

@@ -1,3 +1,4 @@
+import { sessionSurfaceManager } from '@/features/chat/managers/session-surface.manager';
 import {
   isHiddenNcpMessage,
   NcpEventType,
@@ -146,6 +147,10 @@ export class ChatCompletionNotificationManager {
       title,
       description: preview || t("chatBackgroundReplyFallbackPreview"),
       href: buildSessionPath(sessionId),
+      action: {
+        label: t('chatFloatingExpand'),
+        onClick: () => sessionSurfaceManager.open({ sessionKey: sessionId, title }),
+      },
       ariaLabel: t("chatBackgroundReplyOpenAriaLabel").replace("{title}", title),
     });
   };

package/src/features/chat/managers/chat-composer-intent.manager.ts

@@ -1,6 +1,9 @@
 import {
   CHAT_CONVERSATION_EXCERPT_TOKEN_KIND,
   CHAT_UI_RESOURCE_TOKEN_KIND,
+  CHAT_SYSTEM_OBJECT_TOKEN_KIND,
+  readSystemObjectResolvedReference,
+  type SystemObjectResolvedReference,
   CHAT_WORKSPACE_DIRECTORY_TOKEN_KIND,
   CHAT_WORKSPACE_EXCERPT_TOKEN_KIND,
   CHAT_WORKSPACE_FILE_TOKEN_KIND,
@@ -43,7 +46,13 @@ export type ChatComposerUiResourceReferenceIntent = ChatComposerReferenceIntentB
   reference: ChatUiResourceReference;
 };
 
+export type ChatComposerSystemObjectReferenceIntent = ChatComposerReferenceIntentBase & {
+  kind: typeof CHAT_SYSTEM_OBJECT_TOKEN_KIND;
+  reference: SystemObjectResolvedReference;
+};
+
 export type ChatComposerReferenceIntent =
+  | ChatComposerSystemObjectReferenceIntent
   | ChatComposerFileReferenceIntent
   | ChatComposerDirectoryReferenceIntent
   | ChatComposerExcerptReferenceIntent
@@ -51,6 +60,7 @@ export type ChatComposerReferenceIntent =
   | ChatComposerUiResourceReferenceIntent;
 
 type ChatComposerReferenceRequest =
+  | Omit<ChatComposerSystemObjectReferenceIntent, 'id'>
   | Omit<ChatComposerFileReferenceIntent, 'id'>
   | Omit<ChatComposerDirectoryReferenceIntent, 'id'>
   | Omit<ChatComposerExcerptReferenceIntent, 'id'>
@@ -179,6 +189,12 @@ export class ChatComposerIntentManager {
     });
   };
 
+  requestSystemObjectReference = (params: { targetSessionKey: string | null; reference: SystemObjectResolvedReference }) => {
+    const reference = readSystemObjectResolvedReference(params.reference);
+    if (!reference) return;
+    this.publish({ kind: CHAT_SYSTEM_OBJECT_TOKEN_KIND, targetSessionKey: params.targetSessionKey, tokenKey: reference.uri, label: reference.label, reference });
+  };
+
   requestUiResourceReference = (params: {
     targetSessionKey: string | null;
     reference: ChatUiResourceReference;

package/src/features/chat/managers/chat-thread.manager.ts

@@ -1,3 +1,5 @@
+import type { DocBrowserManager } from '@/shared/components/doc-browser/managers/doc-browser.manager';
+import { createWorkspaceFilePanelTarget, type WorkspaceFileViewContext } from '@/features/chat/features/workspace/utils/workspace-file-panel-route.utils';
 import { appQueryClient } from '@/app-query-client';
 import { deleteNcpSession as deleteNcpSessionApi, deleteNcpSessionSummaryInQueryClient } from '@/shared/lib/api';
 import { toast } from 'sonner';
@@ -40,6 +42,7 @@ import {
 } from '@/features/chat/features/workspace/utils/chat-workspace-file-viewer.utils';
 import {
   createWorkspaceFileTab,
+  createWorkspaceFileViewerTab,
   upsertWorkspaceFileTab,
 } from '@/features/chat/features/workspace/utils/chat-workspace-file-tab.utils';
 import {
@@ -148,13 +151,14 @@ export class ChatThreadManager {
           );
     useChatThreadStore.getState().setSnapshot({
       ...patch,
+      workspacePanelHidden: false,
       closedWorkspaceTabEntries,
       workspaceNavigationHistory: [...history.entries],
       workspaceNavigationHistoryIndex: history.index,
     });
   };
 
-  private openWorkspacePage = (
+  openWorkspacePage = (
     rawParentSessionKey: string | null,
     kind: 'overview' | 'child-sessions' | 'project-files' | 'cron' | 'continuous-attention',
   ) => {
@@ -184,7 +188,10 @@ export class ChatThreadManager {
     const normalizedSessionKey = sessionKey?.trim() || null;
     const { snapshot } = useChatThreadStore.getState();
     if (snapshot.workspacePanelParentKey === normalizedSessionKey && snapshot.activeWorkspacePanelKind) {
-      this.closeWorkspacePanel();
+      if (snapshot.workspacePanelHidden) {
+        useChatThreadStore.getState().setSnapshot({ workspacePanelHidden: false });
+        this.onWorkspacePanelOpened?.();
+      } else this.closeWorkspacePanel();
       return;
     }
     if (normalizedSessionKey) {
@@ -327,6 +334,13 @@ export class ChatThreadManager {
     this.activateWorkspaceFileTab(nextTab);
   };
 
+  moveFileToGlobal = (fileKey: string, context: WorkspaceFileViewContext, docBrowser: DocBrowserManager): void => {
+    const file = useChatThreadStore.getState().snapshot.workspaceFileTabs.find((item) => item.key === fileKey);
+    if (!file) return;
+    docBrowser.openTarget(createWorkspaceFilePanelTarget(file, context), { newTab: true, placement: 'docked' });
+    this.closeWorkspaceTab({ kind: 'file', key: file.key });
+  };
+
   openWorkspaceFileViewer = (fileKey: string, viewer?: ChatWorkspaceFileViewer) => {
     const sourceTab = useChatThreadStore
       .getState()
@@ -338,21 +352,7 @@ export class ChatThreadManager {
     if (!nextViewer) {
       return;
     }
-    const nextTab = createWorkspaceFileTab(
-      {
-        path: sourceTab.path,
-        label: sourceTab.label ?? undefined,
-        viewMode: 'preview',
-        previewViewer: nextViewer,
-        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,
-    );
+    const nextTab = createWorkspaceFileViewerTab(sourceTab, nextViewer);
     if (nextTab) {
       this.activateWorkspaceFileTab(nextTab, sourceTab.key);
     }
@@ -486,16 +486,7 @@ export class ChatThreadManager {
   };
 
   closeWorkspacePanel = () => {
-    useChatThreadStore.getState().setSnapshot({
-      workspacePanelParentKey: null,
-      activeWorkspacePanelKind: null,
-      activeChildSessionKey: null,
-      activeSideChatDraft: null,
-      activeWorkspaceFileKey: null,
-      closedWorkspaceTabEntries: [],
-      workspaceNavigationHistory: [],
-      workspaceNavigationHistoryIndex: 0,
-    });
+    useChatThreadStore.getState().setSnapshot({ workspacePanelHidden: true });
   };
 
   openSessionCronPanel = (sessionKey: string) => {

package/src/features/chat/managers/chat-voice-input.manager.ts

@@ -1,8 +1,8 @@
 import type { ChatComposerDictationSession } from '@nextclaw/agent-chat-ui';
-import { checkMicrophoneAccess, classifyMicrophoneError } from '@/features/chat/utils/chat-voice-permissions.utils';
+import { checkMicrophoneAccess, classifyMicrophoneError, isMicrophoneSecureContext } from '@/features/chat/utils/chat-voice-permissions.utils';
 
 export type VoicePhase = 'idle' | 'ready' | 'starting' | 'recording' | 'stopping' | 'error';
-export type VoiceError = 'unsupported' | 'permission' | 'service-denied' | 'no-device' | 'device-busy' | 'network' | 'audio-capture' | 'no-speech' | 'interrupted' | 'timeout' | 'failed';
+export type VoiceError = 'insecure-context' | 'unsupported' | 'permission' | 'service-denied' | 'no-device' | 'device-busy' | 'network' | 'audio-capture' | 'no-speech' | 'interrupted' | 'timeout' | 'failed';
 export type VoiceSnapshot = { phase: VoicePhase; text: string; interim: string; seconds: number; error: VoiceError | null };
 export type SpeechRecognitionLike = {
   lang: string;
@@ -38,7 +38,8 @@ export class ChatVoiceInputManager {
   private draft: ChatComposerDictationSession | null = null;
 
   constructor(private readonly createRecognition = createBrowserRecognition,
-    private readonly checkMicrophone = checkMicrophoneAccess) {}
+    private readonly checkMicrophone = checkMicrophoneAccess,
+    private readonly isSecureContext = isMicrophoneSecureContext) {}
 
   getSnapshot = (): VoiceSnapshot => this.snapshot;
   subscribe = (listener: () => void): (() => void) => {
@@ -70,6 +71,7 @@ export class ChatVoiceInputManager {
     this.draft = draft;
     this.update({ ...initialSnapshot(), phase: 'starting' });
     try {
+      if (!this.isSecureContext()) { this.fail('insecure-context'); return; }
       const recognition = this.createRecognition();
       if (!recognition) { this.fail('unsupported'); return; }
       this.recognition = recognition;

package/src/features/chat/managers/session-surface.manager.ts

@@ -0,0 +1,46 @@
+import { workbenchSurfaceManager } from '@/shared/components/workbench/managers/workbench-surface.manager';
+import { GLOBAL_WORKBENCH_SURFACE, SESSION_WORKBENCH_SURFACE } from '@/shared/components/workbench/types/workbench-surface.types';
+import { useFloatingSessionStore, type FloatingSession } from '@/features/chat/stores/floating-session.store';
+import type { DocBrowserManager } from '@/shared/components/doc-browser/managers/doc-browser.manager';
+import type { DocBrowserTab } from '@/shared/components/doc-browser/types/doc-browser.types';
+import { buildSessionPanelUrl, CHAT_SESSION_PANEL_KIND, parseSessionKeyFromPanelUrl } from '@/features/chat/features/session/utils/chat-session-route.utils';
+
+class SessionSurfaceManager {
+  open = (session: FloatingSession): void => {
+    useFloatingSessionStore.setState({ session });
+    workbenchSurfaceManager.place(SESSION_WORKBENCH_SURFACE, 'floating');
+  };
+
+  minimize = (): void => {
+    workbenchSurfaceManager.minimize(SESSION_WORKBENCH_SURFACE);
+  };
+
+  restore = (): void => {
+    workbenchSurfaceManager.restore(SESSION_WORKBENCH_SURFACE);
+  };
+
+  close = (): void => {
+    useFloatingSessionStore.setState({ session: null });
+    workbenchSurfaceManager.place(SESSION_WORKBENCH_SURFACE, 'floating');
+  };
+
+  dock = (session: FloatingSession, docBrowser: DocBrowserManager): void => {
+    workbenchSurfaceManager.place(GLOBAL_WORKBENCH_SURFACE, 'docked');
+    docBrowser.open(buildSessionPanelUrl(session.sessionKey), {
+      kind: CHAT_SESSION_PANEL_KIND,
+      title: session.title,
+      newTab: true,
+      dedupeKey: buildSessionPanelUrl(session.sessionKey),
+    });
+    if (useFloatingSessionStore.getState().session?.sessionKey === session.sessionKey) this.close();
+  };
+
+  popOut = (tab: DocBrowserTab, docBrowser: DocBrowserManager): void => {
+    const sessionKey = parseSessionKeyFromPanelUrl(tab.currentUrl);
+    if (!sessionKey) return;
+    this.open({ sessionKey, title: tab.title });
+    docBrowser.closeTab(tab.id);
+  };
+}
+
+export const sessionSurfaceManager = new SessionSurfaceManager();

package/src/features/chat/pages/__tests__/ncp-chat-page.test.tsx

@@ -1,8 +1,10 @@
+import { sessionSurfaceManager } from '@/features/chat/managers/session-surface.manager';
 import { act, render, screen, waitFor } from '@testing-library/react';
 import { MemoryRouter, Route, Routes } from 'react-router-dom';
 import { beforeEach, describe, expect, it, vi } from 'vitest';
 
 import { AppPresenterProvider } from '@/app/components/app-presenter-provider';
+import { ChatRuntimeProvider } from '@/features/chat/components/providers/chat-runtime.provider';
 import { NcpChatPage } from '@/features/chat/pages/ncp-chat-page';
 import { buildSessionPath } from '@/features/chat/features/session/utils/chat-session-route.utils';
 import { useChatThreadStore } from '@/features/chat/stores/chat-thread.store';
@@ -19,6 +21,7 @@ const mocks = vi.hoisted(() => ({
 vi.mock('@/app/presenters/app.presenter', () => ({
   getAppPresenter: () => ({
     docBrowserManager: {},
+    pageResourceManager: { bindWorkspace: vi.fn() },
     chatDraftIntentManager: {
       consumePending: mocks.consumePending,
       markConsumed: mocks.markConsumed,
@@ -56,8 +59,13 @@ vi.mock('@/features/chat/features/ncp/hooks/use-ui-show-content-event', () => ({
   useUiShowContentEvent: () => undefined,
 }));
 
-describe('NcpChatPage render boundary', () => {
+vi.mock('@/features/chat/features/conversation/components/floating-session-conversation', () => ({
+  FloatingSessionConversation: () => null,
+}));
+
+describe('Shared chat runtime and page boundary', () => {
   beforeEach(() => {
+    sessionSurfaceManager.close();
     mocks.syncVisibleSessions.mockReset();
     mocks.useChatSessionSync.mockReset();
     useChatThreadStore.getState().setSnapshot({
@@ -70,9 +78,9 @@ describe('NcpChatPage render boundary', () => {
   it('creates its chat presenter from the global app presenter provider', () => {
     render(
       <MemoryRouter initialEntries={['/chat']}>
-        <AppPresenterProvider>
+        <AppPresenterProvider><ChatRuntimeProvider>
           <NcpChatPage view="chat" />
-        </AppPresenterProvider>
+        </ChatRuntimeProvider></AppPresenterProvider>
       </MemoryRouter>,
     );
 
@@ -89,17 +97,19 @@ describe('NcpChatPage render boundary', () => {
     });
     const view = render(
       <MemoryRouter initialEntries={[sessionPath]}>
-        <AppPresenterProvider>
+        <AppPresenterProvider><ChatRuntimeProvider>
           <Routes>
             <Route path="/chat/:sessionId?" element={<NcpChatPage view="chat" />} />
           </Routes>
-        </AppPresenterProvider>
+        </ChatRuntimeProvider></AppPresenterProvider>
       </MemoryRouter>,
     );
 
     expect(mocks.syncVisibleSessions).toHaveBeenCalledWith([
       'session-background',
       'session-child',
+      undefined,
+      null,
     ]);
 
     act(() => {
@@ -111,9 +121,17 @@ describe('NcpChatPage render boundary', () => {
       expect(mocks.syncVisibleSessions).toHaveBeenLastCalledWith([
         'session-background',
         null,
+        undefined,
+        null,
       ]);
     });
 
+    act(() => {
+      sessionSurfaceManager.open({ sessionKey: 'session-float', title: 'Float' });
+    });
+    expect(mocks.syncVisibleSessions).toHaveBeenLastCalledWith(['session-background', null, 'session-float', null]);
+    act(() => sessionSurfaceManager.minimize());
+    expect(mocks.syncVisibleSessions).toHaveBeenLastCalledWith(['session-background', null, null, null]);
     view.unmount();
     expect(mocks.syncVisibleSessions).toHaveBeenLastCalledWith([]);
   });