jupyterlab_claude_code_extension 1.0.56 → 1.0.58

package/README.md

@@ -18,6 +18,7 @@ Browse, resume, and manage your Claude Code sessions from a JupyterLab side pane
 - **Live indicator** - a green dot marks sessions that are currently running somewhere
 - **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
 - **Hover tooltip** with project path, last activity, message count, branch, and session id

package/lib/widget.d.ts

@@ -38,6 +38,15 @@ export declare class ClaudeCodeSessionsWidget extends Widget {
     private _remove;
     private _resumeInTerminal;
     private _doResumeInTerminal;
+    /**
+     * Bring a terminal tab to the front AND hand it keyboard focus, so the
+     * user can start typing without an extra click. `activateById` only
+     * reveals the tab; the xterm inside doesn't always grab DOM focus,
+     * especially when the click originated in this sidebar. We defer the
+     * `term.focus()` to the next frame so the widget is attached and visible
+     * first.
+     */
+    private _focusTerminal;
     private _findTerminalForCwd;
     private _showCloseExistingDialog;
     /** Show a modal with a spinner while the terminal is being launched. The

package/lib/widget.js

@@ -3,7 +3,7 @@ import { CommandRegistry } from '@lumino/commands';
 import { Menu, Widget } from '@lumino/widgets';
 import { requestAPI } from './request';
 import { claudeIcon, refreshIcon, removeIcon, shieldIcon, starFilledIcon } from './icons';
-const POLL_INTERVAL_MS = 10000;
+const POLL_INTERVAL_MS = 30000;
 const DEFAULT_RECENT_LIMIT = 10;
 const EXPANDED_STORAGE_KEY = 'jupyterlab_claude_code_extension:expanded';
 const DEFAULT_PRESENTATION_MODE = 'session';
@@ -85,9 +85,14 @@ export class ClaudeCodeSessionsWidget extends Widget {
     refresh() {
         this._showLoading();
         this._setRefreshSpinning(true);
-        this._fetch()
-            .catch(err => this._showError(err))
-            .finally(() => this._setRefreshSpinning(false));
+        // `_fetch` is filesystem-fast, so without a floor the refresh icon would
+        // spin for a single frame and read as "nothing happened". Hold the
+        // spinner for at least ~500 ms so the click visibly registers.
+        const minSpin = new Promise(resolve => window.setTimeout(resolve, 500));
+        Promise.all([
+            this._fetch().catch(err => this._showError(err)),
+            minSpin
+        ]).finally(() => this._setRefreshSpinning(false));
     }
     /** Choose how rows are labelled: by session name, folder name, or path. */
     setPresentationMode(mode) {
@@ -244,7 +249,10 @@ export class ClaudeCodeSessionsWidget extends Widget {
     // ------------------------------------------------------------------ data
     async _fetch() {
         var _a;
-        const data = await requestAPI('sessions', this._serverSettings);
+        // `cache: 'no-store'` so the manual refresh button (and the post-launch
+        // refresh) always re-read the server's view of ~/.claude rather than a
+        // possibly-stale browser-cached response.
+        const data = await requestAPI('sessions', this._serverSettings, { cache: 'no-store' });
         this._sessions = (_a = data.sessions) !== null && _a !== void 0 ? _a : [];
         this._render();
     }
@@ -315,10 +323,8 @@ export class ClaudeCodeSessionsWidget extends Widget {
             if (cached && !cached.isDisposed) {
                 if (forceDangerous) {
                     await this._showCloseExistingDialog();
-                    this._app.shell.activateById(cached.id);
-                    return;
                 }
-                this._app.shell.activateById(cached.id);
+                this._focusTerminal(cached);
                 return;
             }
             // 2. Walk every live terminal widget JL knows about.
@@ -328,10 +334,8 @@ export class ClaudeCodeSessionsWidget extends Widget {
                 this._wireTerminalDisposal(session.project_path, found);
                 if (forceDangerous) {
                     await this._showCloseExistingDialog();
-                    this._app.shell.activateById(found.id);
-                    return;
                 }
-                this._app.shell.activateById(found.id);
+                this._focusTerminal(found);
                 return;
             }
             // 3. No matching terminal - spawn a new one with `claude --resume <id>`
@@ -357,6 +361,7 @@ export class ClaudeCodeSessionsWidget extends Widget {
                 if (widget === null || widget === void 0 ? void 0 : widget.id) {
                     this._terminalsByPath.set(session.project_path, widget);
                     this._wireTerminalDisposal(session.project_path, widget);
+                    this._focusTerminal(widget);
                 }
             }
             finally {
@@ -366,6 +371,36 @@ export class ClaudeCodeSessionsWidget extends Widget {
         catch (err) {
             this._showError(err);
         }
+        finally {
+            // Reuse or fresh launch, either way the picture changed (a session may
+            // now be remote-controlled, a row may have appeared). Pull fresh state.
+            void this._fetch().catch(() => {
+                /* a poll tick will retry; nothing actionable here */
+            });
+        }
+    }
+    /**
+     * Bring a terminal tab to the front AND hand it keyboard focus, so the
+     * user can start typing without an extra click. `activateById` only
+     * reveals the tab; the xterm inside doesn't always grab DOM focus,
+     * especially when the click originated in this sidebar. We defer the
+     * `term.focus()` to the next frame so the widget is attached and visible
+     * first.
+     */
+    _focusTerminal(widget) {
+        if (!widget || widget.isDisposed) {
+            return;
+        }
+        this._app.shell.activateById(widget.id);
+        requestAnimationFrame(() => {
+            var _a, _b, _c;
+            try {
+                (_c = (_b = (_a = widget.content) === null || _a === void 0 ? void 0 : _a.term) === null || _b === void 0 ? void 0 : _b.focus) === null || _c === void 0 ? void 0 : _c.call(_b);
+            }
+            catch (_err) {
+                /* terminal may have been disposed in the meantime - ignore */
+            }
+        });
     }
     async _findTerminalForCwd(projectPath) {
         var _a, _b;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "jupyterlab_claude_code_extension",
-    "version": "1.0.56",
+    "version": "1.0.58",
     "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/widget.ts

@@ -22,7 +22,7 @@ import {
   ISessionsListResponse
 } from './types';
 
-const POLL_INTERVAL_MS = 10_000;
+const POLL_INTERVAL_MS = 30_000;
 const DEFAULT_RECENT_LIMIT = 10;
 const EXPANDED_STORAGE_KEY = 'jupyterlab_claude_code_extension:expanded';
 
@@ -113,9 +113,16 @@ export class ClaudeCodeSessionsWidget extends Widget {
   refresh(): void {
     this._showLoading();
     this._setRefreshSpinning(true);
-    this._fetch()
-      .catch(err => this._showError(err))
-      .finally(() => this._setRefreshSpinning(false));
+    // `_fetch` is filesystem-fast, so without a floor the refresh icon would
+    // spin for a single frame and read as "nothing happened". Hold the
+    // spinner for at least ~500 ms so the click visibly registers.
+    const minSpin = new Promise<void>(resolve =>
+      window.setTimeout(resolve, 500)
+    );
+    Promise.all([
+      this._fetch().catch(err => this._showError(err)),
+      minSpin
+    ]).finally(() => this._setRefreshSpinning(false));
   }
 
   /** Choose how rows are labelled: by session name, folder name, or path. */
@@ -296,9 +303,13 @@ export class ClaudeCodeSessionsWidget extends Widget {
   // ------------------------------------------------------------------ data
 
   private async _fetch(): Promise<void> {
+    // `cache: 'no-store'` so the manual refresh button (and the post-launch
+    // refresh) always re-read the server's view of ~/.claude rather than a
+    // possibly-stale browser-cached response.
     const data = await requestAPI<ISessionsListResponse>(
       'sessions',
-      this._serverSettings
+      this._serverSettings,
+      { cache: 'no-store' }
     );
     this._sessions = data.sessions ?? [];
     this._render();
@@ -390,10 +401,8 @@ export class ClaudeCodeSessionsWidget extends Widget {
       if (cached && !cached.isDisposed) {
         if (forceDangerous) {
           await this._showCloseExistingDialog();
-          this._app.shell.activateById(cached.id);
-          return;
         }
-        this._app.shell.activateById(cached.id);
+        this._focusTerminal(cached);
         return;
       }
 
@@ -404,10 +413,8 @@ export class ClaudeCodeSessionsWidget extends Widget {
         this._wireTerminalDisposal(session.project_path, found);
         if (forceDangerous) {
           await this._showCloseExistingDialog();
-          this._app.shell.activateById(found.id);
-          return;
         }
-        this._app.shell.activateById(found.id);
+        this._focusTerminal(found);
         return;
       }
 
@@ -441,13 +448,42 @@ export class ClaudeCodeSessionsWidget extends Widget {
         if (widget?.id) {
           this._terminalsByPath.set(session.project_path, widget);
           this._wireTerminalDisposal(session.project_path, widget);
+          this._focusTerminal(widget);
         }
       } finally {
         spinner.resolve();
       }
     } catch (err) {
       this._showError(err);
+    } finally {
+      // Reuse or fresh launch, either way the picture changed (a session may
+      // now be remote-controlled, a row may have appeared). Pull fresh state.
+      void this._fetch().catch(() => {
+        /* a poll tick will retry; nothing actionable here */
+      });
+    }
+  }
+
+  /**
+   * Bring a terminal tab to the front AND hand it keyboard focus, so the
+   * user can start typing without an extra click. `activateById` only
+   * reveals the tab; the xterm inside doesn't always grab DOM focus,
+   * especially when the click originated in this sidebar. We defer the
+   * `term.focus()` to the next frame so the widget is attached and visible
+   * first.
+   */
+  private _focusTerminal(widget: any): void {
+    if (!widget || widget.isDisposed) {
+      return;
     }
+    this._app.shell.activateById(widget.id);
+    requestAnimationFrame(() => {
+      try {
+        widget.content?.term?.focus?.();
+      } catch (_err) {
+        /* terminal may have been disposed in the meantime - ignore */
+      }
+    });
   }
 
   private async _findTerminalForCwd(projectPath: string): Promise<any | null> {