@ccpocket/bridge 1.80.2 → 1.81.1

package/dist/websocket.js

@@ -104,6 +104,7 @@ const OPT_IN_SERVER_MESSAGES = new Set([
     "goal_state",
     "guardian_approval",
     "prompt_history_status",
+    "projects",
     "push_registration_result",
 ]);
 function isRecord(value) {
@@ -517,6 +518,8 @@ export class BridgeWebSocketServer {
     uploadStore;
     galleryStore;
     projectHistory;
+    workspaceStore;
+    pendingSessionWorkspaces = new Map();
     debugTraceStore;
     recordingStore;
     worktreeStore;
@@ -570,7 +573,7 @@ export class BridgeWebSocketServer {
     pendingClaudeResumeInputs = new WeakMap();
     resumeOperations = new Map();
     constructor(options) {
-        const { server, apiKey, allowedDirs, imageStore, mediaStore, uploadStore, galleryStore, projectHistory, debugTraceStore, recordingStore, firebaseAuth, promptHistoryBackup, promptHistoryStore, platform, fileListMaxEntries, fileListMaxBytes, fileDownloadMaxBytes, fileUploadMaxBytes, deltaBatchMs, deltaBatchMaxChars, } = options;
+        const { server, apiKey, allowedDirs, imageStore, mediaStore, uploadStore, galleryStore, projectHistory, workspaceStore, debugTraceStore, recordingStore, firebaseAuth, promptHistoryBackup, promptHistoryStore, platform, fileListMaxEntries, fileListMaxBytes, fileDownloadMaxBytes, fileUploadMaxBytes, deltaBatchMs, deltaBatchMaxChars, } = options;
         this.apiKey = apiKey ?? null;
         this.allowedDirs = allowedDirs ?? [];
         this.imageStore = imageStore ?? null;
@@ -578,6 +581,7 @@ export class BridgeWebSocketServer {
         this.uploadStore = uploadStore ?? null;
         this.galleryStore = galleryStore ?? null;
         this.projectHistory = projectHistory ?? null;
+        this.workspaceStore = workspaceStore ?? null;
         this.debugTraceStore = debugTraceStore ?? new DebugTraceStore();
         this.recordingStore = recordingStore ?? null;
         this.worktreeStore = new WorktreeStore();
@@ -619,7 +623,10 @@ export class BridgeWebSocketServer {
                 const info = this.galleryStore.metaToInfo(meta);
                 this.broadcast({ type: "gallery_new_image", image: info });
             }
-        }, this.worktreeStore, () => this.broadcastSessionList());
+        }, this.worktreeStore, (sessionId) => {
+            void this.persistPendingSessionWorkspace(sessionId);
+            this.broadcastSessionList();
+        });
         this.wss.on("connection", (ws, req) => {
             // API key authentication
             if (this.apiKey) {
@@ -856,12 +863,16 @@ export class BridgeWebSocketServer {
         const derivedCodexSettings = provider === "codex"
             ? withDerivedCodexPermissionsMode(session?.codexSettings)
             : session?.codexSettings;
+        const workspace = session
+            ? this.workspaceForRuntimeSession(session)
+            : undefined;
         const msg = {
             type: "system",
             subtype: "session_created",
             sessionId,
             provider,
             projectPath,
+            ...(workspace ? { workspace } : {}),
             ...(permissionMode
                 ? {
                     permissionMode: permissionMode,
@@ -1069,6 +1080,7 @@ export class BridgeWebSocketServer {
         }
         const projectPath = session.projectPath;
         const codexSettings = session.codexSettings;
+        const workspace = this.workspaceForRuntimeSession(session);
         const worktreeOpts = session.worktreePath
             ? {
                 existingWorktreePath: session.worktreePath,
@@ -1086,6 +1098,7 @@ export class BridgeWebSocketServer {
             ...(codexSettings ?? {}),
             threadId,
         }));
+        this.attachWorkspaceToRuntimeSession(newSessionId, workspace);
         const newSession = this.sessionManager.get(newSessionId);
         this.send(ws, {
             type: "rewind_result",
@@ -1152,6 +1165,7 @@ export class BridgeWebSocketServer {
         }
         const projectPath = session.projectPath;
         const codexSettings = session.codexSettings;
+        const workspace = this.workspaceForRuntimeSession(session);
         const worktreeOpts = session.worktreePath
             ? {
                 existingWorktreePath: session.worktreePath,
@@ -1174,6 +1188,7 @@ export class BridgeWebSocketServer {
             ...(codexSettings ?? {}),
             threadId: forkedThreadId,
         }));
+        this.attachWorkspaceToRuntimeSession(newSessionId, workspace);
         const newSession = this.sessionManager.get(newSessionId);
         this.send(ws, this.buildSessionCreatedMessage({
             sessionId: newSessionId,
@@ -1852,7 +1867,7 @@ export class BridgeWebSocketServer {
         // Send session list and project history on connect
         this.refreshConnectionMetadata();
         this.sendSessionList(ws);
-        const projects = this.projectHistory?.getProjects() ?? [];
+        const projects = this.legacyProjectHistoryProjects();
         this.send(ws, { type: "project_history", projects });
         ws.on("message", (data) => {
             if (this.rejectedProtocolClients.has(ws))
@@ -1954,7 +1969,32 @@ export class BridgeWebSocketServer {
         }
         switch (msg.type) {
             case "start": {
-                const projectPath = resolvePlatformPath(msg.projectPath, this.platform);
+                let projectPath = resolvePlatformPath(msg.projectPath, this.platform);
+                let resolvedWorkspace;
+                if (msg.projectId) {
+                    const project = this.workspaceStore?.getProject(msg.projectId);
+                    if (!project) {
+                        this.send(ws, {
+                            type: "error",
+                            requestId: msg.requestId,
+                            errorCode: "project_not_found",
+                            message: `Project not found: ${msg.projectId}`,
+                        });
+                        break;
+                    }
+                    const normalized = this.normalizeWorkspaceRoots(project.rootPaths);
+                    if (normalized.deniedRoot || !normalized.roots) {
+                        this.send(ws, this.buildPathNotAllowedError(normalized.deniedRoot ?? project.rootPaths[0]));
+                        break;
+                    }
+                    projectPath = normalized.roots[0];
+                    resolvedWorkspace = {
+                        kind: "project",
+                        projectId: project.id,
+                        projectName: project.name,
+                        rootPaths: normalized.roots,
+                    };
+                }
                 if (!this.isPathAllowed(projectPath)) {
                     this.send(ws, {
                         ...this.buildPathNotAllowedError(msg.projectPath),
@@ -2012,9 +2052,9 @@ export class BridgeWebSocketServer {
                             break;
                         }
                     }
-                    const additionalWritableRoots = provider === "codex"
-                        ? this.normalizeAdditionalWritableRoots(msg.additionalWritableRoots, projectPath)
-                        : {};
+                    const requestedAdditionalRoots = resolvedWorkspace?.rootPaths.slice(1) ??
+                        msg.additionalWritableRoots;
+                    const additionalWritableRoots = this.normalizeAdditionalWritableRoots(requestedAdditionalRoots, projectPath);
                     if (additionalWritableRoots.deniedRoot) {
                         this.send(ws, {
                             ...this.buildPathNotAllowedError(additionalWritableRoots.deniedRoot),
@@ -2041,6 +2081,7 @@ export class BridgeWebSocketServer {
                                 ...(msg.sandboxMode
                                     ? { sandboxEnabled: msg.sandboxMode === "on" }
                                     : {}),
+                                additionalDirectories: additionalWritableRoots.roots,
                             },
                             worktreeOptions: {
                                 useWorktree: msg.useWorktree,
@@ -2086,6 +2127,10 @@ export class BridgeWebSocketServer {
                             usedFallback: false,
                         };
                     const createdSession = this.sessionManager.get(sessionId);
+                    if (resolvedWorkspace) {
+                        this.pendingSessionWorkspaces.set(sessionId, resolvedWorkspace);
+                        void this.persistPendingSessionWorkspace(sessionId);
+                    }
                     const cached = this.sessionManager.getCachedCommands(provider, createdSession?.worktreePath ?? projectPath);
                     // Load saved session name from CLI storage (for resumed sessions)
                     void this.loadAndSetSessionName(createdSession, provider, projectPath, msg.sessionId).then(() => {
@@ -2150,9 +2195,17 @@ export class BridgeWebSocketServer {
                     this.recordingStore?.saveMeta(sessionId, {
                         bridgeSessionId: sessionId,
                         projectPath,
+                        ...(resolvedWorkspace?.projectId
+                            ? { projectId: resolvedWorkspace.projectId }
+                            : {}),
+                        ...(resolvedWorkspace?.projectName
+                            ? { projectName: resolvedWorkspace.projectName }
+                            : {}),
                         createdAt: new Date().toISOString(),
                     });
-                    this.projectHistory?.addProject(projectPath);
+                    if (!resolvedWorkspace) {
+                        this.projectHistory?.addProject(projectPath);
+                    }
                 }
                 catch (err) {
                     console.error(`[ws] Failed to start session:`, err);
@@ -2805,6 +2858,7 @@ export class BridgeWebSocketServer {
                     const worktreePath = session.worktreePath;
                     const worktreeBranch = session.worktreeBranch;
                     const sessionName = session.name;
+                    const workspace = this.workspaceForRuntimeSession(session);
                     this.destroySession(oldSessionId);
                     console.log(`[ws] Permission mode change: destroyed session ${oldSessionId}`);
                     const hasUserMessages = session.history?.some((m) => m.type === "user_input" || m.type === "assistant") ||
@@ -2822,8 +2876,10 @@ export class BridgeWebSocketServer {
                             serviceTier: oldSettings.serviceTier,
                             networkAccessEnabled: oldSettings.networkAccessEnabled,
                             webSearchMode: oldSettings.webSearchMode,
+                            additionalWritableRoots: oldSettings.additionalWritableRoots,
                             collaborationMode: newCollaboration,
                         }));
+                        this.attachWorkspaceToRuntimeSession(newId, workspace);
                         const newSession = this.sessionManager.get(newId);
                         if (newSession && sessionName)
                             newSession.name = sessionName;
@@ -2883,8 +2939,10 @@ export class BridgeWebSocketServer {
                             serviceTier: oldSettings.serviceTier,
                             networkAccessEnabled: oldSettings.networkAccessEnabled,
                             webSearchMode: oldSettings.webSearchMode,
+                            additionalWritableRoots: oldSettings.additionalWritableRoots,
                             collaborationMode: newCollaboration,
                         }));
+                        this.attachWorkspaceToRuntimeSession(newId, workspace);
                         const newSession = this.sessionManager.get(newId);
                         if (newSession && sessionName) {
                             newSession.name = sessionName;
@@ -3174,6 +3232,7 @@ export class BridgeWebSocketServer {
                     const sessionName = session.name;
                     const permissionMode = session.process.permissionMode;
                     const model = session.process.model;
+                    const workspace = this.workspaceForRuntimeSession(session);
                     this.destroySession(oldSessionId);
                     console.log(`[ws] Claude sandbox change: destroyed session ${oldSessionId}`);
                     const newId = this.sessionManager.create(projectPath, {
@@ -3181,9 +3240,11 @@ export class BridgeWebSocketServer {
                         permissionMode,
                         model,
                         sandboxEnabled: newEnabled,
+                        additionalDirectories: workspace?.rootPaths.slice(1),
                     }, undefined, worktreePath
                         ? { existingWorktreePath: worktreePath, worktreeBranch }
                         : undefined, "claude");
+                    this.attachWorkspaceToRuntimeSession(newId, workspace);
                     const newSession = this.sessionManager.get(newId);
                     if (newSession && sessionName)
                         newSession.name = sessionName;
@@ -3227,6 +3288,7 @@ export class BridgeWebSocketServer {
                 const sessionName = session.name;
                 const collaborationMode = session.process
                     .collaborationMode;
+                const workspace = this.workspaceForRuntimeSession(session);
                 const executionMode = oldSettings.approvalPolicy === "never" ? "fullAccess" : "default";
                 const planMode = collaborationMode === "plan";
                 const legacyPermissionMode = modesToLegacyPermissionMode("codex", executionMode, planMode);
@@ -3255,8 +3317,10 @@ export class BridgeWebSocketServer {
                         serviceTier: oldSettings.serviceTier,
                         networkAccessEnabled: oldSettings.networkAccessEnabled,
                         webSearchMode: oldSettings.webSearchMode,
+                        additionalWritableRoots: oldSettings.additionalWritableRoots,
                         collaborationMode,
                     }));
+                    this.attachWorkspaceToRuntimeSession(newId, workspace);
                     const newSession = this.sessionManager.get(newId);
                     if (newSession && sessionName)
                         newSession.name = sessionName;
@@ -3309,8 +3373,10 @@ export class BridgeWebSocketServer {
                         serviceTier: oldSettings.serviceTier,
                         networkAccessEnabled: oldSettings.networkAccessEnabled,
                         webSearchMode: oldSettings.webSearchMode,
+                        additionalWritableRoots: oldSettings.additionalWritableRoots,
                         collaborationMode,
                     }));
+                    this.attachWorkspaceToRuntimeSession(newId, workspace);
                     // Restore session name
                     const newSession = this.sessionManager.get(newId);
                     if (newSession && sessionName) {
@@ -3377,6 +3443,7 @@ export class BridgeWebSocketServer {
                     const permissionMode = sdkProc.permissionMode;
                     const worktreePath = session.worktreePath;
                     const worktreeBranch = session.worktreeBranch;
+                    const workspace = this.workspaceForRuntimeSession(session);
                     this.destroySession(sessionId);
                     console.log(`[ws] Clear context: destroyed session ${sessionId}`);
                     const newId = this.sessionManager.create(projectPath, {
@@ -3388,9 +3455,11 @@ export class BridgeWebSocketServer {
                             : {}),
                         permissionMode,
                         initialInput: planText || undefined,
+                        additionalDirectories: workspace?.rootPaths.slice(1),
                     }, undefined, worktreePath
                         ? { existingWorktreePath: worktreePath, worktreeBranch }
                         : undefined);
+                    this.attachWorkspaceToRuntimeSession(newId, workspace);
                     console.log(`[ws] Clear context: created new session ${newId} (CLI session: ${claudeSessionId ?? "new"})`);
                     // Notify all clients. Broadcast is used so reconnecting clients also receive it.
                     const newSession = this.sessionManager.get(newId);
@@ -3576,7 +3645,7 @@ export class BridgeWebSocketServer {
                     this.send(ws, {
                         type: "session_context",
                         sessionId: msg.sessionId,
-                        context: { ...context },
+                        context: { ...this.runtimeSessionWithWorkspace(context) },
                     });
                 }
                 else {
@@ -3830,6 +3899,8 @@ export class BridgeWebSocketServer {
                         limit: msg.limit,
                         offset: msg.offset,
                         projectPath: msg.projectPath,
+                        projectId: msg.projectId,
+                        workspaceKind: msg.workspaceKind,
                         requestScope: msg.requestScope,
                         requestId: msg.requestId,
                     });
@@ -3844,6 +3915,8 @@ export class BridgeWebSocketServer {
                         message: `Failed to list recent sessions: ${err}`,
                         errorCode: "recent_sessions_failed",
                         path: msg.projectPath,
+                        projectId: msg.projectId,
+                        workspaceKind: msg.workspaceKind,
                         requestId: msg.requestId,
                         requestScope: msg.requestScope,
                         offset: msg.offset,
@@ -3904,9 +3977,58 @@ export class BridgeWebSocketServer {
             }
             case "resume_session": {
                 const resumeStartedAt = Date.now();
-                console.log(`[ws] resume_session: sessionId=${msg.sessionId} projectPath=${msg.projectPath} provider=${msg.provider ?? "claude"}`);
-                const resumeProjectPath = resolvePlatformPath(msg.projectPath, this.platform);
                 const provider = msg.provider ?? "claude";
+                const storedAssignment = this.workspaceStore?.getAssignment(provider, msg.sessionId);
+                const requestedProject = !storedAssignment && msg.projectId
+                    ? this.workspaceStore?.getProject(msg.projectId)
+                    : undefined;
+                if (!storedAssignment && msg.projectId && !requestedProject) {
+                    this.sendResumeFailed(ws, {
+                        provider,
+                        sourceSessionId: msg.sessionId,
+                        projectPath: msg.projectPath,
+                        resumeRequestId: msg.resumeRequestId,
+                    });
+                    this.send(ws, {
+                        type: "error",
+                        sessionId: msg.sessionId,
+                        requestId: msg.resumeRequestId,
+                        errorCode: "project_not_found",
+                        message: `Project not found: ${msg.projectId}`,
+                    });
+                    break;
+                }
+                const assignedProject = storedAssignment?.projectId
+                    ? this.workspaceStore?.getProject(storedAssignment.projectId)
+                    : undefined;
+                const resolvedResumeProjectName = assignedProject?.name ?? storedAssignment?.projectName;
+                const resumeRoots = storedAssignment?.rootPaths ?? requestedProject?.rootPaths;
+                console.log(`[ws] resume_session: sessionId=${msg.sessionId} projectPath=${msg.projectPath} provider=${msg.provider ?? "claude"}`);
+                // A stored assignment supplies the root snapshot and secondary roots,
+                // while the recent-session path may be a worktree cwd that must win.
+                const resumeProjectPath = resolvePlatformPath(storedAssignment
+                    ? msg.projectPath
+                    : (resumeRoots?.[0] ?? msg.projectPath), this.platform);
+                const resumeAdditionalRoots = resumeRoots?.slice(1) ?? msg.additionalWritableRoots;
+                const resolvedResumeWorkspace = storedAssignment
+                    ? {
+                        kind: storedAssignment.kind,
+                        ...(storedAssignment.projectId
+                            ? { projectId: storedAssignment.projectId }
+                            : {}),
+                        ...(resolvedResumeProjectName
+                            ? { projectName: resolvedResumeProjectName }
+                            : {}),
+                        rootPaths: storedAssignment.rootPaths,
+                    }
+                    : requestedProject
+                        ? {
+                            kind: "project",
+                            projectId: requestedProject.id,
+                            projectName: requestedProject.name,
+                            rootPaths: requestedProject.rootPaths,
+                        }
+                        : undefined;
                 if (!this.isPathAllowed(resumeProjectPath)) {
                     this.sendResumeFailed(ws, {
                         provider,
@@ -3917,6 +4039,13 @@ export class BridgeWebSocketServer {
                     this.send(ws, this.buildPathNotAllowedError(msg.projectPath));
                     break;
                 }
+                if (resolvedResumeWorkspace &&
+                    !storedAssignment &&
+                    this.workspaceStore) {
+                    void this.workspaceStore.assignSession(provider, msg.sessionId, resolvedResumeWorkspace).catch((error) => {
+                        console.error("[workspace] Failed to persist resume assignment:", error);
+                    });
+                }
                 const normalizedCodexPermissionsMode = provider === "codex"
                     ? normalizeCodexPermissionsMode(msg.codexPermissionsMode)
                     : undefined;
@@ -3960,7 +4089,7 @@ export class BridgeWebSocketServer {
                     const effectiveProfile = msg.profile
                         ? await this.resolveCodexResumeProfile(msg.profile, sessionRefId, effectiveProjectPath)
                         : undefined;
-                    const additionalWritableRoots = this.normalizeAdditionalWritableRoots(msg.additionalWritableRoots, effectiveProjectPath);
+                    const additionalWritableRoots = this.normalizeAdditionalWritableRoots(resumeAdditionalRoots, effectiveProjectPath);
                     if (additionalWritableRoots.deniedRoot) {
                         this.sendResumeFailed(ws, {
                             provider,
@@ -4098,7 +4227,9 @@ export class BridgeWebSocketServer {
                             type: "session_resumed",
                             detail: `provider=codex thread=${sessionRefId}`,
                         });
-                        this.projectHistory?.addProject(effectiveProjectPath);
+                        if (!resolvedResumeWorkspace) {
+                            this.projectHistory?.addProject(effectiveProjectPath);
+                        }
                         console.info(formatResumePerformanceLog({
                             provider: "codex",
                             sourceSessionId: sessionRefId,
@@ -4136,6 +4267,17 @@ export class BridgeWebSocketServer {
                     break;
                 }
                 const claudeSessionId = sessionRefId;
+                const additionalDirectories = this.normalizeAdditionalWritableRoots(resumeAdditionalRoots, resumeProjectPath);
+                if (additionalDirectories.deniedRoot) {
+                    this.sendResumeFailed(ws, {
+                        provider,
+                        sourceSessionId: sessionRefId,
+                        projectPath: resumeProjectPath,
+                        resumeRequestId: msg.resumeRequestId,
+                    });
+                    this.send(ws, this.buildPathNotAllowedError(additionalDirectories.deniedRoot));
+                    break;
+                }
                 // Look up worktree mapping for this Claude session
                 const wtMapping = this.worktreeStore.get(claudeSessionId);
                 let worktreeOpts;
@@ -4190,6 +4332,7 @@ export class BridgeWebSocketServer {
                             ...(msg.sandboxMode
                                 ? { sandboxEnabled: msg.sandboxMode === "on" }
                                 : {}),
+                            additionalDirectories: additionalDirectories.roots,
                         },
                         pastMessages,
                         worktreeOptions: worktreeOpts,
@@ -4260,7 +4403,9 @@ export class BridgeWebSocketServer {
                         type: "session_resumed",
                         detail: `provider=claude session=${claudeSessionId}`,
                     });
-                    this.projectHistory?.addProject(resumeProjectPath);
+                    if (!resolvedResumeWorkspace) {
+                        this.projectHistory?.addProject(resumeProjectPath);
+                    }
                 })
                     .catch((err) => {
                     if (!historyLoaded) {
@@ -4347,16 +4492,104 @@ export class BridgeWebSocketServer {
                 break;
             }
             case "list_project_history": {
-                const projects = this.projectHistory?.getProjects() ?? [];
+                const projects = this.legacyProjectHistoryProjects();
                 this.send(ws, { type: "project_history", projects });
                 break;
             }
             case "remove_project_history": {
                 this.projectHistory?.removeProject(msg.projectPath);
-                const projects = this.projectHistory?.getProjects() ?? [];
+                const projects = this.legacyProjectHistoryProjects();
                 this.send(ws, { type: "project_history", projects });
                 break;
             }
+            case "list_projects": {
+                this.send(ws, this.projectsMessage(msg.requestId));
+                break;
+            }
+            case "create_project": {
+                if (!this.workspaceStore) {
+                    this.send(ws, {
+                        type: "error",
+                        requestId: msg.requestId,
+                        errorCode: "projects_unavailable",
+                        message: "Project storage is unavailable",
+                    });
+                    break;
+                }
+                const normalized = this.normalizeWorkspaceRoots(msg.rootPaths);
+                if (normalized.deniedRoot || !normalized.roots) {
+                    this.send(ws, this.buildPathNotAllowedError(normalized.deniedRoot ?? msg.rootPaths[0]));
+                    break;
+                }
+                try {
+                    await this.workspaceStore.createProject(msg.name, normalized.roots);
+                    this.broadcast(this.projectsMessage(msg.requestId));
+                }
+                catch (error) {
+                    this.sendWorkspaceMutationError(ws, msg.requestId, "create Project", error);
+                }
+                break;
+            }
+            case "update_project": {
+                if (!this.workspaceStore) {
+                    this.send(ws, {
+                        type: "error",
+                        requestId: msg.requestId,
+                        errorCode: "projects_unavailable",
+                        message: "Project storage is unavailable",
+                    });
+                    break;
+                }
+                const normalized = this.normalizeWorkspaceRoots(msg.rootPaths);
+                if (normalized.deniedRoot || !normalized.roots) {
+                    this.send(ws, this.buildPathNotAllowedError(normalized.deniedRoot ?? msg.rootPaths[0]));
+                    break;
+                }
+                let updated;
+                try {
+                    updated = await this.workspaceStore.updateProject(msg.projectId, msg.name, normalized.roots);
+                }
+                catch (error) {
+                    this.sendWorkspaceMutationError(ws, msg.requestId, "update Project", error);
+                    break;
+                }
+                if (!updated) {
+                    this.send(ws, {
+                        type: "error",
+                        requestId: msg.requestId,
+                        errorCode: "project_not_found",
+                        message: `Project not found: ${msg.projectId}`,
+                    });
+                    break;
+                }
+                this.broadcast(this.projectsMessage(msg.requestId));
+                break;
+            }
+            case "remove_project": {
+                if (!this.workspaceStore) {
+                    this.sendWorkspaceMutationError(ws, msg.requestId, "remove Project", new Error("Project storage is unavailable"));
+                    break;
+                }
+                let removed;
+                try {
+                    removed = await this.workspaceStore.removeProject(msg.projectId);
+                }
+                catch (error) {
+                    this.sendWorkspaceMutationError(ws, msg.requestId, "remove Project", error);
+                    break;
+                }
+                if (!removed) {
+                    this.send(ws, {
+                        type: "error",
+                        requestId: msg.requestId,
+                        errorCode: "project_not_found",
+                        message: `Project not found: ${msg.projectId}`,
+                    });
+                    break;
+                }
+                this.broadcast(this.projectsMessage(msg.requestId));
+                break;
+            }
             case "list_directory": {
                 try {
                     const listing = await listAllowedDirectories(msg.path, this.allowedDirs, this.platform, msg.includeHidden ?? false);
@@ -4700,6 +4933,20 @@ export class BridgeWebSocketServer {
                             }
                         }
                     }
+                    // A recording keeps its name snapshot after Project deletion, but a
+                    // live Project rename should be reflected when the list is read.
+                    for (const recording of recordings) {
+                        const projectId = recording.meta?.projectId;
+                        if (!projectId)
+                            continue;
+                        const project = this.workspaceStore?.getProject(projectId);
+                        if (project && recording.meta) {
+                            recording.meta = {
+                                ...recording.meta,
+                                projectName: project.name,
+                            };
+                        }
+                    }
                     this.send(ws, { type: "recording_list", recordings });
                 });
                 break;
@@ -5758,9 +6005,17 @@ export class BridgeWebSocketServer {
                     break;
                 }
                 try {
+                    const runtimeSession = msg.sessionId
+                        ? this.resolveSession(msg.sessionId)
+                        : undefined;
+                    const workspace = runtimeSession
+                        ? this.workspaceForRuntimeSession(runtimeSession)
+                        : undefined;
                     const entry = await this.promptHistoryStore.record({
                         text: msg.text,
                         projectPath: msg.projectPath,
+                        projectId: workspace?.projectId ?? msg.projectId,
+                        projectName: workspace?.projectName ?? msg.projectName,
                         clientId: msg.clientId,
                         clientName: msg.clientName,
                         sessionId: msg.sessionId,
@@ -5831,6 +6086,7 @@ export class BridgeWebSocketServer {
                         id: msg.id,
                         text: msg.text,
                         projectPath: msg.projectPath,
+                        projectId: msg.projectId,
                         action: msg.action,
                         isFavorite: msg.isFavorite,
                         updatedAt: msg.updatedAt,
@@ -6204,7 +6460,7 @@ export class BridgeWebSocketServer {
     }
     sendSessionList(ws) {
         this.pruneDebugEvents();
-        const sessions = this.sessionManager.list();
+        const sessions = this.runtimeSessionsWithWorkspaces();
         this.send(ws, {
             type: "session_list",
             sessions,
@@ -6242,7 +6498,7 @@ export class BridgeWebSocketServer {
     /** Broadcast session list to all connected clients. */
     broadcastSessionList() {
         this.pruneDebugEvents();
-        const sessions = this.sessionManager.list();
+        const sessions = this.runtimeSessionsWithWorkspaces();
         this.broadcast({
             type: "session_list",
             sessions,
@@ -6264,6 +6520,18 @@ export class BridgeWebSocketServer {
             ],
         });
     }
+    runtimeSessionsWithWorkspaces() {
+        return this.sessionManager
+            .list()
+            .map((summary) => this.runtimeSessionWithWorkspace(summary));
+    }
+    runtimeSessionWithWorkspace(summary) {
+        const session = this.sessionManager.get(summary.id);
+        const workspace = session
+            ? this.workspaceForRuntimeSession(session)
+            : undefined;
+        return workspace ? { ...summary, workspace } : summary;
+    }
     broadcastPromptHistoryStatus() {
         if (!this.promptHistoryStore)
             return;
@@ -6390,6 +6658,7 @@ export class BridgeWebSocketServer {
     }
     destroySession(sessionId) {
         this.flushSessionDeltaBatches(sessionId);
+        this.pendingSessionWorkspaces.delete(sessionId);
         this.sessionManager.destroy(sessionId);
     }
     trackSessionMessage(sessionId, msg) {
@@ -6407,10 +6676,15 @@ export class BridgeWebSocketServer {
             msg.sessionId) {
             const session = this.sessionManager.get(sessionId);
             if (session) {
+                const workspace = this.workspaceForRuntimeSession(session);
                 this.recordingStore?.saveMeta(sessionId, {
                     bridgeSessionId: sessionId,
                     claudeSessionId: msg.sessionId,
                     projectPath: session.projectPath,
+                    ...(workspace?.projectId ? { projectId: workspace.projectId } : {}),
+                    ...(workspace?.projectName
+                        ? { projectName: workspace.projectName }
+                        : {}),
                     createdAt: session.createdAt.toISOString(),
                 });
             }
@@ -6433,6 +6707,128 @@ export class BridgeWebSocketServer {
         }
     }
     async listRecentSessions(msg) {
+        const primaryProjectIds = new Set(msg.projectPath === undefined
+            ? []
+            : (this.workspaceStore?.listProjects() ?? [])
+                .filter((project) => project.rootPaths[0] === msg.projectPath)
+                .map((project) => project.id));
+        const workspaceFilterRequested = msg.projectId !== undefined ||
+            msg.workspaceKind !== undefined ||
+            primaryProjectIds.size > 0;
+        if (!workspaceFilterRequested) {
+            const rawResult = await this.listRecentSessionsRaw(msg);
+            const enriched = rawResult.sessions.map((session) => this.enrichRecentSessionWorkspace(session));
+            return { sessions: enriched, hasMore: rawResult.hasMore };
+        }
+        const matchesWorkspace = (session) => {
+            const value = session;
+            const workspace = value.workspace;
+            if (msg.projectId && workspace?.projectId !== msg.projectId)
+                return false;
+            if (msg.workspaceKind && workspace?.kind !== msg.workspaceKind)
+                return false;
+            if (msg.projectPath !== undefined) {
+                const matchesPrimaryProject = typeof workspace?.projectId === "string" &&
+                    primaryProjectIds.has(workspace.projectId);
+                if (value.projectPath !== msg.projectPath &&
+                    !matchesPrimaryProject) {
+                    return false;
+                }
+            }
+            return true;
+        };
+        const offset = msg.offset ?? 0;
+        const limit = msg.limit ?? 20;
+        const requiredMatches = offset + limit + 1;
+        let filtered;
+        if (msg.provider === "codex") {
+            filtered = await this.listWorkspaceFilteredCodexSessions(msg, matchesWorkspace, requiredMatches);
+        }
+        else if (msg.provider === "claude") {
+            filtered = await this.listWorkspaceFilteredIndexedSessions(msg, matchesWorkspace, requiredMatches);
+        }
+        else {
+            // The filesystem index includes both providers and is also the fallback
+            // for Codex rollouts not returned by app-server. Merge it with one
+            // cursor-preserving app-server scan for the freshest Codex metadata.
+            const [indexed, codex] = await Promise.all([
+                this.listWorkspaceFilteredIndexedSessions(msg, matchesWorkspace, requiredMatches),
+                this.listWorkspaceFilteredCodexSessions({ ...msg, provider: "codex" }, matchesWorkspace, requiredMatches),
+            ]);
+            filtered = mergeRecentSessionPages([...codex, ...indexed]);
+        }
+        return {
+            sessions: filtered.slice(offset, offset + limit),
+            hasMore: filtered.length > offset + limit,
+        };
+    }
+    async listWorkspaceFilteredIndexedSessions(msg, matchesWorkspace, limit) {
+        const result = await getAllRecentSessions({
+            limit,
+            offset: 0,
+            // Project identity is authoritative. Do not pre-filter by the current
+            // primary root: assignments may retain an older snapshot or worktree cwd.
+            provider: msg.provider,
+            namedOnly: msg.namedOnly,
+            searchQuery: msg.searchQuery,
+            archivedSessionIds: this.archiveStore.archivedIds(),
+            sessionFilter: (session) => matchesWorkspace(this.enrichRecentSessionWorkspace(session)),
+        });
+        return result.sessions.map((session) => this.enrichRecentSessionWorkspace(session));
+    }
+    async listWorkspaceFilteredCodexSessions(msg, matchesWorkspace, limit) {
+        try {
+            return await this.listWorkspaceFilteredCodexThreads(msg, matchesWorkspace, limit);
+        }
+        catch (err) {
+            console.warn(`[ws] Codex thread/list failed, falling back to rollout scan: ${err}`);
+            return this.listWorkspaceFilteredIndexedSessions({ ...msg, provider: "codex" }, matchesWorkspace, limit);
+        }
+    }
+    async listWorkspaceFilteredCodexThreads(msg, matchesWorkspace, limit) {
+        const activeProcess = this.getActiveCodexProcess();
+        const process = activeProcess ?? (await this.createStandaloneCodexProcess(undefined));
+        const isStandalone = activeProcess === null;
+        try {
+            const archivedIds = this.archiveStore.archivedIds();
+            const matchingThreads = [];
+            let cursor;
+            do {
+                const request = {
+                    limit: 500,
+                    searchTerm: msg.searchQuery,
+                    sourceKinds: CODEX_RECENT_THREAD_SOURCE_KINDS,
+                };
+                if (cursor != null)
+                    request.cursor = cursor;
+                const result = await process.listThreads(request);
+                for (const thread of result.data) {
+                    if (archivedIds.has(thread.id))
+                        continue;
+                    if (msg.namedOnly && !thread.name)
+                        continue;
+                    const workspaceProbe = this.enrichRecentSessionWorkspace({
+                        provider: "codex",
+                        sessionId: thread.id,
+                        projectPath: thread.cwd,
+                    });
+                    if (!matchesWorkspace(workspaceProbe))
+                        continue;
+                    matchingThreads.push(thread);
+                    if (matchingThreads.length >= limit)
+                        break;
+                }
+                cursor = result.nextCursor;
+            } while (matchingThreads.length < limit && cursor != null);
+            const indexedById = await getCodexSessionIndexMetadata(matchingThreads.map((thread) => thread.id));
+            return matchingThreads.map((thread) => this.enrichRecentSessionWorkspace(codexThreadToRecentSession(thread, indexedById.get(thread.id))));
+        }
+        finally {
+            if (isStandalone)
+                process.stop();
+        }
+    }
+    async listRecentSessionsRaw(msg) {
         if (msg.provider === "codex") {
             return this.listRecentCodexSessions(msg);
         }
@@ -6449,11 +6845,106 @@ export class BridgeWebSocketServer {
             archivedSessionIds: this.archiveStore.archivedIds(),
         });
     }
+    enrichRecentSessionWorkspace(session) {
+        if (!session || typeof session !== "object")
+            return session;
+        const value = session;
+        const provider = value.provider;
+        const providerSessionId = value.sessionId;
+        const projectPath = value.projectPath;
+        if ((provider !== "claude" && provider !== "codex") ||
+            typeof providerSessionId !== "string" ||
+            typeof projectPath !== "string") {
+            return session;
+        }
+        const workspace = this.workspaceStore?.resolveRecentWorkspace(provider, providerSessionId);
+        return {
+            ...value,
+            workspace: workspace ?? {
+                kind: "unassigned",
+                rootPaths: projectPath ? [projectPath] : [],
+            },
+        };
+    }
+    normalizeWorkspaceRoots(rootPaths) {
+        const roots = [];
+        const seen = new Set();
+        for (const rawPath of rootPaths) {
+            const path = resolvePlatformPath(rawPath, this.platform);
+            if (!this.isPathAllowed(path))
+                return { deniedRoot: rawPath };
+            if (!seen.has(path)) {
+                seen.add(path);
+                roots.push(path);
+            }
+        }
+        return roots.length > 0 ? { roots } : {};
+    }
+    async persistPendingSessionWorkspace(sessionId) {
+        const workspace = this.pendingSessionWorkspaces.get(sessionId);
+        const session = this.sessionManager.get(sessionId);
+        if (!workspace || !session?.claudeSessionId || !this.workspaceStore)
+            return;
+        try {
+            await this.workspaceStore.assignSession(session.provider, session.claudeSessionId, workspace);
+            this.pendingSessionWorkspaces.delete(sessionId);
+        }
+        catch (error) {
+            console.error("[workspace] Failed to persist session assignment:", error);
+        }
+    }
+    workspaceForRuntimeSession(session) {
+        const pending = this.pendingSessionWorkspaces.get(session.id);
+        if (pending) {
+            return { ...pending, rootPaths: [...pending.rootPaths] };
+        }
+        if (!session.claudeSessionId || !this.workspaceStore)
+            return undefined;
+        const assignment = this.workspaceStore.getAssignment(session.provider, session.claudeSessionId);
+        if (!assignment)
+            return undefined;
+        const project = assignment.projectId
+            ? this.workspaceStore.getProject(assignment.projectId)
+            : undefined;
+        const projectName = project?.name ?? assignment.projectName;
+        return {
+            kind: assignment.kind,
+            ...(assignment.projectId ? { projectId: assignment.projectId } : {}),
+            ...(projectName ? { projectName } : {}),
+            rootPaths: [...assignment.rootPaths],
+        };
+    }
+    attachWorkspaceToRuntimeSession(sessionId, workspace) {
+        if (!workspace)
+            return;
+        this.pendingSessionWorkspaces.set(sessionId, workspace);
+        void this.persistPendingSessionWorkspace(sessionId);
+    }
+    projectsMessage(requestId) {
+        return {
+            type: "projects",
+            projects: this.workspaceStore?.listProjects() ?? [],
+            ...(requestId ? { requestId } : {}),
+        };
+    }
+    sendWorkspaceMutationError(ws, requestId, action, error) {
+        this.send(ws, {
+            type: "error",
+            requestId,
+            errorCode: "workspace_write_failed",
+            message: `Failed to ${action}: ${error instanceof Error ? error.message : String(error)}`,
+        });
+    }
+    legacyProjectHistoryProjects() {
+        return this.projectHistory?.getProjects() ?? [];
+    }
     listRecentSessionsCoalesced(msg) {
         const key = JSON.stringify({
             limit: msg.limit ?? null,
             offset: msg.offset ?? null,
             projectPath: msg.projectPath ?? null,
+            projectId: msg.projectId ?? null,
+            workspaceKind: msg.workspaceKind ?? null,
             provider: msg.provider ?? null,
             namedOnly: msg.namedOnly ?? null,
             searchQuery: msg.searchQuery ?? null,
@@ -6810,11 +7301,14 @@ export class BridgeWebSocketServer {
             throw err;
         }
     }
-    /** Extract a short project label from the full projectPath (last directory name). */
+    /** Resolve a user-facing Project label, falling back to the cwd basename. */
     projectLabel(sessionId) {
         const session = this.sessionManager.get(sessionId);
         if (!session?.projectPath)
             return "";
+        const workspace = this.workspaceForRuntimeSession(session);
+        if (workspace?.projectName)
+            return workspace.projectName;
         const parts = session.projectPath.replace(/\/+$/, "").split("/");
         return parts[parts.length - 1] || "";
     }