jupyterlab_claude_code_extension 1.0.29 → 1.0.34

package/lib/index.js

@@ -31,9 +31,10 @@ const plugin = {
             try {
                 const settings = await settingRegistry.load(PLUGIN_ID);
                 const apply = () => {
-                    const resolve = settings.get('resolveSessionNames')
-                        .composite;
-                    widget.setResolveSessionNames(resolve !== false);
+                    const mode = settings.get('presentationMode').composite;
+                    if (mode === 'session' || mode === 'folder' || mode === 'path') {
+                        widget.setPresentationMode(mode);
+                    }
                     const limit = settings.get('recentLimit').composite;
                     if (typeof limit === 'number') {
                         widget.setRecentLimit(limit);

package/lib/widget.d.ts

@@ -2,11 +2,12 @@ import { JupyterFrontEnd } from '@jupyterlab/application';
 import { ITerminalTracker } from '@jupyterlab/terminal';
 import { Widget } from '@lumino/widgets';
 import { Message } from '@lumino/messaging';
+export type PresentationMode = 'session' | 'folder' | 'path';
 export declare class ClaudeCodeSessionsWidget extends Widget {
     constructor(app: JupyterFrontEnd, rootDir: string, terminalTracker?: ITerminalTracker | null);
     refresh(): void;
-    /** Toggle whether explicit ``/rename`` names are honoured. */
-    setResolveSessionNames(on: boolean): void;
+    /** Choose how rows are labelled: by session name, folder name, or path. */
+    setPresentationMode(mode: PresentationMode): void;
     /** Set how many rows the Recent section displays. */
     setRecentLimit(n: number): void;
     /** Toggle the --dangerously-skip-permissions flag on launched sessions. */
@@ -40,7 +41,8 @@ export declare class ClaudeCodeSessionsWidget extends Widget {
     private _findTerminalForCwd;
     private _showCloseExistingDialog;
     private _wireTerminalDisposal;
-    /** Apply the resolve-names setting + path-segment disambiguation. */
+    /** Apply the presentation-mode setting (path-segment disambiguation is
+     * handled separately in ``_disambiguate``). */
     private _displayName;
     private _basename;
     /** Walk path tails until every name in a colliding group is unique. */
@@ -74,7 +76,7 @@ export declare class ClaudeCodeSessionsWidget extends Widget {
     private readonly _terminalsByPath;
     private readonly _pendingByPath;
     private readonly _rootDir;
-    private _resolveNames;
+    private _presentationMode;
     private _recentLimit;
     private _dangerouslySkip;
     private _displayNames;

package/lib/widget.js

@@ -6,6 +6,7 @@ import { claudeIcon, refreshIcon, removeIcon, shieldIcon, starFilledIcon } from
 const POLL_INTERVAL_MS = 10000;
 const DEFAULT_RECENT_LIMIT = 10;
 const EXPANDED_STORAGE_KEY = 'jupyterlab_claude_code_extension:expanded';
+const DEFAULT_PRESENTATION_MODE = 'session';
 const SECTION_LABELS = {
     favourites: 'Favourites',
     recent: 'Recent',
@@ -65,7 +66,7 @@ export class ClaudeCodeSessionsWidget extends Widget {
         this._removingPaths = new Set();
         this._terminalsByPath = new Map();
         this._pendingByPath = new Map();
-        this._resolveNames = true;
+        this._presentationMode = DEFAULT_PRESENTATION_MODE;
         this._recentLimit = DEFAULT_RECENT_LIMIT;
         this._dangerouslySkip = false;
         this._displayNames = new Map();
@@ -88,12 +89,12 @@ export class ClaudeCodeSessionsWidget extends Widget {
             .catch(err => this._showError(err))
             .finally(() => this._setRefreshSpinning(false));
     }
-    /** Toggle whether explicit ``/rename`` names are honoured. */
-    setResolveSessionNames(on) {
-        if (this._resolveNames === on) {
+    /** Choose how rows are labelled: by session name, folder name, or path. */
+    setPresentationMode(mode) {
+        if (this._presentationMode === mode) {
             return;
         }
-        this._resolveNames = on;
+        this._presentationMode = mode;
         this._render();
     }
     /** Set how many rows the Recent section displays. */
@@ -417,12 +418,19 @@ export class ClaudeCodeSessionsWidget extends Widget {
         });
     }
     // -------------------------------------------------------------- rendering
-    /** Apply the resolve-names setting + path-segment disambiguation. */
+    /** Apply the presentation-mode setting (path-segment disambiguation is
+     * handled separately in ``_disambiguate``). */
     _displayName(s) {
-        if (!this._resolveNames) {
-            return this._basename(s.project_path) || s.encoded_path;
+        const folder = this._basename(s.project_path) || s.encoded_path;
+        switch (this._presentationMode) {
+            case 'folder':
+                return folder;
+            case 'path':
+                return this._displayPath(s.project_path) || folder;
+            case 'session':
+            default:
+                return s.name || folder;
         }
-        return s.name || this._basename(s.project_path) || s.encoded_path;
     }
     _basename(p) {
         if (!p) {
@@ -546,14 +554,14 @@ export class ClaudeCodeSessionsWidget extends Widget {
             }
             else {
                 for (const item of items) {
-                    list.appendChild(this._renderRow(item));
+                    list.appendChild(this._renderRow(item, key));
                 }
             }
             section.appendChild(list);
         }
         this._bodyEl.appendChild(section);
     }
-    _renderRow(session) {
+    _renderRow(session, sectionKey) {
         const row = document.createElement('div');
         row.className = 'jp-ClaudeSessionsPanel-row';
         row.title = this._buildRowTooltip(session);
@@ -582,7 +590,9 @@ export class ClaudeCodeSessionsWidget extends Widget {
         name.className = 'jp-ClaudeSessionsPanel-name';
         name.textContent = this._lookupName(session);
         row.appendChild(name);
-        if (session.favourite) {
+        // No star in the Favourites section - every row there is a favourite
+        // by definition; stars are an indicator only useful in Recent/All.
+        if (session.favourite && sectionKey !== 'favourites') {
             const star = document.createElement('span');
             star.className = 'jp-ClaudeSessionsPanel-favStar';
             star.title = 'Favourite';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "jupyterlab_claude_code_extension",
-    "version": "1.0.29",
+    "version": "1.0.34",
     "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/index.ts

@@ -9,7 +9,7 @@ import { ITerminalTracker } from '@jupyterlab/terminal';
 
 import { requestAPI } from './request';
 import { IStatusResponse } from './types';
-import { ClaudeCodeSessionsWidget } from './widget';
+import { ClaudeCodeSessionsWidget, PresentationMode } from './widget';
 
 const PLUGIN_ID = 'jupyterlab_claude_code_extension:plugin';
 const WIDGET_ID = 'jupyterlab-claude-code-extension';
@@ -59,9 +59,10 @@ const plugin: JupyterFrontEndPlugin<void> = {
       try {
         const settings = await settingRegistry.load(PLUGIN_ID);
         const apply = (): void => {
-          const resolve = settings.get('resolveSessionNames')
-            .composite as boolean;
-          widget.setResolveSessionNames(resolve !== false);
+          const mode = settings.get('presentationMode').composite as string;
+          if (mode === 'session' || mode === 'folder' || mode === 'path') {
+            widget.setPresentationMode(mode as PresentationMode);
+          }
           const limit = settings.get('recentLimit').composite as number;
           if (typeof limit === 'number') {
             widget.setRecentLimit(limit);

package/src/widget.ts

@@ -28,6 +28,10 @@ const EXPANDED_STORAGE_KEY = 'jupyterlab_claude_code_extension:expanded';
 
 type SectionKey = 'favourites' | 'recent' | 'all';
 
+export type PresentationMode = 'session' | 'folder' | 'path';
+
+const DEFAULT_PRESENTATION_MODE: PresentationMode = 'session';
+
 const SECTION_LABELS: Record<SectionKey, string> = {
   favourites: 'Favourites',
   recent: 'Recent',
@@ -113,12 +117,12 @@ export class ClaudeCodeSessionsWidget extends Widget {
       .finally(() => this._setRefreshSpinning(false));
   }
 
-  /** Toggle whether explicit ``/rename`` names are honoured. */
-  setResolveSessionNames(on: boolean): void {
-    if (this._resolveNames === on) {
+  /** Choose how rows are labelled: by session name, folder name, or path. */
+  setPresentationMode(mode: PresentationMode): void {
+    if (this._presentationMode === mode) {
       return;
     }
-    this._resolveNames = on;
+    this._presentationMode = mode;
     this._render();
   }
 
@@ -501,12 +505,19 @@ export class ClaudeCodeSessionsWidget extends Widget {
 
   // -------------------------------------------------------------- rendering
 
-  /** Apply the resolve-names setting + path-segment disambiguation. */
+  /** Apply the presentation-mode setting (path-segment disambiguation is
+   * handled separately in ``_disambiguate``). */
   private _displayName(s: ISession): string {
-    if (!this._resolveNames) {
-      return this._basename(s.project_path) || s.encoded_path;
+    const folder = this._basename(s.project_path) || s.encoded_path;
+    switch (this._presentationMode) {
+      case 'folder':
+        return folder;
+      case 'path':
+        return this._displayPath(s.project_path) || folder;
+      case 'session':
+      default:
+        return s.name || folder;
     }
-    return s.name || this._basename(s.project_path) || s.encoded_path;
   }
 
   private _basename(p: string): string {
@@ -649,7 +660,7 @@ export class ClaudeCodeSessionsWidget extends Widget {
         list.appendChild(empty);
       } else {
         for (const item of items) {
-          list.appendChild(this._renderRow(item));
+          list.appendChild(this._renderRow(item, key));
         }
       }
       section.appendChild(list);
@@ -658,7 +669,7 @@ export class ClaudeCodeSessionsWidget extends Widget {
     this._bodyEl.appendChild(section);
   }
 
-  private _renderRow(session: ISession): HTMLDivElement {
+  private _renderRow(session: ISession, sectionKey: SectionKey): HTMLDivElement {
     const row = document.createElement('div');
     row.className = 'jp-ClaudeSessionsPanel-row';
     row.title = this._buildRowTooltip(session);
@@ -689,7 +700,9 @@ export class ClaudeCodeSessionsWidget extends Widget {
     name.textContent = this._lookupName(session);
     row.appendChild(name);
 
-    if (session.favourite) {
+    // No star in the Favourites section - every row there is a favourite
+    // by definition; stars are an indicator only useful in Recent/All.
+    if (session.favourite && sectionKey !== 'favourites') {
       const star = document.createElement('span');
       star.className = 'jp-ClaudeSessionsPanel-favStar';
       star.title = 'Favourite';
@@ -904,7 +917,7 @@ export class ClaudeCodeSessionsWidget extends Widget {
   private readonly _terminalsByPath: Map<string, any> = new Map();
   private readonly _pendingByPath: Map<string, Promise<void>> = new Map();
   private readonly _rootDir: string;
-  private _resolveNames: boolean = true;
+  private _presentationMode: PresentationMode = DEFAULT_PRESENTATION_MODE;
   private _recentLimit: number = DEFAULT_RECENT_LIMIT;
   private _dangerouslySkip: boolean = false;
   private _displayNames: Map<string, string> = new Map();