jupyterlab_claude_code_extension 1.1.21 → 1.1.25

package/README.md

@@ -19,8 +19,9 @@ Browse, resume, and manage your Claude Code sessions from a JupyterLab side pane
 - **One-click resume** - click a row to jump back into that session in a terminal. If a terminal for the project is already open, it's reused instead of duplicated
 - **Favorites** - star projects you keep coming back to via the right-click menu
 - **Remove** - drop a project's Claude history from the panel via the right-click menu; the history folder is moved to the trash (it honours JupyterLab's "move files to trash" setting), not deleted permanently
-- **Search** - fuzzy filter at the top of the panel
-- **Presentation modes** - label rows by session name, folder name, or path relative to the JupyterLab root
+- **Clean up parallel sessions** - when a project has accumulated extra sessions beyond the main one, a right-click menu item (showing the count in brackets) removes them all, keeping only the main session; removed files honour the same trash setting
+- **Search** - fuzzy filter toggled by the funnel button next to refresh
+- **Presentation modes** - label rows by session name (so a `/rename` shows through), folder name, or path relative to the JupyterLab root
 - **Hover tooltip** with project path, last activity, message count, branch, and session id
 - **Auto-disabled** when the Claude Code CLI is not installed
 

package/lib/types.d.ts

@@ -13,6 +13,7 @@ export interface ISession {
     git_branch: string | null;
     remote_control: boolean;
     favourite: boolean;
+    extra_sessions: number;
 }
 export interface ISessionsListResponse {
     sessions: ISession[];
@@ -35,6 +36,12 @@ export interface IRemoveRequest {
 export interface IRemoveResponse {
     removed: string;
 }
+export interface ICleanupRequest {
+    encoded_path: string;
+}
+export interface ICleanupResponse {
+    removed_count: number;
+}
 export interface ILaunchTerminalRequest {
     project_path: string;
     session_id: string;

package/lib/widget.d.ts

@@ -41,6 +41,7 @@ export declare class ClaudeCodeSessionsWidget extends Widget {
     private _fetch;
     private _toggleFavourite;
     private _remove;
+    private _cleanupParallel;
     private _resumeInTerminal;
     private _doResumeInTerminal;
     /**

package/lib/widget.js

@@ -334,6 +334,54 @@ export class ClaudeCodeSessionsWidget extends Widget {
             this._render();
         }
     }
+    async _cleanupParallel(session) {
+        const body = new Widget();
+        body.node.className = 'jp-ClaudeSessionsPanel-cleanupBody';
+        const message = document.createElement('div');
+        message.className = 'jp-ClaudeSessionsPanel-cleanupMessage';
+        const count = session.extra_sessions;
+        message.textContent = `Removing ${count} parallel session${count === 1 ? '' : 's'}...`;
+        body.node.appendChild(message);
+        // No `value` attribute -> indeterminate (animated) while the request is
+        // in flight; set to max on completion so the bar reads as finished.
+        const bar = document.createElement('progress');
+        bar.className = 'jp-ClaudeSessionsPanel-cleanupProgress';
+        bar.max = 1;
+        body.node.appendChild(bar);
+        const dialog = new Dialog({
+            title: 'Clean Up Parallel Sessions',
+            body,
+            buttons: [Dialog.okButton({ label: 'Close' })]
+        });
+        // Hide the Close button while work is in progress; restore it once the
+        // outcome (success or error) is shown so the user dismisses the popup.
+        const footer = dialog.node.querySelector('.jp-Dialog-footer');
+        if (footer) {
+            footer.style.display = 'none';
+        }
+        void dialog.launch();
+        try {
+            const data = await requestAPI('sessions/cleanup', this._serverSettings, {
+                method: 'POST',
+                body: JSON.stringify({ encoded_path: session.encoded_path })
+            });
+            bar.value = 1;
+            message.textContent = `Removed ${data.removed_count} parallel session${data.removed_count === 1 ? '' : 's'}.`;
+            // Refresh so the row's extra_sessions count (and menu label) update
+            await this._fetch();
+        }
+        catch (err) {
+            bar.remove();
+            message.classList.add('jp-ClaudeSessionsPanel-cleanupError');
+            message.textContent = `Cleanup failed: ${err instanceof Error ? err.message : String(err)}`;
+            this._showError(err);
+        }
+        finally {
+            if (footer) {
+                footer.style.display = '';
+            }
+        }
+    }
     // -------------------------------------------------------------- terminal
     async _resumeInTerminal(session, forceDangerous = false) {
         // Coalesce concurrent clicks on the same row - subsequent clicks attach
@@ -897,6 +945,15 @@ export class ClaudeCodeSessionsWidget extends Widget {
                 Clipboard.copyToSystem(path);
             }
         });
+        this._commands.addCommand('claude-code-sessions:cleanup-parallel', {
+            label: () => { var _a, _b; return `Clean Up Parallel Sessions (${(_b = (_a = this._activeSession) === null || _a === void 0 ? void 0 : _a.extra_sessions) !== null && _b !== void 0 ? _b : 0})`; },
+            isVisible: () => { var _a, _b; return ((_b = (_a = this._activeSession) === null || _a === void 0 ? void 0 : _a.extra_sessions) !== null && _b !== void 0 ? _b : 0) > 0; },
+            execute: () => {
+                if (this._activeSession) {
+                    void this._cleanupParallel(this._activeSession);
+                }
+            }
+        });
         this._commands.addCommand('claude-code-sessions:remove', {
             label: 'Remove from Claude',
             icon: removeIcon,
@@ -923,6 +980,9 @@ export class ClaudeCodeSessionsWidget extends Widget {
         });
         this._contextMenu.addItem({ command: 'claude-code-sessions:copy-path' });
         this._contextMenu.addItem({ type: 'separator' });
+        this._contextMenu.addItem({
+            command: 'claude-code-sessions:cleanup-parallel'
+        });
         this._contextMenu.addItem({ command: 'claude-code-sessions:remove' });
         this._contextMenu.aboutToClose.connect(() => {
             // Only clear the visual highlight - DO NOT null _activeSession.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "jupyterlab_claude_code_extension",
-    "version": "1.1.21",
+    "version": "1.1.25",
     "description": "Browse, resume, and manage your Claude Code CLI sessions from a JupyterLab side panel. One click reactivates the right terminal - no duplicate tabs, live remote-control indicator, and favourites for the projects you keep coming back to.",
     "keywords": [
         "jupyter",

package/src/__tests__/jupyterlab_claude_code_extension.spec.ts

@@ -22,6 +22,7 @@ const session = (over: Partial<ISession> = {}): ISession => ({
   git_branch: null,
   remote_control: false,
   favourite: false,
+  extra_sessions: 0,
   ...over
 });
 
@@ -83,6 +84,44 @@ describe('launch spinner dismiss contract', () => {
     'utf-8'
   );
 
+  /**
+   * Contract for the cleanup-parallel popup: the dialog opens with the
+   * Close button hidden while the POST is in flight (footer display
+   * 'none'), shows an indeterminate <progress> bar, then on completion
+   * fills the bar and reports success - or drops the bar and shows the
+   * error - and restores the footer so the user can dismiss.
+   */
+  describe('cleanup popup contract', () => {
+    const cleanup = (widgetSrc.match(
+      /private async _cleanupParallel[\s\S]*?\n  \}/
+    ) ?? [''])[0];
+
+    it('creates a progress element in the dialog body', () => {
+      expect(cleanup).toMatch(/createElement\('progress'\)/);
+    });
+
+    it('hides the footer during the request and restores it in finally', () => {
+      expect(cleanup).toMatch(/footer\.style\.display = 'none'/);
+      expect(cleanup).toMatch(/finally[\s\S]*?footer\.style\.display = ''/);
+    });
+
+    it('fills the bar and reports the removed count on success', () => {
+      expect(cleanup).toMatch(/bar\.value = 1/);
+      expect(cleanup).toMatch(/Removed \$\{data\.removed_count\}/);
+    });
+
+    it('shows an error message styled with the error class on failure', () => {
+      expect(cleanup).toMatch(/catch[\s\S]*?bar\.remove\(\)/);
+      expect(cleanup).toMatch(/jp-ClaudeSessionsPanel-cleanupError/);
+      expect(cleanup).toMatch(/Cleanup failed: /);
+    });
+
+    it('refreshes the session list after a successful cleanup', () => {
+      const successBlock = (cleanup.match(/try[\s\S]*?catch/) ?? [''])[0];
+      expect(successBlock).toMatch(/await this\._fetch\(\)/);
+    });
+  });
+
   it('_doResumeInTerminal dismisses spinner via dispose(), not resolve()', () => {
     expect(widgetSrc).toMatch(/spinner\.dispose\(\)/);
     expect(widgetSrc).not.toMatch(/spinner\.resolve\(\)/);

package/src/types.ts

@@ -13,6 +13,7 @@ export interface ISession {
   git_branch: string | null;
   remote_control: boolean;
   favourite: boolean;
+  extra_sessions: number;
 }
 
 export interface ISessionsListResponse {
@@ -42,6 +43,14 @@ export interface IRemoveResponse {
   removed: string;
 }
 
+export interface ICleanupRequest {
+  encoded_path: string;
+}
+
+export interface ICleanupResponse {
+  removed_count: number;
+}
+
 export interface ILaunchTerminalRequest {
   project_path: string;
   session_id: string;

package/src/widget.ts

@@ -24,6 +24,7 @@ import {
 import {
   IFavouriteResponse,
   ILaunchTerminalResponse,
+  ICleanupResponse,
   IRemoveResponse,
   ISession,
   ISessionsListResponse
@@ -406,6 +407,69 @@ export class ClaudeCodeSessionsWidget extends Widget {
     }
   }
 
+  private async _cleanupParallel(session: ISession): Promise<void> {
+    const body = new Widget();
+    body.node.className = 'jp-ClaudeSessionsPanel-cleanupBody';
+
+    const message = document.createElement('div');
+    message.className = 'jp-ClaudeSessionsPanel-cleanupMessage';
+    const count = session.extra_sessions;
+    message.textContent = `Removing ${count} parallel session${
+      count === 1 ? '' : 's'
+    }...`;
+    body.node.appendChild(message);
+
+    // No `value` attribute -> indeterminate (animated) while the request is
+    // in flight; set to max on completion so the bar reads as finished.
+    const bar = document.createElement('progress');
+    bar.className = 'jp-ClaudeSessionsPanel-cleanupProgress';
+    bar.max = 1;
+    body.node.appendChild(bar);
+
+    const dialog = new Dialog<unknown>({
+      title: 'Clean Up Parallel Sessions',
+      body,
+      buttons: [Dialog.okButton({ label: 'Close' })]
+    });
+    // Hide the Close button while work is in progress; restore it once the
+    // outcome (success or error) is shown so the user dismisses the popup.
+    const footer = dialog.node.querySelector(
+      '.jp-Dialog-footer'
+    ) as HTMLElement | null;
+    if (footer) {
+      footer.style.display = 'none';
+    }
+    void dialog.launch();
+
+    try {
+      const data = await requestAPI<ICleanupResponse>(
+        'sessions/cleanup',
+        this._serverSettings,
+        {
+          method: 'POST',
+          body: JSON.stringify({ encoded_path: session.encoded_path })
+        }
+      );
+      bar.value = 1;
+      message.textContent = `Removed ${data.removed_count} parallel session${
+        data.removed_count === 1 ? '' : 's'
+      }.`;
+      // Refresh so the row's extra_sessions count (and menu label) update
+      await this._fetch();
+    } catch (err) {
+      bar.remove();
+      message.classList.add('jp-ClaudeSessionsPanel-cleanupError');
+      message.textContent = `Cleanup failed: ${
+        err instanceof Error ? err.message : String(err)
+      }`;
+      this._showError(err);
+    } finally {
+      if (footer) {
+        footer.style.display = '';
+      }
+    }
+  }
+
   // -------------------------------------------------------------- terminal
 
   private async _resumeInTerminal(
@@ -1039,6 +1103,17 @@ export class ClaudeCodeSessionsWidget extends Widget {
       }
     });
 
+    this._commands.addCommand('claude-code-sessions:cleanup-parallel', {
+      label: () =>
+        `Clean Up Parallel Sessions (${this._activeSession?.extra_sessions ?? 0})`,
+      isVisible: () => (this._activeSession?.extra_sessions ?? 0) > 0,
+      execute: () => {
+        if (this._activeSession) {
+          void this._cleanupParallel(this._activeSession);
+        }
+      }
+    });
+
     this._commands.addCommand('claude-code-sessions:remove', {
       label: 'Remove from Claude',
       icon: removeIcon,
@@ -1066,6 +1141,9 @@ export class ClaudeCodeSessionsWidget extends Widget {
     });
     this._contextMenu.addItem({ command: 'claude-code-sessions:copy-path' });
     this._contextMenu.addItem({ type: 'separator' });
+    this._contextMenu.addItem({
+      command: 'claude-code-sessions:cleanup-parallel'
+    });
     this._contextMenu.addItem({ command: 'claude-code-sessions:remove' });
 
     this._contextMenu.aboutToClose.connect(() => {

package/style/base.css

@@ -261,6 +261,24 @@
   border-width: 3px;
 }
 
+.jp-ClaudeSessionsPanel-cleanupBody {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  gap: 12px;
+  padding: 12px 8px;
+  min-width: 280px;
+}
+
+.jp-ClaudeSessionsPanel-cleanupProgress {
+  width: 100%;
+}
+
+.jp-ClaudeSessionsPanel-cleanupError {
+  color: var(--jp-error-color1);
+}
+
 .jp-ClaudeSessionsPanel-row.jp-mod-busy {
   opacity: 0.55;
   pointer-events: none;