xtralab 0.11.1 → 0.12.1

package/src/launcher/dashboard.tsx

@@ -4,6 +4,7 @@ import type { CommandRegistry } from '@lumino/commands';
 import type { ReadonlyPartialJSONObject } from '@lumino/coreutils';
 import { Poll } from '@lumino/polling';
 import type { IDocumentWidget } from '@jupyterlab/docregistry';
+import type { TranslationBundle } from '@jupyterlab/translation';
 import {
   LabIcon,
   ReactWidget,
@@ -38,7 +39,7 @@ import { agentCommandId } from './tokens';
  * 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
@@ -74,6 +75,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;
 }
 
 /**
@@ -125,7 +131,8 @@ function LauncherDashboardComponent(
     agentSessions,
     onAgentLaunch,
     repoPath,
-    cwd
+    cwd,
+    trans
   } = props;
   const [prompt, setPrompt] = React.useState('');
   const [git, setGit] = React.useState<IGitState>({
@@ -264,19 +271,22 @@ function LauncherDashboardComponent(
         prompt={prompt}
         onPromptChange={setPrompt}
         onLaunch={launch}
+        trans={trans}
       />
-      <McpSection agents={agents} />
+      <McpSection agents={agents} trans={trans} />
       <OpenSection
         editor={editor}
         onLaunchTerminal={launchTerminal}
         onLaunchNotebook={launchNotebook}
         onLaunchConsole={launchConsole}
         onLaunchEditor={launchEditor}
+        trans={trans}
       />
       <ChangesSection
         git={git}
         onOpen={openDiff}
         onRefresh={() => void refresh()}
+        trans={trans}
       />
     </div>
   );
@@ -286,8 +296,9 @@ function ChangesSection(props: {
   git: IGitState;
   onOpen: (change: IFileChange) => void;
   onRefresh: () => void;
+  trans: TranslationBundle;
 }): React.ReactElement {
-  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
@@ -300,11 +311,17 @@ function ChangesSection(props: {
       open
     >
       <summary className="jp-xtralab-Launcher-section-summary">
-        <span className="jp-xtralab-Launcher-section-title">Changes</span>
+        <span className="jp-xtralab-Launcher-section-title">
+          {trans.__('Changes')}
+        </span>
         {files.length > 0 && (
           <span
             className="jp-xtralab-Launcher-section-count"
-            aria-label={`${files.length} changed file${files.length === 1 ? '' : 's'}`}
+            aria-label={trans._n(
+              '%1 changed file',
+              '%1 changed files',
+              files.length
+            )}
           >
             {files.length}
           </span>
@@ -312,7 +329,7 @@ function ChangesSection(props: {
         <button
           type="button"
           className="jp-xtralab-Launcher-section-action"
-          aria-label="Refresh changes"
+          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 => {
@@ -326,13 +343,13 @@ function ChangesSection(props: {
       </summary>
       <div className="jp-xtralab-Launcher-section-body">
         {git.loading && files.length === 0 && (
-          <p className="jp-xtralab-Launcher-empty">Loading…</p>
+          <p className="jp-xtralab-Launcher-empty">{trans.__('Loading…')}</p>
         )}
         {!git.loading && git.error !== null && (
           <p className="jp-xtralab-Launcher-empty">{git.error}</p>
         )}
         {!git.loading && git.error === null && files.length === 0 && (
-          <p className="jp-xtralab-Launcher-empty">No changes.</p>
+          <p className="jp-xtralab-Launcher-empty">{trans.__('No changes.')}</p>
         )}
         {files.length > 0 && (
           <ul className="jp-xtralab-Launcher-changes">
@@ -342,7 +359,7 @@ function ChangesSection(props: {
                   type="button"
                   className="jp-xtralab-Launcher-change"
                   onClick={() => onOpen(change)}
-                  title={`Open diff for ${change.path}`}
+                  title={trans.__('Open diff for %1', change.path)}
                 >
                   <span
                     className={`jp-xtralab-Launcher-change-badge jp-xtralab-Launcher-change-${change.status}`}
@@ -357,7 +374,7 @@ function ChangesSection(props: {
                     className="jp-xtralab-Launcher-change-group"
                     aria-hidden="true"
                   >
-                    {change.group === 'staged' ? 'staged' : ''}
+                    {change.group === 'staged' ? trans.__('staged') : ''}
                   </span>
                 </button>
               </li>
@@ -395,8 +412,9 @@ function AgentSection(props: {
   prompt: string;
   onPromptChange: (value: string) => void;
   onLaunch: (agent: IAgent) => void;
+  trans: TranslationBundle;
 }): React.ReactElement {
-  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
@@ -407,10 +425,14 @@ function AgentSection(props: {
 
   return (
     <section className="jp-xtralab-Launcher-section">
-      <h2 className="jp-xtralab-Launcher-section-title">Start an agent</h2>
+      <h2 className="jp-xtralab-Launcher-section-title">
+        {trans.__('Start an agent')}
+      </h2>
       <textarea
         className="jp-xtralab-Launcher-prompt"
-        placeholder="Initial prompt (optional) — passed to the selected agent."
+        placeholder={trans.__(
+          'Initial prompt (optional) — passed to the selected agent.'
+        )}
         value={prompt}
         spellCheck={false}
         rows={3}
@@ -433,15 +455,23 @@ function AgentSection(props: {
         aria-live="polite"
       >
         {promptActive
-          ? `Cmd/Ctrl+Enter launches ${primaryAgent?.label ?? '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.",
+              primaryAgent?.label ?? trans.__('the first prompt-capable agent')
+            )
+          : trans.__(
+              'Type a prompt to send it to the chosen agent. Some agents only launch without a prompt.'
+            )}
       </p>
       <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 (
             <button
@@ -478,7 +508,9 @@ function AgentSection(props: {
  */
 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';
 
 /**
@@ -515,7 +547,11 @@ function legacyCopy(text: string): boolean {
  * proxy discover the server from its runtime file. Renders nothing when none
  * of those agents are on `$PATH`.
  */
