"use client"; import React, { useCallback, useEffect, useRef, memo } from "react"; import { DockviewReact, DockviewDefaultTab, type IDockviewPanelProps, type IDockviewPanelHeaderProps, type DockviewReadyEvent, } from "dockview-react"; import { themeKandev } from "@/lib/layout/dockview-theme"; import { useDockviewStore, performLayoutSwitch } from "@/lib/state/dockview-store"; import { restoreEnvLayout } from "./dockview-layout-restore"; import { setupContainerResizeSync, setupGroupTracking, setupLayoutPersistence, setupPortalCleanup, setupSashDragCapToggle, } from "./dockview-layout-setup"; import { useAppStore, useAppStoreApi } from "@/components/state-provider"; import { useFileEditors } from "@/hooks/use-file-editors"; import { useLspFileOpener } from "@/hooks/use-lsp-file-opener"; import { useEditorKeybinds } from "@/hooks/use-editor-keybinds"; import { usePlanPanelAutoOpen } from "@/hooks/use-plan-panel-auto-open"; import { useSessionChangesCount } from "@/hooks/domains/session/use-session-changes-count"; import { useEnvironmentSessionId } from "@/hooks/use-environment-session-id"; import { useActiveTaskHasRepos } from "@/hooks/domains/kanban/use-active-task-has-repos"; // Panel components (rendered via portals, not directly by dockview) import { LeftHeaderActions, RightHeaderActions } from "./dockview-header-actions"; import { DockviewWatermark } from "./dockview-watermark"; import { TaskChatPanel } from "./task-chat-panel"; import { TaskChangesPanel } from "./task-changes-panel"; import type { ReviewSource } from "@/hooks/domains/session/use-review-sources"; import type { OpenDiffOptions } from "./changes-diff-target"; import { ChangesPanel } from "./changes-panel"; import { FilesPanel } from "./files-panel"; import { TaskPlanPanel } from "./task-plan-panel"; import { FileEditorPanel } from "./file-editor-panel"; import { PassthroughToolbar } from "./passthrough-toolbar"; import { PanelRoot, PanelBody } from "./panel-primitives"; import { ContextMenuTab } from "./tab-context-menu"; import { ChangesTab } from "./changes-tab"; import { PlanTab } from "./plan-tab"; import { PreviewFileTab, PreviewDiffTab, PreviewCommitTab, PinnedDefaultTab } from "./preview-tab"; import { SessionTab } from "./session-tab"; import { TerminalTab } from "./terminal-tab"; import { useTabMaximizeOnDoubleClick } from "./use-tab-maximize"; import { setupSessionTabSync, setupChatPanelSafetyNet, useAutoSessionTab, useAutoPRPanel, } from "./dockview-session-tabs"; import { useCompactDockviewDefault, useDockviewUnmountCleanup, } from "./dockview-desktop-layout-hooks"; import { TerminalPanel } from "./terminal-panel"; import { BrowserPanel } from "./browser-panel"; import { VscodePanel } from "./vscode-panel"; import { CommitDetailPanel } from "./commit-detail-panel"; import { PRDetailPanelComponent } from "@/components/github/pr-detail-panel"; import { PreviewController } from "./preview-controller"; import { ReviewDialog } from "@/components/review/review-dialog"; import { BottomTerminalPanel } from "./bottom-terminal-panel"; import { useReviewDialog } from "./use-review-dialog"; import type { Repository, RepositoryScript } from "@/lib/types/http"; import type { Terminal } from "@/hooks/domains/session/use-terminals"; // Portal system import { setPanelTitle } from "@/lib/layout/panel-portal-manager"; import { PanelPortalHost, usePortalSlot } from "@/lib/layout/panel-portal-host"; import { ENV_SCOPED_DOCKVIEW_COMPONENTS } from "@/lib/state/dockview-env-scoped-components"; import type { AppState } from "@/lib/state/store"; import { createDebugLogger, isDebug } from "@/lib/debug/log"; const debugChangesVisibility = createDebugLogger("changes:visibility"); // --------------------------------------------------------------------------- // PORTAL SLOT — generic dockview component that adopts a persistent portal // --------------------------------------------------------------------------- /** * Components whose portals are tied to a specific task environment. * * When the user switches task envs, portals for these components are released * via `panelPortalManager.releaseByEnv()` so stale state (WebSocket * connections, iframes, editor buffers) from the old env doesn't leak * into the new one. Same-env session switches are a no-op — these portals * persist because the underlying workspace, container, and git history all * belong to the env, not the session. * * A component belongs here if its content is bound to env-specific runtime * state that can't be swapped by simply reading a new `activeSessionId` from * the store: * * - file-editor — editing a file in the env's worktree * - browser — iframe preview of the env's dev server URL * - vscode — VS Code Server iframe running in the env's container * - commit-detail — displays a commit from the env's git history * - diff-viewer — shows file diffs from the env's working tree * - pr-detail — PR linked to the env's task * * Components NOT listed here are **global** — they read `activeSessionId` * reactively from the store and automatically reflect the current session: * * - sidebar — workspace/task navigation, not session-specific * - chat — subscribes to `activeSessionId`, re-renders for new session * - terminal — uses `useEnvironmentSessionId()`, reconnects only on env change * - changes — uses `useEnvironmentSessionId()` for stable git state * - files — uses `useEnvironmentSessionId()` for stable file tree * - plan — reads `activeTaskId` from the store */ const ENV_SCOPED_COMPONENTS = ENV_SCOPED_DOCKVIEW_COMPONENTS; /** * Every entry in the dockview `components` map uses this wrapper. * It renders an empty container and attaches the persistent portal element * managed by PanelPortalManager. The actual panel content is rendered by * PanelPortalHost outside the dockview tree. * * Env-scoped panels are tagged with the current task-env ID so they can be * cleaned up on env switch. */ function PortalSlot(props: IDockviewPanelProps) { const component = props.api.component; const activeEnvId = useAppStore((s) => { const sid = s.tasks.activeSessionId; return sid ? (s.environmentIdBySessionId[sid] ?? null) : null; }); const envId = ENV_SCOPED_COMPONENTS.has(component) ? (activeEnvId ?? undefined) : undefined; const containerRef = usePortalSlot(props, envId); return
; } // --- COMPONENT MAP --- // All panel types use the same PortalSlot wrapper — dockview only manages // layout positioning. Actual rendering happens in PanelPortalHost below. const components: Record> = { chat: PortalSlot, "diff-viewer": PortalSlot, "file-editor": PortalSlot, "commit-detail": PortalSlot, changes: PortalSlot, files: PortalSlot, terminal: PortalSlot, browser: PortalSlot, vscode: PortalSlot, plan: PortalSlot, "pr-detail": PortalSlot, // Backwards compat aliases for saved layouts "diff-files": PortalSlot, "all-files": PortalSlot, }; // --- TAB COMPONENTS --- function PermanentTab(props: IDockviewPanelHeaderProps) { const onDoubleClick = useTabMaximizeOnDoubleClick(props.api); return (
); } /** Sync the user's default saved layout from settings into the dockview store. */ function useSyncUserDefaultLayout() { const savedLayouts = useAppStore((s) => s.userSettings.savedLayouts); const setUserDefaultLayout = useDockviewStore((s) => s.setUserDefaultLayout); useEffect(() => { const defaultLayout = savedLayouts.find((l) => l.is_default); const state = defaultLayout?.layout as unknown as | import("@/lib/state/layout-manager").LayoutState | undefined; // Drop the obsolete "sidebar" column: the dockview-embedded sidebar pane was // retired for the unified AppSidebar, but a default layout saved before that // change still carries it. The default-build path applies this layout // without the restore-time sanitize layer, so an orphaned sidebar column // (its panel component is no longer registered) renders a broken grid. const columns = state?.columns?.filter((c) => c.id !== "sidebar"); setUserDefaultLayout(columns && columns.length > 0 ? { ...state, columns } : null); }, [savedLayouts, setUserDefaultLayout]); } const tabComponents: Record> = { permanentTab: PermanentTab, changesTab: ChangesTab, planTab: PlanTab, sessionTab: SessionTab, terminalTab: TerminalTab, previewFileTab: PreviewFileTab, previewDiffTab: PreviewDiffTab, previewCommitTab: PreviewCommitTab, pinnedDefaultTab: PinnedDefaultTab, }; // --------------------------------------------------------------------------- // PORTAL CONTENT — the actual panel implementations rendered via portals // --------------------------------------------------------------------------- // Each content component renders the real panel UI. They live permanently // in the PanelPortalHost and survive dockview layout switches. export const CHAT_PANEL_FALLBACK_LABEL = "Agent"; export function resolveChatPanelTitle(agentLabel: string | null | undefined): string { return agentLabel || CHAT_PANEL_FALLBACK_LABEL; } function useChatSessionTitle(panelId: string, sessionId: string | null) { const agentLabel = useAppStore((state) => { if (!sessionId) return null; const session = state.taskSessions.items[sessionId]; if (!session?.agent_profile_id) return null; const profile = state.agentProfiles.items.find( (p: { id: string }) => p.id === session.agent_profile_id, ); if (!profile) return null; const parts = profile.label.split(" \u2022 "); return parts[1] || parts[0] || profile.label; }); useEffect(() => { setPanelTitle(panelId, resolveChatPanelTitle(agentLabel)); }, [panelId, agentLabel]); } function ChatContent({ panelId, params }: { panelId: string; params: Record }) { const paramSessionId = params?.sessionId as string | undefined; const storeSessionId = useAppStore((state) => state.tasks.activeSessionId); const sessionId = paramSessionId ?? storeSessionId; const taskId = useAppStore((state) => state.tasks.activeTaskId); const { openFile } = useFileEditors(); const isPassthrough = useAppStore((state) => sessionId ? state.taskSessions.items[sessionId]?.is_passthrough === true : false, ); useChatSessionTitle(panelId, sessionId); if (isPassthrough) { return ( ); } return ( ); } function DiffViewerContent({ panelId, params, }: { panelId: string; params: Record; }) { const selectedDiff = useDockviewStore((s) => s.selectedDiff); const setSelectedDiff = useDockviewStore((s) => s.setSelectedDiff); const { openFile } = useFileEditors(); const panelKind = (params?.kind as string) ?? "all"; const selectedPath = panelKind === "file" ? (params?.path as string) : undefined; const sourceFilter = ((params?.source as string) || "all") as "all" | ReviewSource; const panelSelectedDiff = panelKind === "all" ? selectedDiff : null; const handleClosePanel = useCallback(() => { const dockApi = useDockviewStore.getState().api; const panel = dockApi?.getPanel(panelId); if (dockApi && panel) dockApi.removePanel(panel); }, [panelId]); return ( setSelectedDiff(null)} onOpenFile={openFile} onBecameEmpty={handleClosePanel} /> ); } function describeTaskRepositoriesForDebug(state: AppState, taskId: string | null) { if (!taskId) return { source: "none", repositoryId: "-", repoCount: -1, repoIds: "-" }; const task = state.kanban.tasks.find((item) => item.id === taskId); if (task) { return { source: "kanban", repositoryId: task.repositoryId ?? "-", repoCount: task.repositories?.length ?? -1, repoIds: task.repositories?.map((repo) => repo.repository_id).join(",") || "-", }; } for (const [workflowId, snapshot] of Object.entries(state.kanbanMulti.snapshots)) { const snapshotTask = snapshot.tasks.find((item) => item.id === taskId); if (!snapshotTask) continue; return { source: `kanbanMulti:${workflowId}`, repositoryId: snapshotTask.repositoryId ?? "-", repoCount: snapshotTask.repositories?.length ?? -1, repoIds: snapshotTask.repositories?.map((repo) => repo.repository_id).join(",") || "-", }; } return { source: "missing", repositoryId: "-", repoCount: -1, repoIds: "-" }; } function ChangesContent({ panelId }: { panelId: string }) { const addDiffViewerPanel = useDockviewStore((s) => s.addDiffViewerPanel); const addFileDiffPanel = useDockviewStore((s) => s.addFileDiffPanel); const addCommitDetailPanel = useDockviewStore((s) => s.addCommitDetailPanel); const { openFile } = useFileEditors(); const appStore = useAppStoreApi(); // Dynamic title with file count — use environment-stable sessionId so the // tab title doesn't re-fetch on same-environment session tab switches. const activeSessionId = useEnvironmentSessionId(); const totalCount = useSessionChangesCount(activeSessionId); // Repo-less tasks have no git changes ever — auto-close the panel so users // don't see a permanently empty Changes tab. Gate on a confirmed `false`: // `null` means the task hasn't loaded yet, and removing the panel during // that window is unrecoverable in the same session. const taskHasRepos = useActiveTaskHasRepos(); useEffect(() => { const dockApi = useDockviewStore.getState().api; const panel = dockApi?.getPanel(panelId); if (isDebug()) { const state = appStore.getState(); const activeTaskId = state.tasks.activeTaskId; const repoDebug = describeTaskRepositoriesForDebug(state, activeTaskId); let action = "keep"; if (taskHasRepos === false) { action = panel ? "remove" : "remove-missing-panel"; } debugChangesVisibility("auto-close decision", { panelId, taskHasRepos: taskHasRepos === null ? "unknown" : String(taskHasRepos), action, activeTaskId: activeTaskId ?? "-", sessionId: state.tasks.activeSessionId ?? "-", taskSource: repoDebug.source, repositoryId: repoDebug.repositoryId, repoCount: repoDebug.repoCount, repoIds: repoDebug.repoIds, livePanelIds: dockApi?.panels.map((p) => p.id).join(",") ?? "-", }); } if (taskHasRepos !== false) return; if (dockApi && panel) dockApi.removePanel(panel); }, [taskHasRepos, panelId, appStore]); useEffect(() => { const title = totalCount > 0 ? `Changes (${totalCount})` : "Changes"; setPanelTitle(panelId, title); }, [totalCount, panelId]); const handleEditFile = useCallback((path: string) => openFile(path), [openFile]); const handleOpenDiffFile = useCallback( (path: string, options?: OpenDiffOptions) => addFileDiffPanel(path, { source: options?.source, repositoryName: options?.repositoryName }), [addFileDiffPanel], ); const handleOpenCommitDetail = useCallback( (sha: string, repo?: string) => addCommitDetailPanel(sha, { repo }), [addCommitDetailPanel], ); const handleOpenDiffAll = useCallback(() => addDiffViewerPanel(), [addDiffViewerPanel]); const handleOpenReview = useCallback(() => { window.dispatchEvent(new CustomEvent("open-review-dialog")); }, []); return ( ); } function FilesContent() { const { openFile } = useFileEditors(); const handleOpenFile = useCallback( (file: { path: string; name: string; content: string }) => openFile(file.path), [openFile], ); return ; } function PlanContent() { const taskId = useAppStore((state) => state.tasks.activeTaskId); return ; } // --------------------------------------------------------------------------- // renderPanel — maps component names to their portal content // --------------------------------------------------------------------------- /** Resolve legacy component aliases to current names. */ const COMPONENT_ALIASES: Record = { "diff-files": "changes", "all-files": "files", }; function resolveComponent(component: string): string { return COMPONENT_ALIASES[component] ?? component; } function renderPanel( panelId: string, component: string, params: Record, ): React.ReactNode { const resolved = resolveComponent(component); switch (resolved) { case "sidebar": return null; case "chat": return ; case "diff-viewer": return ; case "file-editor": return ; case "commit-detail": return ; case "changes": return ; case "files": return ; case "terminal": return ; case "browser": return ; case "vscode": return ; case "plan": return ; case "pr-detail": return ; default: return
Unknown panel: {component}
; } } // --------------------------------------------------------------------------- // LAYOUT RESTORATION HELPERS // --------------------------------------------------------------------------- const VALID_COMPONENTS = new Set(Object.keys(components)); // --------------------------------------------------------------------------- // useEnvSwitchCleanup — backup layout switch for external session changes // --------------------------------------------------------------------------- function useEnvSwitchCleanup(effectiveSessionId: string | null, effectiveEnvId: string | null) { const prevEnvRef = useRef(undefined); useEffect(() => { const newEnvId = effectiveEnvId; if (prevEnvRef.current === undefined) { prevEnvRef.current = newEnvId; return; } if (prevEnvRef.current === newEnvId) return; const oldEnvId = prevEnvRef.current; prevEnvRef.current = newEnvId; // Portal cleanup is handled synchronously inside switchEnvLayout (in the // dockview store action) before any fromJSON call. This hook serves as a // backup for external session changes (e.g. WS-driven) that don't go // through the sidebar/dropdown switch helpers. Same-env switches return // early above (no-op). if (newEnvId) { performLayoutSwitch(oldEnvId, newEnvId, effectiveSessionId); } }, [effectiveEnvId, effectiveSessionId]); } // --------------------------------------------------------------------------- // MAIN LAYOUT COMPONENT // --------------------------------------------------------------------------- type DockviewDesktopLayoutProps = { workspaceId: string | null; workflowId: string | null; sessionId?: string | null; repository?: Repository | null; initialScripts?: RepositoryScript[]; initialTerminals?: Terminal[]; initialLayout?: string | null; compact?: boolean; }; export const DockviewDesktopLayout = memo(function DockviewDesktopLayout({ sessionId, repository, initialLayout, compact = false, }: DockviewDesktopLayoutProps) { const setApi = useDockviewStore((s) => s.setApi); const buildDefaultLayout = useDockviewStore((s) => s.buildDefaultLayout); const saveTimerRef = useRef | null>(null); const readyDisposersRef = useRef void>>([]); const appStore = useAppStoreApi(); const effectiveSessionId = useAppStore((state) => state.tasks.activeSessionId) ?? sessionId ?? null; const effectiveEnvId = useAppStore((state) => effectiveSessionId ? (state.environmentIdBySessionId[effectiveSessionId] ?? null) : null, ); const envIdRef = useRef(effectiveEnvId); const hasDevScript = Boolean(repository?.dev_script?.trim()); const review = useReviewDialog(effectiveSessionId); useSyncUserDefaultLayout(); useLspFileOpener(); useEditorKeybinds(); usePlanPanelAutoOpen(); useCompactDockviewDefault(compact); useEffect(() => { envIdRef.current = effectiveEnvId; }, [effectiveEnvId]); const onReady = useCallback( (event: DockviewReadyEvent) => { const api = event.api; setApi(api); const currentEnvId = envIdRef.current; const restored = !initialLayout && restoreEnvLayout(api, currentEnvId, appStore, VALID_COMPONENTS); if (!restored) { buildDefaultLayout(api, initialLayout ?? (compact ? "compact" : undefined)); } useDockviewStore.setState({ currentLayoutEnvId: currentEnvId }); readyDisposersRef.current.push(setupGroupTracking(api)); setupSessionTabSync(api, appStore); setupChatPanelSafetyNet(api, appStore); readyDisposersRef.current.push(setupLayoutPersistence(api, saveTimerRef, envIdRef)); setupPortalCleanup(api, appStore); readyDisposersRef.current.push(setupContainerResizeSync(api)); readyDisposersRef.current.push(setupSashDragCapToggle(api)); }, [setApi, buildDefaultLayout, initialLayout, compact, appStore], ); // Release session-scoped portals + trigger layout switch on session change. // IMPORTANT: this must run BEFORE useAutoSessionTab so the old layout is // saved before a new session tab is created — otherwise the new session's // panel could leak into the old session's persisted layout. useEnvSwitchCleanup(effectiveSessionId, effectiveEnvId); // Auto-create a session tab when a session becomes active useAutoSessionTab(effectiveSessionId); // Auto-show PR detail panel when the task has an associated PR useAutoPRPanel(); useDockviewUnmountCleanup(saveTimerRef, readyDisposersRef); // Visual masking: hide the dockview container during slow-path layout // switches (full fromJSON rebuild) to prevent the old layout from flashing. const isRestoringLayout = useDockviewStore((s) => s.isRestoringLayout); return (
{effectiveSessionId && ( )}
); });