@jupyterlab/notebook-extension 4.5.0-alpha.0 → 4.5.0-alpha.2

package/lib/index.js

@@ -33,6 +33,7 @@ import { JSONExt, UUID } from '@lumino/coreutils';
 import { DisposableSet } from '@lumino/disposable';
 import { MessageLoop } from '@lumino/messaging';
 import { Panel } from '@lumino/widgets';
+import { CellBarExtension } from '@jupyterlab/cell-toolbar';
 import { cellExecutor } from './cellexecutor';
 import { logNotebookOutput } from './nboutput';
 import { ActiveCellTool } from './tool-widgets/activeCellToolWidget';
@@ -373,7 +374,27 @@ export const exportPlugin = {
                 }
                 return (_b = (_a = services.nbconvert).exportAs) === null || _b === void 0 ? void 0 : _b.call(_a, exportOptions);
             },
-            isEnabled
+            isEnabled,
+            describedBy: {
+                args: {
+                    type: 'object',
+                    properties: {
+                        format: {
+                            type: 'string',
+                            description: trans.__('The export format (e.g., pdf, html, latex)')
+                        },
+                        label: {
+                            type: 'string',
+                            description: trans.__('The label to display for this format')
+                        },
+                        isPalette: {
+                            type: 'boolean',
+                            description: trans.__('Whether the command is called from the command palette')
+                        }
+                    },
+                    required: ['format']
+                }
+            }
         });
         // Add a notebook group to the File menu.
         let exportTo;
@@ -927,7 +948,22 @@ function activateClonedOutputs(app, docManager, notebookTracker, translator, res
                 widget.dispose();
             });
         },