-function McpSection(props: { agents: IAgent[] }): React.ReactElement | null {
+function McpSection(props: {
+  agents: IAgent[];
+  trans: TranslationBundle;
+}): React.ReactElement | null {
+  const { trans } = props;
   const [copiedId, setCopiedId] = React.useState<string | null>(null);
   const registerable = props.agents.filter(agent =>
     MCP_ADD_AGENT_IDS.has(agent.id)
@@ -555,13 +591,14 @@ function McpSection(props: { agents: IAgent[] }): React.ReactElement | null {
     <details className="jp-xtralab-Launcher-section jp-xtralab-Launcher-mcp-section">
       <summary className="jp-xtralab-Launcher-section-summary">
         <span className="jp-xtralab-Launcher-section-title">
-          Connect agents to JupyterLab (MCP)
+          {trans.__('Connect agents to JupyterLab (MCP)')}
         </span>
       </summary>
       <div className="jp-xtralab-Launcher-section-body">
         <p className="jp-xtralab-Launcher-agent-hint">
-          Run once per agent to let it drive this JupyterLab over MCP. No port
-          needed — the proxy finds this server on its own.
+          {trans.__(
+            'Run once per agent to let it drive this JupyterLab over MCP. No port needed — the proxy finds this server on its own.'
+          )}
         </p>
         <ul className="jp-xtralab-Launcher-mcp-list">
           {registerable.map(agent => {
@@ -578,19 +615,22 @@ function McpSection(props: { agents: IAgent[] }): React.ReactElement | null {
                       ? 'jp-xtralab-Launcher-mcp-copy jp-mod-copied'
                       : 'jp-xtralab-Launcher-mcp-copy'
                   }
-                  aria-label={`Copy the ${agent.label} command`}
+                  aria-label={trans.__('Copy the %1 command', agent.label)}
                   onClick={() => copy(command, agent.id)}
                 >
-                  {copiedId === agent.id ? 'Copied!' : 'Copy'}
+                  {copiedId === agent.id
+                    ? trans.__('Copied!')
+                    : trans.__('Copy')}
                 </button>
               </li>
             );
           })}
         </ul>
         <p className="jp-xtralab-Launcher-mcp-note">
-          Other agents (Goose, OpenCode, Kiro, Mistral Vibe, Antigravity)
-          register MCP through their own config — point them at the same{' '}
-          <code>{MCP_PROXY_COMMAND}</code> command.
+          {trans.__(
+            'Other agents (Goose, OpenCode, Kiro, Mistral Vibe, Antigravity) register MCP through their own config — point them at the same'
+          )}{' '}
+          <code>{MCP_PROXY_COMMAND}</code> {trans.__('command.')}
         </p>
       </div>
     </details>
@@ -615,23 +655,25 @@ function OpenSection(props: {
   onLaunchNotebook: () => void;
   onLaunchConsole: () => void;
   onLaunchEditor: () => void;
+  trans: TranslationBundle;
 }): React.ReactElement {
   const {
     editor,
     onLaunchTerminal,
     onLaunchNotebook,
     onLaunchConsole,
-    onLaunchEditor
+    onLaunchEditor,
+    trans
   } = props;
   return (
     <section className="jp-xtralab-Launcher-section">
-      <h2 className="jp-xtralab-Launcher-section-title">Open</h2>
+      <h2 className="jp-xtralab-Launcher-section-title">{trans.__('Open')}</h2>
       <div className="jp-xtralab-Launcher-agents">
         <button
           type="button"
           className="jp-xtralab-Launcher-agent"
-          title="Open a new terminal."
-          aria-label="Open a new terminal"
+          title={trans.__('Open a new terminal.')}
+          aria-label={trans.__('Open a new terminal')}
           onClick={onLaunchTerminal}
         >
           <LabIcon.resolveReact
@@ -639,13 +681,15 @@ function OpenSection(props: {
             tag="span"
             className="jp-xtralab-Launcher-agent-icon"
           />
-          <span className="jp-xtralab-Launcher-agent-label">Terminal</span>
+          <span className="jp-xtralab-Launcher-agent-label">
+            {trans.__('Terminal')}
+          </span>
         </button>
         <button
           type="button"
           className="jp-xtralab-Launcher-agent"
-          title="Create a new notebook."
-          aria-label="Create a new notebook"
+          title={trans.__('Create a new notebook.')}
+          aria-label={trans.__('Create a new notebook')}
           onClick={onLaunchNotebook}
         >
           <LabIcon.resolveReact
@@ -653,13 +697,15 @@ function OpenSection(props: {
             tag="span"
             className="jp-xtralab-Launcher-agent-icon"
           />
-          <span className="jp-xtralab-Launcher-agent-label">Notebook</span>
+          <span className="jp-xtralab-Launcher-agent-label">
+            {trans.__('Notebook')}
+          </span>
         </button>
         <button
           type="button"
           className="jp-xtralab-Launcher-agent"
-          title="Create a new console."
-          aria-label="Create a new console"
+          title={trans.__('Create a new console.')}
+          aria-label={trans.__('Create a new console')}
           onClick={onLaunchConsole}
         >
           <LabIcon.resolveReact
@@ -667,7 +713,9 @@ function OpenSection(props: {
             tag="span"
             className="jp-xtralab-Launcher-agent-icon"
           />
-          <span className="jp-xtralab-Launcher-agent-label">Console</span>
+          <span className="jp-xtralab-Launcher-agent-label">
+            {trans.__('Console')}
+          </span>
         </button>
         {editor && (
           <button

package/src/launcher/editorRegistry.ts

@@ -72,7 +72,9 @@ class EditorRegistry implements IEditorRegistry {
     return this._changed;
   }
 
-  /** Replace both lists (recomputed together) and notify observers. */
+  /**
+   * Replace both lists (recomputed together) and notify observers.
+   */
   set(editors: IEditor[], current: IEditor | null): void {
     this._editors = editors;
     this._current = current;
@@ -110,9 +112,13 @@ export const editorRegistryPlugin: JupyterFrontEndPlugin<IEditorRegistry> = {
       // 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
-        .filter(editor => editor.requireAvailable)
-        .map(editor => editor.command);
+      const probe = Array.from(
+        new Set(
+          editors
+            .filter(editor => editor.requireAvailable)
+            .map(editor => editor.command)
+        )
+      );
       const available = await fetchAvailableCommands(probe);
       registry.set(editors, resolveEditor(editors, available));
     };

package/src/launcher/editors.ts

@@ -10,15 +10,25 @@ import { BUILTIN_EDITOR_ICONS } from './icons';
  * 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

package/src/launcher/icons.ts

@@ -6,8 +6,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
@@ -28,7 +27,7 @@ import { LabIcon } from '@jupyterlab/ui-components';
  * 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">
@@ -107,21 +106,21 @@ export const antigravityIcon = new LabIcon({
 </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"/>
@@ -129,7 +128,7 @@ export const copilotIcon = new LabIcon({
 </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">
@@ -138,7 +137,7 @@ export const gooseIcon = new LabIcon({
 </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"/>
@@ -153,7 +152,7 @@ export const kiroIcon = new LabIcon({
 </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)">
@@ -171,7 +170,7 @@ export const mistralVibeIcon = new LabIcon({
 </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"/>
@@ -180,14 +179,14 @@ export const opencodeIcon = new LabIcon({
 </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/src/launcher/index.ts

@@ -164,7 +164,8 @@ const plugin: JupyterFrontEndPlugin<IAgentRegistry> = {
           // 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/src/launcher/invocation.ts

@@ -14,7 +14,7 @@ import type { IAgent } from './agents';
  * longer involved. Backslashes and single quotes are escaped first so
  * the source text round-trips unchanged.
  */
-export function shellQuote(value: string): string {
+function shellQuote(value: string): string {
   const escaped = value
     .replace(/\\/g, '\\\\')
     .replace(/'/g, "\\'")

package/src/launcher/schemaDefaults.ts

@@ -4,7 +4,9 @@ import type { ISettingRegistry } from '@jupyterlab/settingregistry';
 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';
 
 /**

package/src/mimeData.ts

@@ -0,0 +1,20 @@
+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 function coerceData(
+  mimeType: string,
+  data: ReadonlyPartialJSONValue
+): ReadonlyPartialJSONValue {
+  if (typeof data === 'string' && /\+?json$/.test(mimeType)) {
+    try {
+      return JSON.parse(data) as ReadonlyPartialJSONValue;
+    } catch {
+      return data;
+    }
+  }
+  return data;
+}

package/src/omnibox/index.ts

@@ -3,11 +3,14 @@ import {
   JupyterFrontEndPlugin
 } from '@jupyterlab/application';
 import { ICommandPalette } from '@jupyterlab/apputils';
+import { ISettingRegistry } from '@jupyterlab/settingregistry';
+import { IStateDB } from '@jupyterlab/statedb';
 import { ITranslator, nullTranslator } from '@jupyterlab/translation';
 import { Widget } from '@lumino/widgets';
 
 import { IAgentRegistry } from '../launcher/tokens';
 
+import { OmniboxRecents } from './recents';
 import { IOmnibox, OMNIBOX_OPEN_COMMAND } from './tokens';
 import { OmniboxWidget } from './widget';
 
@@ -20,6 +23,10 @@ const PLUGIN_ID = 'xtralab:omnibox';
  * 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.
  */
@@ -29,17 +36,56 @@ const plugin: JupyterFrontEndPlugin<IOmnibox> = {
     'A launcher overlay that searches files and commands and prompts agents.',
   autoStart: true,
   provides: IOmnibox,
-  optional: [IAgentRegistry, ICommandPalette, ITranslator],
+  optional: [
+    IAgentRegistry,
+    ICommandPalette,
+    ISettingRegistry,
+    IStateDB,
+    ITranslator
+  ],
   activate: (
     app: JupyterFrontEnd,
     agentRegistry: IAgentRegistry | null,
     palette: ICommandPalette | null,
+    settingRegistry: ISettingRegistry | null,
+    state: IStateDB | null,
     translator: ITranslator | null
   ): IOmnibox => {
     const { commands, docRegistry } = app;
     const trans = (translator ?? nullTranslator).load('jupyterlab');
     const placeholder = trans.__('Search files and commands, or ask an agent…');
 
+    const recents = new OmniboxRecents({ state });
+
+    // Restore the persisted recents only after the configured cap is known:
+    // `restore` trims to `maxItems`, so restoring at the constructor default
+    // would permanently drop entries beyond it whenever the user configured a
+    // larger cap and the state fetch won the race against the settings load.
+    if (settingRegistry) {
+      void settingRegistry
+        .load(PLUGIN_ID)
+        .then(settings => {
+          const apply = (): void => {
+            const value = settings.get('maxNumberRecents').composite;
+            if (typeof value === 'number') {
+              recents.maxItems = value;
+            }
+          };
+          apply();
+          settings.changed.connect(apply);
+          void recents.restore();
+        })
+        .catch(reason => {
+          console.error(
+            `xtralab omnibox: failed to load settings for ${PLUGIN_ID}`,
+            reason
+          );
+          void recents.restore();
+        });
+    } else {
+      void recents.restore();
+    }
+
     let current: OmniboxWidget | null = null;
 
     const close = (): void => {
@@ -58,6 +104,7 @@ const plugin: JupyterFrontEndPlugin<IOmnibox> = {
         agents: agentRegistry ? agentRegistry.agents : [],
         placeholder,
         initialQuery: query ?? '',
+        recents,
         trans,
         onClose: close
       });