jupyterlab_ai_code_assistants_extension 1.2.7 → 1.2.18

package/README.md

@@ -31,7 +31,7 @@ Chat-panel extensions re-implement the agent loop and trail the real tool. This
 - **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
 - **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
 - **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

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/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';
@@ -303,6 +304,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 +368,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,5 +1,6 @@
 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';
@@ -97,7 +98,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 +139,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 +151,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 +303,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 +313,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 +331,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 +341,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', () => {
@@ -593,7 +597,10 @@ export class AssistantSessionsPanel extends Widget {
             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' })],
+            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 +634,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' })],
+            buttons: [
+                Dialog.cancelButton(),
+                Dialog.warnButton({ label: this._trans.__('Remove') })
+            ],
             // Cancel, as above (DEF-51).
             defaultButton: 0
         });
@@ -651,9 +661,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
@@ -1481,7 +1491,7 @@ export class AssistantSessionsPanel extends Widget {
             row.classList.add('jp-mod-busy');
             const spinner = document.createElement('span');
             spinner.className = 'jp-AiAssistantsPanel-spinner';
-            spinner.title = 'Removing...';
+            spinner.title = this._trans.__('Removing...');
             row.appendChild(spinner);
         }
         else {
@@ -1531,7 +1541,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 +1636,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;
         }