-        isEnabled: isEnabledAndSingleSelected
+        isEnabled: isEnabledAndSingleSelected,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {
+                    path: {
+                        type: 'string',
+                        description: trans.__('The path to the notebook containing the cell')
+                    },
+                    index: {
+                        type: 'number',
+                        description: trans.__('The index of the cell to create an output view for')
+                    }
+                }
+            }
+        }
     });
 }
 /**
@@ -946,7 +982,18 @@ function activateCodeConsole(app, tracker, translator) {
             }
             return Private.createConsole(commands, current, args['activate']);
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {
+                    activate: {
+                        type: 'boolean',
+                        description: trans.__('Whether to activate the console after creation')
+                    }
+                }
+            }
+        }
     });
     commands.addCommand(CommandIDs.createSubshellConsole, {
         label: trans.__('New Subshell Console for Notebook'),
@@ -962,6 +1009,17 @@ function activateCodeConsole(app, tracker, translator) {
             var _a, _b, _c;
             const kernel = (_b = (_a = tracker.currentWidget) === null || _a === void 0 ? void 0 : _a.context.sessionContext.session) === null || _b === void 0 ? void 0 : _b.kernel;
             return (_c = kernel === null || kernel === void 0 ? void 0 : kernel.supportsSubshells) !== null && _c !== void 0 ? _c : false;
+        },
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {
+                    activate: {
+                        type: 'boolean',
+                        description: trans.__('Whether to activate the console after creation')
+                    }
+                }
+            }
         }
     });
     commands.addCommand(CommandIDs.runInConsole, {
@@ -1076,7 +1134,13 @@ function activateCodeConsole(app, tracker, translator) {
                 metadata
             });
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
 }
 /**
@@ -1123,6 +1187,12 @@ function activateCopyOutput(app, translator, tracker) {
                 const area = outputAreaAreas[0];
                 copyElement(area);
             }
+        },
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
         }
     });
     app.contextMenu.addItem({
@@ -1222,7 +1292,18 @@ function activateNotebookHandler(app, factory, extensions, executor, palette, de
             isToggled: () => ['codeCellConfig', 'markdownCellConfig', 'rawCellConfig'].some(x => {
                 var _a;
                 return ((_a = settings.get(x).composite.autoClosingBrackets) !== null && _a !== void 0 ? _a : extensions.baseConfiguration['autoClosingBrackets']) === true;
-            })
+            }),
+            describedBy: {
+                args: {
+                    type: 'object',
+                    properties: {
+                        force: {
+                            type: 'boolean',
+                            description: trans.__('Force toggling the auto closing brackets setting')
+                        }
+                    }
+                }
+            }
         });
         commands.addCommand(CommandIDs.setSideBySideRatio, {
             label: trans.__('Set side-by-side ratio'),
@@ -1238,6 +1319,12 @@ function activateNotebookHandler(app, factory, extensions, executor, palette, de
                     }
                 })
                     .catch(console.error);
+            },
+            describedBy: {
+                args: {
+                    type: 'object',
+                    properties: {}
+                }
             }
         });
         addCommands(app, tracker, translator, sessionDialogs, settings, isEnabled);
@@ -1421,6 +1508,37 @@ function activateNotebookHandler(app, factory, extensions, executor, palette, de
             const kernelId = args['kernelId'] || '';
             const kernelName = args['kernelName'] || '';
             return createNew(cwd, kernelId, kernelName);
+        },
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {
+                    cwd: {
+                        type: 'string',
+                        description: trans.__('Current working directory for the new notebook')
+                    },
+                    kernelId: {
+                        type: 'string',
+                        description: trans.__('Kernel ID to use for the new notebook')
+                    },
+                    kernelName: {
+                        type: 'string',
+                        description: trans.__('Kernel name to use for the new notebook')
+                    },
+                    isLauncher: {
+                        type: 'boolean',
+                        description: trans.__('Whether the command is executed from launcher')
+                    },
+                    isPalette: {
+                        type: 'boolean',
+                        description: trans.__('Whether the command is executed from palette')
+                    },
+                    isContextMenu: {
+                        type: 'boolean',
+                        description: trans.__('Whether the command is executed from context menu')
+                    }
+                }
+            }
         }
     });
     // Add a launcher item if the launcher is available.
@@ -1476,6 +1594,17 @@ function activateNotebookCompleterService(app, notebooks, manager, translator, a
             if (panel && ((_a = panel.content.activeCell) === null || _a === void 0 ? void 0 : _a.model.type) === 'code') {
                 manager.invoke(panel.id);
             }
+        },
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {
+                    activate: {
+                        type: 'boolean',
+                        description: trans.__('Whether to activate the widget')
+                    }
+                }
+            }
         }
     });
     app.commands.addCommand(CommandIDs.selectCompleter, {
@@ -1485,6 +1614,17 @@ function activateNotebookCompleterService(app, notebooks, manager, translator, a
             if (id) {
                 return manager.select(id);
             }
+        },
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {
+                    activate: {
+                        type: 'boolean',
+                        description: trans.__('Whether to activate the widget')
+                    }
+                }
+            }
         }
     });
     app.commands.addKeyBinding({
@@ -1549,10 +1689,20 @@ function activateNotebookLanguageServer(app, notebooks, connectionManager, featu
 }
 // Get the current widget and activate unless the args specify otherwise.
 function getCurrent(tracker, shell, args) {
-    var _a;
-    const widget = args[SemanticCommand.WIDGET]
-        ? (_a = tracker.find(panel => panel.id === args[SemanticCommand.WIDGET])) !== null && _a !== void 0 ? _a : null
-        : tracker.currentWidget;
+    var _a, _b;
+    let widget = null;
+    // Check for panelId in args (used by cell toolbars)
+    if (args[CellBarExtension.WIDGET_ID_ARG]) {
+        widget =
+            (_a = tracker.find(panel => panel.id === args[CellBarExtension.WIDGET_ID_ARG])) !== null && _a !== void 0 ? _a : null;
+    }
+    else if (args[SemanticCommand.WIDGET]) {
+        widget =
+            (_b = tracker.find(panel => panel.id === args[SemanticCommand.WIDGET])) !== null && _b !== void 0 ? _b : null;
+    }
+    else {
+        widget = tracker.currentWidget;
+    }
     const activate = args['activate'] !== false;
     if (activate && widget) {
         shell.activateById(widget.id);
@@ -1573,7 +1723,14 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
         var _a, _b;
         for (const cell of notebook.widgets) {
             if (cell instanceof MarkdownCell && cell.headingCollapsed) {
-                NotebookActions.setHeadingCollapse(cell, true, notebook);
+                cell
+                    .getHeadings()
+                    .then(() => {
+                    NotebookActions.setHeadingCollapse(cell, true, notebook);
+                })
+                    .catch(error => {
+                    console.warn('Failed to resolve headings: ', error);
+                });
             }
             if (cell.model.id === ((_b = (_a = notebook.activeCell) === null || _a === void 0 ? void 0 : _a.model) === null || _b === void 0 ? void 0 : _b.id)) {
                 NotebookActions.expandParent(cell, notebook);
@@ -1636,7 +1793,22 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
             }
         },
         isEnabled: args => (args.toolbar ? true : isEnabled()),
-        icon: args => (args.toolbar ? runIcon : undefined)
+        icon: args => (args.toolbar ? runIcon : undefined),
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {
+                    toolbar: {
+                        type: 'boolean',
+                        description: 'Whether the command is being executed from the toolbar'
+                    },
+                    activate: {
+                        type: 'boolean',
+                        description: trans.__('Whether to activate the notebook after execution')
+                    }
+                }
+            }
+        }
     });
     commands.addCommand(CommandIDs.run, {
         label: args => {
@@ -1651,7 +1823,18 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.run(content, context.sessionContext, sessionDialogs, translator);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {
+                    activate: {
+                        type: 'boolean',
+                        description: trans.__('Whether to activate the notebook after execution')
+                    }
+                }
+            }
+        }
     });
     commands.addCommand(CommandIDs.runAndInsert, {
         label: args => {
@@ -1666,7 +1849,18 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.runAndInsert(content, context.sessionContext, sessionDialogs, translator);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {
+                    activate: {
+                        type: 'boolean',
+                        description: trans.__('Whether to activate the notebook after execution')
+                    }
+                }
+            }
+        }
     });
     commands.addCommand(CommandIDs.runAll, {
         label: trans.__('Run All Cells'),
@@ -1678,7 +1872,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.runAll(content, context.sessionContext, sessionDialogs, translator);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.runAllAbove, {
         label: trans.__('Run All Above Selected Cell'),
@@ -1694,6 +1894,12 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
             // or if we are at the top of the notebook.
             return (isEnabledAndSingleSelected() &&
                 tracker.currentWidget.content.activeCellIndex !== 0);
+        },
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
         }
     });
     commands.addCommand(CommandIDs.runAllBelow, {
@@ -1712,6 +1918,12 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 (tracker.currentWidget.content.widgets.length === 1 ||
                     tracker.currentWidget.content.activeCellIndex !==
                         tracker.currentWidget.content.widgets.length - 1));
+        },
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
         }
     });
     commands.addCommand(CommandIDs.renderAllMarkdown, {
@@ -1723,7 +1935,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.renderAllMarkdown(content);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.restart, {
         label: trans.__('Restart Kernel…'),
@@ -1735,7 +1953,18 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
             }
         },
         isEnabled: args => (args.toolbar ? true : isEnabled()),
-        icon: args => (args.toolbar ? refreshIcon : undefined)
+        icon: args => (args.toolbar ? refreshIcon : undefined),
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {
+                    toolbar: {
+                        type: 'boolean',
+                        description: 'Whether the command is being executed from the toolbar'
+                    }
+                }
+            }
+        }
     });
     commands.addCommand(CommandIDs.shutdown, {
         label: trans.__('Shut Down Kernel'),
@@ -1746,7 +1975,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
             }
             return current.context.sessionContext.shutdown();
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.closeAndShutdown, {
         label: trans.__('Close and Shut Down Notebook…'),
@@ -1770,7 +2005,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 }
             });
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.trust, {
         label: () => trans.__('Trust Notebook'),
@@ -1781,7 +2022,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.trust(content).then(() => context.save());
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.restartClear, {
         label: trans.__('Restart Kernel and Clear Outputs of All Cells…'),
@@ -1794,7 +2041,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 await commands.execute(CommandIDs.clearAllOutputs);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.restartAndRunToSelected, {
         label: trans.__('Restart Kernel and Run up to Selected Cell…'),
@@ -1810,7 +2063,18 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.runCells(content, cells, context.sessionContext, sessionDialogs, translator);
             }
         },
-        isEnabled: isEnabledAndSingleSelected
+        isEnabled: isEnabledAndSingleSelected,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {
+                    activate: {
+                        type: 'boolean',
+                        description: trans.__('Whether to activate the notebook after execution')
+                    }
+                }
+            }
+        }
     });
     commands.addCommand(CommandIDs.restartRunAll, {
         label: trans.__('Restart Kernel and Run All Cells…'),
@@ -1828,7 +2092,22 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
             }
         },
         isEnabled: args => (args.toolbar ? true : isEnabled()),
-        icon: args => (args.toolbar ? fastForwardIcon : undefined)
+        icon: args => (args.toolbar ? fastForwardIcon : undefined),
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {
+                    toolbar: {
+                        type: 'boolean',
+                        description: 'Whether the command is being executed from the toolbar'
+                    },
+                    activate: {
+                        type: 'boolean',
+                        description: trans.__('Whether to activate the notebook after execution')
+                    }
+                }
+            }
+        }
     });
     commands.addCommand(CommandIDs.clearAllOutputs, {
         label: trans.__('Clear Outputs of All Cells'),
@@ -1839,7 +2118,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.clearAllOutputs(current.content);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.clearOutputs, {
         label: trans.__('Clear Cell Output'),
@@ -1850,7 +2135,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.clearOutputs(current.content);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.interrupt, {
         label: trans.__('Interrupt Kernel'),
@@ -1867,7 +2158,18 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
             }
         },
         isEnabled: args => (args.toolbar ? true : isEnabled()),
-        icon: args => (args.toolbar ? stopIcon : undefined)
+        icon: args => (args.toolbar ? stopIcon : undefined),
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {
+                    toolbar: {
+                        type: 'boolean',
+                        description: 'Whether the command is being executed from the toolbar'
+                    }
+                }
+            }
+        }
     });
     commands.addCommand(CommandIDs.toCode, {
         label: trans.__('Change to Code Cell Type'),
@@ -1877,7 +2179,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.changeCellType(current.content, 'code', translator);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.toMarkdown, {
         label: trans.__('Change to Markdown Cell Type'),
@@ -1887,7 +2195,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.changeCellType(current.content, 'markdown', translator);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.toRaw, {
         label: trans.__('Change to Raw Cell Type'),
@@ -1897,7 +2211,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.changeCellType(current.content, 'raw', translator);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.cut, {
         label: args => {
@@ -1910,14 +2230,29 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
             const current = getCurrent(tracker, shell, { ...args, activate: false });
             return trans._n('Cut this cell', 'Cut these %1 cells', (_a = current === null || current === void 0 ? void 0 : current.content.selectedCells.length) !== null && _a !== void 0 ? _a : 1);
         },
-        execute: args => {
+        execute: async (args) => {
             const current = getCurrent(tracker, shell, args);
             if (current) {
-                return NotebookActions.cut(current.content);
+                return await NotebookActions.cutToSystemClipboard(current.content);
             }
         },
         icon: args => (args.toolbar ? cutIcon : undefined),
-        isEnabled: args => (args.toolbar ? true : isEnabled())
+        isEnabled: args => (args.toolbar ? true : isEnabled()),
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {
+                    toolbar: {
+                        type: 'boolean',
+                        description: 'Whether the command is being executed from the toolbar'
+                    },
+                    activate: {
+                        type: 'boolean',
+                        description: trans.__('Whether to activate the notebook after execution')
+                    }
+                }
+            }
+        }
     });
     commands.addCommand(CommandIDs.copy, {
         label: args => {
@@ -1930,14 +2265,29 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
             const current = getCurrent(tracker, shell, { ...args, activate: false });
             return trans._n('Copy this cell', 'Copy these %1 cells', (_a = current === null || current === void 0 ? void 0 : current.content.selectedCells.length) !== null && _a !== void 0 ? _a : 1);
         },
-        execute: args => {
+        execute: async (args) => {
             const current = getCurrent(tracker, shell, args);
             if (current) {
-                return NotebookActions.copy(current.content);
+                return await NotebookActions.copyToSystemClipboard(current.content);
             }
         },
         icon: args => (args.toolbar ? copyIcon : undefined),
-        isEnabled: args => (args.toolbar ? true : isEnabled())
+        isEnabled: args => (args.toolbar ? true : isEnabled()),
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {
+                    toolbar: {
+                        type: 'boolean',
+                        description: 'Whether the command is being executed from the toolbar'
+                    },
+                    activate: {
+                        type: 'boolean',
+                        description: trans.__('Whether to activate the notebook after execution')
+                    }
+                }
+            }
+        }
     });
     commands.addCommand(CommandIDs.pasteBelow, {
         label: args => {
@@ -1950,14 +2300,29 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
             const current = getCurrent(tracker, shell, { ...args, activate: false });
             return trans._n('Paste this cell from the clipboard', 'Paste these %1 cells from the clipboard', (_a = current === null || current === void 0 ? void 0 : current.content.selectedCells.length) !== null && _a !== void 0 ? _a : 1);
         },
-        execute: args => {
+        execute: async (args) => {
             const current = getCurrent(tracker, shell, args);
             if (current) {
-                return NotebookActions.paste(current.content, 'below');
+                return await NotebookActions.pasteFromSystemClipboard(current.content, 'below');
             }
         },
         icon: args => (args.toolbar ? pasteIcon : undefined),
-        isEnabled: args => (args.toolbar ? true : isEnabled())
+        isEnabled: args => (args.toolbar ? true : isEnabled()),
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {
+                    toolbar: {
+                        type: 'boolean',
+                        description: 'Whether the command is being executed from the toolbar'
+                    },
+                    activate: {
+                        type: 'boolean',
+                        description: trans.__('Whether to activate the notebook after execution')
+                    }
+                }
+            }
+        }
     });
     commands.addCommand(CommandIDs.pasteAbove, {
         label: args => {
@@ -1970,13 +2335,24 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
             const current = getCurrent(tracker, shell, { ...args, activate: false });
             return trans._n('Paste this cell from the clipboard', 'Paste these %1 cells from the clipboard', (_a = current === null || current === void 0 ? void 0 : current.content.selectedCells.length) !== null && _a !== void 0 ? _a : 1);
         },
-        execute: args => {
+        execute: async (args) => {
             const current = getCurrent(tracker, shell, args);
             if (current) {
-                return NotebookActions.paste(current.content, 'above');
+                return await NotebookActions.pasteFromSystemClipboard(current.content, 'above');
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {
+                    activate: {
+                        type: 'boolean',
+                        description: trans.__('Whether to activate the notebook after execution')
+                    }
+                }
+            }
+        }
     });
     commands.addCommand(CommandIDs.duplicateBelow, {
         label: args => {
@@ -1996,7 +2372,22 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
             }
         },
         icon: args => (args.toolbar ? duplicateIcon : undefined),
-        isEnabled: args => (args.toolbar ? true : isEnabled())
+        isEnabled: args => (args.toolbar ? true : isEnabled()),
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {
+                    toolbar: {
+                        type: 'boolean',
+                        description: 'Whether the command is being executed from the toolbar'
+                    },
+                    activate: {
+                        type: 'boolean',
+                        description: trans.__('Whether to activate the notebook after execution')
+                    }
+                }
+            }
+        }
     });
     commands.addCommand(CommandIDs.pasteAndReplace, {
         label: args => {
@@ -2004,13 +2395,24 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
             const current = getCurrent(tracker, shell, { ...args, activate: false });
             return trans._n('Paste Cell and Replace', 'Paste Cells and Replace', (_a = current === null || current === void 0 ? void 0 : current.content.selectedCells.length) !== null && _a !== void 0 ? _a : 1);
         },
-        execute: args => {
+        execute: async (args) => {
             const current = getCurrent(tracker, shell, args);
             if (current) {
-                return NotebookActions.paste(current.content, 'replace');
+                return await NotebookActions.pasteFromSystemClipboard(current.content, 'replace');
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {
+                    activate: {
+                        type: 'boolean',
+                        description: trans.__('Whether to activate the notebook after execution')
+                    }
+                }
+            }
+        }
     });
     commands.addCommand(CommandIDs.deleteCell, {
         label: args => {
@@ -2029,7 +2431,22 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.deleteCells(current.content);
             }
         },
-        isEnabled: args => (args.toolbar ? true : isEnabled())
+        isEnabled: args => (args.toolbar ? true : isEnabled()),
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {
+                    toolbar: {
+                        type: 'boolean',
+                        description: 'Whether the command is being executed from the toolbar'
+                    },
+                    activate: {
+                        type: 'boolean',
+                        description: trans.__('Whether to activate the notebook after execution')
+                    }
+                }
+            }
+        }
     });
     commands.addCommand(CommandIDs.split, {
         label: trans.__('Split Cell'),
@@ -2039,7 +2456,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.splitCell(current.content);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.merge, {
         label: trans.__('Merge Selected Cells'),
@@ -2049,7 +2472,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.mergeCells(current.content);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.mergeAbove, {
         label: trans.__('Merge Cell Above'),
@@ -2059,7 +2488,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.mergeCells(current.content, true);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.mergeBelow, {
         label: trans.__('Merge Cell Below'),
@@ -2069,7 +2504,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.mergeCells(current.content, false);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.insertAbove, {
         label: trans.__('Insert Cell Above'),
@@ -2081,7 +2522,18 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
             }
         },
         icon: args => (args.toolbar ? addAboveIcon : undefined),
-        isEnabled: args => (args.toolbar ? true : isEnabled())
+        isEnabled: args => (args.toolbar ? true : isEnabled()),
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {
+                    toolbar: {
+                        type: 'boolean',
+                        description: 'Whether the command is being executed from the toolbar'
+                    }
+                }
+            }
+        }
     });
     commands.addCommand(CommandIDs.insertBelow, {
         label: trans.__('Insert Cell Below'),
@@ -2093,7 +2545,18 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
             }
         },
         icon: args => (args.toolbar ? addBelowIcon : undefined),
-        isEnabled: args => (args.toolbar ? true : isEnabled())
+        isEnabled: args => (args.toolbar ? true : isEnabled()),
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {
+                    toolbar: {
+                        type: 'boolean',
+                        description: 'Whether the command is being executed from the toolbar'
+                    }
+                }
+            }
+        }
     });
     commands.addCommand(CommandIDs.selectAbove, {
         label: trans.__('Select Cell Above'),
@@ -2103,7 +2566,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.selectAbove(current.content);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.selectBelow, {
         label: trans.__('Select Cell Below'),
@@ -2113,7 +2582,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.selectBelow(current.content);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.insertHeadingAbove, {
         label: trans.__('Insert Heading Above Current Heading'),
@@ -2123,7 +2598,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.insertSameLevelHeadingAbove(current.content);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.insertHeadingBelow, {
         label: trans.__('Insert Heading Below Current Heading'),
@@ -2133,7 +2614,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.insertSameLevelHeadingBelow(current.content);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.selectHeadingAboveOrCollapse, {
         label: trans.__('Select Heading Above or Collapse Heading'),
@@ -2143,7 +2630,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.selectHeadingAboveOrCollapseHeading(current.content);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.selectHeadingBelowOrExpand, {
         label: trans.__('Select Heading Below or Expand Heading'),
@@ -2153,7 +2646,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.selectHeadingBelowOrExpandHeading(current.content);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.extendAbove, {
         label: trans.__('Extend Selection Above'),
@@ -2163,7 +2662,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.extendSelectionAbove(current.content);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.extendTop, {
         label: trans.__('Extend Selection to Top'),
@@ -2173,7 +2678,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.extendSelectionAbove(current.content, true);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.extendBelow, {
         label: trans.__('Extend Selection Below'),
@@ -2183,7 +2694,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.extendSelectionBelow(current.content);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.extendBottom, {
         label: trans.__('Extend Selection to Bottom'),
@@ -2193,7 +2710,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.extendSelectionBelow(current.content, true);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.selectAll, {
         label: trans.__('Select All Cells'),
@@ -2203,7 +2726,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.selectAll(current.content);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.deselectAll, {
         label: trans.__('Deselect All Cells'),
@@ -2213,7 +2742,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.deselectAll(current.content);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.moveUp, {
         label: args => {
@@ -2240,7 +2775,22 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
             }
             return current.content.activeCellIndex >= 1;
         },
-        icon: args => (args.toolbar ? moveUpIcon : undefined)
+        icon: args => (args.toolbar ? moveUpIcon : undefined),
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {
+                    toolbar: {
+                        type: 'boolean',
+                        description: 'Whether the command is being executed from the toolbar'
+                    },
+                    activate: {
+                        type: 'boolean',
+                        description: trans.__('Whether to activate the notebook after execution')
+                    }
+                }
+            }
+        }
     });
     commands.addCommand(CommandIDs.moveDown, {
         label: args => {
@@ -2268,7 +2818,22 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
             const length = current.content.model.cells.length;
             return current.content.activeCellIndex < length - 1;
         },
-        icon: args => (args.toolbar ? moveDownIcon : undefined)
+        icon: args => (args.toolbar ? moveDownIcon : undefined),
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {
+                    toolbar: {
+                        type: 'boolean',
+                        description: 'Whether the command is being executed from the toolbar'
+                    },
+                    activate: {
+                        type: 'boolean',
+                        description: trans.__('Whether to activate the notebook after execution')
+                    }
+                }
+            }
+        }
     });
     commands.addCommand(CommandIDs.toggleAllLines, {
         label: trans.__('Show Line Numbers'),
@@ -2290,6 +2855,17 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
             else {
                 return false;
             }
+        },
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {
+                    activate: {
+                        type: 'boolean',
+                        description: trans.__('Whether to activate the notebook after execution')
+                    }
+                }
+            }
         }
     });
     commands.addCommand(CommandIDs.commandMode, {
@@ -2300,7 +2876,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 current.content.mode = 'command';
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.editMode, {
         label: trans.__('Enter Edit Mode'),
@@ -2310,7 +2892,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 current.content.mode = 'edit';
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.undoCellAction, {
         label: trans.__('Undo Cell Operation'),
@@ -2320,7 +2908,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.undo(current.content);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.redoCellAction, {
         label: trans.__('Redo Cell Operation'),
@@ -2330,7 +2924,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.redo(current.content);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.redo, {
         label: trans.__('Redo'),
@@ -2344,6 +2944,12 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                     return (_a = cell.editor) === null || _a === void 0 ? void 0 : _a.redo();
                 }
             }
+        },
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
         }
     });
     commands.addCommand(CommandIDs.undo, {
@@ -2358,6 +2964,12 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                     return (_a = cell.editor) === null || _a === void 0 ? void 0 : _a.undo();
                 }
             }
+        },
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
         }
     });
     commands.addCommand(CommandIDs.changeKernel, {
@@ -2368,7 +2980,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return sessionDialogs.selectKernel(current.context.sessionContext);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.getKernel, {
         label: trans.__('Get Kernel'),
@@ -2379,7 +2997,18 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return (_a = current.sessionContext.session) === null || _a === void 0 ? void 0 : _a.kernel;
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {
+                    activate: {
+                        type: 'boolean',
+                        description: trans.__('Whether to activate the notebook after execution')
+                    }
+                }
+            }
+        }
     });
     commands.addCommand(CommandIDs.reconnectToKernel, {
         label: trans.__('Reconnect to Kernel'),
@@ -2394,7 +3023,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return kernel.reconnect();
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.markdown1, {
         label: trans.__('Change to Heading 1'),
@@ -2404,7 +3039,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.setMarkdownHeader(current.content, 1, translator);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.markdown2, {
         label: trans.__('Change to Heading 2'),
@@ -2414,7 +3055,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.setMarkdownHeader(current.content, 2, translator);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.markdown3, {
         label: trans.__('Change to Heading 3'),
@@ -2424,7 +3071,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.setMarkdownHeader(current.content, 3, translator);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.markdown4, {
         label: trans.__('Change to Heading 4'),
@@ -2434,7 +3087,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.setMarkdownHeader(current.content, 4, translator);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.markdown5, {
         label: trans.__('Change to Heading 5'),
@@ -2444,7 +3103,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.setMarkdownHeader(current.content, 5, translator);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.markdown6, {
         label: trans.__('Change to Heading 6'),
@@ -2454,7 +3119,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.setMarkdownHeader(current.content, 6, translator);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.hideCode, {
         label: trans.__('Collapse Selected Code'),
@@ -2464,7 +3135,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.hideCode(current.content);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.showCode, {
         label: trans.__('Expand Selected Code'),
@@ -2474,7 +3151,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.showCode(current.content);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.hideAllCode, {
         label: trans.__('Collapse All Code'),
@@ -2484,7 +3167,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.hideAllCode(current.content);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.showAllCode, {
         label: trans.__('Expand All Code'),
@@ -2494,7 +3183,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.showAllCode(current.content);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.hideOutput, {
         label: trans.__('Collapse Selected Outputs'),
@@ -2504,7 +3199,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.hideOutput(current.content);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.showOutput, {
         label: trans.__('Expand Selected Outputs'),
@@ -2514,7 +3215,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.showOutput(current.content);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.toggleOutput, {
         label: trans.__('Toggle Visibility of Selected Outputs'),
@@ -2524,7 +3231,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.toggleOutput(current.content);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.hideAllOutputs, {
         label: trans.__('Collapse All Outputs'),
@@ -2534,7 +3247,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.hideAllOutputs(current.content);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.toggleRenderSideBySideCurrentNotebook, {
         label: trans.__('Render Side-by-Side'),
@@ -2556,6 +3275,17 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
             else {
                 return false;
             }
+        },
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {
+                    activate: {
+                        type: 'boolean',
+                        description: trans.__('Whether to activate the notebook after execution')
+                    }
+                }
+            }
         }
     });
     commands.addCommand(CommandIDs.showAllOutputs, {
@@ -2566,7 +3296,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.showAllOutputs(current.content);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.enableOutputScrolling, {
         label: trans.__('Enable Scrolling for Outputs'),
@@ -2576,7 +3312,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.enableOutputScrolling(current.content);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.disableOutputScrolling, {
         label: trans.__('Disable Scrolling for Outputs'),
@@ -2586,7 +3328,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.disableOutputScrolling(current.content);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.selectLastRunCell, {
         label: trans.__('Select current running or last run cell'),
@@ -2596,7 +3344,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.selectLastRunCell(current.content);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.replaceSelection, {
         label: trans.__('Replace Selection in Notebook Cell'),
@@ -2607,7 +3361,18 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.replaceSelection(current.content, text);
             }
         },
-        isEnabled
+        isEnabled,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {
+                    text: {
+                        type: 'string',
+                        description: trans.__('Text to replace the selection with')
+                    }
+                }
+            }
+        }
     });
     commands.addCommand(CommandIDs.toggleCollapseCmd, {
         label: trans.__('Toggle Collapse Notebook Heading'),
@@ -2617,7 +3382,13 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
                 return NotebookActions.toggleCurrentHeadingCollapse(current.content);
             }
         },
-        isEnabled: isEnabledAndHeadingSelected
+        isEnabled: isEnabledAndHeadingSelected,
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
+        }
     });
     commands.addCommand(CommandIDs.collapseAllCmd, {
         label: trans.__('Collapse All Headings'),
@@ -2626,6 +3397,12 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
             if (current) {
                 return NotebookActions.collapseAllHeadings(current.content);
             }
+        },
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
         }
     });
     commands.addCommand(CommandIDs.expandAllCmd, {
@@ -2635,6 +3412,12 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
             if (current) {
                 return NotebookActions.expandAllHeadings(current.content);
             }
+        },
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
         }
     });
     commands.addCommand(CommandIDs.tocRunCells, {
@@ -2662,6 +3445,17 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
             }
             current.content.extendContiguousSelectionTo(lastIndex);
             void NotebookActions.run(current.content, current.sessionContext, sessionDialogs, translator);
+        },
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {
+                    activate: {
+                        type: 'boolean',
+                        description: trans.__('Whether to activate the notebook after execution')
+                    }
+                }
+            }
         }
     });
     commands.addCommand(CommandIDs.accessPreviousHistory, {
@@ -2671,6 +3465,12 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
             if (current) {
                 return await NotebookActions.accessPreviousHistory(current.content);
             }
+        },
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
         }
     });
     commands.addCommand(CommandIDs.accessNextHistory, {
@@ -2680,6 +3480,12 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
             if (current) {
                 return await NotebookActions.accessNextHistory(current.content);
             }
+        },
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {}
+            }
         }
     });
     commands.addCommand(CommandIDs.virtualScrollbar, {
@@ -2708,6 +3514,17 @@ function addCommands(app, tracker, translator, sessionDialogs, settings, isEnabl
             const visible = (args.toolbar ? true : isEnabled()) &&
                 ((_a = (settings === null || settings === void 0 ? void 0 : settings.composite.windowingMode) === 'full') !== null && _a !== void 0 ? _a : false);
             return visible;
+        },
+        describedBy: {
+            args: {
+                type: 'object',
+                properties: {
+                    toolbar: {
+                        type: 'boolean',
+                        description: trans.__('Whether the command is called from toolbar')
+                    }
+                }
+            }
         }
     });
     // All commands with isEnabled defined directly or in a semantic commands