@qodalis/cli 2.0.0-beta.7 → 2.0.0-beta.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qodalis/cli",
-  "version": "2.0.0-beta.7",
+  "version": "2.0.0-beta.8",
   "description": "Framework-agnostic CLI engine for @qodalis terminal applications.",
   "author": "Nicolae Lupei, Qodalis Solutions",
   "license": "MIT",
@@ -30,7 +30,7 @@
     "./assets/*": "./assets/*"
   },
   "dependencies": {
-    "@qodalis/cli-core": "2.0.0-beta.7",
+    "@qodalis/cli-core": "2.0.0-beta.8",
     "@xterm/xterm": "^5.5.0",
     "@xterm/addon-fit": "^0.10.0",
     "@xterm/addon-web-links": "^0.11.0",

package/public-api.d.mts

@@ -1,5 +1,5 @@
 import * as _qodalis_cli_core from '@qodalis/cli-core';
-import { ICliCommandProcessor, ICliCommandParameterDescriptor, ICliCommandProcessorRegistry, ICliCommandChildProcessor, CliProcessorMetadata, CliStateConfiguration, ICliExecutionContext, CliProcessCommand, ICliCommandAuthor, CliThemeInfo, ICliExecutionProcess, ICliUserSession, ICliSpinner, ICliPercentageProgressBar, ICliTextAnimator, ICliTerminalWriter, ICliCommandExecutorService, ICliClipboard, ICliStateStore, CliOptions, ICliLogger, ICliServiceProvider, ICliTranslationService, ICliInputReader, ICliBackgroundServiceRegistry, ICliManagedInterval, ICliManagedTimer, ICliKeyValueStore, CliSelectOption, CliMultiSelectOption, ICliCompletionProvider, ICliGlobalParameterHandler, CliProvider, CliForegroundColor, CliBackgroundColor, CliLogLevel, CliPercentageProgressBarUpdateValueOptions, CliTextAnimatorOptions, ICliModule, CliModuleRegistry, Package, ICliPingServerService, ICliProcessRegistry, ICliProcessEntry, ICliDragDropService, CliState, CliEngineSnapshot, CliServerConfig, CliServerCommandDescriptor, CliServerCapabilities, CliServerResponse, CliIcon } from '@qodalis/cli-core';
+import { ICliCommandProcessor, ICliCommandParameterDescriptor, ICliCommandProcessorRegistry, ICliCommandChildProcessor, CliProcessorMetadata, CliStateConfiguration, ICliExecutionContext, CliProcessCommand, ICliCommandAuthor, CliThemeInfo, ICliExecutionProcess, ICliUserSession, ICliSpinner, ICliPercentageProgressBar, ICliTextAnimator, ICliTerminalWriter, ICliCommandExecutorService, ICliClipboard, ICliStateStore, CliOptions, ICliLogger, ICliServiceProvider, ICliTranslationService, ICliInputReader, ICliBackgroundServiceRegistry, ICliManagedInterval, ICliManagedTimer, ICliKeyValueStore, ICliCompletionProvider, ICliFilePickerProvider, ICliGlobalParameterHandler, CliProvider, CliForegroundColor, CliBackgroundColor, CliLogLevel, CliPercentageProgressBarUpdateValueOptions, CliTextAnimatorOptions, ICliModule, CliModuleRegistry, Package, ICliPingServerService, CliLineOptions, CliSelectOption, CliSelectOptions, CliMultiSelectOption, CliMultiSelectOptions, CliDateOptions, CliFilePickerOptions, CliFileResult, ICliProcessRegistry, ICliProcessRegisterOptions, ICliProcessEntry, ICliDragDropService, CliState, CliEngineSnapshot, CliServerConfig, CliServerCommandDescriptor, CliServerCapabilities, CliServerResponse, CliIcon } from '@qodalis/cli-core';
 export { ICliUserSessionService_TOKEN, ICliUsersStoreService_TOKEN } from '@qodalis/cli-core';
 import { ITheme, Terminal, ITerminalAddon, ITerminalOptions, ITerminalInitOnlyOptions } from '@xterm/xterm';
 import { Subject, Observable, Subscription } from 'rxjs';
@@ -140,7 +140,7 @@ declare const CliBackgroundServiceRegistry_TOKEN = "cli-background-service-regis
  */
 declare const CliPackageManagerService_TOKEN = "cli-package-manager-service";
 
-declare const LIBRARY_VERSION = "2.0.0-beta.7";
+declare const LIBRARY_VERSION = "2.0.0-beta.8";
 declare const API_VERSION = 2;
 
 declare class CliAliasCommandProcessor implements ICliCommandProcessor {
@@ -406,7 +406,6 @@ declare class CliUptimeCommandProcessor implements ICliCommandProcessor {
     description: string;
     author: _qodalis_cli_core.ICliCommandAuthor;
     metadata?: CliProcessorMetadata;
-    private sessionStartTimes;
     initialize(context: ICliExecutionContext): Promise<void>;
     processCommand(_: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
     writeDescription(context: ICliExecutionContext): void;
@@ -600,6 +599,7 @@ declare class CliNanoCommandProcessor implements ICliCommandProcessor {
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
     onData(data: string, context: ICliExecutionContext): Promise<void>;
     writeDescription(context: ICliExecutionContext): void;
+    private setupHighlighting;
     private render;
     private renderPrompt;
     private showStatus;
@@ -649,6 +649,43 @@ declare class CliKillCommandProcessor implements ICliCommandProcessor {
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
 }
 
+declare class CliHtopCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    metadata?: CliProcessorMetadata;
+    private context;
+    private registry;
+    private refreshTimer;
+    private rows;
+    private selectedIndex;
+    private scrollOffset;
+    private termCols;
+    private termRows;
+    private showingLogs;
+    private errorMessage;
+    private errorTimeout;
+    processCommand(_command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    onData(data: string, context: ICliExecutionContext): Promise<void>;
+    onResize(cols: number, rows: number, _context: ICliExecutionContext): void;
+    onDispose(_context: ICliExecutionContext): void;
+    writeDescription(context: ICliExecutionContext): void;
+    private refreshData;
+    private actionKill;
+    private actionStart;
+    private actionStop;
+    private actionRestart;
+    private actionLogs;
+    private moveSelection;
+    private get visibleRows();
+    private clampScroll;
+    private render;
+    private buildFooter;
+    private renderLogsOverlay;
+    private showError;
+    private exit;
+}
+
 declare const systemProcessors: ICliCommandProcessor[];
 
 declare class CliThemeCommandProcessor implements ICliCommandProcessor {
@@ -949,53 +986,6 @@ declare class CliStateStoreManager implements ICliStateStoreManager {
     }[];
 }
 
-type ActiveInputRequestType = 'line' | 'password' | 'confirm' | 'select' | 'select-inline' | 'multi-select' | 'number';
-interface ActiveInputRequest {
-    type: ActiveInputRequestType;
-    promptText: string;
-    resolve: (value: any) => void;
-    buffer: string;
-    cursorPosition: number;
-    defaultValue?: boolean;
-    options?: CliSelectOption[];
-    selectedIndex?: number;
-    onChange?: (value: string) => void;
-    checkedIndices?: Set<number>;
-    numberOptions?: {
-        min?: number;
-        max?: number;
-        default?: number;
-    };
-    scrollOffset?: number;
-    maxVisible?: number;
-    displayLines?: number;
-}
-interface CliInputReaderHost {
-    readonly activeInputRequest: ActiveInputRequest | null;
-    setActiveInputRequest(request: ActiveInputRequest | null): void;
-    writeToTerminal(text: string): void;
-    getTerminalRows?(): number;
-}
-declare class CliInputReader implements ICliInputReader {
-    private readonly host;
-    constructor(host: CliInputReaderHost);
-    readLine(prompt: string): Promise<string | null>;
-    readPassword(prompt: string): Promise<string | null>;
-    readConfirm(prompt: string, defaultValue?: boolean): Promise<boolean | null>;
-    readSelect(prompt: string, options: CliSelectOption[], onChange?: (value: string) => void): Promise<string | null>;
-    readSelectInline(prompt: string, options: CliSelectOption[], onChange?: (value: string) => void): Promise<string | null>;
-    readMultiSelect(prompt: string, options: CliMultiSelectOption[]): Promise<string[] | null>;
-    readNumber(prompt: string, options?: {
-        min?: number;
-        max?: number;
-        default?: number;
-    }): Promise<number | null>;
-    renderSelectOptions(options: CliSelectOption[], selectedIndex: number, scrollOffset?: number, maxVisible?: number): number;
-    renderInlineSelectOptions(options: CliSelectOption[], selectedIndex: number): string;
-    renderMultiSelectOptions(options: CliSelectOption[], selectedIndex: number, checkedIndices: Set<number>, scrollOffset?: number, maxVisible?: number): number;
-    private createInputRequest;
-}
-
 /**
  * Manages tab-completion by querying registered providers in priority order.
  * Implements bash-style behavior:
@@ -1042,7 +1032,7 @@ declare class CliCompletionEngine {
 /**
  * Reusable text buffer with cursor management.
  * Eliminates duplicated line-editing logic across CommandLineMode,
- * ReaderMode, and any future input mode.
+ * LineInputMode, and any future input mode.
  */
 declare class CliLineBuffer {
     private _text;
@@ -1086,6 +1076,28 @@ interface IInputMode {
      * Called when this mode is no longer the active input mode.
      */
     deactivate?(): void;
+    /** Called when the terminal is resized while this mode is active. */
+    onResize?(cols: number, rows: number): void;
+}
+/**
+ * Host interface for input modes. Provides access to terminal I/O,
+ * dimensions, and mode stack management.
+ */
+interface InputModeHost {
+    /** Write raw text/ANSI to the terminal */
+    writeToTerminal(text: string): void;
+    /** Get terminal row count for scroll window sizing */
+    getTerminalRows(): number;
+    /** Get terminal column count for overflow calculations */
+    getTerminalCols(): number;
+    /** Push a mode onto the input mode stack */
+    pushMode(mode: IInputMode): void;
+    /** Pop the current mode from the input mode stack */
+    popMode(): void;
+    /** The xterm.js Terminal instance (for direct write when needed) */
+    readonly terminal: Terminal;
+    /** File picker provider for the current environment */
+    readonly filePickerProvider: ICliFilePickerProvider;
 }
 
 interface PromptOptions {
@@ -1145,16 +1157,6 @@ interface CommandLineModeHost {
     }): void;
 }
 
-/**
- * Host interface for ReaderMode — provides access to the active input request.
- */
-interface ReaderModeHost {
-    readonly terminal: Terminal;
-    getActiveInputRequest(): ActiveInputRequest | null;
-    setActiveInputRequest(request: ActiveInputRequest | null): void;
-    popMode(): void;
-}
-
 interface CliExecutionContextDeps {
     services: ICliServiceProvider;
     logger: ICliLogger;
@@ -1162,7 +1164,7 @@ interface CliExecutionContextDeps {
     stateStoreManager: CliStateStoreManager;
     translator: ICliTranslationService;
 }
-declare class CliExecutionContext implements ICliExecutionContext, CliInputReaderHost, CommandLineModeHost, ReaderModeHost {
+declare class CliExecutionContext implements ICliExecutionContext, InputModeHost, CommandLineModeHost {
     terminal: Terminal;
     executor: ICliCommandExecutorService;
     userSession?: ICliUserSession;
@@ -1187,20 +1189,14 @@ declare class CliExecutionContext implements ICliExecutionContext, CliInputReade
     readonly lineBuffer: CliLineBuffer;
     readonly lineRenderer: CliTerminalLineRenderer;
     readonly commandHistory: CliCommandHistory;
-    private _activeInputRequest;
+    readonly filePickerProvider: ICliFilePickerProvider;
     private readonly modeStack;
     private readonly managedTimers;
     private resizeDisposable;
     constructor(deps: CliExecutionContextDeps, terminal: Terminal, executor: ICliCommandExecutorService, cliOptions?: CliOptions);
-    get activeInputRequest(): ActiveInputRequest | null;
-    /**
-     * Sets the active input request. When a non-null request is provided,
-     * pushes ReaderMode onto the mode stack. ReaderMode pops itself on
-     * completion, so passing null here does NOT pop the mode.
-     */
-    setActiveInputRequest(request: ActiveInputRequest | null): void;
     writeToTerminal(text: string): void;
     getTerminalRows(): number;
+    getTerminalCols(): number;
     get currentLine(): string;
     get cursorPosition(): number;
     set cursorPosition(value: number);
@@ -1239,7 +1235,6 @@ declare class CliExecutionContext implements ICliExecutionContext, CliInputReade
     getPromptLength(): number;
     setPromptLength(value: number): void;
     getExecutionContext(): ICliExecutionContext;
-    getActiveInputRequest(): ActiveInputRequest | null;
     private clearAllManagedTimers;
     /**
      * Dispose all resources. Called by CliEngine.destroy() when the
@@ -1271,6 +1266,8 @@ declare class CliCommandExecutor implements ICliCommandExecutorService {
     private appendOutputToFile;
     private writeOutputToFile;
     private executeSingleCommand;
+    private completeProcess;
+    private failProcess;
     private writeStderrToFile;
     private appendStderrToFile;
     showHelp(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
@@ -1471,11 +1468,6 @@ declare class CliTerminalProgressBar implements ICliPercentageProgressBar {
     complete(): void;
     setText(text: string): void;
     private updateProgressBar;
-    /**
-     * Returns an ANSI 256-color escape for a position in the progress bar.
-     * Gradient: red (0%) -> yellow (50%) -> green (100%).
-     */
-    private progressGradientColor;
     private clearCurrentLine;
     private calcLineCount;
 }
@@ -1651,6 +1643,28 @@ declare class CliDefaultPingServerService implements ICliPingServerService {
     ping(): Promise<void>;
 }
 
+/**
+ * Factory-based input reader. Creates the appropriate input mode
+ * and pushes it onto the mode stack for each request.
+ */
+declare class CliInputReader implements ICliInputReader {
+    private readonly host;
+    constructor(host: InputModeHost);
+    readLine(prompt: string, options?: CliLineOptions): Promise<string | null>;
+    readPassword(prompt: string): Promise<string | null>;
+    readConfirm(prompt: string, defaultValue?: boolean): Promise<boolean | null>;
+    readSelect(prompt: string, options: CliSelectOption[], selectOptions?: CliSelectOptions): Promise<string | null>;
+    readSelectInline(prompt: string, options: CliSelectOption[], selectOptions?: CliSelectOptions): Promise<string | null>;
+    readMultiSelect(prompt: string, options: CliMultiSelectOption[], selectOptions?: CliMultiSelectOptions): Promise<string[] | null>;
+    readNumber(prompt: string, options?: {
+        min?: number;
+        max?: number;
+        default?: number;
+    }): Promise<number | null>;
+    readDate(prompt: string, options?: CliDateOptions): Promise<string | null>;
+    readFile(prompt: string, options?: CliFilePickerOptions): Promise<CliFileResult[] | null>;
+}
+
 /**
  * A terminal writer wrapper that captures "stdout-equivalent" output
  * (`write`, `writeln`, `writeJson`, `writeObjectsAsTable`, `writeTable`)
@@ -1735,7 +1749,7 @@ declare class CliProcessRegistry implements ICliProcessRegistry {
     private _currentPid;
     private maxHistory;
     get currentPid(): number | undefined;
-    register(command: string): {
+    register(command: string, options?: ICliProcessRegisterOptions): {
         pid: number;
         abortController: AbortController;
     };
@@ -2205,6 +2219,10 @@ interface ICliWasmAccelerator {
     prefixMatch(candidates: string[], prefix: string): string[];
     /** Longest common prefix of the given strings. */
     commonPrefix(strings: string[]): string;
+    /** Register a named rule set for syntax highlighting tokenization. */
+    registerRuleSet(ruleSetId: string, rules: string): void;
+    /** Tokenize a line using a previously registered rule set. Returns newline-separated "start,end,tokenType" entries. */
+    tokenizeLine(line: string, ruleSetId: string): string;
 }
 
 /**
@@ -2218,6 +2236,9 @@ declare class JsFallbackAccelerator implements ICliWasmAccelerator {
         text: string;
     };
     prefixMatch(candidates: string[], prefix: string): string[];
+    private ruleSets;
+    registerRuleSet(ruleSetId: string, rules: string): void;
+    tokenizeLine(line: string, ruleSetId: string): string;
     commonPrefix(strings: string[]): string;
 }
 
@@ -2242,4 +2263,4 @@ declare function getAccelerator(): ICliWasmAccelerator;
  */
 declare function isWasmAccelerated(): boolean;
 
-export { API_VERSION, type ActiveInputRequest, type ActiveInputRequestType, CLi_Name_Art, CapturingTerminalWriter, type CdnSourceName, CliAliasCommandProcessor, CliArgsParser, CliBackgroundServiceRegistry_TOKEN, CliBoot, CliCalCommandProcessor, CliCaptureCommandProcessor, CliClearCommandProcessor, CliClipboard, CliClipboardCommandProcessor, CliColorCommandProcessor, CliCommandExecutionContext, CliCommandExecutor, CliCommandHistory, CliCommandHistory_TOKEN, CliCommandProcessorRegistry, CliConfigureCommandProcessor, CliConvertCommandProcessor, CliDebugCommandProcessor, CliDefaultPingServerService, CliDiffCommandProcessor, CliDragDropService, CliEchoCommandProcessor, CliEngine, type CliEngineOptions, CliEnvCommandProcessor, CliEnvironment, CliEvalCommandProcessor, CliExecutionContext, type CliExecutionContextDeps, CliExecutionProcess, CliExportCommandProcessor, CliFeedbackCommandProcessor, CliFontSizeCommandProcessor, CliHelpCommandProcessor, CliHistoryCommandProcessor, CliHotKeysCommandProcessor, CliInputReader, type CliInputReaderHost, CliJsonCommandProcessor, CliKeyValueStore, CliKillCommandProcessor, CliLogger, CliLoremCommandProcessor, CliModuleRegistry_TOKEN, CliNanoCommandProcessor, CliOpenCommandProcessor, CliPackageManagerService, CliPackageManagerService_TOKEN, CliPackagesCommandProcessor, CliPingCommandProcessor, CliProcessRegistry, CliProcessRegistry_TOKEN, CliProcessorsRegistry_TOKEN, CliPsCommandProcessor, CliRandomCommandProcessor, CliScreenCommandProcessor, CliSeqCommandProcessor, CliServerCommandProcessor, CliServerConnection, CliServerManager, CliServerManager_TOKEN, CliServerMultiProxyProcessor, CliServerProxyProcessor, CliServiceContainer, CliServicesCommandProcessor, CliSleepCommandProcessor, CliSnippetCommandProcessor, CliSshCommandProcessor, CliStateStore, CliStateStoreManager, CliStateStoreManager_TOKEN, CliTerminalProgressBar, CliTerminalSpinner, CliTerminalTextAnimator, CliTerminalWriter, CliTestHarness, type CliTestResult, CliThemeCommandProcessor, CliTimeCommandProcessor, CliTimestampCommandProcessor, CliUnAliasCommandProcessor, CliUnameCommandProcessor, CliUnsetCommandProcessor, CliUptimeCommandProcessor, CliVersionCommandProcessor, type CliWelcomeMessageConfig, CliYesCommandProcessor, CommandParser, type CommandParserOutput, type CommandPart, type ConfigureState, type DefaultServerProvider, type DiffLine, type DiffType, type ICliEnvironment, ICliEnvironment_TOKEN, type ICliExecutionHost, ICliPingServerService_TOKEN, type ICliStateStoreManager, type ICliWasmAccelerator, JsFallbackAccelerator, LIBRARY_VERSION, type MultiProxyEntry, OverlayAddon, type ParsedArg, type ParsedToken, ProcessExitedError, ScriptLoaderService, type ThemeState, builtinProcessors, computeDiff, contextGlobalParameter, createServerModule, executeOnServer, formatDiff, getAccelerator, getCliNameArt, getGreetingBasedOnTime, groupBy, helpGlobalParameter, hotkeysInfo, initWasmAccelerator, isWasmAccelerated, miscProcessors, openLink, reconcileArgs, renderServerResponse, systemProcessors, themeInfos, themes, versionGlobalParameter, welcomeModule };
+export { API_VERSION, CLi_Name_Art, CapturingTerminalWriter, type CdnSourceName, CliAliasCommandProcessor, CliArgsParser, CliBackgroundServiceRegistry_TOKEN, CliBoot, CliCalCommandProcessor, CliCaptureCommandProcessor, CliClearCommandProcessor, CliClipboard, CliClipboardCommandProcessor, CliColorCommandProcessor, CliCommandExecutionContext, CliCommandExecutor, CliCommandHistory, CliCommandHistory_TOKEN, CliCommandProcessorRegistry, CliConfigureCommandProcessor, CliConvertCommandProcessor, CliDebugCommandProcessor, CliDefaultPingServerService, CliDiffCommandProcessor, CliDragDropService, CliEchoCommandProcessor, CliEngine, type CliEngineOptions, CliEnvCommandProcessor, CliEnvironment, CliEvalCommandProcessor, CliExecutionContext, type CliExecutionContextDeps, CliExecutionProcess, CliExportCommandProcessor, CliFeedbackCommandProcessor, CliFontSizeCommandProcessor, CliHelpCommandProcessor, CliHistoryCommandProcessor, CliHotKeysCommandProcessor, CliHtopCommandProcessor, CliInputReader, CliJsonCommandProcessor, CliKeyValueStore, CliKillCommandProcessor, CliLogger, CliLoremCommandProcessor, CliModuleRegistry_TOKEN, CliNanoCommandProcessor, CliOpenCommandProcessor, CliPackageManagerService, CliPackageManagerService_TOKEN, CliPackagesCommandProcessor, CliPingCommandProcessor, CliProcessRegistry, CliProcessRegistry_TOKEN, CliProcessorsRegistry_TOKEN, CliPsCommandProcessor, CliRandomCommandProcessor, CliScreenCommandProcessor, CliSeqCommandProcessor, CliServerCommandProcessor, CliServerConnection, CliServerManager, CliServerManager_TOKEN, CliServerMultiProxyProcessor, CliServerProxyProcessor, CliServiceContainer, CliServicesCommandProcessor, CliSleepCommandProcessor, CliSnippetCommandProcessor, CliSshCommandProcessor, CliStateStore, CliStateStoreManager, CliStateStoreManager_TOKEN, CliTerminalProgressBar, CliTerminalSpinner, CliTerminalTextAnimator, CliTerminalWriter, CliTestHarness, type CliTestResult, CliThemeCommandProcessor, CliTimeCommandProcessor, CliTimestampCommandProcessor, CliUnAliasCommandProcessor, CliUnameCommandProcessor, CliUnsetCommandProcessor, CliUptimeCommandProcessor, CliVersionCommandProcessor, type CliWelcomeMessageConfig, CliYesCommandProcessor, CommandParser, type CommandParserOutput, type CommandPart, type ConfigureState, type DefaultServerProvider, type DiffLine, type DiffType, type ICliEnvironment, ICliEnvironment_TOKEN, type ICliExecutionHost, ICliPingServerService_TOKEN, type ICliStateStoreManager, type ICliWasmAccelerator, JsFallbackAccelerator, LIBRARY_VERSION, type MultiProxyEntry, OverlayAddon, type ParsedArg, type ParsedToken, ProcessExitedError, ScriptLoaderService, type ThemeState, builtinProcessors, computeDiff, contextGlobalParameter, createServerModule, executeOnServer, formatDiff, getAccelerator, getCliNameArt, getGreetingBasedOnTime, groupBy, helpGlobalParameter, hotkeysInfo, initWasmAccelerator, isWasmAccelerated, miscProcessors, openLink, reconcileArgs, renderServerResponse, systemProcessors, themeInfos, themes, versionGlobalParameter, welcomeModule };

package/public-api.d.ts

@@ -1,5 +1,5 @@
 import * as _qodalis_cli_core from '@qodalis/cli-core';
-import { ICliCommandProcessor, ICliCommandParameterDescriptor, ICliCommandProcessorRegistry, ICliCommandChildProcessor, CliProcessorMetadata, CliStateConfiguration, ICliExecutionContext, CliProcessCommand, ICliCommandAuthor, CliThemeInfo, ICliExecutionProcess, ICliUserSession, ICliSpinner, ICliPercentageProgressBar, ICliTextAnimator, ICliTerminalWriter, ICliCommandExecutorService, ICliClipboard, ICliStateStore, CliOptions, ICliLogger, ICliServiceProvider, ICliTranslationService, ICliInputReader, ICliBackgroundServiceRegistry, ICliManagedInterval, ICliManagedTimer, ICliKeyValueStore, CliSelectOption, CliMultiSelectOption, ICliCompletionProvider, ICliGlobalParameterHandler, CliProvider, CliForegroundColor, CliBackgroundColor, CliLogLevel, CliPercentageProgressBarUpdateValueOptions, CliTextAnimatorOptions, ICliModule, CliModuleRegistry, Package, ICliPingServerService, ICliProcessRegistry, ICliProcessEntry, ICliDragDropService, CliState, CliEngineSnapshot, CliServerConfig, CliServerCommandDescriptor, CliServerCapabilities, CliServerResponse, CliIcon } from '@qodalis/cli-core';
+import { ICliCommandProcessor, ICliCommandParameterDescriptor, ICliCommandProcessorRegistry, ICliCommandChildProcessor, CliProcessorMetadata, CliStateConfiguration, ICliExecutionContext, CliProcessCommand, ICliCommandAuthor, CliThemeInfo, ICliExecutionProcess, ICliUserSession, ICliSpinner, ICliPercentageProgressBar, ICliTextAnimator, ICliTerminalWriter, ICliCommandExecutorService, ICliClipboard, ICliStateStore, CliOptions, ICliLogger, ICliServiceProvider, ICliTranslationService, ICliInputReader, ICliBackgroundServiceRegistry, ICliManagedInterval, ICliManagedTimer, ICliKeyValueStore, ICliCompletionProvider, ICliFilePickerProvider, ICliGlobalParameterHandler, CliProvider, CliForegroundColor, CliBackgroundColor, CliLogLevel, CliPercentageProgressBarUpdateValueOptions, CliTextAnimatorOptions, ICliModule, CliModuleRegistry, Package, ICliPingServerService, CliLineOptions, CliSelectOption, CliSelectOptions, CliMultiSelectOption, CliMultiSelectOptions, CliDateOptions, CliFilePickerOptions, CliFileResult, ICliProcessRegistry, ICliProcessRegisterOptions, ICliProcessEntry, ICliDragDropService, CliState, CliEngineSnapshot, CliServerConfig, CliServerCommandDescriptor, CliServerCapabilities, CliServerResponse, CliIcon } from '@qodalis/cli-core';
 export { ICliUserSessionService_TOKEN, ICliUsersStoreService_TOKEN } from '@qodalis/cli-core';
 import { ITheme, Terminal, ITerminalAddon, ITerminalOptions, ITerminalInitOnlyOptions } from '@xterm/xterm';
 import { Subject, Observable, Subscription } from 'rxjs';
@@ -140,7 +140,7 @@ declare const CliBackgroundServiceRegistry_TOKEN = "cli-background-service-regis
  */
 declare const CliPackageManagerService_TOKEN = "cli-package-manager-service";
 
-declare const LIBRARY_VERSION = "2.0.0-beta.7";
+declare const LIBRARY_VERSION = "2.0.0-beta.8";
 declare const API_VERSION = 2;
 
 declare class CliAliasCommandProcessor implements ICliCommandProcessor {
@@ -406,7 +406,6 @@ declare class CliUptimeCommandProcessor implements ICliCommandProcessor {
     description: string;
     author: _qodalis_cli_core.ICliCommandAuthor;
     metadata?: CliProcessorMetadata;
-    private sessionStartTimes;
     initialize(context: ICliExecutionContext): Promise<void>;
     processCommand(_: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
     writeDescription(context: ICliExecutionContext): void;
@@ -600,6 +599,7 @@ declare class CliNanoCommandProcessor implements ICliCommandProcessor {
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
     onData(data: string, context: ICliExecutionContext): Promise<void>;
     writeDescription(context: ICliExecutionContext): void;
+    private setupHighlighting;
     private render;
     private renderPrompt;
     private showStatus;
@@ -649,6 +649,43 @@ declare class CliKillCommandProcessor implements ICliCommandProcessor {
     processCommand(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
 }
 
+declare class CliHtopCommandProcessor implements ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: _qodalis_cli_core.ICliCommandAuthor;
+    metadata?: CliProcessorMetadata;
+    private context;
+    private registry;
+    private refreshTimer;
+    private rows;
+    private selectedIndex;
+    private scrollOffset;
+    private termCols;
+    private termRows;
+    private showingLogs;
+    private errorMessage;
+    private errorTimeout;
+    processCommand(_command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
+    onData(data: string, context: ICliExecutionContext): Promise<void>;
+    onResize(cols: number, rows: number, _context: ICliExecutionContext): void;
+    onDispose(_context: ICliExecutionContext): void;
+    writeDescription(context: ICliExecutionContext): void;
+    private refreshData;
+    private actionKill;
+    private actionStart;
+    private actionStop;
+    private actionRestart;
+    private actionLogs;
+    private moveSelection;
+    private get visibleRows();
+    private clampScroll;
+    private render;
+    private buildFooter;
+    private renderLogsOverlay;
+    private showError;
+    private exit;
+}
+
 declare const systemProcessors: ICliCommandProcessor[];
 
 declare class CliThemeCommandProcessor implements ICliCommandProcessor {
@@ -949,53 +986,6 @@ declare class CliStateStoreManager implements ICliStateStoreManager {
     }[];
 }
 
-type ActiveInputRequestType = 'line' | 'password' | 'confirm' | 'select' | 'select-inline' | 'multi-select' | 'number';
-interface ActiveInputRequest {
-    type: ActiveInputRequestType;
-    promptText: string;
-    resolve: (value: any) => void;
-    buffer: string;
-    cursorPosition: number;
-    defaultValue?: boolean;
-    options?: CliSelectOption[];
-    selectedIndex?: number;
-    onChange?: (value: string) => void;
-    checkedIndices?: Set<number>;
-    numberOptions?: {
-        min?: number;
-        max?: number;
-        default?: number;
-    };
-    scrollOffset?: number;
-    maxVisible?: number;
-    displayLines?: number;
-}
-interface CliInputReaderHost {
-    readonly activeInputRequest: ActiveInputRequest | null;
-    setActiveInputRequest(request: ActiveInputRequest | null): void;
-    writeToTerminal(text: string): void;
-    getTerminalRows?(): number;
-}
-declare class CliInputReader implements ICliInputReader {
-    private readonly host;
-    constructor(host: CliInputReaderHost);
-    readLine(prompt: string): Promise<string | null>;
-    readPassword(prompt: string): Promise<string | null>;
-    readConfirm(prompt: string, defaultValue?: boolean): Promise<boolean | null>;
-    readSelect(prompt: string, options: CliSelectOption[], onChange?: (value: string) => void): Promise<string | null>;
-    readSelectInline(prompt: string, options: CliSelectOption[], onChange?: (value: string) => void): Promise<string | null>;
-    readMultiSelect(prompt: string, options: CliMultiSelectOption[]): Promise<string[] | null>;
-    readNumber(prompt: string, options?: {
-        min?: number;
-        max?: number;
-        default?: number;
-    }): Promise<number | null>;
-    renderSelectOptions(options: CliSelectOption[], selectedIndex: number, scrollOffset?: number, maxVisible?: number): number;
-    renderInlineSelectOptions(options: CliSelectOption[], selectedIndex: number): string;
-    renderMultiSelectOptions(options: CliSelectOption[], selectedIndex: number, checkedIndices: Set<number>, scrollOffset?: number, maxVisible?: number): number;
-    private createInputRequest;
-}
-
 /**
  * Manages tab-completion by querying registered providers in priority order.
  * Implements bash-style behavior:
@@ -1042,7 +1032,7 @@ declare class CliCompletionEngine {
 /**
  * Reusable text buffer with cursor management.
  * Eliminates duplicated line-editing logic across CommandLineMode,
- * ReaderMode, and any future input mode.
+ * LineInputMode, and any future input mode.
  */
 declare class CliLineBuffer {
     private _text;
@@ -1086,6 +1076,28 @@ interface IInputMode {
      * Called when this mode is no longer the active input mode.
      */
     deactivate?(): void;
+    /** Called when the terminal is resized while this mode is active. */
+    onResize?(cols: number, rows: number): void;
+}
+/**
+ * Host interface for input modes. Provides access to terminal I/O,
+ * dimensions, and mode stack management.
+ */
+interface InputModeHost {
+    /** Write raw text/ANSI to the terminal */
+    writeToTerminal(text: string): void;
+    /** Get terminal row count for scroll window sizing */
+    getTerminalRows(): number;
+    /** Get terminal column count for overflow calculations */
+    getTerminalCols(): number;
+    /** Push a mode onto the input mode stack */
+    pushMode(mode: IInputMode): void;
+    /** Pop the current mode from the input mode stack */
+    popMode(): void;
+    /** The xterm.js Terminal instance (for direct write when needed) */
+    readonly terminal: Terminal;
+    /** File picker provider for the current environment */
+    readonly filePickerProvider: ICliFilePickerProvider;
 }
 
 interface PromptOptions {
@@ -1145,16 +1157,6 @@ interface CommandLineModeHost {
     }): void;
 }
 
-/**
- * Host interface for ReaderMode — provides access to the active input request.
- */
-interface ReaderModeHost {
-    readonly terminal: Terminal;
-    getActiveInputRequest(): ActiveInputRequest | null;
-    setActiveInputRequest(request: ActiveInputRequest | null): void;
-    popMode(): void;
-}
-
 interface CliExecutionContextDeps {
     services: ICliServiceProvider;
     logger: ICliLogger;
@@ -1162,7 +1164,7 @@ interface CliExecutionContextDeps {
     stateStoreManager: CliStateStoreManager;
     translator: ICliTranslationService;
 }
-declare class CliExecutionContext implements ICliExecutionContext, CliInputReaderHost, CommandLineModeHost, ReaderModeHost {
+declare class CliExecutionContext implements ICliExecutionContext, InputModeHost, CommandLineModeHost {
     terminal: Terminal;
     executor: ICliCommandExecutorService;
     userSession?: ICliUserSession;
@@ -1187,20 +1189,14 @@ declare class CliExecutionContext implements ICliExecutionContext, CliInputReade
     readonly lineBuffer: CliLineBuffer;
     readonly lineRenderer: CliTerminalLineRenderer;
     readonly commandHistory: CliCommandHistory;
-    private _activeInputRequest;
+    readonly filePickerProvider: ICliFilePickerProvider;
     private readonly modeStack;
     private readonly managedTimers;
     private resizeDisposable;
     constructor(deps: CliExecutionContextDeps, terminal: Terminal, executor: ICliCommandExecutorService, cliOptions?: CliOptions);
-    get activeInputRequest(): ActiveInputRequest | null;
-    /**
-     * Sets the active input request. When a non-null request is provided,
-     * pushes ReaderMode onto the mode stack. ReaderMode pops itself on
-     * completion, so passing null here does NOT pop the mode.
-     */
-    setActiveInputRequest(request: ActiveInputRequest | null): void;
     writeToTerminal(text: string): void;
     getTerminalRows(): number;
+    getTerminalCols(): number;
     get currentLine(): string;
     get cursorPosition(): number;
     set cursorPosition(value: number);
@@ -1239,7 +1235,6 @@ declare class CliExecutionContext implements ICliExecutionContext, CliInputReade
     getPromptLength(): number;
     setPromptLength(value: number): void;
     getExecutionContext(): ICliExecutionContext;
-    getActiveInputRequest(): ActiveInputRequest | null;
     private clearAllManagedTimers;
     /**
      * Dispose all resources. Called by CliEngine.destroy() when the
@@ -1271,6 +1266,8 @@ declare class CliCommandExecutor implements ICliCommandExecutorService {
     private appendOutputToFile;
     private writeOutputToFile;
     private executeSingleCommand;
+    private completeProcess;
+    private failProcess;
     private writeStderrToFile;
     private appendStderrToFile;
     showHelp(command: CliProcessCommand, context: ICliExecutionContext): Promise<void>;
@@ -1471,11 +1468,6 @@ declare class CliTerminalProgressBar implements ICliPercentageProgressBar {
     complete(): void;
     setText(text: string): void;
     private updateProgressBar;
-    /**
-     * Returns an ANSI 256-color escape for a position in the progress bar.
-     * Gradient: red (0%) -> yellow (50%) -> green (100%).
-     */
-    private progressGradientColor;
     private clearCurrentLine;
     private calcLineCount;
 }
@@ -1651,6 +1643,28 @@ declare class CliDefaultPingServerService implements ICliPingServerService {
     ping(): Promise<void>;
 }
 
+/**
+ * Factory-based input reader. Creates the appropriate input mode
+ * and pushes it onto the mode stack for each request.
+ */
+declare class CliInputReader implements ICliInputReader {
+    private readonly host;
+    constructor(host: InputModeHost);
+    readLine(prompt: string, options?: CliLineOptions): Promise<string | null>;
+    readPassword(prompt: string): Promise<string | null>;
+    readConfirm(prompt: string, defaultValue?: boolean): Promise<boolean | null>;
+    readSelect(prompt: string, options: CliSelectOption[], selectOptions?: CliSelectOptions): Promise<string | null>;
+    readSelectInline(prompt: string, options: CliSelectOption[], selectOptions?: CliSelectOptions): Promise<string | null>;
+    readMultiSelect(prompt: string, options: CliMultiSelectOption[], selectOptions?: CliMultiSelectOptions): Promise<string[] | null>;
+    readNumber(prompt: string, options?: {
+        min?: number;
+        max?: number;
+        default?: number;
+    }): Promise<number | null>;
+    readDate(prompt: string, options?: CliDateOptions): Promise<string | null>;
+    readFile(prompt: string, options?: CliFilePickerOptions): Promise<CliFileResult[] | null>;
+}
+
 /**
  * A terminal writer wrapper that captures "stdout-equivalent" output
  * (`write`, `writeln`, `writeJson`, `writeObjectsAsTable`, `writeTable`)
@@ -1735,7 +1749,7 @@ declare class CliProcessRegistry implements ICliProcessRegistry {
     private _currentPid;
     private maxHistory;
     get currentPid(): number | undefined;
-    register(command: string): {
+    register(command: string, options?: ICliProcessRegisterOptions): {
         pid: number;
         abortController: AbortController;
     };
@@ -2205,6 +2219,10 @@ interface ICliWasmAccelerator {
     prefixMatch(candidates: string[], prefix: string): string[];
     /** Longest common prefix of the given strings. */
     commonPrefix(strings: string[]): string;
+    /** Register a named rule set for syntax highlighting tokenization. */
+    registerRuleSet(ruleSetId: string, rules: string): void;
+    /** Tokenize a line using a previously registered rule set. Returns newline-separated "start,end,tokenType" entries. */
+    tokenizeLine(line: string, ruleSetId: string): string;
 }
 
 /**
@@ -2218,6 +2236,9 @@ declare class JsFallbackAccelerator implements ICliWasmAccelerator {
         text: string;
     };
     prefixMatch(candidates: string[], prefix: string): string[];
+    private ruleSets;
+    registerRuleSet(ruleSetId: string, rules: string): void;
+    tokenizeLine(line: string, ruleSetId: string): string;
     commonPrefix(strings: string[]): string;
 }
 
@@ -2242,4 +2263,4 @@ declare function getAccelerator(): ICliWasmAccelerator;
  */
 declare function isWasmAccelerated(): boolean;
 
-export { API_VERSION, type ActiveInputRequest, type ActiveInputRequestType, CLi_Name_Art, CapturingTerminalWriter, type CdnSourceName, CliAliasCommandProcessor, CliArgsParser, CliBackgroundServiceRegistry_TOKEN, CliBoot, CliCalCommandProcessor, CliCaptureCommandProcessor, CliClearCommandProcessor, CliClipboard, CliClipboardCommandProcessor, CliColorCommandProcessor, CliCommandExecutionContext, CliCommandExecutor, CliCommandHistory, CliCommandHistory_TOKEN, CliCommandProcessorRegistry, CliConfigureCommandProcessor, CliConvertCommandProcessor, CliDebugCommandProcessor, CliDefaultPingServerService, CliDiffCommandProcessor, CliDragDropService, CliEchoCommandProcessor, CliEngine, type CliEngineOptions, CliEnvCommandProcessor, CliEnvironment, CliEvalCommandProcessor, CliExecutionContext, type CliExecutionContextDeps, CliExecutionProcess, CliExportCommandProcessor, CliFeedbackCommandProcessor, CliFontSizeCommandProcessor, CliHelpCommandProcessor, CliHistoryCommandProcessor, CliHotKeysCommandProcessor, CliInputReader, type CliInputReaderHost, CliJsonCommandProcessor, CliKeyValueStore, CliKillCommandProcessor, CliLogger, CliLoremCommandProcessor, CliModuleRegistry_TOKEN, CliNanoCommandProcessor, CliOpenCommandProcessor, CliPackageManagerService, CliPackageManagerService_TOKEN, CliPackagesCommandProcessor, CliPingCommandProcessor, CliProcessRegistry, CliProcessRegistry_TOKEN, CliProcessorsRegistry_TOKEN, CliPsCommandProcessor, CliRandomCommandProcessor, CliScreenCommandProcessor, CliSeqCommandProcessor, CliServerCommandProcessor, CliServerConnection, CliServerManager, CliServerManager_TOKEN, CliServerMultiProxyProcessor, CliServerProxyProcessor, CliServiceContainer, CliServicesCommandProcessor, CliSleepCommandProcessor, CliSnippetCommandProcessor, CliSshCommandProcessor, CliStateStore, CliStateStoreManager, CliStateStoreManager_TOKEN, CliTerminalProgressBar, CliTerminalSpinner, CliTerminalTextAnimator, CliTerminalWriter, CliTestHarness, type CliTestResult, CliThemeCommandProcessor, CliTimeCommandProcessor, CliTimestampCommandProcessor, CliUnAliasCommandProcessor, CliUnameCommandProcessor, CliUnsetCommandProcessor, CliUptimeCommandProcessor, CliVersionCommandProcessor, type CliWelcomeMessageConfig, CliYesCommandProcessor, CommandParser, type CommandParserOutput, type CommandPart, type ConfigureState, type DefaultServerProvider, type DiffLine, type DiffType, type ICliEnvironment, ICliEnvironment_TOKEN, type ICliExecutionHost, ICliPingServerService_TOKEN, type ICliStateStoreManager, type ICliWasmAccelerator, JsFallbackAccelerator, LIBRARY_VERSION, type MultiProxyEntry, OverlayAddon, type ParsedArg, type ParsedToken, ProcessExitedError, ScriptLoaderService, type ThemeState, builtinProcessors, computeDiff, contextGlobalParameter, createServerModule, executeOnServer, formatDiff, getAccelerator, getCliNameArt, getGreetingBasedOnTime, groupBy, helpGlobalParameter, hotkeysInfo, initWasmAccelerator, isWasmAccelerated, miscProcessors, openLink, reconcileArgs, renderServerResponse, systemProcessors, themeInfos, themes, versionGlobalParameter, welcomeModule };
+export { API_VERSION, CLi_Name_Art, CapturingTerminalWriter, type CdnSourceName, CliAliasCommandProcessor, CliArgsParser, CliBackgroundServiceRegistry_TOKEN, CliBoot, CliCalCommandProcessor, CliCaptureCommandProcessor, CliClearCommandProcessor, CliClipboard, CliClipboardCommandProcessor, CliColorCommandProcessor, CliCommandExecutionContext, CliCommandExecutor, CliCommandHistory, CliCommandHistory_TOKEN, CliCommandProcessorRegistry, CliConfigureCommandProcessor, CliConvertCommandProcessor, CliDebugCommandProcessor, CliDefaultPingServerService, CliDiffCommandProcessor, CliDragDropService, CliEchoCommandProcessor, CliEngine, type CliEngineOptions, CliEnvCommandProcessor, CliEnvironment, CliEvalCommandProcessor, CliExecutionContext, type CliExecutionContextDeps, CliExecutionProcess, CliExportCommandProcessor, CliFeedbackCommandProcessor, CliFontSizeCommandProcessor, CliHelpCommandProcessor, CliHistoryCommandProcessor, CliHotKeysCommandProcessor, CliHtopCommandProcessor, CliInputReader, CliJsonCommandProcessor, CliKeyValueStore, CliKillCommandProcessor, CliLogger, CliLoremCommandProcessor, CliModuleRegistry_TOKEN, CliNanoCommandProcessor, CliOpenCommandProcessor, CliPackageManagerService, CliPackageManagerService_TOKEN, CliPackagesCommandProcessor, CliPingCommandProcessor, CliProcessRegistry, CliProcessRegistry_TOKEN, CliProcessorsRegistry_TOKEN, CliPsCommandProcessor, CliRandomCommandProcessor, CliScreenCommandProcessor, CliSeqCommandProcessor, CliServerCommandProcessor, CliServerConnection, CliServerManager, CliServerManager_TOKEN, CliServerMultiProxyProcessor, CliServerProxyProcessor, CliServiceContainer, CliServicesCommandProcessor, CliSleepCommandProcessor, CliSnippetCommandProcessor, CliSshCommandProcessor, CliStateStore, CliStateStoreManager, CliStateStoreManager_TOKEN, CliTerminalProgressBar, CliTerminalSpinner, CliTerminalTextAnimator, CliTerminalWriter, CliTestHarness, type CliTestResult, CliThemeCommandProcessor, CliTimeCommandProcessor, CliTimestampCommandProcessor, CliUnAliasCommandProcessor, CliUnameCommandProcessor, CliUnsetCommandProcessor, CliUptimeCommandProcessor, CliVersionCommandProcessor, type CliWelcomeMessageConfig, CliYesCommandProcessor, CommandParser, type CommandParserOutput, type CommandPart, type ConfigureState, type DefaultServerProvider, type DiffLine, type DiffType, type ICliEnvironment, ICliEnvironment_TOKEN, type ICliExecutionHost, ICliPingServerService_TOKEN, type ICliStateStoreManager, type ICliWasmAccelerator, JsFallbackAccelerator, LIBRARY_VERSION, type MultiProxyEntry, OverlayAddon, type ParsedArg, type ParsedToken, ProcessExitedError, ScriptLoaderService, type ThemeState, builtinProcessors, computeDiff, contextGlobalParameter, createServerModule, executeOnServer, formatDiff, getAccelerator, getCliNameArt, getGreetingBasedOnTime, groupBy, helpGlobalParameter, hotkeysInfo, initWasmAccelerator, isWasmAccelerated, miscProcessors, openLink, reconcileArgs, renderServerResponse, systemProcessors, themeInfos, themes, versionGlobalParameter, welcomeModule };