xtralab 0.11.0 → 0.12.0

package/lib/launcher/dashboard.d.ts

@@ -1,5 +1,6 @@
 import * as React from 'react';
 import type { CommandRegistry } from '@lumino/commands';
+import type { TranslationBundle } from '@jupyterlab/translation';
 import { ReactWidget } from '@jupyterlab/ui-components';
 import type { Widget } from '@lumino/widgets';
 import type { IAgentSessions } from '../agentSessions';
@@ -12,7 +13,7 @@ import type { IEditor } from './editors';
  * tab for the freshly created terminal). Keeping it as an opaque
  * callback means the widget itself does not import `app.shell`.
  */
-export interface ILauncherDashboardOptions {
+interface ILauncherDashboardOptions {
     commands: CommandRegistry;
     /**
      * The agent list to render. Already filtered by availability + sorted by
@@ -48,6 +49,11 @@ export interface ILauncherDashboardOptions {
      * Empty string lets the terminal extension default to the server root.
      */
     cwd: string;
+    /**
+     * The translation bundle used to localize the dashboard's user-facing
+     * strings.
+     */
+    trans: TranslationBundle;
 }
 /**
  * Lumino host for the React-based launcher dashboard. Mirrors the
@@ -59,3 +65,4 @@ export declare class LauncherDashboard extends ReactWidget {
     protected render(): React.ReactElement;
     private _options;
 }
+export {};

package/lib/launcher/dashboard.js

@@ -33,7 +33,7 @@ const CHANGES_POLL_INTERVAL_MS = 8000;
  */
 const CHANGES_POLL_MAX_MS = 300000;
 function LauncherDashboardComponent(props) {
-    const { commands, agents, editor, agentSessions, onAgentLaunch, repoPath, cwd } = props;
+    const { commands, agents, editor, agentSessions, onAgentLaunch, repoPath, cwd, trans } = props;
     const [prompt, setPrompt] = React.useState('');
     const [git, setGit] = React.useState({
         loading: true,
@@ -145,13 +145,13 @@ function LauncherDashboardComponent(props) {
         void commands.execute(GitCommandIDs.openDiff, args);
     }, [commands, repoPath]);
     return (React.createElement("div", { className: "jp-xtralab-Launcher-body" },
-        React.createElement(AgentSection, { agents: agents, prompt: prompt, onPromptChange: setPrompt, onLaunch: launch }),
-        React.createElement(McpSection, { agents: agents }),
-        React.createElement(OpenSection, { editor: editor, onLaunchTerminal: launchTerminal, onLaunchNotebook: launchNotebook, onLaunchConsole: launchConsole, onLaunchEditor: launchEditor }),
-        React.createElement(ChangesSection, { git: git, onOpen: openDiff, onRefresh: () => void refresh() })));
+        React.createElement(AgentSection, { agents: agents, prompt: prompt, onPromptChange: setPrompt, onLaunch: launch, trans: trans }),
+        React.createElement(McpSection, { agents: agents, trans: trans }),
+        React.createElement(OpenSection, { editor: editor, onLaunchTerminal: launchTerminal, onLaunchNotebook: launchNotebook, onLaunchConsole: launchConsole, onLaunchEditor: launchEditor, trans: trans }),
+        React.createElement(ChangesSection, { git: git, onOpen: openDiff, onRefresh: () => void refresh(), trans: trans })));
 }
 function ChangesSection(props) {
-    const { git, onOpen, onRefresh } = props;
+    const { git, onOpen, onRefresh, trans } = props;
     const files = git.result ? expandStatusFiles(git.result.files) : [];
     // Native `<details>` rather than a hand-rolled toggle: we get the
     // disclosure triangle, keyboard handling, and aria-expanded semantics
@@ -159,9 +159,9 @@ function ChangesSection(props) {
     // we don't need to persist.
     return (React.createElement("details", { className: "jp-xtralab-Launcher-section jp-xtralab-Launcher-changes-section", open: true },
         React.createElement("summary", { className: "jp-xtralab-Launcher-section-summary" },
-            React.createElement("span", { className: "jp-xtralab-Launcher-section-title" }, "Changes"),
-            files.length > 0 && (React.createElement("span", { className: "jp-xtralab-Launcher-section-count", "aria-label": `${files.length} changed file${files.length === 1 ? '' : 's'}` }, files.length)),
-            React.createElement("button", { type: "button", className: "jp-xtralab-Launcher-section-action", "aria-label": "Refresh changes", 
+            React.createElement("span", { className: "jp-xtralab-Launcher-section-title" }, trans.__('Changes')),
+            files.length > 0 && (React.createElement("span", { className: "jp-xtralab-Launcher-section-count", "aria-label": trans._n('%1 changed file', '%1 changed files', files.length) }, files.length)),
+            React.createElement("button", { type: "button", className: "jp-xtralab-Launcher-section-action", "aria-label": trans.__('Refresh changes'), 
                 // Stop the click from toggling the surrounding `<details>` —
                 // refreshing while the section is open shouldn't collapse it.
                 onClick: event => {
@@ -171,14 +171,14 @@ function ChangesSection(props) {
                 } },
                 React.createElement(LabIcon.resolveReact, { icon: refreshIcon, tag: "span" }))),
         React.createElement("div", { className: "jp-xtralab-Launcher-section-body" },
-            git.loading && files.length === 0 && (React.createElement("p", { className: "jp-xtralab-Launcher-empty" }, "Loading\u2026")),
+            git.loading && files.length === 0 && (React.createElement("p", { className: "jp-xtralab-Launcher-empty" }, trans.__('Loading…'))),
             !git.loading && git.error !== null && (React.createElement("p", { className: "jp-xtralab-Launcher-empty" }, git.error)),
-            !git.loading && git.error === null && files.length === 0 && (React.createElement("p", { className: "jp-xtralab-Launcher-empty" }, "No changes.")),
+            !git.loading && git.error === null && files.length === 0 && (React.createElement("p", { className: "jp-xtralab-Launcher-empty" }, trans.__('No changes.'))),
             files.length > 0 && (React.createElement("ul", { className: "jp-xtralab-Launcher-changes" }, files.map((change, index) => (React.createElement("li", { key: `${change.group}:${change.path}:${index}` },
-                React.createElement("button", { type: "button", className: "jp-xtralab-Launcher-change", onClick: () => onOpen(change), title: `Open diff for ${change.path}` },
+                React.createElement("button", { type: "button", className: "jp-xtralab-Launcher-change", onClick: () => onOpen(change), title: trans.__('Open diff for %1', change.path) },
                     React.createElement("span", { className: `jp-xtralab-Launcher-change-badge jp-xtralab-Launcher-change-${change.status}`, "aria-hidden": "true" }, statusBadge(change.status)),
                     React.createElement("span", { className: "jp-xtralab-Launcher-change-path" }, change.path),
-                    React.createElement("span", { className: "jp-xtralab-Launcher-change-group", "aria-hidden": "true" }, change.group === 'staged' ? 'staged' : ''))))))))));
+                    React.createElement("span", { className: "jp-xtralab-Launcher-change-group", "aria-hidden": "true" }, change.group === 'staged' ? trans.__('staged') : ''))))))))));
 }
 function statusBadge(status) {
     switch (status) {
@@ -202,7 +202,7 @@ function statusBadge(status) {
 }
 function AgentSection(props) {
     var _a;
-    const { agents, prompt, onPromptChange, onLaunch } = props;
+    const { agents, prompt, onPromptChange, onLaunch, trans } = props;
     const trimmed = prompt.trim();
     const promptActive = trimmed.length > 0;
     // The first prompt-capable agent is what Cmd/Ctrl+Enter fires; the hint
@@ -211,8 +211,8 @@ function AgentSection(props) {
     const primaryAgent = agents.find(agent => agent.promptArgs !== undefined);
     const hintId = 'jp-xtralab-Launcher-agent-hint';
     return (React.createElement("section", { className: "jp-xtralab-Launcher-section" },
-        React.createElement("h2", { className: "jp-xtralab-Launcher-section-title" }, "Start an agent"),
-        React.createElement("textarea", { className: "jp-xtralab-Launcher-prompt", placeholder: "Initial prompt (optional) \u2014 passed to the selected agent.", value: prompt, spellCheck: false, rows: 3, onChange: event => onPromptChange(event.target.value), onKeyDown: event => {
+        React.createElement("h2", { className: "jp-xtralab-Launcher-section-title" }, trans.__('Start an agent')),
+        React.createElement("textarea", { className: "jp-xtralab-Launcher-prompt", placeholder: trans.__('Initial prompt (optional) — passed to the selected agent.'), value: prompt, spellCheck: false, rows: 3, onChange: event => onPromptChange(event.target.value), onKeyDown: event => {
                 if (event.key === 'Enter' &&
                     (event.metaKey || event.ctrlKey) &&
                     trimmed.length > 0 &&
@@ -222,13 +222,13 @@ function AgentSection(props) {
                 }
             } }),
         React.createElement("p", { id: hintId, className: "jp-xtralab-Launcher-agent-hint", "aria-live": "polite" }, promptActive
-            ? `Cmd/Ctrl+Enter launches ${(_a = primaryAgent === null || primaryAgent === void 0 ? void 0 : primaryAgent.label) !== null && _a !== void 0 ? _a : 'the first prompt-capable agent'}. Agents that don't accept an initial prompt are dimmed.`
-            : 'Type a prompt to send it to the chosen agent. Some agents only launch without a prompt.'),
+            ? trans.__("Cmd/Ctrl+Enter launches %1. Agents that don't accept an initial prompt are dimmed.", (_a = primaryAgent === null || primaryAgent === void 0 ? void 0 : primaryAgent.label) !== null && _a !== void 0 ? _a : trans.__('the first prompt-capable agent'))
+            : trans.__('Type a prompt to send it to the chosen agent. Some agents only launch without a prompt.')),
         React.createElement("div", { className: "jp-xtralab-Launcher-agents" }, agents.map(agent => {
             const supportsPrompt = agent.promptArgs !== undefined;
             const disabled = promptActive && !supportsPrompt;
             const tooltip = disabled
-                ? `${agent.label} doesn't accept an initial prompt — clear the prompt to launch.`
+                ? trans.__("%1 doesn't accept an initial prompt — clear the prompt to launch.", agent.label)
                 : agent.caption;
             return (React.createElement("button", { key: agent.id, type: "button", className: "jp-xtralab-Launcher-agent", title: tooltip, "aria-label": agent.label, "aria-describedby": hintId, disabled: disabled, onClick: () => onLaunch(agent) },
                 React.createElement(LabIcon.resolveReact, { icon: agent.icon, tag: "span", className: "jp-xtralab-Launcher-agent-icon" }),
@@ -242,7 +242,9 @@ function AgentSection(props) {
  * there is no one-line command to surface for them.
  */
 const MCP_ADD_AGENT_IDS = new Set(['claude', 'codex', 'copilot']);
-/** The stdio proxy console script that bridges an agent to the MCP server. */
+/**
+ * The stdio proxy console script that bridges an agent to the MCP server.
+ */
 const MCP_PROXY_COMMAND = 'jupyter-server-mcp-proxy';
 /**
  * Copy `text` to the clipboard via a hidden, selected `<textarea>` and the
@@ -279,6 +281,7 @@ function legacyCopy(text) {
  * of those agents are on `$PATH`.
  */
 function McpSection(props) {
+    const { trans } = props;
     const [copiedId, setCopiedId] = React.useState(null);
     const registerable = props.agents.filter(agent => MCP_ADD_AGENT_IDS.has(agent.id));
     if (registerable.length === 0) {
@@ -306,22 +309,25 @@ function McpSection(props) {
     };
     return (React.createElement("details", { className: "jp-xtralab-Launcher-section jp-xtralab-Launcher-mcp-section" },
         React.createElement("summary", { className: "jp-xtralab-Launcher-section-summary" },
-            React.createElement("span", { className: "jp-xtralab-Launcher-section-title" }, "Connect agents to JupyterLab (MCP)")),
+            React.createElement("span", { className: "jp-xtralab-Launcher-section-title" }, trans.__('Connect agents to JupyterLab (MCP)'))),
         React.createElement("div", { className: "jp-xtralab-Launcher-section-body" },
-            React.createElement("p", { className: "jp-xtralab-Launcher-agent-hint" }, "Run once per agent to let it drive this JupyterLab over MCP. No port needed \u2014 the proxy finds this server on its own."),
+            React.createElement("p", { className: "jp-xtralab-Launcher-agent-hint" }, trans.__('Run once per agent to let it drive this JupyterLab over MCP. No port needed — the proxy finds this server on its own.')),
             React.createElement("ul", { className: "jp-xtralab-Launcher-mcp-list" }, registerable.map(agent => {
                 const command = `${agent.command} mcp add jupyter -- ${MCP_PROXY_COMMAND}`;
                 return (React.createElement("li", { key: agent.id, className: "jp-xtralab-Launcher-mcp-item" },
                     React.createElement("code", { className: "jp-xtralab-Launcher-mcp-command" }, command),
                     React.createElement("button", { type: "button", className: copiedId === agent.id
                             ? 'jp-xtralab-Launcher-mcp-copy jp-mod-copied'
-                            : 'jp-xtralab-Launcher-mcp-copy', "aria-label": `Copy the ${agent.label} command`, onClick: () => copy(command, agent.id) }, copiedId === agent.id ? 'Copied!' : 'Copy')));
+                            : 'jp-xtralab-Launcher-mcp-copy', "aria-label": trans.__('Copy the %1 command', agent.label), onClick: () => copy(command, agent.id) }, copiedId === agent.id
+                        ? trans.__('Copied!')
+                        : trans.__('Copy'))));
             })),
             React.createElement("p", { className: "jp-xtralab-Launcher-mcp-note" },
-                "Other agents (Goose, OpenCode, Kiro, Mistral Vibe, Antigravity) register MCP through their own config \u2014 point them at the same",
+                trans.__('Other agents (Goose, OpenCode, Kiro, Mistral Vibe, Antigravity) register MCP through their own config — point them at the same'),
                 ' ',
                 React.createElement("code", null, MCP_PROXY_COMMAND),
-                " command."))));
+                " ",
+                trans.__('command.')))));
 }
 /**
  * The non-agent launch tiles — a plain terminal, a new notebook, and a
@@ -336,19 +342,19 @@ function McpSection(props) {
  * renders.
  */
 function OpenSection(props) {
-    const { editor, onLaunchTerminal, onLaunchNotebook, onLaunchConsole, onLaunchEditor } = props;
+    const { editor, onLaunchTerminal, onLaunchNotebook, onLaunchConsole, onLaunchEditor, trans } = props;
     return (React.createElement("section", { className: "jp-xtralab-Launcher-section" },
-        React.createElement("h2", { className: "jp-xtralab-Launcher-section-title" }, "Open"),
+        React.createElement("h2", { className: "jp-xtralab-Launcher-section-title" }, trans.__('Open')),
         React.createElement("div", { className: "jp-xtralab-Launcher-agents" },
-            React.createElement("button", { type: "button", className: "jp-xtralab-Launcher-agent", title: "Open a new terminal.", "aria-label": "Open a new terminal", onClick: onLaunchTerminal },
+            React.createElement("button", { type: "button", className: "jp-xtralab-Launcher-agent", title: trans.__('Open a new terminal.'), "aria-label": trans.__('Open a new terminal'), onClick: onLaunchTerminal },
                 React.createElement(LabIcon.resolveReact, { icon: terminalIcon, tag: "span", className: "jp-xtralab-Launcher-agent-icon" }),
-                React.createElement("span", { className: "jp-xtralab-Launcher-agent-label" }, "Terminal")),
-            React.createElement("button", { type: "button", className: "jp-xtralab-Launcher-agent", title: "Create a new notebook.", "aria-label": "Create a new notebook", onClick: onLaunchNotebook },
+                React.createElement("span", { className: "jp-xtralab-Launcher-agent-label" }, trans.__('Terminal'))),
+            React.createElement("button", { type: "button", className: "jp-xtralab-Launcher-agent", title: trans.__('Create a new notebook.'), "aria-label": trans.__('Create a new notebook'), onClick: onLaunchNotebook },
                 React.createElement(LabIcon.resolveReact, { icon: notebookIcon, tag: "span", className: "jp-xtralab-Launcher-agent-icon" }),
-                React.createElement("span", { className: "jp-xtralab-Launcher-agent-label" }, "Notebook")),
-            React.createElement("button", { type: "button", className: "jp-xtralab-Launcher-agent", title: "Create a new console.", "aria-label": "Create a new console", onClick: onLaunchConsole },
+                React.createElement("span", { className: "jp-xtralab-Launcher-agent-label" }, trans.__('Notebook'))),
+            React.createElement("button", { type: "button", className: "jp-xtralab-Launcher-agent", title: trans.__('Create a new console.'), "aria-label": trans.__('Create a new console'), onClick: onLaunchConsole },
                 React.createElement(LabIcon.resolveReact, { icon: consoleIcon, tag: "span", className: "jp-xtralab-Launcher-agent-icon" }),
-                React.createElement("span", { className: "jp-xtralab-Launcher-agent-label" }, "Console")),
+                React.createElement("span", { className: "jp-xtralab-Launcher-agent-label" }, trans.__('Console'))),
             editor && (React.createElement("button", { type: "button", className: "jp-xtralab-Launcher-agent", title: editor.caption, "aria-label": editor.caption, onClick: onLaunchEditor },
                 React.createElement(LabIcon.resolveReact, { icon: editor.icon, tag: "span", className: "jp-xtralab-Launcher-agent-icon" }),
                 React.createElement("span", { className: "jp-xtralab-Launcher-agent-label" }, editor.label))))));

package/lib/launcher/editorRegistry.js

@@ -29,7 +29,9 @@ class EditorRegistry {
     get changed() {
         return this._changed;
     }
-    /** Replace both lists (recomputed together) and notify observers. */
+    /**
+     * Replace both lists (recomputed together) and notify observers.
+     */
     set(editors, current) {
         this._editors = editors;
         this._current = current;
@@ -57,9 +59,9 @@ export const editorRegistryPlugin = {
             // Probe only the editors that opt into the availability check; entries
             // with `requireAvailable: false` (e.g. a shell alias) are shown
             // regardless and don't need a `which` lookup.
-            const probe = editors
+            const probe = Array.from(new Set(editors
                 .filter(editor => editor.requireAvailable)
-                .map(editor => editor.command);
+                .map(editor => editor.command)));
             const available = await fetchAvailableCommands(probe);
             registry.set(editors, resolveEditor(editors, available));
         };

package/lib/launcher/editors.d.ts

@@ -7,15 +7,25 @@ import { LabIcon } from '@jupyterlab/ui-components';
  * the terminals panel to badge running editors.
  */
 export interface IEditor {
-    /** Stable id; also the default `$PATH` command probed for availability. */
+    /**
+     * Stable id; also the default `$PATH` command probed for availability.
+     */
     id: string;
-    /** Tile label, e.g. "Neovim". */
+    /**
+     * Tile label, e.g. "Neovim".
+     */
     label: string;
-    /** Tile tooltip. */
+    /**
+     * Tile tooltip.
+     */
     caption: string;
-    /** The literal command typed into the new terminal, e.g. `nvim`. */
+    /**
+     * The literal command typed into the new terminal, e.g. `nvim`.
+     */
     command: string;
-    /** Brand icon for the tile. */
+    /**
+     * Brand icon for the tile.
+     */
     icon: LabIcon;
     /**
      * Preference order for the single launcher tile: the first candidate, by
@@ -53,7 +63,12 @@ export interface IEditorSettings {
      * the editor tile entirely. Defaults to true.
      */
     enabled?: boolean;
-    /** See {@link IEditor.requireAvailable}. */
+    /**
+     * See {@link IEditor.requireAvailable}. Defaults to true for a built-in
+     * editor that still uses its shipped command, and to false once you override
+     * the `command` (a user-chosen command — often a shell alias — is trusted and
+     * always shown). Set it explicitly to force the check on or off.
+     */
     requireAvailable?: boolean;
 }
 /**
@@ -69,7 +84,9 @@ export declare function defaultEditorSettings(): IEditorSettings[];
  * entries keep their fields unless explicitly overridden; user-only entries are
  * appended. `enabled: false` filters an entry out of the result entirely (so
  * callers don't need to re-check the flag). The result is sorted by rank, which
- * is also the launcher's tile-preference order. Mirrors `mergeAgents`.
+ * is also the launcher's tile-preference order. Mirrors `mergeAgents`, including
+ * turning `requireAvailable` off when the user overrides a built-in's `command`
+ * so an aliased editor still shows.
  */
 export declare function mergeEditors(overrides: IEditorSettings[]): IEditor[];
 /**

package/lib/launcher/editors.js

@@ -58,7 +58,9 @@ function resolveEditorIcon(id, iconSvg) {
  * entries keep their fields unless explicitly overridden; user-only entries are
  * appended. `enabled: false` filters an entry out of the result entirely (so
  * callers don't need to re-check the flag). The result is sorted by rank, which
- * is also the launcher's tile-preference order. Mirrors `mergeAgents`.
+ * is also the launcher's tile-preference order. Mirrors `mergeAgents`, including
+ * turning `requireAvailable` off when the user overrides a built-in's `command`
+ * so an aliased editor still shows.
  */
 export function mergeEditors(overrides) {
     var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
@@ -74,16 +76,23 @@ export function mergeEditors(overrides) {
         if (override.enabled === false) {
             continue;
         }
+        const command = (_a = override.command) !== null && _a !== void 0 ? _a : base.command;
         merged.push({
             id: base.id,
-            label: (_a = override.label) !== null && _a !== void 0 ? _a : base.label,
-            caption: (_b = override.caption) !== null && _b !== void 0 ? _b : base.caption,
-            command: (_c = override.command) !== null && _c !== void 0 ? _c : base.command,
+            label: (_b = override.label) !== null && _b !== void 0 ? _b : base.label,
+            caption: (_c = override.caption) !== null && _c !== void 0 ? _c : base.caption,
+            command,
             icon: override.iconSvg
                 ? resolveEditorIcon(base.id, override.iconSvg)
                 : base.icon,
             rank: (_d = override.rank) !== null && _d !== void 0 ? _d : base.rank,
-            requireAvailable: (_e = override.requireAvailable) !== null && _e !== void 0 ? _e : base.requireAvailable
+            // See `mergeAgents`: once the user points a built-in editor at their own
+            // command (e.g. a shell alias `which` can't resolve), stop requiring
+            // availability so the tile still shows. The check stays on only while the
+            // command is xtralab's default.
+            requireAvailable: command === base.command
+                ? ((_e = override.requireAvailable) !== null && _e !== void 0 ? _e : base.requireAvailable)
+                : false
         });
     }
     // What remains in `overrideById` are ids that don't match a built-in — treat

package/lib/launcher/icons.d.ts

@@ -1,41 +1,4 @@
 import { LabIcon } from '@jupyterlab/ui-components';
-/**
- * Brand icons for the agent launcher cards. Most marks are taken verbatim
- * from `jupyter-ai-contrib/jupyter-ai-acp-client`
- * (`jupyter_ai_acp_client/static/*.svg`, BSD-3-Clause); Antigravity post-dates
- * that set, so its mark is the official glyph from `@lobehub/icons-static-svg`
- * (MIT) — we ship the brand-colored `antigravity-color` variant so Antigravity
- * reads as a multi-color Google mark, occupying the slot the Gemini icon used
- * to fill before the upstream Gemini CLI sunset. Small adjustments are applied
- * to play nicely with JupyterLab themes:
- *   - Monochrome marks (Codex, Copilot, Goose) use `currentColor` so they
- *     inherit the surrounding launcher card's text color rather than
- *     hard-coding black, which disappears on the dark theme.
- *   - The Goose mark upstream is rendered on a white rounded rect; we drop
- *     the rect so the silhouette can sit on the launcher card directly.
- *   - SVG ids that would collide if two copies of the same artwork ended up
- *     on the page (gradient/mask/filter defs) are namespaced under
- *     `xtralab-…`.
- *
- * Brand-colored icons (Antigravity, Claude, Kiro, Mistral Vibe, OpenCode) keep
- * their upstream colors; the dark/light contrast of the launcher card behind
- * them is the same as on `jupyter-ai-acp-client`.
- *
- * The Vim and Neovim marks belong to the launcher's "Open" editor tile rather
- * than the agent grid. They are the brand silhouettes from Simple Icons
- * (https://simpleicons.org, CC0), each filled with its brand green so the mark
- * reads on both the light and dark themes.
- */
-export declare const antigravityIcon: LabIcon;
-export declare const claudeIcon: LabIcon;
-export declare const codexIcon: LabIcon;
-export declare const copilotIcon: LabIcon;
-export declare const gooseIcon: LabIcon;
-export declare const kiroIcon: LabIcon;
-export declare const mistralVibeIcon: LabIcon;
-export declare const opencodeIcon: LabIcon;
-export declare const neovimIcon: LabIcon;
-export declare const vimIcon: LabIcon;
 /**
  * Built-in icons keyed by the agent's id, used to resolve the icon for an
  * agent declared without an inline `iconSvg` override (i.e. one of xtralab's

package/lib/launcher/icons.js

@@ -5,8 +5,7 @@ import { LabIcon } from '@jupyterlab/ui-components';
  * (`jupyter_ai_acp_client/static/*.svg`, BSD-3-Clause); Antigravity post-dates
  * that set, so its mark is the official glyph from `@lobehub/icons-static-svg`
  * (MIT) — we ship the brand-colored `antigravity-color` variant so Antigravity
- * reads as a multi-color Google mark, occupying the slot the Gemini icon used
- * to fill before the upstream Gemini CLI sunset. Small adjustments are applied
+ * reads as a multi-color Google mark. Small adjustments are applied
  * to play nicely with JupyterLab themes:
  *   - Monochrome marks (Codex, Copilot, Goose) use `currentColor` so they
  *     inherit the surrounding launcher card's text color rather than
@@ -26,7 +25,7 @@ import { LabIcon } from '@jupyterlab/ui-components';
  * (https://simpleicons.org, CC0), each filled with its brand green so the mark
  * reads on both the light and dark themes.
  */
-export const antigravityIcon = new LabIcon({
+const antigravityIcon = new LabIcon({
     name: 'xtralab:agent-antigravity',
     svgstr: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none">
   <mask id="xtralab-antigravity-mask" height="23" maskUnits="userSpaceOnUse" width="24" x="0" y="1">
@@ -104,26 +103,26 @@ export const antigravityIcon = new LabIcon({
   </defs>
 </svg>`
 });
-export const claudeIcon = new LabIcon({
+const claudeIcon = new LabIcon({
     name: 'xtralab:agent-claude',
     svgstr: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 1200">
   <path fill="#d97757" d="M 233.959793 800.214905 L 468.644287 668.536987 L 472.590637 657.100647 L 468.644287 650.738403 L 457.208069 650.738403 L 417.986633 648.322144 L 283.892639 644.69812 L 167.597321 639.865845 L 54.926208 633.825623 L 26.577238 627.785339 L 3.3e-05 592.751709 L 2.73832 575.27533 L 26.577238 559.248352 L 60.724873 562.228149 L 136.187973 567.382629 L 249.422867 575.194763 L 331.570496 580.026978 L 453.261841 592.671082 L 472.590637 592.671082 L 475.328857 584.859009 L 468.724915 580.026978 L 463.570557 575.194763 L 346.389313 495.785217 L 219.543671 411.865906 L 153.100723 363.543762 L 117.181267 339.060425 L 99.060455 316.107361 L 91.248367 266.01355 L 123.865784 230.093994 L 167.677887 233.073853 L 178.872513 236.053772 L 223.248367 270.201477 L 318.040283 343.570496 L 441.825592 434.738342 L 459.946411 449.798706 L 467.194672 444.64447 L 468.080597 441.020203 L 459.946411 427.409485 L 392.617493 305.718323 L 320.778564 181.932983 L 288.80542 130.630859 L 280.348999 99.865845 C 277.369171 87.221436 275.194641 76.590698 275.194641 63.624268 L 312.322174 13.20813 L 332.8591 6.604126 L 382.389313 13.20813 L 403.248352 31.328979 L 434.013519 101.71814 L 483.865753 212.537048 L 561.181274 363.221497 L 583.812134 407.919434 L 595.892639 449.315491 L 600.40271 461.959839 L 608.214783 461.959839 L 608.214783 454.711609 L 614.577271 369.825623 L 626.335632 265.61084 L 637.771851 131.516846 L 641.718201 93.745117 L 660.402832 48.483276 L 697.530334 24.000122 L 726.52356 37.852417 L 750.362549 72 L 747.060486 94.067139 L 732.886047 186.201416 L 705.100708 330.52356 L 686.979919 427.167847 L 697.530334 427.167847 L 709.61084 415.087341 L 758.496704 350.174561 L 840.644348 247.490051 L 876.885925 206.738342 L 919.167847 161.71814 L 946.308838 140.29541 L 997.61084 140.29541 L 1035.38269 196.429626 L 1018.469849 254.416199 L 965.637634 321.422852 L 921.825562 378.201538 L 859.006714 462.765259 L 819.785278 530.41626 L 823.409424 535.812073 L 832.75177 534.92627 L 974.657776 504.724915 L 1051.328979 490.872559 L 1142.818848 475.167786 L 1184.214844 494.496582 L 1188.724854 514.147644 L 1172.456421 554.335693 L 1074.604126 578.496765 L 959.838989 601.449829 L 788.939636 641.879272 L 786.845764 643.409485 L 789.261841 646.389343 L 866.255127 653.637634 L 899.194702 655.409424 L 979.812134 655.409424 L 1129.932861 666.604187 L 1169.154419 692.537109 L 1192.671265 724.268677 L 1188.724854 748.429688 L 1128.322144 779.194641 L 1046.818848 759.865845 L 856.590759 714.604126 L 791.355774 698.335754 L 782.335693 698.335754 L 782.335693 703.731567 L 836.69812 756.885986 L 936.322205 846.845581 L 1061.073975 962.81897 L 1067.436279 991.490112 L 1051.409424 1014.120911 L 1034.496704 1011.704712 L 924.885986 929.234924 L 882.604126 892.107544 L 786.845764 811.48999 L 780.483276 811.48999 L 780.483276 819.946289 L 802.550415 852.241699 L 919.087341 1027.409424 L 925.127625 1081.127686 L 916.671204 1098.604126 L 886.469849 1109.154419 L 853.288696 1103.114136 L 785.073914 1007.355835 L 714.684631 899.516785 L 657.906067 802.872498 L 650.979858 806.81897 L 617.476624 1167.704834 L 601.771851 1186.147705 L 565.530212 1200 L 535.328857 1177.046997 L 519.302124 1139.919556 L 535.328857 1066.550537 L 554.657776 970.792053 L 570.362488 894.68457 L 584.536926 800.134277 L 592.993347 768.724976 L 592.429626 766.630859 L 585.503479 767.516968 L 514.22821 865.369263 L 405.825531 1011.865906 L 320.053711 1103.677979 L 299.516815 1111.812256 L 263.919525 1093.369263 L 267.221497 1060.429688 L 287.114136 1031.114136 L 405.825531 880.107361 L 477.422913 786.52356 L 523.651062 732.483276 L 523.328918 724.671265 L 520.590698 724.671265 L 205.288605 929.395935 L 149.154434 936.644409 L 124.993355 914.01355 L 127.973183 876.885986 L 139.409409 864.80542 L 234.201385 799.570435 L 233.879227 799.8927 Z"/>
 </svg>`
 });
-export const codexIcon = new LabIcon({
+const codexIcon = new LabIcon({
     name: 'xtralab:agent-codex',
     svgstr: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32" fill="none">
   <path stroke="currentColor" stroke-linecap="round" stroke-width="2.484" d="M22.356 19.797H17.17M9.662 12.29l1.979 3.576a.511.511 0 0 1-.005.504l-1.974 3.409M30.758 16c0 8.15-6.607 14.758-14.758 14.758-8.15 0-14.758-6.607-14.758-14.758C1.242 7.85 7.85 1.242 16 1.242c8.15 0 14.758 6.608 14.758 14.758Z"/>
 </svg>`
 });
-export const copilotIcon = new LabIcon({
+const copilotIcon = new LabIcon({
     name: 'xtralab:agent-copilot',
     svgstr: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" fill="currentColor">
   <path d="M7.998 15.035c-4.562 0-7.873-2.914-7.998-3.749V9.338c.085-.628.677-1.686 1.588-2.065.013-.07.024-.143.036-.218.029-.183.06-.384.126-.612-.201-.508-.254-1.084-.254-1.656 0-.87.128-1.769.693-2.484.579-.733 1.494-1.124 2.724-1.261 1.206-.134 2.262.034 2.944.765.05.053.096.108.139.165.044-.057.094-.112.143-.165.682-.731 1.738-.899 2.944-.765 1.23.137 2.145.528 2.724 1.261.566.715.693 1.614.693 2.484 0 .572-.053 1.148-.254 1.656.066.228.098.429.126.612.012.076.024.148.037.218.924.385 1.522 1.471 1.591 2.095v1.872c0 .766-3.351 3.795-8.002 3.795Zm0-1.485c2.28 0 4.584-1.11 5.002-1.433V7.862l-.023-.116c-.49.21-1.075.291-1.727.291-1.146 0-2.059-.327-2.71-.991A3.222 3.222 0 0 1 8 6.303a3.24 3.24 0 0 1-.544.743c-.65.664-1.563.991-2.71.991-.652 0-1.236-.081-1.727-.291l-.023.116v4.255c.419.323 2.722 1.433 5.002 1.433ZM6.762 2.83c-.193-.206-.637-.413-1.682-.297-1.019.113-1.479.404-1.713.7-.247.312-.369.789-.369 1.554 0 .793.129 1.171.308 1.371.162.181.519.379 1.442.379.853 0 1.339-.235 1.638-.54.315-.322.527-.827.617-1.553.117-.935-.037-1.395-.241-1.614Zm4.155-.297c-1.044-.116-1.488.091-1.681.297-.204.219-.359.679-.242 1.614.091.726.303 1.231.618 1.553.299.305.784.54 1.638.54.922 0 1.28-.198 1.442-.379.179-.2.308-.578.308-1.371 0-.765-.123-1.242-.37-1.554-.233-.296-.693-.587-1.713-.7Z"/>
   <path d="M6.25 9.037a.75.75 0 0 1 .75.75v1.501a.75.75 0 0 1-1.5 0V9.787a.75.75 0 0 1 .75-.75Zm4.25.75v1.501a.75.75 0 0 1-1.5 0V9.787a.75.75 0 0 1 1.5 0Z"/>
 </svg>`
 });
-export const gooseIcon = new LabIcon({
+const gooseIcon = new LabIcon({
     name: 'xtralab:agent-goose',
     svgstr: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 2048 2048">
   <g transform="translate(128, 94) scale(3)" fill="currentColor">
@@ -131,7 +130,7 @@ export const gooseIcon = new LabIcon({
   </g>
 </svg>`
 });
-export const kiroIcon = new LabIcon({
+const kiroIcon = new LabIcon({
     name: 'xtralab:agent-kiro',
     svgstr: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 1200" fill="none">
   <rect width="1200" height="1200" rx="260" fill="#9046FF"/>
@@ -145,7 +144,7 @@ export const kiroIcon = new LabIcon({
   </g>
 </svg>`
 });
-export const mistralVibeIcon = new LabIcon({
+const mistralVibeIcon = new LabIcon({
     name: 'xtralab:agent-mistral-vibe',
     svgstr: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256" fill="none">
   <g transform="translate(48 71) scale(0.84)">
@@ -162,7 +161,7 @@ export const mistralVibeIcon = new LabIcon({
   </g>
 </svg>`
 });
-export const opencodeIcon = new LabIcon({
+const opencodeIcon = new LabIcon({
     name: 'xtralab:agent-opencode',
     svgstr: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" fill="none">
   <rect width="512" height="512" fill="#131010"/>
@@ -170,13 +169,13 @@ export const opencodeIcon = new LabIcon({
   <path fill-rule="evenodd" clip-rule="evenodd" d="M384 416H128V96H384V416ZM320 160H192V352H320V160Z" fill="white"/>
 </svg>`
 });
-export const neovimIcon = new LabIcon({
+const neovimIcon = new LabIcon({
     name: 'xtralab:editor-neovim',
     svgstr: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="#57A143">
   <path d="M2.214 4.954v13.615L7.655 24V10.314L3.312 3.845 2.214 4.954zm4.999 17.98l-4.557-4.548V5.136l.59-.596 3.967 5.908v12.485zm14.573-4.457l-.862.937-4.24-6.376V0l5.068 5.092.034 13.385zM7.431.001l12.998 19.835-3.637 3.637L3.787 3.683 7.43 0z"/>
 </svg>`
 });
-export const vimIcon = new LabIcon({
+const vimIcon = new LabIcon({
     name: 'xtralab:editor-vim',
     svgstr: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="#019733">
   <path d="M24 11.986h-.027l-4.318-4.318 4.303-4.414V1.461l-.649-.648h-8.198l-.66.605v1.045L12.015.027V0L12 .014 11.986 0v.027l-1.29 1.291-.538-.539H2.035l-.638.692v1.885l.616.616h.72v5.31L.027 11.987H0L.014 12 0 12.014h.027l2.706 2.706v6.467l.907.523h2.322l1.857-1.904 4.166 4.166V24l.015-.014.014.014v-.028l2.51-2.509h.485c.111 0 .211-.07.25-.179l.146-.426c.028-.084.012-.172-.037-.239l1.462-1.462-.612 1.962c-.043.141.036.289.177.332.025.008.052.012.078.012h1.824c.106-.001.201-.064.243-.163l.165-.394c.025-.065.024-.138-.004-.203-.027-.065-.08-.116-.146-.142-.029-.012-.062-.019-.097-.02h-.075l.84-2.644h1.232l-1.016 3.221c-.043.141.036.289.176.332.025.008.052.012.079.012h2.002c.11 0 .207-.066.248-.17l.164-.428c.051-.138-.021-.29-.158-.341-.029-.011-.06-.017-.091-.017h-.145l1.131-3.673c.027-.082.012-.173-.039-.24l-.375-.504-.003-.005c-.051-.064-.127-.102-.209-.102h-1.436c-.071 0-.141.03-.19.081l-.4.439h-.624l-.042-.046 4.445-4.445H24L23.986 12l.014-.014zM9.838 21.139l1.579-4.509h-.501l.297-.304h1.659l-1.563 4.555h.623l-.079.258H9.838zm3.695-7.516l.15.151-.269.922-.225.226h-.969l-.181-.181.311-.871.288-.247h.895zM5.59 20.829H3.877l-.262-.15V3.091H2.379l-.1-.1V1.815l.143-.154h7.371l.213.214v1.108l-.142.173H8.785v8.688l8.807-8.688h-2.086l-.175-.188V1.805l.121-.111h7.49l.132.133v1.07L12.979 13.25h-.373c-.015-.001-.028 0-.042.001l-.02.003c-.045.01-.086.03-.119.06l-.343.295-.004.003c-.033.031-.059.069-.073.111l-.296.83-6.119 6.276zm14.768-3.952l.474-.519h1.334l.309.415-1.265 4.107h.493l-.08.209H19.84l1.124-3.564h-2.015l-1.077 3.391h.424l-.073.174h-1.605l1.107-3.548h-2.096l-1.062 3.339h.436l-.072.209H13.27l1.514-4.46H14.198l.091-.271h1.65l.519.537h.906l.491-.554h1.061l.489.535h.953z"/>

package/lib/launcher/index.js

@@ -27,7 +27,9 @@ const PLUGIN_ID = 'xtralab:launcher';
  * The agent list is the merge of xtralab's defaults with the user's
  * `xtralab:launcher` settings, then filtered by a server-side `which`
  * check so users only see agents that are actually installed. Agents with
- * `requireAvailable: false` (e.g. shell aliases) skip the filter.
+ * `requireAvailable: false` skip the filter, as does any built-in whose
+ * `command` the user has overridden (a user-chosen command — often a shell
+ * alias the server can't resolve — is trusted and always shown).
  *
  * The plugin deliberately does NOT provide the `ILauncher` token: other
  * extensions register notebook/console/terminal cards on it as a side
@@ -129,7 +131,8 @@ const plugin = {
                     // the git panel and the stock launcher: let the server resolve
                     // the working tree from its root directory.
                     repoPath: '',
-                    cwd: ''
+                    cwd: '',
+                    trans
                 });
                 launcher.title.icon = launcherIcon;
                 launcher.title.label = trans.__('Launcher');

package/lib/launcher/invocation.d.ts

@@ -1,19 +1,4 @@
 import type { IAgent } from './agents';
-/**
- * Quote a string so it can be safely passed as a single argument on a
- * bash/zsh command line that is *typed into an interactive terminal* —
- * not the usual file-parsing context.
- *
- * The distinction matters: an actual newline byte (0x0A) sent into a PTY
- * is interpreted by the line discipline as Enter regardless of whether
- * it sits inside `'...'` quotes, so the shell never sees the closing
- * quote. We therefore use ANSI-C `$'...'` quoting and emit `\n` (and
- * `\r`) as their two-character escape sequences; the shell expands them
- * to real newlines after the line is submitted, when readline is no
- * longer involved. Backslashes and single quotes are escaped first so
- * the source text round-trips unchanged.
- */
-export declare function shellQuote(value: string): string;
 /**
  * Compose the literal command line typed into a fresh terminal for `agent`.
  * When `prompt` is empty (or whitespace-only), this is just `agent.command`.

package/lib/launcher/invocation.js

@@ -12,7 +12,7 @@
  * longer involved. Backslashes and single quotes are escaped first so
  * the source text round-trips unchanged.
  */
-export function shellQuote(value) {
+function shellQuote(value) {
     const escaped = value
         .replace(/\\/g, '\\\\')
         .replace(/'/g, "\\'")

package/lib/launcher/schemaDefaults.d.ts

@@ -1,5 +1,7 @@
 import type { ISettingRegistry } from '@jupyterlab/settingregistry';
-/** Schema id the launcher's `agents`/`editors` settings live under. */
+/**
+ * Schema id the launcher's `agents`/`editors` settings live under.
+ */
 export declare const LAUNCHER_PLUGIN_ID = "xtralab:launcher";
 /**
  * Register a `fetch` transform that injects xtralab's built-in agent and

package/lib/launcher/schemaDefaults.js

@@ -1,6 +1,8 @@
 import { defaultAgentSettings } from './agents';
 import { defaultEditorSettings } from './editors';
-/** Schema id the launcher's `agents`/`editors` settings live under. */
+/**
+ * Schema id the launcher's `agents`/`editors` settings live under.
+ */
 export const LAUNCHER_PLUGIN_ID = 'xtralab:launcher';
 /**
  * Setting registries that already have the transform, so both callers skip

package/lib/mimeData.d.ts

@@ -0,0 +1,7 @@
+import type { ReadonlyPartialJSONValue } from '@lumino/coreutils';
+/**
+ * Parse a JSON-typed value that may have arrived as a string. Agents and the
+ * MCP bridge sometimes serialize a spec (e.g. a Vega-Lite object) to a string;
+ * for `application/...json` MIME types we accept either and parse the string.
+ */
+export declare function coerceData(mimeType: string, data: ReadonlyPartialJSONValue): ReadonlyPartialJSONValue;

package/lib/mimeData.js

@@ -0,0 +1,16 @@
+/**
+ * Parse a JSON-typed value that may have arrived as a string. Agents and the
+ * MCP bridge sometimes serialize a spec (e.g. a Vega-Lite object) to a string;
+ * for `application/...json` MIME types we accept either and parse the string.
+ */
+export function coerceData(mimeType, data) {
+    if (typeof data === 'string' && /\+?json$/.test(mimeType)) {
+        try {
+            return JSON.parse(data);
+        }
+        catch (_a) {
+            return data;
+        }
+    }
+    return data;
+}

package/lib/omnibox/index.d.ts

@@ -7,6 +7,10 @@ import { IOmnibox } from './tokens';
  * it in a fresh terminal through the launcher's `xtralab:start-agent:<id>`
  * commands). It is opened by the top-bar command bar.
  *
+ * Commands run and files opened through the overlay are remembered (persisted
+ * in the state database) and offered again at the top while the query is
+ * empty; the `maxNumberRecents` setting caps how many of each are kept.
+ *
  * The agent rows come from the launcher's `IAgentRegistry`; when the launcher
  * is disabled the omnibox still searches files and commands.
  */