@@ -1838,6 +1848,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 +1917,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 +1942,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 +1964,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 +1973,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 +2105,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 +2125,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) {
@@ -2335,6 +2352,7 @@ export class AssistantSessionsPanel extends Widget {
             return;
         }
         showManageSessionsPopup({
+            trans: this._trans,
             branches: this._lastBranches,
             current: this._lastBranchesCurrent || session.session_id,
             projectName: this._lookupName(session),

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,6 +10,10 @@ 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. */

package/lib/core/popup.js

@@ -1,14 +1,15 @@
 import { Clipboard, Dialog } from '@jupyterlab/apputils';
+import { nullTranslator } from '@jupyterlab/translation';
 import { copyIcon } from '@jupyterlab/ui-components';
 import { Widget } from '@lumino/widgets';
 import { branchIcon } from './icons';
 /** Compact copy button for a popup row. `stopPropagation` keeps the click from
  * switching or selecting the row it sits in. */
-function copyButton(sessionId) {
+function copyButton(sessionId, trans) {
     const btn = document.createElement('button');
     btn.type = 'button';
     btn.className = 'jp-AiAssistantsPanel-branchCopy';
-    btn.title = 'Copy session id';
+    btn.title = trans.__('Copy session id');
     copyIcon.element({ container: btn });
     btn.addEventListener('click', e => {
         e.stopPropagation();
@@ -17,6 +18,8 @@ function copyButton(sessionId) {
     return btn;
 }
 export function showManageSessionsPopup(options) {
+    var _a;
+    const trans = (_a = options.trans) !== null && _a !== void 0 ? _a : nullTranslator.load('jupyterlab_ai_code_assistants_extension');
     // Local working copy so deletions can refresh the list in place.
     let items = [...options.branches];
     const selected = new Set();
@@ -31,7 +34,7 @@ export function showManageSessionsPopup(options) {
     const search = document.createElement('input');
     search.type = 'search';
     search.placeholder = 'Filter sessions...';
-    search.setAttribute('aria-label', 'Filter sessions');
+    search.setAttribute('aria-label', trans.__('Filter sessions'));
     search.className = 'jp-AiAssistantsPanel-branchSearch';
     body.appendChild(search);
     // Header strip: select-all left, conversation count right.
@@ -52,7 +55,7 @@ export function showManageSessionsPopup(options) {
     list.className = 'jp-AiAssistantsPanel-branchList';
     // role=group makes the aria-label apply to the conversation list region.
     list.setAttribute('role', 'group');
-    list.setAttribute('aria-label', 'Conversations');
+    list.setAttribute('aria-label', trans.__('Conversations'));
     body.appendChild(list);
     const footer = document.createElement('div');
     footer.className = 'jp-AiAssistantsPanel-branchFooter';
@@ -78,12 +81,12 @@ export function showManageSessionsPopup(options) {
     body.appendChild(srLive);
     const bodyWidget = new Widget({ node: body });
     const dialog = new Dialog({
-        title: 'Manage Sessions',
+        title: trans.__('Manage Sessions'),
         body: bodyWidget,
         // `Close`, not `Cancel`: deletions here are committed as they happen, so
         // the only exit must not read as an offer to undo them. The cleanup dialog
         // in the panel already says Close for the same reason.
-        buttons: [Dialog.okButton({ label: 'Close' })]
+        buttons: [Dialog.okButton({ label: trans.__('Close') })]
     });
     // Per-row "Open" launches that conversation in its own terminal and closes
     // the popup. stopPropagation keeps the click from toggling selection or
@@ -163,7 +166,7 @@ export function showManageSessionsPopup(options) {
         badge.textContent = 'current';
         currentRow.appendChild(badge);
         currentRow.appendChild(openButton(options.current));
-        currentRow.appendChild(copyButton(options.current));
+        currentRow.appendChild(copyButton(options.current, trans));
         list.appendChild(currentRow);
         const matches = visibleMatches();
         if (matches.length === 0) {
@@ -241,7 +244,7 @@ export function showManageSessionsPopup(options) {
             time.textContent = options.formatTime(b.file_mtime);
             row.appendChild(time);
             row.appendChild(openButton(b.session_id));
-            row.appendChild(copyButton(b.session_id));
+            row.appendChild(copyButton(b.session_id, trans));
             const activate = () => {
                 // Selection mode: while anything is ticked, row clicks toggle
                 // selection - no accidental switch mid-selection.

package/lib/core/terminals.d.ts

@@ -1,5 +1,6 @@
 import { JupyterFrontEnd } from '@jupyterlab/application';
 import { Dialog } from '@jupyterlab/apputils';
+import { TranslationBundle } from '@jupyterlab/translation';
 import { ServerConnection } from '@jupyterlab/services';
 import { ITerminalTracker } from '@jupyterlab/terminal';
 import { IColourfulTabs } from 'jupyterlab_colourful_tab_extension';
@@ -11,7 +12,7 @@ import { ILaunchRequest, IProviderDescriptor, ISession, ITerminalProbeResponse }
  * Hide does not abort the request - it only takes the app-wide scrim away, so
  * a stalled launch cannot leave the user staring at a modal with no exit. If
  * the launch later succeeds the terminal simply appears. */
-export declare function showLaunchSpinner(title: string): Dialog<unknown>;
+export declare function showLaunchSpinner(title: string, trans: TranslationBundle): Dialog<unknown>;
 /**
  * Terminals for one provider: the reuse ladder, the launch call and the tab
  * tint pass.
@@ -202,6 +203,7 @@ export declare class TerminalManager {
     private _key;
     private readonly _app;
     private readonly _descriptor;
+    private readonly _trans;
     private readonly _colours;
     private readonly _tracker;
     /** The injected colour token narrowed to its ownership API, or null when the
@@ -227,5 +229,9 @@ export declare namespace TerminalManager {
         terminalTracker: ITerminalTracker | null;
         colourfulTabs: IColourfulTabs | null;
         serverSettings: ServerConnection.ISettings;
+        /** 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/terminals.js

@@ -1,4 +1,5 @@
 import { Dialog, Notification } from '@jupyterlab/apputils';
+import { nullTranslator } from '@jupyterlab/translation';
 import { Widget } from '@lumino/widgets';
 import { effectiveColour, sessionForCwds } from './colour';
 import { LOG_PREFIX } from './registry';
@@ -51,7 +52,7 @@ function warnLegacyCompanion() {
  * Hide does not abort the request - it only takes the app-wide scrim away, so
  * a stalled launch cannot leave the user staring at a modal with no exit. If
  * the launch later succeeds the terminal simply appears. */
-export function showLaunchSpinner(title) {
+export function showLaunchSpinner(title, trans) {
     const body = new Widget();
     body.node.className = 'jp-AiAssistantsPanel-launchOverlay';
     const spinner = document.createElement('div');
@@ -65,7 +66,7 @@ export function showLaunchSpinner(title) {
         // the request is already on the wire and the terminal will still open and
         // take focus. A button named Cancel that does not cancel is worse than no
         // button.
-        buttons: [Dialog.okButton({ label: 'Hide' })]
+        buttons: [Dialog.okButton({ label: trans.__('Hide') })]
     });
     // `launch()` returns a promise nobody awaits - disposing an open Lumino
     // dialog rejects it with `undefined`, so swallow that here and keep a benign
@@ -84,6 +85,7 @@ export function showLaunchSpinner(title) {
  */
 export class TerminalManager {
     constructor(options) {
+        var _a;
         // One claim per terminal, keyed by widget id - see `_claimTab` for why that
         // id identifies exactly one widget.
         this._claims = new Map();
@@ -115,6 +117,8 @@ export class TerminalManager {
         this._colours = options.colourStore;
         this._tracker = options.terminalTracker;
         this._serverSettings = options.serverSettings;
+        this._trans =
+            (_a = options.trans) !== null && _a !== void 0 ? _a : nullTranslator.load('jupyterlab_ai_code_assistants_extension');
         // This narrowing decides whether the extension tints at all. Against a
         // companion with no ownership API it paints nothing: a colour the user
         // picks on a tab cannot be captured there, so the next pass would repaint
@@ -209,7 +213,7 @@ export class TerminalManager {
      * that conversation now belongs to reuses this very terminal.
      */
     async launch(request, tagSessionId) {
-        const spinner = showLaunchSpinner(`Opening ${this._descriptor.label}`);
+        const spinner = showLaunchSpinner(`Opening ${this._descriptor.label}`, this._trans);
         try {
             const launched = await requestProvider(this._descriptor.id, 'launch', this._serverSettings, { method: 'POST', body: JSON.stringify(request) });
             const widget = await this._app.commands.execute('terminal:open', {

package/lib/index.js

@@ -4,6 +4,7 @@ import { IDefaultFileBrowser } from '@jupyterlab/filebrowser';
 import { ILauncher } from '@jupyterlab/launcher';
 import { ISettingRegistry } from '@jupyterlab/settingregistry';
 import { ITerminalTracker } from '@jupyterlab/terminal';
+import { ITranslator, nullTranslator } from '@jupyterlab/translation';
 import { IColourfulTabs } from 'jupyterlab_colourful_tab_extension';
 import { launcherTileIcon, providerIcon } from './core/icons';
 import { DEFAULT_RECENT_LIMIT } from './core/limits';
@@ -38,10 +39,15 @@ const plugin = {
         ITerminalTracker,
         IDefaultFileBrowser,
         IColourfulTabs,
-        ILauncher
+        ILauncher,
+        ITranslator
     ],
-    activate: async (app, labShell, restorer, settingRegistry, terminalTracker, fileBrowser, colourfulTabs, launcher) => {
+    activate: async (app, labShell, restorer, settingRegistry, terminalTracker, fileBrowser, colourfulTabs, launcher, translator) => {
         console.log('JupyterLab extension jupyterlab_ai_code_assistants_extension is activated!');
+        // Every user-visible string in the panels goes through this bundle.
+        // `ITranslator` is optional, and the null translator returns each string
+        // unchanged, so an install without one behaves exactly as before.
+        const trans = (translator !== null && translator !== void 0 ? translator : nullTranslator).load('jupyterlab_ai_code_assistants_extension');
         // A duplicate id throws here, at registration, rather than surfacing later
         // as two panels quietly fighting over one widget id.
         const registry = new ProviderRegistry(PROVIDERS);
@@ -163,7 +169,8 @@ const plugin = {
                     deleteToTrash: status ? status.delete_to_trash !== false : false,
                     terminalTracker,
                     fileBrowser,
-                    colourfulTabs
+                    colourfulTabs,
+                    trans
                 });
                 applySharedSettings(panel);
                 dock(panel);
@@ -172,6 +179,8 @@ const plugin = {
                 restorer === null || restorer === void 0 ? void 0 : restorer.add(panel, panelWidgetId(id));
                 const command = app.commands.addCommand(commandId(id, 'refresh'), {
                     label: `Refresh ${module.descriptor.panelTitle}`,
+                    // Takes no arguments, which is what `null` says here.
+                    describedBy: { args: null },
                     execute: () => panel.refresh()
                 });
                 // The Launcher tile's command. It is registered whether or not a
@@ -184,6 +193,17 @@ const plugin = {
                     // The section header borrows this icon too; the view draws the
                     // joint icon there and the provider's own on the tile.
                     icon: launcherTileIcon(providerIcon(module.descriptor.iconName, module.descriptor.iconSvg)),
+                    describedBy: {
+                        args: {
+                            type: 'object',
+                            properties: {
+                                cwd: {
+                                    type: 'string',
+                                    description: 'Folder to start the assistant in. The server root when absent.'
+                                }
+                            }
+                        }
+                    },
                     // The Launcher puts the file browser's folder in `cwd` on every
                     // click; the panel resolves it against the server root.
                     execute: args => panel.launchHere(args.cwd)

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "jupyterlab_ai_code_assistants_extension",
-    "version": "1.2.7",
+    "version": "1.2.18",
     "description": "Jupyterlab extension to replace individual jupyterlab_*_code_extension and integrate into one, that offers joint capability, joint settings page and individual right toolbar panels per code assistant, with the ability in settings to decide which code assistant support is on (default - all are enabled)",
     "keywords": [
         "jupyter",
@@ -66,6 +66,7 @@
         "@jupyterlab/services": "^7.0.0",
         "@jupyterlab/settingregistry": "^4.0.0",
         "@jupyterlab/terminal": "^4.0.0",
+        "@jupyterlab/translation": "^4.0.0",
         "@jupyterlab/ui-components": "^4.0.0",
         "@lumino/commands": "^2.0.0",
         "@lumino/coreutils": "^2.0.0",

package/src/core/icons.ts

@@ -128,10 +128,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({

package/src/core/panel.ts

@@ -17,6 +17,7 @@ import {
   folderIcon,
   terminalIcon
 } from '@jupyterlab/ui-components';
+import { TranslationBundle, nullTranslator } from '@jupyterlab/translation';
 import { CommandRegistry } from '@lumino/commands';
 import { UUID } from '@lumino/coreutils';
 import { Message } from '@lumino/messaging';
@@ -177,6 +178,9 @@ export class AssistantSessionsPanel extends Widget {
     this._app = options.app;
     this._descriptor = options.descriptor;
     this._hooks = options.hooks ?? {};
+    this._trans =
+      options.trans ??
+      nullTranslator.load('jupyterlab_ai_code_assistants_extension');
     this._serverSettings = options.app.serviceManager.serverSettings;
     this.setRoot(options.rootDir, options.deleteToTrash !== false);
     this._fileBrowser = options.fileBrowser ?? null;
@@ -190,7 +194,8 @@ export class AssistantSessionsPanel extends Widget {
       colourStore: this._colours,
       terminalTracker: options.terminalTracker ?? null,
       colourfulTabs: options.colourfulTabs ?? null,
-      serverSettings: this._serverSettings
+      serverSettings: this._serverSettings,
+      trans: this._trans
     });
 
     this.id = panelWidgetId(this._descriptor.id);
@@ -364,7 +369,7 @@ export class AssistantSessionsPanel extends Widget {
 
     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');
@@ -375,7 +380,7 @@ export class AssistantSessionsPanel extends Widget {
 
     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);
@@ -395,7 +400,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;
@@ -406,7 +411,7 @@ export class AssistantSessionsPanel extends Widget {
 
     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', () => {
@@ -697,7 +702,10 @@ export class AssistantSessionsPanel extends Widget {
         `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' })],
+      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
@@ -737,12 +745,15 @@ 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' })],
+      buttons: [
+        Dialog.cancelButton(),
+        Dialog.warnButton({ label: this._trans.__('Remove') })
+      ],
       // Cancel, as above (DEF-51).
       defaultButton: 0
     });
@@ -768,9 +779,9 @@ export class AssistantSessionsPanel extends Widget {
     body.node.appendChild(bar);
 
     const dialog = new Dialog<unknown>({
-      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
@@ -1771,7 +1782,7 @@ export class AssistantSessionsPanel extends Widget {
       row.classList.add('jp-mod-busy');
       const spinner = document.createElement('span');
       spinner.className = 'jp-AiAssistantsPanel-spinner';
-      spinner.title = 'Removing...';
+      spinner.title = this._trans.__('Removing...');
       row.appendChild(spinner);
     } else {
       row.appendChild(this._renderIndicator(session));
@@ -1824,7 +1835,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);
@@ -1927,7 +1938,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;
     }
@@ -2169,6 +2180,12 @@ export class AssistantSessionsPanel extends Widget {
     return this._resolvedVariant()?.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. */
   private _setupCommands(): void {
     this._commands = new CommandRegistry();
     const active = (): ISession | null => this._activeSession;
@@ -2236,7 +2253,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();
@@ -2270,7 +2287,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();
@@ -2301,7 +2318,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) {
@@ -2311,7 +2328,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: () => {
         const id = active()?.session_id;
         if (id) {
@@ -2451,6 +2468,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
@@ -2473,19 +2491,23 @@ 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) {
@@ -2722,6 +2744,7 @@ export class AssistantSessionsPanel extends Widget {
       return;
     }
     showManageSessionsPopup({
+      trans: this._trans,
       branches: this._lastBranches,
       current: this._lastBranchesCurrent || session.session_id,
       projectName: this._lookupName(session),
@@ -2805,6 +2828,7 @@ export class AssistantSessionsPanel extends Widget {
 
   private readonly _app: JupyterFrontEnd;
   private readonly _descriptor: IProviderDescriptor;
+  private readonly _trans: TranslationBundle;
   private readonly _hooks: IProviderHooks;
   private readonly _serverSettings: ServerConnection.ISettings;
   private _rootDir = '';
@@ -2869,5 +2893,9 @@ export 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/src/core/popup.ts

@@ -1,4 +1,5 @@
 import { Clipboard, Dialog } from '@jupyterlab/apputils';
+import { TranslationBundle, nullTranslator } from '@jupyterlab/translation';
 import { copyIcon } from '@jupyterlab/ui-components';
 import { Widget } from '@lumino/widgets';
 
@@ -15,6 +16,10 @@ import { IBranch } from './types';
  */
 export namespace ManageSessionsPopup {
   export 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. */
@@ -50,11 +55,14 @@ export namespace ManageSessionsPopup {
 
 /** Compact copy button for a popup row. `stopPropagation` keeps the click from
  * switching or selecting the row it sits in. */
-function copyButton(sessionId: string): HTMLButtonElement {
+function copyButton(
+  sessionId: string,
+  trans: TranslationBundle
+): HTMLButtonElement {
   const btn = document.createElement('button');
   btn.type = 'button';
   btn.className = 'jp-AiAssistantsPanel-branchCopy';
-  btn.title = 'Copy session id';
+  btn.title = trans.__('Copy session id');
   copyIcon.element({ container: btn });
   btn.addEventListener('click', e => {
     e.stopPropagation();
@@ -66,6 +74,9 @@ function copyButton(sessionId: string): HTMLButtonElement {
 export function showManageSessionsPopup(
   options: ManageSessionsPopup.IOptions
 ): void {
+  const trans =
+    options.trans ??
+    nullTranslator.load('jupyterlab_ai_code_assistants_extension');
   // Local working copy so deletions can refresh the list in place.
   let items = [...options.branches];
   const selected = new Set<string>();
@@ -82,7 +93,7 @@ export function showManageSessionsPopup(
   const search = document.createElement('input');
   search.type = 'search';
   search.placeholder = 'Filter sessions...';
-  search.setAttribute('aria-label', 'Filter sessions');
+  search.setAttribute('aria-label', trans.__('Filter sessions'));
   search.className = 'jp-AiAssistantsPanel-branchSearch';
   body.appendChild(search);
 
@@ -105,7 +116,7 @@ export function showManageSessionsPopup(
   list.className = 'jp-AiAssistantsPanel-branchList';
   // role=group makes the aria-label apply to the conversation list region.
   list.setAttribute('role', 'group');
-  list.setAttribute('aria-label', 'Conversations');
+  list.setAttribute('aria-label', trans.__('Conversations'));
   body.appendChild(list);
 
   const footer = document.createElement('div');
@@ -134,12 +145,12 @@ export function showManageSessionsPopup(
 
   const bodyWidget = new Widget({ node: body });
   const dialog = new Dialog({
-    title: 'Manage Sessions',
+    title: trans.__('Manage Sessions'),
     body: bodyWidget,
     // `Close`, not `Cancel`: deletions here are committed as they happen, so
     // the only exit must not read as an offer to undo them. The cleanup dialog
     // in the panel already says Close for the same reason.
-    buttons: [Dialog.okButton({ label: 'Close' })]
+    buttons: [Dialog.okButton({ label: trans.__('Close') })]
   });
 
   // Per-row "Open" launches that conversation in its own terminal and closes
@@ -232,7 +243,7 @@ export function showManageSessionsPopup(
     badge.textContent = 'current';
     currentRow.appendChild(badge);
     currentRow.appendChild(openButton(options.current));
-    currentRow.appendChild(copyButton(options.current));
+    currentRow.appendChild(copyButton(options.current, trans));
     list.appendChild(currentRow);
 
     const matches = visibleMatches();
@@ -314,7 +325,7 @@ export function showManageSessionsPopup(
       row.appendChild(time);
 
       row.appendChild(openButton(b.session_id));
-      row.appendChild(copyButton(b.session_id));
+      row.appendChild(copyButton(b.session_id, trans));
 
       const activate = (): void => {
         // Selection mode: while anything is ticked, row clicks toggle

package/src/core/terminals.ts

@@ -1,5 +1,6 @@
 import { JupyterFrontEnd } from '@jupyterlab/application';
 import { Dialog, Notification } from '@jupyterlab/apputils';
+import { TranslationBundle, nullTranslator } from '@jupyterlab/translation';
 import { ServerConnection } from '@jupyterlab/services';
 import { ITerminalTracker } from '@jupyterlab/terminal';
 import { IColourfulTabs } from 'jupyterlab_colourful_tab_extension';
@@ -76,7 +77,10 @@ function warnLegacyCompanion(): void {
  * Hide does not abort the request - it only takes the app-wide scrim away, so
  * a stalled launch cannot leave the user staring at a modal with no exit. If
  * the launch later succeeds the terminal simply appears. */
-export function showLaunchSpinner(title: string): Dialog<unknown> {
+export function showLaunchSpinner(
+  title: string,
+  trans: TranslationBundle
+): Dialog<unknown> {
   const body = new Widget();
   body.node.className = 'jp-AiAssistantsPanel-launchOverlay';
 
@@ -92,7 +96,7 @@ export function showLaunchSpinner(title: string): Dialog<unknown> {
     // the request is already on the wire and the terminal will still open and
     // take focus. A button named Cancel that does not cancel is worse than no
     // button.
-    buttons: [Dialog.okButton({ label: 'Hide' })]
+    buttons: [Dialog.okButton({ label: trans.__('Hide') })]
   });
   // `launch()` returns a promise nobody awaits - disposing an open Lumino
   // dialog rejects it with `undefined`, so swallow that here and keep a benign
@@ -117,6 +121,9 @@ export class TerminalManager {
     this._colours = options.colourStore;
     this._tracker = options.terminalTracker;
     this._serverSettings = options.serverSettings;
+    this._trans =
+      options.trans ??
+      nullTranslator.load('jupyterlab_ai_code_assistants_extension');
 
     // This narrowing decides whether the extension tints at all. Against a
     // companion with no ownership API it paints nothing: a colour the user
@@ -226,7 +233,10 @@ export class TerminalManager {
    * that conversation now belongs to reuses this very terminal.
    */
   async launch(request: ILaunchRequest, tagSessionId?: string): Promise<any> {
-    const spinner = showLaunchSpinner(`Opening ${this._descriptor.label}`);
+    const spinner = showLaunchSpinner(
+      `Opening ${this._descriptor.label}`,
+      this._trans
+    );
     try {
       const launched = await requestProvider<ILaunchResponse>(
         this._descriptor.id,
@@ -821,6 +831,7 @@ export class TerminalManager {
 
   private readonly _app: JupyterFrontEnd;
   private readonly _descriptor: IProviderDescriptor;
+  private readonly _trans: TranslationBundle;
   private readonly _colours: ColourStore;
   private readonly _tracker: ITerminalTracker | null;
   /** The injected colour token narrowed to its ownership API, or null when the
@@ -867,5 +878,9 @@ export namespace TerminalManager {
     terminalTracker: ITerminalTracker | null;
     colourfulTabs: IColourfulTabs | null;
     serverSettings: ServerConnection.ISettings;
+    /** 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/src/index.ts

@@ -9,6 +9,7 @@ import { IDefaultFileBrowser } from '@jupyterlab/filebrowser';
 import { ILauncher } from '@jupyterlab/launcher';
 import { ISettingRegistry } from '@jupyterlab/settingregistry';
 import { ITerminalTracker } from '@jupyterlab/terminal';
+import { ITranslator, nullTranslator } from '@jupyterlab/translation';
 import { IColourfulTabs } from 'jupyterlab_colourful_tab_extension';
 import { IDisposable } from '@lumino/disposable';
 
@@ -73,7 +74,8 @@ const plugin: JupyterFrontEndPlugin<void> = {
     ITerminalTracker,
     IDefaultFileBrowser,
     IColourfulTabs,
-    ILauncher
+    ILauncher,
+    ITranslator
   ],
   activate: async (
     app: JupyterFrontEnd,
@@ -83,12 +85,20 @@ const plugin: JupyterFrontEndPlugin<void> = {
     terminalTracker: ITerminalTracker | null,
     fileBrowser: IDefaultFileBrowser | null,
     colourfulTabs: IColourfulTabs | null,
-    launcher: ILauncher | null
+    launcher: ILauncher | null,
+    translator: ITranslator | null
   ) => {
     console.log(
       'JupyterLab extension jupyterlab_ai_code_assistants_extension is activated!'
     );
 
+    // Every user-visible string in the panels goes through this bundle.
+    // `ITranslator` is optional, and the null translator returns each string
+    // unchanged, so an install without one behaves exactly as before.
+    const trans = (translator ?? nullTranslator).load(
+      'jupyterlab_ai_code_assistants_extension'
+    );
+
     // A duplicate id throws here, at registration, rather than surfacing later
     // as two panels quietly fighting over one widget id.
     const registry = new ProviderRegistry(PROVIDERS);
@@ -229,7 +239,8 @@ const plugin: JupyterFrontEndPlugin<void> = {
           deleteToTrash: status ? status.delete_to_trash !== false : false,
           terminalTracker,
           fileBrowser,
-          colourfulTabs
+          colourfulTabs,
+          trans
         });
         applySharedSettings(panel);
         dock(panel);
@@ -238,6 +249,8 @@ const plugin: JupyterFrontEndPlugin<void> = {
         restorer?.add(panel, panelWidgetId(id));
         const command = app.commands.addCommand(commandId(id, 'refresh'), {
           label: `Refresh ${module.descriptor.panelTitle}`,
+          // Takes no arguments, which is what `null` says here.
+          describedBy: { args: null },
           execute: () => panel.refresh()
         });
         // The Launcher tile's command. It is registered whether or not a
@@ -252,6 +265,18 @@ const plugin: JupyterFrontEndPlugin<void> = {
           icon: launcherTileIcon(
             providerIcon(module.descriptor.iconName, module.descriptor.iconSvg)
           ),
+          describedBy: {
+            args: {
+              type: 'object',
+              properties: {
+                cwd: {
+                  type: 'string',
+                  description:
+                    'Folder to start the assistant in. The server root when absent.'
+                }
+              }
+            }
+          },
           // The Launcher puts the file browser's folder in `cwd` on every
           // click; the panel resolves it against the server root.
           execute: args => panel.launchHere(args.cwd as string | undefined)

package/style/base.css

@@ -366,17 +366,51 @@
   height: 8px;
 }
 
-/* The theme picks the green, through the circle's own fill. This dot is the
-   ONLY graphic for "a process is running here", so WCAG 1.4.11's 3:1 applies:
-   color1 is md-green-700 on the light theme and md-green-500 on the dark one,
-   measuring 4.11:1 on white and 5.79:1 on the dark row. color0 clears the bar
-   too and was used before, but on the light theme it is md-green-900 - dark
-   enough at 8px to read as a near-black mark rather than a green light, which
-   is the whole of what the dot has to say (DEF-PANE-174). */
+/* The theme picks the green, through the circle's own fill rather than a
+   presentation attribute on the svg, the way every other glyph here is
+   recoloured (DEF-PANE-174). This dot is the ONLY graphic for "a process is
+   running here", so WCAG 1.4.11's 3:1 applies: color1 is md-green-500 on every
+   dark theme installed, 5.79:1 against the stock dark row. color0 clears the
+   bar too and was used before, but it is a step darker again and at 8px reads
+   as a near-black mark rather than a green light, which is the whole of what
+   the dot has to say. The light themes need a different answer entirely - see
+   the rule below. */
 .jp-AiAssistantsPanel-dotGlyph {
   fill: var(--jp-success-color1);
 }
 
+/* Light themes take a different dot, because both halves of the one above stop
+   working there. JupyterLab stamps the theme's own `isLight` onto the body, so
+   the switch is CSS and no TypeScript sees it.
+
+   Fill - `--jp-success-color1` is a dark green on every light theme installed
+   (md-green-700 on JupyterLab Light, #27632a on the others), which is the
+   near-black mark the rule above rejects (DEF-PANE-175). md-green-500 is the
+   green the dark themes already carry, defined on `:root` by JupyterLab's own
+   materialcolors.css, so no fallback copy belongs here.
+
+   Glow - a mint ring, md-green-200, three passes at 2px. The dot's own green
+   would separate nothing from the dot, and white was tried and rejected on
+   sight (DEF-PANE-201): on the mid-grey rows the installed light themes draw
+   (#bec3ca, #c0c0c0) a white ring reads as a bright blob, not a light. A pale
+   green three steps lighter than the fill reads as the fill's own glow instead.
+   Three passes because drop-shadow spreads its alpha over the blur, so one
+   pass stays faint; 2px because at 1px the ring is barely wider than the
+   circle's anti-aliasing and at 3px stacked deeper it washes over the first
+   letter of the name. Size and shade chosen from rendered candidates on the
+   live row (2026-09-07). Stated plainly: no pale halo reaches WCAG 1.4.11's
+   3:1 on those rows - pure white against #bec3ca is 1.77:1, the ceiling - and
+   the dark contour that would was rejected on sight (DEF-PANE-185). */
+body[data-jp-theme-light='true'] .jp-AiAssistantsPanel-dot {
+  filter: drop-shadow(0 0 2px var(--md-green-200))
+    drop-shadow(0 0 2px var(--md-green-200))
+    drop-shadow(0 0 2px var(--md-green-200));
+}
+
+body[data-jp-theme-light='true'] .jp-AiAssistantsPanel-dotGlyph {
+  fill: var(--md-green-500);
+}
+
 .jp-AiAssistantsPanel-dotPlaceholder {
   background-color: transparent;
 }