xtralab 0.15.0 → 0.15.2

package/lib/askAgent/prompt.js

@@ -10,10 +10,8 @@ export function serverPath(context) {
         : context.path;
 }
 /**
- * Cap on the snippet embedded in the prompt, in characters. The path and
- * line range are the authoritative pointers — agents open the file
- * themselves — so a very long selection is trimmed instead of being typed
- * into the terminal wholesale.
+ * Cap on the embedded snippet; the path and line range are the
+ * authoritative pointers, so a very long selection is trimmed.
  */
 const MAX_SNIPPET_CHARS = 2000;
 /**
@@ -28,10 +26,6 @@ function fenceFor(text) {
     }
     return '`'.repeat(Math.max(3, longest + 1));
 }
-/**
- * Trim `text` to {@link MAX_SNIPPET_CHARS}, cutting at a line boundary.
- * Returns the (possibly shortened) snippet and whether anything was dropped.
- */
 function clampSnippet(text) {
     if (text.length <= MAX_SNIPPET_CHARS) {
         return { snippet: text, truncated: false };
@@ -53,7 +47,7 @@ function locatorFor(context) {
     const where = [`\`${context.path}\``];
     if (context.cell !== undefined) {
         // Both orderings so the agent can count cells or index the nbformat
-        // `cells` array, whichever its notebook tooling prefers.
+        // `cells` array.
         where.push(`${context.cell.type} cell ${context.cell.index + 1} ` +
             `(0-based index ${context.cell.index})`);
     }
@@ -69,11 +63,6 @@ function locatorFor(context) {
     }
     return where.join(', ');
 }
-/**
- * The blocks describing one comment: `headline`, the selected snippet in a
- * code fence (when there is one), then the user's instruction. Blocks are
- * joined with blank lines by the callers.
- */
 function commentParts(context, instruction, headline) {
     const parts = [headline];
     if (context.text.length > 0) {
@@ -88,11 +77,9 @@ function commentParts(context, instruction, headline) {
     return parts;
 }
 /**
- * Compose the prompt handed to the agent CLI: a one-line locator, the
- * selected snippet in a code fence, then the user's instruction.
- *
- * The scaffold is written in English on purpose — it is consumed by the
- * agent, not shown in the UI, and the agent CLIs are English-first.
+ * Compose the prompt handed to the agent CLI: locator, fenced snippet,
+ * instruction. The scaffold is English on purpose — consumed by the agent,
+ * not shown in the UI.
  */
 export function buildPrompt(context, instruction) {
     return commentParts(context, instruction, `In ${locatorFor(context)}:`).join('\n\n');

package/lib/askAgent/queue.d.ts

@@ -3,8 +3,8 @@ import { ISignal } from '@lumino/signaling';
 import type { AskAgentTarget, IAskAgentContext } from './tokens';
 /**
  * One queued prompt: a code selection, the user's instruction about it, and
- * where it should go. Every prompt is independent — a queue can mix targets
- * (different agents, new terminals, different running sessions) freely.
+ * where it should go. Every prompt is independent — a queue mixes targets
+ * freely.
  */
 export interface IQueuedPrompt {
     /**
@@ -20,22 +20,15 @@ export interface IQueuedPrompt {
      */
     instruction: string;
     /**
-     * The destination picked for this prompt (captured from the popup when it
-     * was queued, editable in the panel). `null` when a persisted target no
-     * longer parses — the panel then asks for a new pick before sending.
+     * The destination picked in the popup, editable in the panel. `null` when
+     * a persisted target no longer parses — the panel then asks for a new pick.
      */
     target: AskAgentTarget | null;
 }
 /**
- * The accumulated ask-agent prompts awaiting a batch send.
- *
- * Queueing decouples writing review comments from deciding where they go:
- * the popup appends entries here instead of sending, the side panel lists
- * and edits them, and one batch send flushes the lot, delivering each
- * destination's prompts as one numbered message. The queue itself is a
- * plain in-memory model; the plugin mirrors it into the JupyterLab state
- * database (via {@link serializeQueuedPrompts}) so a page reload does not
- * silently drop typed comments.
+ * The accumulated ask-agent prompts awaiting a batch send. A plain
+ * in-memory model; the plugin mirrors it into the state database so a page
+ * reload does not silently drop typed comments.
  */
 export declare class PromptQueue {
     constructor(items?: IQueuedPrompt[]);
@@ -64,8 +57,7 @@ export declare class PromptQueue {
      */
     remove(id: string): void;
     /**
-     * Remove several queued prompts at once (one signal emission) — used when
-     * a batch send succeeds for one target while other targets' prompts stay.
+     * Remove several queued prompts at once (one signal emission).
      */
     removeMany(ids: readonly string[]): void;
     /**
@@ -80,14 +72,12 @@ export declare class PromptQueue {
     private _changed;
 }
 /**
- * Rebuild queued prompts from a value read back from the state database.
- * Entries that no longer parse are dropped silently — the queue is a
- * convenience buffer, not a document.
+ * Rebuild queued prompts from the state database; entries that no longer
+ * parse are dropped silently.
  */
 export declare function deserializeQueuedPrompts(value: unknown): IQueuedPrompt[];
 /**
  * The queue as a JSON value for the state database. Ids are session-scoped
- * handles, so they are not persisted; {@link deserializeQueuedPrompts}
- * assigns fresh ones on load.
+ * and not persisted; fresh ones are assigned on load.
  */
 export declare function serializeQueuedPrompts(items: readonly IQueuedPrompt[]): ReadonlyPartialJSONValue;

package/lib/askAgent/queue.js

@@ -4,15 +4,9 @@ function nextId() {
     return `queued-${Date.now().toString(36)}-${idCounter++}`;
 }
 /**
- * The accumulated ask-agent prompts awaiting a batch send.
- *
- * Queueing decouples writing review comments from deciding where they go:
- * the popup appends entries here instead of sending, the side panel lists
- * and edits them, and one batch send flushes the lot, delivering each
- * destination's prompts as one numbered message. The queue itself is a
- * plain in-memory model; the plugin mirrors it into the JupyterLab state
- * database (via {@link serializeQueuedPrompts}) so a page reload does not
- * silently drop typed comments.
+ * The accumulated ask-agent prompts awaiting a batch send. A plain
+ * in-memory model; the plugin mirrors it into the state database so a page
+ * reload does not silently drop typed comments.
  */
 export class PromptQueue {
     constructor(items = []) {
@@ -80,8 +74,7 @@ export class PromptQueue {
         this.removeMany([id]);
     }
     /**
-     * Remove several queued prompts at once (one signal emission) — used when
-     * a batch send succeeds for one target while other targets' prompts stay.
+     * Remove several queued prompts at once (one signal emission).
      */
     removeMany(ids) {
         const drop = new Set(ids);
@@ -109,9 +102,8 @@ export class PromptQueue {
     }
 }
 /**
- * Validate one persisted context. Only fields that still match the
- * `IAskAgentContext` contract are kept, so schema drift (or manual
- * state-database edits) degrades an entry instead of poisoning the queue.
+ * Validate one persisted context; schema drift degrades an entry instead
+ * of poisoning the queue.
  */
 function sanitizeContext(value) {
     if (value === null || typeof value !== 'object') {
@@ -170,9 +162,8 @@ function sanitizeTarget(value) {
     return null;
 }
 /**
- * Rebuild queued prompts from a value read back from the state database.
- * Entries that no longer parse are dropped silently — the queue is a
- * convenience buffer, not a document.
+ * Rebuild queued prompts from the state database; entries that no longer
+ * parse are dropped silently.
  */
 export function deserializeQueuedPrompts(value) {
     if (!Array.isArray(value)) {
@@ -195,8 +186,7 @@ export function deserializeQueuedPrompts(value) {
 }
 /**
  * The queue as a JSON value for the state database. Ids are session-scoped
- * handles, so they are not persisted; {@link deserializeQueuedPrompts}
- * assigns fresh ones on load.
+ * and not persisted; fresh ones are assigned on load.
  */
 export function serializeQueuedPrompts(items) {
     return items.map(({ context, instruction, target }) => ({

package/lib/askAgent/queuePanel.d.ts

@@ -6,24 +6,20 @@ import type { IAgent } from '../launcher/agents';
 import type { PromptQueue } from './queue';
 import type { ISessionTarget } from './targetPicker';
 /**
- * The right-sidebar review panel for queued ask-agent prompts.
- *
- * Lists every queued comment — jump-to-code context line, snippet preview,
- * editable instruction, its own destination picker, remove button — plus a
- * send button that flushes the whole queue in one go: prompts sharing a
- * destination are combined into one numbered message, and each destination
- * gets its own delivery. The widget re-renders on queue changes itself; the
- * plugin additionally ties it to the agent registry and terminal signals so
- * the destination choices stay current.
+ * The right-sidebar review panel for queued ask-agent prompts: an editable
+ * list with per-prompt destinations, plus a send button that flushes the
+ * whole queue, combining prompts that share a destination into one
+ * numbered message.
  */
 export declare class AskAgentQueuePanel extends ReactWidget {
     constructor(options: AskAgentQueuePanel.IOptions);
+    /**
+     * Render the panel content.
+     */
     render(): JSX.Element;
     /**
-     * Dispose on close (e.g. the close button when the panel has been dragged
-     * to the main area) rather than leaving a detached, reusable widget
-     * behind. The plugin recreates the panel in the side area on demand; the
-     * queue itself lives on in the model.
+     * Dispose on close rather than leaving a detached widget behind; the
+     * plugin recreates the panel on demand and the queue lives on in the model.
      */
     protected onCloseRequest(msg: Message): void;
     private _onQueueChanged;
@@ -54,9 +50,8 @@ export declare namespace AskAgentQueuePanel {
          */
         targets: () => ISessionTarget[];
         /**
-         * Live reader of whether a batch send is in flight (called on every
-         * render). While true the send and clear buttons are disabled, so one
-         * flush cannot be double-delivered.
+         * Live reader of whether a batch send is in flight; while true the send
+         * and clear buttons are disabled.
          */
         sending: () => boolean;
         /**
@@ -64,8 +59,8 @@ export declare namespace AskAgentQueuePanel {
          */
         trans: TranslationBundle;
         /**
-         * Send every queued prompt to its own destination (the panel only calls
-         * this while all instructions and destinations are valid).
+         * Send every queued prompt to its own destination (called only while
+         * all instructions and destinations are valid).
          */
         onSend: () => void;
         /**

package/lib/askAgent/queuePanel.js

@@ -4,23 +4,14 @@ import { closeIcon, HTMLSelect, ReactWidget } from '@jupyterlab/ui-components';
 import * as React from 'react';
 import { contextSummary } from './popup';
 import { serverPath } from './prompt';
-/**
- * Command the context buttons dispatch; keeps the panel decoupled from the plugin.
- */
 const HIGHLIGHT_LINES_COMMAND = 'xtralab:highlight-lines';
 /**
- * Textarea height that fits `text` without scrolling, within sane bounds:
- * tall enough to look editable, short enough that one long comment cannot
- * crowd out the rest of the queue.
+ * Textarea height that fits `text` without scrolling, bounded so one long
+ * comment cannot crowd out the rest of the queue.
  */
 function rowsFor(text) {
     return Math.min(8, Math.max(2, text.split('\n').length));
 }
-/**
- * A target as a `<select>` option value: `session:<name>` for a running
- * agent terminal, `new:<agentId>` for a fresh terminal, `''` for a missing
- * target (the placeholder option).
- */
 function encodeTarget(target) {
     if (target === null) {
         return '';
@@ -38,10 +29,6 @@ function decodeTarget(value) {
     }
     return null;
 }
-/**
- * Whether `target` can be sent to right now: its session is still running,
- * or its agent still accepts a command-line prompt.
- */
 function targetIsLive(target, agents, targets) {
     if (target === null) {
         return false;
@@ -52,8 +39,8 @@ function targetIsLive(target, agents, targets) {
 }
 function QueuePanelComponent(props) {
     const { queue, commands, agents: readAgents, targets: readTargets, sending: readSending, trans, onSend, onClear } = props;
-    // Snapshots for this render; the widget re-renders on every queue, agent
-    // registry and terminal change, so these stay current.
+    // The widget re-renders on every queue, agent registry and terminal
+    // change, so these snapshots stay current.
     const items = queue.items;
     const agents = readAgents();
     const targets = readTargets();
@@ -65,10 +52,8 @@ function QueuePanelComponent(props) {
         var _a;
         const { context } = item;
         const path = serverPath(context);
-        // The highlighter needs line numbers that index the working file:
-        // notebook lines are cell-relative (or raw-JSON offsets), and diff
-        // selections may come from another revision — just open the document
-        // in those cases.
+        // The highlighter needs working-file line numbers: notebook lines are
+        // cell-relative and diff lines may index another revision — just open.
         const jump = context.cell === undefined &&
             context.startLine !== undefined &&
             context.linesInWorkingFile !== false &&
@@ -97,9 +82,6 @@ function QueuePanelComponent(props) {
             const missing = item.instruction.trim().length === 0;
             const target = item.target;
             const live = targetIsLive(target, agents, targets);
-            // Say what sending will do for this prompt — paste into a running
-            // terminal, or start a fresh one — and badge it with the agent's
-            // icon, so a mixed queue can be scanned without opening dropdowns.
             let icon = null;
             let targetTitle = trans.__('The destination picked for this prompt is gone — choose another');
             if (live && target !== null) {
@@ -152,15 +134,10 @@ function QueuePanelComponent(props) {
                     : trans._n('Send %1 prompt', 'Send %1 prompts', items.length))))));
 }
 /**
- * The right-sidebar review panel for queued ask-agent prompts.
- *
- * Lists every queued comment — jump-to-code context line, snippet preview,
- * editable instruction, its own destination picker, remove button — plus a
- * send button that flushes the whole queue in one go: prompts sharing a
- * destination are combined into one numbered message, and each destination
- * gets its own delivery. The widget re-renders on queue changes itself; the
- * plugin additionally ties it to the agent registry and terminal signals so
- * the destination choices stay current.
+ * The right-sidebar review panel for queued ask-agent prompts: an editable
+ * list with per-prompt destinations, plus a send button that flushes the
+ * whole queue, combining prompts that share a destination into one
+ * numbered message.
  */
 export class AskAgentQueuePanel extends ReactWidget {
     constructor(options) {
@@ -169,14 +146,15 @@ export class AskAgentQueuePanel extends ReactWidget {
         this.addClass('jp-xtralab-AskAgentQueue');
         options.queue.changed.connect(this._onQueueChanged, this);
     }
+    /**
+     * Render the panel content.
+     */
     render() {
         return React.createElement(QueuePanelComponent, { ...this._options });
     }
     /**
-     * Dispose on close (e.g. the close button when the panel has been dragged
-     * to the main area) rather than leaving a detached, reusable widget
-     * behind. The plugin recreates the panel in the side area on demand; the
-     * queue itself lives on in the model.
+     * Dispose on close rather than leaving a detached widget behind; the
+     * plugin recreates the panel on demand and the queue lives on in the model.
      */
     onCloseRequest(msg) {
         super.onCloseRequest(msg);

package/lib/askAgent/targetPicker.d.ts

@@ -26,18 +26,11 @@ export interface ISessionTarget {
 }
 /**
  * The chip row picking where a prompt goes: "New terminal" plus one chip
- * per running agent session. Renders nothing while no agent session is
- * running (a new terminal is then the only possibility and the row would
- * be noise).
+ * per running agent session. Renders nothing while no session is running
+ * (a new terminal is then the only possibility).
  */
 export declare function TargetChips(props: {
-    /**
-     * Agents that could start in a new terminal; gates the "New terminal" chip.
-     */
     agents: IAgent[];
-    /**
-     * The running agent sessions.
-     */
     targets: ISessionTarget[];
     /**
      * The selected session name, or `null` for a new terminal.

package/lib/askAgent/targetPicker.js

@@ -1,11 +1,9 @@
 import { addIcon } from '@jupyterlab/ui-components';
 import * as React from 'react';
 /**
- * Keyboard support shared by the two radiogroups below, following the ARIA
- * radio-group pattern: the group is one tab stop (only the checked radio is
- * tabbable) and the arrow keys move the selection to the neighbouring
- * radio, wrapping around. Selection follows focus, so the handler clicks
- * the neighbour and the re-render moves the roving tabindex along.
+ * Keyboard support for the radiogroups, per the ARIA radio pattern: one tab
+ * stop, arrow keys move and select — the handler clicks the neighbour and
+ * the re-render moves the roving tabindex along.
  */
 function onRadioGroupKeyDown(event) {
     let delta;
@@ -33,9 +31,8 @@ function onRadioGroupKeyDown(event) {
 }
 /**
  * The chip row picking where a prompt goes: "New terminal" plus one chip
- * per running agent session. Renders nothing while no agent session is
- * running (a new terminal is then the only possibility and the row would
- * be noise).
+ * per running agent session. Renders nothing while no session is running
+ * (a new terminal is then the only possibility).
  */
 export function TargetChips(props) {
     const { agents, targets, targetName, trans, onSelect } = props;
@@ -67,8 +64,6 @@ export function AgentChoices(props) {
         return null;
     }
     return (React.createElement("div", { className: "jp-xtralab-AskAgent-agents", role: "radiogroup", "aria-label": trans.__('Agent'), onKeyDown: onRadioGroupKeyDown }, agents.map(agent => (React.createElement("button", { key: agent.id, type: "button", role: "radio", "aria-checked": agent.id === agentId, tabIndex: agent.id === agentId ? 0 : -1, title: agent.label, "aria-label": agent.label, className: 'jp-xtralab-AskAgent-agentButton' +
-            (agent.id === agentId ? ' jp-mod-selected' : ''), 
-        // Keep focus where the user is typing while picking an agent.
-        onMouseDown: event => event.preventDefault(), onClick: () => onSelect(agent.id) },
+            (agent.id === agentId ? ' jp-mod-selected' : ''), onMouseDown: event => event.preventDefault(), onClick: () => onSelect(agent.id) },
         React.createElement(agent.icon.react, { tag: "span", className: "jp-xtralab-AskAgent-agentIcon" }))))));
 }

package/lib/askAgent/tokens.d.ts

@@ -1,43 +1,38 @@
 import { Token } from '@lumino/coreutils';
 /**
- * The command id that opens the ask-agent popup for the current text-editor
- * selection. Registered by `xtralab:ask-agent`; exposed here so menus and
- * other plugins can reference it without importing the plugin internals.
+ * Command id opening the ask-agent popup for the current editor selection;
+ * exposed so other plugins can reference it without the plugin internals.
  */
 export declare const ASK_AGENT_COMMAND = "xtralab:ask-agent";
 /**
- * A code location (and optionally the selected source text) that a prompt
- * should point an agent at. The structured fields are composed into the
- * final prompt by the ask-agent plugin so every entry point — editor
- * selection, diff line selection — produces consistently worded prompts.
+ * A code location (and optionally the selected text) a prompt should point
+ * an agent at; the plugin composes the fields into consistently worded
+ * prompts for every entry point.
  */
 export interface IAskAgentContext {
     /**
-     * Path of the file the selection belongs to, relative to {@link cwd} (or
-     * to the server root when no cwd is given) so the launched agent can open
-     * it directly.
+     * Path of the file, relative to {@link cwd} (or to the server root when
+     * no cwd is given).
      */
     path: string;
     /**
-     * Server-relative directory the agent's terminal starts in. Omit to start
-     * in the server root. Diff selections pass the git repository root here so
-     * the agent can run git commands right away.
+     * Server-relative directory the agent's terminal starts in. Diff
+     * selections pass the git repository root so the agent can run git
+     * commands right away.
      */
     cwd?: string;
     /**
-     * The notebook cell the selection lives in, when {@link path} is a
-     * notebook. `index` is the cell's 0-based position in the nbformat
-     * `cells` array; `type` is the nbformat cell type (`code`, `markdown`,
-     * `raw`). When set, {@link startLine}/{@link endLine} count within the
-     * cell's source rather than within a file.
+     * The notebook cell the selection lives in. `index` is the 0-based
+     * nbformat position, `type` the nbformat cell type; when set,
+     * {@link startLine}/{@link endLine} count within the cell's source.
      */
     cell?: {
         index: number;
         type: string;
     };
     /**
-     * First selected line, 1-indexed and inclusive. Omit when no line range is
-     * known (the prompt then only references the file).
+     * First selected line, 1-indexed and inclusive. Omit when no line range
+     * is known.
      */
     startLine?: number;
     /**
@@ -46,36 +41,30 @@ export interface IAskAgentContext {
      */
     endLine?: number;
     /**
-     * Whether {@link startLine}/{@link endLine} index the file's current
-     * working-tree content. `false` for diff selections taken from another
-     * revision (the old side, or a challenger that is not the working tree),
-     * whose numbers must not be used to highlight the working file. Omitted
-     * means `true`.
+     * Whether the lines index the file's current working-tree content.
+     * `false` for diff selections taken from another revision, whose numbers
+     * must not highlight the working file. Omitted means `true`.
      */
     linesInWorkingFile?: boolean;
     /**
-     * The selected source text. May be empty when only a location is known;
-     * the prompt then relies on the path and line range alone.
+     * The selected source text; may be empty when only a location is known.
      */
     text: string;
     /**
-     * Extra agent-facing locator appended after the line range in the prompt,
-     * e.g. `the old side (INDEX) of the git diff`. Written in English because
-     * it is consumed by the agent, not shown in the UI.
+     * Extra agent-facing locator appended after the line range, e.g. `the old
+     * side (INDEX) of the git diff`. English — consumed by the agent, not the UI.
      */
     location?: string;
     /**
-     * Short user-facing tag shown in the popup header next to the file name,
-     * e.g. "old version". Translated, unlike {@link location}. Omit when the
-     * range reads naturally as the file's current content.
+     * Short user-facing tag shown in the popup header, e.g. "old version".
+     * Translated, unlike {@link location}.
      */
     note?: string;
 }
 /**
  * Where a submitted prompt goes: a fresh terminal started with the chosen
- * agent's command, or an existing terminal session whose running agent
- * receives the prompt in its input box (queued by the agent itself when it
- * is busy).
+ * agent's command, or an existing session whose running agent receives the
+ * prompt in its input box (queued by the agent itself when busy).
  */
 export type AskAgentTarget = {
     kind: 'new';
@@ -94,17 +83,15 @@ export interface IAskAgentRequest {
      */
     context: IAskAgentContext;
     /**
-     * Viewport rectangle the popup anchors to (typically the selection end or
-     * the button that was clicked). `null` positions the popup near the top
-     * center of the viewport.
+     * Viewport rectangle the popup anchors to; `null` positions it near the
+     * top center of the viewport.
      */
     anchor: DOMRect | null;
 }
 /**
- * The ask-agent popup: a small floating prompt box that sends the given
- * code selection, plus the user's typed instruction, to one of the
- * configured coding agents — in a fresh terminal, or into an agent already
- * running in an existing one.
+ * The ask-agent popup: a floating prompt box that sends the given code
+ * selection plus the user's instruction to a coding agent, in a fresh or
+ * running terminal.
  */
 export interface IAskAgent {
     /**
@@ -117,8 +104,7 @@ export interface IAskAgent {
     close(): void;
 }
 /**
- * DI token for {@link IAskAgent}. Provided by `xtralab:ask-agent` and
- * consumed — optionally, so diffs still render when the plugin is disabled —
- * by the git diff plugins to offer "ask an agent about these lines".
+ * DI token for {@link IAskAgent}; consumed optionally by the git diff
+ * plugins so diffs still render when the plugin is disabled.
  */
 export declare const IAskAgent: Token<IAskAgent>;

package/lib/askAgent/tokens.js

@@ -1,13 +1,11 @@
 import { Token } from '@lumino/coreutils';
 /**
- * The command id that opens the ask-agent popup for the current text-editor
- * selection. Registered by `xtralab:ask-agent`; exposed here so menus and
- * other plugins can reference it without importing the plugin internals.
+ * Command id opening the ask-agent popup for the current editor selection;
+ * exposed so other plugins can reference it without the plugin internals.
  */
 export const ASK_AGENT_COMMAND = 'xtralab:ask-agent';
 /**
- * DI token for {@link IAskAgent}. Provided by `xtralab:ask-agent` and
- * consumed — optionally, so diffs still render when the plugin is disabled —
- * by the git diff plugins to offer "ask an agent about these lines".
+ * DI token for {@link IAskAgent}; consumed optionally by the git diff
+ * plugins so diffs still render when the plugin is disabled.
  */
 export const IAskAgent = new Token('xtralab:IAskAgent', 'A floating prompt box that sends the current code selection to a coding agent running in a terminal.');

package/lib/commandBar/index.d.ts

@@ -1,18 +1,9 @@
 import { JupyterFrontEndPlugin } from '@jupyterlab/application';
 /**
- * Contribute a search-bar-styled command bar to JupyterLab's top bar toolbar.
- * Clicking it opens the omnibox — a launcher overlay that fuzzy-searches files
- * and commands and routes a typed prompt to an agent.
- *
- * The pill is a regular settings-driven toolbar item: this plugin registers a
- * widget factory for it on the `IToolbarWidgetRegistry` and declares its rank
- * in schema/command-bar.json, so users can move or disable it from the Top
- * Bar settings like any other toolbar item.
- *
- * The factory is only registered when the omnibox is available — the
- * `IOmnibox` token is provided by `xtralab:omnibox` — so the pill never
- * appears with nothing to open (without a factory, the toolbar item resolves
- * to an empty command button that renders nothing).
+ * Contribute a search-bar-styled pill to the top bar toolbar that opens the
+ * omnibox. It is a settings-driven toolbar item (factory here, rank in
+ * schema/command-bar.json) registered only when `IOmnibox` is provided —
+ * without a factory the item resolves to an empty button that renders nothing.
  */
 declare const plugin: JupyterFrontEndPlugin<void>;
 export default plugin;