jupyterlab_ai_code_assistants_extension 1.2.7 → 1.2.25

package/README.md

@@ -8,7 +8,7 @@
 [![Brought To You By KOLOMOLO](https://img.shields.io/badge/Brought%20To%20You%20By-KOLOMOLO-00ffff?style=flat)](https://kolomolo.com)
 [![Donate PayPal](https://img.shields.io/badge/Donate-PayPal-blue?style=flat)](https://www.paypal.com/donate/?hosted_button_id=B4KPBJDLLXTSA)
 
-A full launcher and manager for every AI code assistant in JupyterLab - Claude Code, Codex, Kimi and Gemini. Start, resume, fork, switch, and clean up CLI sessions from a side panel per assistant - one click lands you in the right terminal with the assistant already running, no duplicate tabs, no UUID hunting. One install replaces the separate `jupyterlab_claude_code_extension`, `jupyterlab_codex_extension` and `jupyterlab_kimi_code_extension` packages and migrates their settings and favourites automatically.
+A full launcher and manager for every AI code assistant in JupyterLab - Claude Code, Codex, Kimi, Gemini and DeepSeek. Start, resume, fork, switch, and clean up CLI sessions from a side panel per assistant - one click lands you in the right terminal with the assistant already running, no duplicate tabs, no UUID hunting. One install replaces the separate `jupyterlab_claude_code_extension`, `jupyterlab_codex_extension` and `jupyterlab_kimi_code_extension` packages and migrates their settings and favourites automatically.
 
 ![Claude Code Sessions panel](.resources/screenshot.png)
 
@@ -25,17 +25,17 @@ Chat-panel extensions re-implement the agent loop and trail the real tool. This
 
 ## Features
 
-- **One install, every assistant** - Claude Code, Codex, Kimi and Gemini from a single package, each with its own right-side panel wearing its official mark
+- **One install, every assistant** - Claude Code, Codex, Kimi, Gemini and DeepSeek from a single package, each with its own right-side panel wearing its official mark
 - **Provider registry** - assistant-specific behaviour lives in one module per assistant behind capability flags; no core file names an assistant, and adding one touches no core file
 - **Joint settings page** - one settings section covering all assistants, with a per-assistant toggle (all on by default); toggling takes effect live, no JupyterLab reload
 - **Three-section side panel** - Favorites, Recent, and All projects, each scrolling independently
-- **One-click resume** - click a row to jump back into that session in a terminal; an open terminal for the project is reused instead of duplicated
+- **One-click resume** - click a row to jump back into that session in a terminal; an open terminal for the project is reused instead of duplicated. Exception: a Codex or Kimi conversation started with `+`, and a Codex fork, run without an id until the CLI writes one, so a click on that row meanwhile opens a second terminal
 - **Launcher tiles** - every enabled assistant has a tile in an "AI Assistants" section of the JupyterLab Launcher (after Other, under the extension's own robot-head icon); a click opens the assistant in the file browser's current folder, resuming the folder's conversation when one exists and starting a new one otherwise, through the companion `jupyterlab_basic_terminal_extension` (installed automatically). Disable an assistant and its tile goes; disable them all and the section goes with them
-- **Your terminal's `claude -c` follows the panel** (Claude) - switching to or launching a conversation makes plain `claude -c` in that project resume that same conversation, including one that has been compacted, which Claude Code otherwise refuses to continue
+- **Your terminal's `claude -c` follows the panel** (Claude) - switching to a conversation makes plain `claude -c` in that project resume that same conversation, including one that has been compacted, which Claude Code otherwise refuses to continue. Launching repairs a compacted conversation the same way, but only switching moves what `claude -c` picks
 - **Conversation switcher** - a right-click "Switch and Manage Sessions" submenu lists a project's other conversations by name and short id with last-activity time; "Manage Sessions..." opens a searchable popup over the full list with multi-select delete and per-row open and copy-id buttons
-- **Branch session** - fork the current conversation into a new named session via the right-click menu; each assistant forks its own way (Claude's native `--fork-session`, Codex's `codex fork`, server-side copies for Kimi and Gemini) behind the same menu item
+- **Branch session** - fork the current conversation into a new named session via the right-click menu; each assistant forks its own way (Claude's native `--fork-session`, Codex's `codex fork`, server-side copies for Kimi, Gemini and DeepSeek) behind the same menu item
 - **Launch modes under each assistant's own name** - Claude's skip-permissions, Codex's approval bypass, Kimi's `--yolo`, Gemini's YOLO; unsafe variants carry a shield glyph in the launch menus
-- **Coloured terminal tabs** - each session's colour tints its terminal tab via the companion `jupyterlab_colourful_tab_extension` (installed automatically). Claude's own `/color` supplies its default, Kimi derives a stable colour from the conversation id; Codex and Gemini have no colour of their own until you set one, and a branched session inherits its parent's colour, which it keeps even if the parent's colour later changes or is reset. Tinting needs the companion release that reports the colours you pick and lets another extension own a tab - against an older one this extension tints no tabs at all and says so once, and the companion's own right-click colours keep working as they always did
+- **Coloured terminal tabs** - each session's colour tints its terminal tab via the companion `jupyterlab_colourful_tab_extension` (installed automatically). Claude's own `/color` supplies its default, Kimi derives a stable colour from the conversation id; Codex, Gemini and DeepSeek have no colour of their own until you set one, and a branched session inherits its parent's colour, which it keeps even if the parent's colour later changes or is reset. Tinting needs the companion release that reports the colours you pick and lets another extension own a tab - against an older one this extension tints no tabs at all and says so once, and the companion's own right-click colours keep working as they always did
 - **Your own tab colour wins** - set a colour on a terminal tab and the extension remembers it for that conversation, overriding whatever the assistant chose. `Reset Tab Colour (n)` in the session's right-click menu hands back every colour you set by hand on that project's conversations, and appears once there is one to hand back. Clearing the colour on the tab itself releases it too, for the conversation that terminal is running; `Reset Tab Colour` is the way back for a conversation with no tab open. A Codex or Kimi conversation that has never been resumed cannot be tracked yet, so a colour set on its tab is not kept
 - **Favorites** - star projects you keep coming back to via the right-click menu; favourites from the standalone extensions are migrated on first run
 - **Remove and clean up** - drop a project's history or a project's extra parallel sessions from the right-click menu, confirmation dialog first; removed files honour JupyterLab's "move files to trash" setting
@@ -44,13 +44,14 @@ Chat-panel extensions re-implement the agent loop and trail the real tool. This
 - **Search** - fuzzy filter per panel, toggled by the funnel button
 - **Presentation modes** - label rows by session name or by path relative to the JupyterLab root
 - **Conflict-safe upgrade** - if a retired standalone extension is still installed, its panel wins and this extension stands down for that assistant instead of showing a duplicate
+- **DeepSeek in the browser** - the DeepSeek Harness has no terminal chat; its panel lists the projects under `~/.dsh/sessions` (or `$DSH_HOME`) and `Open Web UI` starts `dsh --profile web --no-open --port 0` in the project's terminal, which prints the URL to open. The conversation is then chosen in the harness's own browser UI; branching and deleting work from the panel as for every other assistant. The URL is on the machine running JupyterLab, so a remote server needs a port forward to reach it
 - **Auto-disabled when absent** - an assistant whose CLI is not on `PATH` does not show a panel
 
 ## Requirements
 
 - JupyterLab >= 4.0.0
 - Python >= 3.10
-- At least one assistant CLI on `PATH`: `claude`, `codex`, `kimi`, or `gemini`
+- At least one assistant CLI on `PATH`: `claude`, `codex`, `kimi`, `gemini`, or `dsh` (the DeepSeek Harness)
 
 ## Install
 
@@ -60,6 +61,8 @@ Developers must install via the project `Makefile` (which orchestrates clean, bu
 make install
 ```
 
+The companion packages are version floors, so `make install` here pulls their published releases and replaces a locally built `jupyterlab_colourful_tab_extension` or `jupyterlab_basic_terminal_extension`. When verifying a change that spans this extension and a companion, install the companion last.
+
 End-users can install the published package from PyPI:
 
 ```bash

package/lib/core/icons.js

@@ -105,10 +105,13 @@ export const filterIcon = new LabIcon({
 });
 // Row status mark - one filled circle, drawn for a conversation that is live
 // or under remote control. An SVG rather than a rounded span so its colour is
-// a CSS `fill` on the circle itself and the theme decides it, the way every
-// other glyph here is recoloured through its class (DEF-PANE-174).
+// a CSS `fill` on the circle itself, the way every other glyph here is
+// recoloured through its class (DEF-PANE-174). The circle carries no `fill`
+// attribute: the stylesheet is the single source of that colour, and a
+// presentation attribute here would be a second one to keep in step
+// (DEF-PANE-179).
 const statusDotSvgStr = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" width="16" height="16">
-  <circle class="jp-AiAssistantsPanel-dotGlyph" cx="8" cy="8" r="8" fill="#388e3c"/>
+  <circle class="jp-AiAssistantsPanel-dotGlyph" cx="8" cy="8" r="8"/>
 </svg>`;
 export const statusDotIcon = new LabIcon({
     name: `${ICON_PREFIX}:status-dot`,

package/lib/core/labels.d.ts

@@ -0,0 +1,18 @@
+/** The distinguishing part of a conversation id: its first eight characters
+ * past `prefix`, the constant every id of the assistant carries
+ * (`IProviderDescriptor.sessionIdPrefix`). Front-sliced when there is no
+ * prefix, or when the id does not carry it. */
+export declare function shortSessionId(sessionId: string, prefix?: string): string;
+export declare const MENU_TITLE_COLUMNS = 60;
+/** Trim `text` to `maxColumns` display columns, appending an ellipsis when
+ * anything was cut. Iterates by CODE POINT, so an astral character is never
+ * split into a lone surrogate (which chromium paints as the replacement
+ * glyph). Returns `text` unchanged when it already fits. */
+export declare function truncateToColumns(text: string, maxColumns: number): string;
+/** Menu-item label for one branch: the conversation title trimmed to the
+ * column budget, followed by the short session id. Only the TITLE is trimmed -
+ * branches of one project share a path, so the id is what tells them apart and
+ * it must survive. The bracketed id is dropped when the title already IS the
+ * id (the server's last-resort fallback), which can never be truncated since a
+ * short id is at most 8 characters. */
+export declare function branchMenuLabel(label: string, shortId: string): string;

package/lib/core/labels.js

@@ -0,0 +1,68 @@
+// Label derivations of the panel: pure string functions, kept free of
+// JupyterLab imports so the unit tests load them without the panel's DOM.
+/** The distinguishing part of a conversation id: its first eight characters
+ * past `prefix`, the constant every id of the assistant carries
+ * (`IProviderDescriptor.sessionIdPrefix`). Front-sliced when there is no
+ * prefix, or when the id does not carry it. */
+export function shortSessionId(sessionId, prefix) {
+    const start = prefix && sessionId.startsWith(prefix) ? prefix.length : 0;
+    return sessionId.slice(start, start + 8);
+}
+// Lumino sets no `max-width` on `.lm-Menu-itemLabel`, so an uncapped
+// auto-generated conversation title stretches a submenu across the window.
+// Budget is in COLUMNS, not characters. Han, Kana, Hangul and emoji render at
+// roughly one em against Latin's half, so counting characters bounds nothing:
+// 60 Han glyphs measured 851-862px in a real Lumino submenu, at or above the
+// 850px that filed the defect in the first place. An assistant whose titles
+// are model-generated makes a wide-script title the expected case.
+export const MENU_TITLE_COLUMNS = 60;
+// East Asian Wide and Fullwidth ranges, plus emoji. Deliberately coarse: this
+// bounds a menu width, so a handful of mis-classified glyphs cost pixels, not
+// correctness. Anything outside these ranges counts as one column.
+const WIDE_RANGES = [
+    [0x1100, 0x115f], // Hangul Jamo
+    [0x2e80, 0x303e], // CJK radicals, Kangxi, CJK symbols and punctuation
+    [0x3041, 0x33ff], // Hiragana, Katakana, Bopomofo, Hangul Compat, CJK Compat
+    [0x3400, 0x4dbf], // CJK Unified Extension A
+    [0x4e00, 0x9fff], // CJK Unified Ideographs
+    [0xa000, 0xa4cf], // Yi
+    [0xac00, 0xd7a3], // Hangul syllables
+    [0xf900, 0xfaff], // CJK Compatibility Ideographs
+    [0xfe30, 0xfe6f], // CJK Compatibility Forms
+    [0xff00, 0xff60], // Fullwidth forms
+    [0xffe0, 0xffe6], // Fullwidth signs
+    [0x1f300, 0x1faff], // Emoji and pictographs
+    [0x20000, 0x3fffd] // CJK Unified Extensions B and beyond
+];
+function isWide(codePoint) {
+    return WIDE_RANGES.some(([lo, hi]) => codePoint >= lo && codePoint <= hi);
+}
+/** Trim `text` to `maxColumns` display columns, appending an ellipsis when
+ * anything was cut. Iterates by CODE POINT, so an astral character is never
+ * split into a lone surrogate (which chromium paints as the replacement
+ * glyph). Returns `text` unchanged when it already fits. */
+export function truncateToColumns(text, maxColumns) {
+    let columns = 0;
+    let kept = '';
+    for (const ch of text) {
+        const width = isWide(ch.codePointAt(0)) ? 2 : 1;
+        if (columns + width > maxColumns) {
+            // The cut can land just after a space; drop it so the ellipsis hugs the
+            // last word. `trimEnd` is ES2019 and this project targets ES2018.
+            return `${kept.replace(/\s+$/, '')}…`;
+        }
+        columns += width;
+        kept += ch;
+    }
+    return text;
+}
+/** Menu-item label for one branch: the conversation title trimmed to the
+ * column budget, followed by the short session id. Only the TITLE is trimmed -
+ * branches of one project share a path, so the id is what tells them apart and
+ * it must survive. The bracketed id is dropped when the title already IS the
+ * id (the server's last-resort fallback), which can never be truncated since a
+ * short id is at most 8 characters. */
+export function branchMenuLabel(label, shortId) {
+    const title = truncateToColumns(label, MENU_TITLE_COLUMNS);
+    return label === shortId ? title : `${title} (${shortId})`;
+}

package/lib/core/panel.d.ts

@@ -2,6 +2,7 @@ import { JupyterFrontEnd } from '@jupyterlab/application';
 import { IDefaultFileBrowser } from '@jupyterlab/filebrowser';
 import { ITerminalTracker } from '@jupyterlab/terminal';
 import { IColourfulTabs } from 'jupyterlab_colourful_tab_extension';
+import { TranslationBundle } from '@jupyterlab/translation';
 import { Message } from '@lumino/messaging';
 import { Widget } from '@lumino/widgets';
 import { IProviderDescriptor, IProviderHooks } from './types';
@@ -78,6 +79,10 @@ export declare class AssistantSessionsPanel extends Widget {
     private _logError;
     private _fetch;
     private _toggleFavourite;
+    /** The warning a permanent deletion earns and a trashed one does not - a
+     * trashed conversation is recoverable, and the popup one click away says
+     * so; the same sentence on both would be false half the time. */
+    private get _irreversibleNote();
     private get _disposalVerb();
     private _removeProject;
     private _cleanupParallel;
@@ -211,8 +216,7 @@ export declare class AssistantSessionsPanel extends Widget {
      * cannot give. */
     private _formatAbsoluteTime;
     /** Branch entry display: conversation name plus short session id. Branches
-     * share a project path, so the name and id are all that tell them apart. The
-     * suffix is dropped when the label already IS the short id. */
+     * share a project path, so the name and id are all that tell them apart. */
     private _branchDisplayName;
     /** Menu-item label for a branch: display name, relative time, and a trailing
      * marker when a live worker owns the conversation. The marker lives in the
@@ -303,6 +307,7 @@ export declare class AssistantSessionsPanel extends Widget {
     private _stopPolling;
     private readonly _app;
     private readonly _descriptor;
+    private readonly _trans;
     private readonly _hooks;
     private readonly _serverSettings;
     private _rootDir;
@@ -366,5 +371,9 @@ export declare namespace AssistantSessionsPanel {
         terminalTracker?: ITerminalTracker | null;
         fileBrowser?: IDefaultFileBrowser | null;
         colourfulTabs?: IColourfulTabs | null;
+        /** Bundle every user-visible string passes through. Optional so a
+         * caller that does not translate keeps working - the null bundle
+         * returns each string unchanged. */
+        trans?: TranslationBundle;
     }
 }

package/lib/core/panel.js

@@ -1,9 +1,11 @@
 import { Clipboard, Dialog, InputDialog, Notification, showDialog } from '@jupyterlab/apputils';
 import { MenuSvg, closeIcon, folderIcon, terminalIcon } from '@jupyterlab/ui-components';
+import { nullTranslator } from '@jupyterlab/translation';
 import { CommandRegistry } from '@lumino/commands';
 import { UUID } from '@lumino/coreutils';
 import { Widget } from '@lumino/widgets';
 import { ColourStore } from './colour';
+import { branchMenuLabel, shortSessionId } from './labels';
 import { addIcon, branchIcon, cleanupIcon, filterIcon, providerIcon, refreshIcon, removeIcon, shieldIcon, starFilledIcon, statusDotIcon, switchIcon } from './icons';
 import { DEFAULT_RECENT_LIMIT, MAX_RECENT_LIMIT, MIN_RECENT_LIMIT } from './limits';
 import { resolveLaunchMode, resolvedLaunchModeEntry } from './modes';
@@ -97,7 +99,7 @@ function saveExpanded(storageKey, state) {
  */
 export class AssistantSessionsPanel extends Widget {
     constructor(options) {
-        var _a, _b, _c, _d;
+        var _a, _b, _c, _d, _e;
         super();
         this._rootDir = '';
         this._deleteToTrash = true;
@@ -138,9 +140,11 @@ export class AssistantSessionsPanel extends Widget {
         this._app = options.app;
         this._descriptor = options.descriptor;
         this._hooks = (_a = options.hooks) !== null && _a !== void 0 ? _a : {};
+        this._trans =
+            (_b = options.trans) !== null && _b !== void 0 ? _b : nullTranslator.load('jupyterlab_ai_code_assistants_extension');
         this._serverSettings = options.app.serviceManager.serverSettings;
         this.setRoot(options.rootDir, options.deleteToTrash !== false);
-        this._fileBrowser = (_b = options.fileBrowser) !== null && _b !== void 0 ? _b : null;
+        this._fileBrowser = (_c = options.fileBrowser) !== null && _c !== void 0 ? _c : null;
         this._expandedKey = `jupyterlab_ai_code_assistants_extension:${this._descriptor.id}:expanded`;
         this._expanded = loadExpanded(this._expandedKey);
         this._colours = new ColourStore(this._descriptor.id, this._serverSettings);
@@ -148,9 +152,10 @@ export class AssistantSessionsPanel extends Widget {
             app: options.app,
             descriptor: this._descriptor,
             colourStore: this._colours,
-            terminalTracker: (_c = options.terminalTracker) !== null && _c !== void 0 ? _c : null,
-            colourfulTabs: (_d = options.colourfulTabs) !== null && _d !== void 0 ? _d : null,
-            serverSettings: this._serverSettings
+            terminalTracker: (_d = options.terminalTracker) !== null && _d !== void 0 ? _d : null,
+            colourfulTabs: (_e = options.colourfulTabs) !== null && _e !== void 0 ? _e : null,
+            serverSettings: this._serverSettings,
+            trans: this._trans
         });
         this.id = panelWidgetId(this._descriptor.id);
         this.title.icon = providerIcon(this._descriptor.iconName, this._descriptor.iconSvg);
@@ -299,7 +304,7 @@ export class AssistantSessionsPanel extends Widget {
         header.appendChild(newBtn);
         const filterBtn = document.createElement('button');
         filterBtn.className = 'jp-AiAssistantsPanel-iconButton';
-        filterBtn.title = 'Filter sessions';
+        filterBtn.title = this._trans.__('Filter sessions');
         // The pressed state is drawn with a class, which says nothing to a screen
         // reader; the filter bar starts hidden, so this starts false.
         filterBtn.setAttribute('aria-pressed', 'false');
@@ -309,7 +314,7 @@ export class AssistantSessionsPanel extends Widget {
         this._filterBtn = filterBtn;
         const refreshBtn = document.createElement('button');
         refreshBtn.className = 'jp-AiAssistantsPanel-iconButton';
-        refreshBtn.title = 'Refresh';
+        refreshBtn.title = this._trans.__('Refresh');
         refreshIcon.element({ container: refreshBtn });
         refreshBtn.addEventListener('click', () => this.refresh());
         header.appendChild(refreshBtn);
@@ -327,7 +332,7 @@ export class AssistantSessionsPanel extends Widget {
         search.type = 'search';
         search.className = 'jp-AiAssistantsPanel-search';
         search.placeholder = 'Filter sessions...';
-        search.setAttribute('aria-label', 'Filter sessions');
+        search.setAttribute('aria-label', this._trans.__('Filter sessions'));
         search.spellcheck = false;
         search.addEventListener('input', () => {
             this._filter = search.value;
@@ -337,7 +342,7 @@ export class AssistantSessionsPanel extends Widget {
         this._searchEl = search;
         const searchClear = document.createElement('button');
         searchClear.className = 'jp-AiAssistantsPanel-searchClear';
-        searchClear.title = 'Clear filter';
+        searchClear.title = this._trans.__('Clear filter');
         searchClear.hidden = true;
         closeIcon.element({ container: searchClear });
         searchClear.addEventListener('click', () => {
@@ -582,6 +587,12 @@ export class AssistantSessionsPanel extends Widget {
             this._showActionError('Could not toggle favorite - try again.', err);
         }
     }
+    /** The warning a permanent deletion earns and a trashed one does not - a
+     * trashed conversation is recoverable, and the popup one click away says
+     * so; the same sentence on both would be false half the time. */
+    get _irreversibleNote() {
+        return this._deleteToTrash ? '' : ' This cannot be undone.';
+    }
     get _disposalVerb() {
         return this._deleteToTrash ? 'moved to trash' : 'deleted permanently';
     }
@@ -592,8 +603,11 @@ export class AssistantSessionsPanel extends Widget {
             title: `Remove from ${this._descriptor.label}`,
             body: `Remove "${name}" from ${this._descriptor.label}? This drops the ` +
                 `entire project history and every conversation it holds - ` +
-                `${this._disposalVerb}. This cannot be undone.`,
-            buttons: [Dialog.cancelButton(), Dialog.warnButton({ label: 'Remove' })],
+                `${this._disposalVerb}.${this._irreversibleNote}`,
+            buttons: [
+                Dialog.cancelButton(),
+                Dialog.warnButton({ label: this._trans.__('Remove') })
+            ],
             // Cancel, explicitly. JupyterLab defaults `defaultButton` to the LAST
             // button and focuses it on attach, so omitting this handed the keyboard
             // to Remove - one Enter on a dialog that has just appeared and the
@@ -627,11 +641,14 @@ export class AssistantSessionsPanel extends Widget {
         const extra = session.extra_sessions;
         const name = this._lookupName(session);
         const confirm = await showDialog({
-            title: 'Clean Up Parallel Sessions',
+            title: this._trans.__('Clean Up Parallel Sessions'),
             body: `Remove ${extra} parallel session${extra === 1 ? '' : 's'} from ` +
                 `"${name}"? The current conversation is kept; the rest are ` +
-                `${this._disposalVerb}. This cannot be undone.`,
-            buttons: [Dialog.cancelButton(), Dialog.warnButton({ label: 'Remove' })],
+                `${this._disposalVerb}.${this._irreversibleNote}`,
+            buttons: [
+                Dialog.cancelButton(),
+                Dialog.warnButton({ label: this._trans.__('Remove') })
+            ],
             // Cancel, as above (DEF-51).
             defaultButton: 0
         });
@@ -651,9 +668,9 @@ export class AssistantSessionsPanel extends Widget {
         bar.max = 1;
         body.node.appendChild(bar);
         const dialog = new Dialog({
-            title: 'Clean Up Parallel Sessions',
+            title: this._trans.__('Clean Up Parallel Sessions'),
             body,
-            buttons: [Dialog.okButton({ label: 'Close' })]
+            buttons: [Dialog.okButton({ label: this._trans.__('Close') })]
         });
         // Close stays live while the work runs. Hiding it took away the only exit
         // a keyboard user has: the dialog listens for Escape on its own node, it
@@ -829,7 +846,7 @@ export class AssistantSessionsPanel extends Widget {
             if (row) {
                 // A terminal already holding that conversation IS the answer: a second
                 // process on one history is never what the click meant (ACC-LNCH-152).
-                const found = await this._terminals.findForSession(row.session_id);
+                const found = await this._terminals.findForSession(row.session_id, folder);
                 if (found) {
                     this._terminals.focus(found.widget);
                     return found.widget;
@@ -1184,6 +1201,7 @@ export class AssistantSessionsPanel extends Widget {
     }
     /** Make another conversation the row's current one. */
     async _switchBranch(session, sessionId) {
+        var _a;
         try {
             const result = await requestProvider(this._descriptor.id, 'switch', this._serverSettings, {
                 method: 'POST',
@@ -1195,6 +1213,15 @@ export class AssistantSessionsPanel extends Widget {
             if (result.current !== result.requested) {
                 Notification.warning('That conversation could not be made the current one.', { autoClose: 4000 });
             }
+            else {
+                // The re-render is the only other signal, and it can read as the
+                // opposite of success: the row now reports the conversation's true
+                // last activity, so switching to an old one dims the row and drops
+                // it out of Recent (DEF-PANE-181).
+                const target = this._lastBranches.find(b => b.session_id === sessionId);
+                const label = (_a = target === null || target === void 0 ? void 0 : target.label) !== null && _a !== void 0 ? _a : shortSessionId(sessionId, this._descriptor.sessionIdPrefix);
+                Notification.success(`${this._lookupName(session)}: switched to ${label}`, { autoClose: 3000 });
+            }
         }
         catch (err) {
             Notification.error(isResponseStatus(err, 404)
@@ -1476,17 +1503,6 @@ export class AssistantSessionsPanel extends Widget {
                 row.classList.add('jp-mod-stale');
             }
         }
-        const removing = this._removingPaths.has(session.encoded_path);
-        if (removing) {
-            row.classList.add('jp-mod-busy');
-            const spinner = document.createElement('span');
-            spinner.className = 'jp-AiAssistantsPanel-spinner';
-            spinner.title = 'Removing...';
-            row.appendChild(spinner);
-        }
-        else {
-            row.appendChild(this._renderIndicator(session));
-        }
         const name = document.createElement('span');
         name.className = 'jp-AiAssistantsPanel-name';
         // The text ellipsises in a span of its own so the badges after it survive
@@ -1521,6 +1537,21 @@ export class AssistantSessionsPanel extends Widget {
             name.appendChild(bg);
         }
         row.appendChild(name);
+        // The status dot (or the removal spinner in its place) leads the row
+        // visually - CSS `order` puts it first - but follows the name in the DOM,
+        // so a screen reader announces the project before its status sentence
+        // rather than the same preamble ahead of every active row (DEF-PANE-183).
+        const removing = this._removingPaths.has(session.encoded_path);
+        if (removing) {
+            row.classList.add('jp-mod-busy');
+            const spinner = document.createElement('span');
+            spinner.className = 'jp-AiAssistantsPanel-spinner';
+            spinner.title = this._trans.__('Removing...');
+            row.appendChild(spinner);
+        }
+        else {
+            row.appendChild(this._renderIndicator(session));
+        }
         // No star in the Favorites section - every row there is one by definition.
         // The star sits before the time so the fixed-width time column stays the
         // rightmost alignment anchor across all rows.
@@ -1531,7 +1562,7 @@ export class AssistantSessionsPanel extends Widget {
             // menu, rather than becoming a second hit target inside the row.
             const star = document.createElement('span');
             star.className = 'jp-AiAssistantsPanel-favStar';
-            star.setAttribute('aria-label', 'Favorite');
+            star.setAttribute('aria-label', this._trans.__('Favorite'));
             star.setAttribute('role', 'img');
             starFilledIcon.element({ container: star });
             row.appendChild(star);
@@ -1626,7 +1657,7 @@ export class AssistantSessionsPanel extends Widget {
         if (this._descriptor.hasRemoteControl && session.remote_control) {
             dot.className = 'jp-AiAssistantsPanel-dot';
             statusDotIcon.element({ container: dot });
-            dot.title = 'Remote control session is active';
+            dot.title = this._trans.__('Remote control session is active');
             dot.setAttribute('aria-label', dot.title);
             return dot;
         }
@@ -1749,14 +1780,9 @@ export class AssistantSessionsPanel extends Widget {
             `${pad(d.getHours())}:${pad(d.getMinutes())}`);
     }
     /** Branch entry display: conversation name plus short session id. Branches
-     * share a project path, so the name and id are all that tell them apart. The
-     * suffix is dropped when the label already IS the short id. */
+     * share a project path, so the name and id are all that tell them apart. */
     _branchDisplayName(b) {
-        const shortId = b.session_id.slice(0, 8);
-        if (this._hooks.branchLabel) {
-            return this._hooks.branchLabel(b, shortId);
-        }
-        return b.label === shortId ? b.label : `${b.label} (${shortId})`;
+        return branchMenuLabel(b.label, shortSessionId(b.session_id, this._descriptor.sessionIdPrefix));
     }
     /** Menu-item label for a branch: display name, relative time, and a trailing
      * marker when a live worker owns the conversation. The marker lives in the
@@ -1838,6 +1864,12 @@ export class AssistantSessionsPanel extends Widget {
         var _a;
         return ((_a = this._resolvedVariant()) === null || _a === void 0 ? void 0 : _a.unsafe) ? shieldIcon : undefined;
     }
+    /* eslint-disable jupyter/command-described-by --
+       These commands go on the private CommandRegistry built below, which only
+       this panel's own row context menu reads. `describedBy` is metadata for
+       the application registry's consumers - the palette, settings, other
+       extensions - and none of them can see or invoke a command registered
+       here. */
     _setupCommands() {
         this._commands = new CommandRegistry();
         const active = () => this._activeSession;
@@ -1901,7 +1933,7 @@ export class AssistantSessionsPanel extends Widget {
             });
         }
         this._commands.addCommand(this._cmd('open-terminal'), {
-            label: 'Open Terminal',
+            label: this._trans.__('Open Terminal'),
             icon: terminalIcon,
             execute: () => {
                 const s = active();
@@ -1926,7 +1958,7 @@ export class AssistantSessionsPanel extends Widget {
             }
         });
         this._commands.addCommand(this._cmd('show-in-filebrowser'), {
-            label: 'Show in File Browser',
+            label: this._trans.__('Show in File Browser'),
             icon: folderIcon,
             execute: () => {
                 const s = active();
@@ -1948,7 +1980,7 @@ export class AssistantSessionsPanel extends Widget {
             }
         });
         this._commands.addCommand(this._cmd('copy-path'), {
-            label: 'Copy Path',
+            label: this._trans.__('Copy Path'),
             execute: () => {
                 const s = active();
                 if (s) {
@@ -1957,7 +1989,7 @@ export class AssistantSessionsPanel extends Widget {
             }
         });
         this._commands.addCommand(this._cmd('copy-session-id'), {
-            label: 'Copy Session ID',
+            label: this._trans.__('Copy Session ID'),
             execute: () => {
                 var _a;
                 const id = (_a = active()) === null || _a === void 0 ? void 0 : _a.session_id;
@@ -2089,6 +2121,7 @@ export class AssistantSessionsPanel extends Widget {
         });
         this._buildMenus();
     }
+    /* eslint-enable jupyter/command-described-by */
     /** How many forced launch variants would actually render right now. Zero
      * means every variant builds the launch the plain item already builds, so a
      * menu offering both is a menu with one entry. */
@@ -2108,17 +2141,17 @@ export class AssistantSessionsPanel extends Widget {
         // Lists the project's other conversations. Items are rebuilt on every
         // context-menu open from a fresh branches fetch.
         this._switchSubmenu = this._menu();
-        this._switchSubmenu.title.label = 'Switch and Manage Sessions';
+        this._switchSubmenu.title.label = this._trans.__('Switch and Manage Sessions');
         this._switchSubmenu.title.icon = switchIcon;
         // Opens a conversation directly in its own terminal, as opposed to the
         // switch submenu which only changes which one the row points at. Several
         // conversations can be open at once, independently.
         this._openBranchSubmenu = this._menu();
-        this._openBranchSubmenu.title.label = 'Open Branched Conversation';
+        this._openBranchSubmenu.title.label = this._trans.__('Open Branched Conversation');
         this._openBranchSubmenu.title.icon = terminalIcon;
         // Groups the branch launch modes.
         this._branchSessionMenu = this._menu();
-        this._branchSessionMenu.title.label = 'Branch Session';
+        this._branchSessionMenu.title.label = this._trans.__('Branch Session');
         this._branchSessionMenu.title.icon = branchIcon;
         this._branchSessionMenu.addItem({ command: this._cmd('branch-session') });
         for (const mode of this._variantModes) {
@@ -2169,10 +2202,14 @@ export class AssistantSessionsPanel extends Widget {
         add('reset-colour');
         this._contextMenu.addItem({ type: 'separator' });
         if (withBranches) {
-            this._contextMenu.addItem({
-                type: 'submenu',
-                submenu: this._openBranchSubmenu
-            });
+            // A project-scoped assistant has one terminal for every conversation,
+            // so opening a branch in its own terminal is not an action it has.
+            if (this._descriptor.terminalScope === 'conversation') {
+                this._contextMenu.addItem({
+                    type: 'submenu',
+                    submenu: this._openBranchSubmenu
+                });
+            }
             this._contextMenu.addItem({
                 type: 'submenu',
                 submenu: this._switchSubmenu
@@ -2334,10 +2371,12 @@ export class AssistantSessionsPanel extends Widget {
         if (!session) {
             return;
         }
+        const current = this._lastBranchesCurrent || session.session_id;
         showManageSessionsPopup({
+            trans: this._trans,
             branches: this._lastBranches,
-            current: this._lastBranchesCurrent || session.session_id,
-            projectName: this._lookupName(session),
+            current,
+            currentName: `${this._lookupName(session)} (${shortSessionId(current, this._descriptor.sessionIdPrefix)})`,
             deleteToTrash: this._deleteToTrash,
             branchName: b => this._branchDisplayName(b),
             formatTime: ms => this._formatRelativeTime(ms),
@@ -2358,11 +2397,16 @@ export class AssistantSessionsPanel extends Widget {
      * is attached to and carries none. The row's own conversation is not in
      * `_lastBranches`, so it answers from the session. */
     _openBranchTitle(session, sessionId) {
-        var _a;
+        var _a, _b, _c, _d;
+        // One terminal serves a project-scoped assistant, so the button focuses
+        // or starts it, under the provider's own verb for that.
+        if (this._descriptor.terminalScope === 'project') {
+            return ((_c = (_b = (_a = this._hooks).resumeLabel) === null || _b === void 0 ? void 0 : _b.call(_a, session)) !== null && _c !== void 0 ? _c : "Open the project's terminal");
+        }
         const base = 'Open this conversation in its own terminal';
         const target = sessionId === session.session_id
             ? session
-            : ((_a = this._lastBranches.find(b => b.session_id === sessionId)) !== null && _a !== void 0 ? _a : null);
+            : ((_d = this._lastBranches.find(b => b.session_id === sessionId)) !== null && _d !== void 0 ? _d : null);
         const variant = this._resumeVariant(target);
         return variant ? `${base} (${variant.label})` : base;
     }

package/lib/core/popup.d.ts

@@ -1,3 +1,4 @@
+import { TranslationBundle } from '@jupyterlab/translation';
 import { IBranch } from './types';
 /**
  * The Manage Sessions popup: a searchable, scrollable table over every
@@ -9,12 +10,17 @@ import { IBranch } from './types';
  */
 export declare namespace ManageSessionsPopup {
     interface IOptions {
+        /** Bundle every user-visible string passes through. Optional so a
+         * caller that does not translate keeps working - the null bundle
+         * returns each string unchanged. */
+        trans?: TranslationBundle;
         /** Conversations other than the current one. */
         branches: IBranch[];
         /** The project's current conversation id, pinned at the top. */
         current: string;
-        /** Display name of the row this popup was opened from. */
-        projectName: string;
+        /** Display name of the current row: the project's name and the short id
+         * of `current`, derived by the panel with the same rule as `branchName`. */
+        currentName: string;
         /** Whether deletions move to trash - the popup says which it means. */
         deleteToTrash: boolean;
         /** Display name for one branch, `<label> (<short id>)` by default. */