@qodalis/cli 2.0.0-beta.11 → 2.0.0-beta.13

package/public-api.d.mts

@@ -1,7 +1,8 @@
 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, ICliCompletionProvider, ICliFilePickerProvider, CliFullScreenOptions, ICliProcessRegistry, ICliBackgroundService, ICliServiceContext, ICliBackgroundServiceInfo, ICliServiceLogEntry, CliServiceEventHandler, ICliGlobalParameterHandler, CliForegroundColor, CliBackgroundColor, CliProvider, CliTableOptions, CliLogLevel, CliPercentageProgressBarUpdateValueOptions, CliTextAnimatorOptions, ICliModule, CliModuleRegistry, Package, ICliPingServerService, CliLineOptions, CliSelectOption, CliSelectOptions, CliMultiSelectOption, CliMultiSelectOptions, CliNumberOptions, CliDateOptions, CliFilePickerOptions, CliFileResult, ICliProcessRegisterOptions, ICliProcessEntry, ICliDragDropService, CliState, CliEngineSnapshot, CliServerConfig, CliServerCommandDescriptor, CliServerCapabilities, CliServerResponse, CliServerOutput, 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, ICliHttpClient, ICliNotifier, ICliManagedInterval, ICliManagedTimer, ICliKeyValueStore, ICliCompletionProvider, ICliFilePickerProvider, CliFullScreenOptions, ICliProcessRegistry, ICliBackgroundService, ICliServiceContext, ICliBackgroundServiceInfo, ICliServiceLogEntry, CliServiceEventHandler, ICliGlobalParameterHandler, CliForegroundColor, CliBackgroundColor, CliProvider, CliTableOptions, CliLogLevel, CliPercentageProgressBarUpdateValueOptions, CliTextAnimatorOptions, ICliModule, CliModuleRegistry, Package, ICliPingServerService, CliLineOptions, CliSelectOption, CliSelectOptions, CliMultiSelectOption, CliMultiSelectOptions, CliNumberOptions, CliDateOptions, CliFilePickerOptions, CliFileResult, ICliProcessRegisterOptions, ICliProcessEntry, ICliDragDropService, CliHttpRequestOptions, CliNotification, CliState, CliEngineSnapshot, CliServerConfig, ICliServerAuthService, CliServerCommandDescriptor, CliServerCapabilities, CliServerResponse, CliServerOutput, CliIcon } from '@qodalis/cli-core';
 export { ICliUserSessionService_TOKEN, ICliUsersStoreService_TOKEN } from '@qodalis/cli-core';
 import { ITheme, Terminal, ITerminalAddon, ITerminalOptions, ITerminalInitOnlyOptions } from '@xterm/xterm';
+import * as rxjs from 'rxjs';
 import { Subject, Observable, Subscription } from 'rxjs';
 import { FitAddon } from '@xterm/addon-fit';
 import { SerializeAddon } from '@xterm/addon-serialize';
@@ -141,8 +142,18 @@ declare const CliBackgroundServiceRegistry_TOKEN = "cli-background-service-regis
  * Used as a key in the service provider to retrieve the package manager.
  */
 declare const CliPackageManagerService_TOKEN = "cli-package-manager-service";
+/**
+ * Framework-agnostic token for the CLI key-value store.
+ * Used as a key in the service provider to retrieve the persistent storage.
+ */
+declare const CliKeyValueStore_TOKEN = "cli-key-value-store";
+/**
+ * Framework-agnostic token for the syntax highlighter registry.
+ * Used as a key in the service provider to retrieve the syntax highlighter registry.
+ */
+declare const SyntaxHighlighterRegistry_TOKEN = "syntax-highlighter-registry";
 
-declare const LIBRARY_VERSION = "2.0.0-beta.11";
+declare const LIBRARY_VERSION = "2.0.0-beta.13";
 declare const API_VERSION = 2;
 
 declare class CliAliasCommandProcessor implements ICliCommandProcessor {
@@ -910,6 +921,8 @@ declare class CliCommandExecutionContext implements ICliExecutionContext {
     translator: ICliTranslationService;
     reader: ICliInputReader;
     readonly backgroundServices: ICliBackgroundServiceRegistry;
+    http: ICliHttpClient;
+    notifier: ICliNotifier;
     get promptLength(): number;
     set promptLength(value: number);
     get currentLine(): string;
@@ -928,6 +941,7 @@ declare class CliCommandExecutionContext implements ICliExecutionContext {
     exitFullScreenMode: () => void;
     createInterval: (callback: () => void, ms: number) => ICliManagedInterval;
     createTimeout: (callback: () => void, ms: number) => ICliManagedTimer;
+    submitCommand: (command: string) => Promise<void>;
     constructor(context: ICliExecutionContext, processor: ICliCommandProcessor);
 }
 
@@ -1189,10 +1203,25 @@ declare class CliExecutionContext implements ICliExecutionContext, InputModeHost
     readonly services: ICliServiceProvider;
     readonly translator: ICliTranslationService;
     readonly backgroundServices: ICliBackgroundServiceRegistry;
+    http: ICliHttpClient;
+    readonly notifier: ICliNotifier;
     promptPathProvider?: () => string | null;
     readonly completionEngine: CliCompletionEngine;
     promptLength: number;
     readonly reader: ICliInputReader;
+    /**
+     * Result of the most recently executed command.
+     * Updated by the command executor after each command completes.
+     */
+    lastCommandResult?: {
+        command: string;
+        success: boolean;
+    };
+    /**
+     * Whether a command is currently being executed.
+     * Set by the command executor at start/end of executeCommand().
+     */
+    isExecuting: boolean;
     readonly lineBuffer: CliLineBuffer;
     readonly lineRenderer: CliTerminalLineRenderer;
     readonly commandHistory: CliCommandHistory;
@@ -1218,6 +1247,12 @@ declare class CliExecutionContext implements ICliExecutionContext, InputModeHost
         newLine?: boolean;
         keepCurrentLine?: boolean;
     }): void;
+    /**
+     * Submit and execute a command — shared by interactive Enter key
+     * and programmatic engine.execute(). Adds to history, runs the
+     * command, and shows a new prompt afterwards.
+     */
+    submitCommand(command: string): Promise<void>;
     clearCurrentLine(): void;
     refreshCurrentLine(previousContentLength?: number): void;
     /**
@@ -1349,6 +1384,11 @@ declare class CliTimerManager {
 interface ICliExecutionHost extends ICliExecutionContext {
     contextProcessor?: ICliCommandProcessor;
     abort?(): void;
+    lastCommandResult?: {
+        command: string;
+        success: boolean;
+    };
+    isExecuting?: boolean;
 }
 declare class CliCommandExecutor implements ICliCommandExecutorService {
     protected readonly registry: ICliCommandProcessorRegistry;
@@ -1524,18 +1564,58 @@ declare function expandEnvironmentVars(command: string, context: ICliExecutionCo
  * and `get()` returns an array of resolved values.
  */
 declare class CliServiceContainer implements ICliServiceProvider {
-    /** Stores single-value providers (resolved or pending). */
+    /** Stores single-value providers (resolved singletons). */
     private readonly services;
     /** Stores multi-provider arrays. */
     private readonly multiServices;
+    /** Tokens that cannot be overwritten by subsequent `set()` calls. */
+    private readonly sealedTokens;
+    /** Stores provider recipes for transient tokens (re-resolved on every get). */
+    private readonly transientRecipes;
     /**
      * Retrieve a service by its token.
+     * Returns `undefined` when no provider is registered for the token.
+     * For multi-provider tokens, returns the last registered value (use `getAll` for the full array).
+     *
+     * @param token The token used to register the service.
+     * @returns The resolved service instance, or `undefined` if not registered.
+     */
+    get<T>(token: any): T | undefined;
+    /**
+     * Retrieve all registered services for a multi-provider token.
+     * Returns an empty array when no provider is registered for the token.
      *
      * @param token The token used to register the service.
-     * @returns The resolved service instance (or array for multi providers).
+     * @returns Array of all resolved service instances.
+     */
+    getAll<T>(token: any): T[];
+    /**
+     * Retrieve a service by its token, throwing if not registered.
+     * Use this when the service is required and its absence is a programming error.
+     * For multi-provider tokens, returns the last registered value (use `getAll` for the full array).
+     *
+     * @param token The token used to register the service.
+     * @returns The resolved service instance.
      * @throws Error if the token has not been registered.
      */
-    get<T>(token: any): T;
+    getRequired<T>(token: any): T;
+    /**
+     * Check whether a service is registered for the given token.
+     */
+    has(token: any): boolean;
+    /**
+     * Mark a token as sealed so it cannot be overwritten by future `set()` calls.
+     * Only available on the concrete container — not exposed on `ICliServiceProvider`.
+     */
+    seal(token: any): void;
+    /**
+     * Mark multiple tokens as sealed at once.
+     */
+    sealAll(tokens: any[]): void;
+    /**
+     * Check whether a token is sealed.
+     */
+    isSealed(token: any): boolean;
     /**
      * Register one or more providers.
      *
@@ -1554,6 +1634,10 @@ declare class CliServiceContainer implements ICliServiceProvider {
         type: string;
         multi: boolean;
     }[];
+    /**
+     * Convert a token to a human-readable string for diagnostics/errors.
+     */
+    private tokenToString;
     /**
      * Describe a resolved value for diagnostic display.
      */
@@ -1564,6 +1648,9 @@ declare class CliServiceContainer implements ICliServiceProvider {
     private registerProvider;
     /**
      * Resolve a provider definition to a concrete value.
+     *
+     * Note: `deps` are resolved eagerly at registration time, so
+     * dependency tokens must be registered before the provider that needs them.
      */
     private resolveProvider;
 }
@@ -1938,6 +2025,49 @@ declare class CliDragDropService implements ICliDragDropService {
     destroy(): void;
 }
 
+/**
+ * Default HTTP client implementation.
+ *
+ * Wraps the global `fetch()` and automatically merges an abort signal
+ * so that in-flight requests are cancelled when the user presses Ctrl+C.
+ *
+ * Created per-command by the executor — each instance is bound to the
+ * command's own AbortSignal.
+ */
+declare class CliHttpClient implements ICliHttpClient {
+    private readonly signal?;
+    constructor(signal?: AbortSignal | undefined);
+    fetch(url: string, init?: RequestInit): Promise<Response>;
+    get<T = any>(url: string, options?: CliHttpRequestOptions): Promise<T>;
+    post<T = any>(url: string, body?: any, options?: CliHttpRequestOptions): Promise<T>;
+    put<T = any>(url: string, body?: any, options?: CliHttpRequestOptions): Promise<T>;
+    patch<T = any>(url: string, body?: any, options?: CliHttpRequestOptions): Promise<T>;
+    delete<T = any>(url: string, options?: CliHttpRequestOptions): Promise<T>;
+    head(url: string, options?: CliHttpRequestOptions): Promise<Response>;
+    options<T = any>(url: string, options?: CliHttpRequestOptions): Promise<T>;
+    private jsonRequest;
+    private isRawBody;
+    /**
+     * Merge the command signal with any additional signals (caller, timeout).
+     * Uses AbortSignal.any() when available, falls back to a manual composite
+     * controller for older browsers (pre-Chrome 116 / Safari 17.4).
+     */
+    private mergeSignal;
+}
+
+declare class CliNotifier implements ICliNotifier {
+    private _current;
+    private readonly _change$;
+    readonly change$: rxjs.Observable<CliNotification | undefined>;
+    get current(): CliNotification | undefined;
+    info(message: string): void;
+    success(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    clear(): void;
+    private set;
+}
+
 declare class OverlayAddon implements ITerminalAddon {
     private terminal;
     private overlayNode;
@@ -2034,6 +2164,7 @@ declare class CliEngine {
     private resizeScheduled;
     private bootService?;
     private dragDropService?;
+    private _startedAt?;
     constructor(container: HTMLElement, options?: CliEngineOptions | undefined);
     /**
      * Register a CLI module to be loaded on start().
@@ -2084,7 +2215,13 @@ declare class CliEngine {
      */
     getRegistry(): CliCommandProcessorRegistry;
     /**
-     * Execute a command programmatically.
+     * Timestamp (ms since epoch) when the engine finished starting.
+     */
+    get startedAt(): number | undefined;
+    /**
+     * Execute a command programmatically, behaving the same as if the user
+     * typed it and pressed Enter: echoes the command, adds it to history,
+     * executes it, and shows a new prompt afterwards.
      */
     execute(command: string): Promise<void>;
     /**
@@ -2178,6 +2315,7 @@ declare class CliServerConnection {
     private readonly _config;
     private readonly _backgroundServices?;
     private readonly _logger?;
+    private readonly _authService?;
     private _connected;
     private _commands;
     private _capabilities;
@@ -2194,12 +2332,18 @@ declare class CliServerConnection {
     private static readonly HEALTH_CHECK_MAX_ATTEMPTS;
     onDisconnect?: () => void;
     onReconnected?: () => void;
-    constructor(_config: CliServerConfig, _backgroundServices?: ICliBackgroundServiceRegistry | undefined, _logger?: ICliLogger | undefined);
+    constructor(_config: CliServerConfig, _backgroundServices?: ICliBackgroundServiceRegistry | undefined, _logger?: ICliLogger | undefined, _authService?: ICliServerAuthService | undefined);
     get config(): CliServerConfig;
     get connected(): boolean;
     get commands(): CliServerCommandDescriptor[];
     get capabilities(): CliServerCapabilities | null;
     get apiVersion(): number;
+    /**
+     * Resolve auth headers for this server connection.
+     * Uses the auth service (which merges config headers with registered
+     * ICliServerAuthTokenProviders), or falls back to config headers directly.
+     */
+    resolveAuthHeaders(): Record<string, string>;
     connect(): Promise<void>;
     disconnect(): void;
     startHealthCheck(): void;
@@ -2285,12 +2429,13 @@ declare class CliServerMultiProxyProcessor implements ICliCommandProcessor {
 declare const CliServerManager_TOKEN = "cli-server-manager";
 declare class CliServerManager implements DefaultServerProvider {
     private readonly registry;
+    private readonly authService?;
     readonly connections: Map<string, CliServerConnection>;
     private _logger?;
     private _cliLogger?;
     private _defaultServer;
     private _backgroundServices?;
-    constructor(registry: ICliCommandProcessorRegistry);
+    constructor(registry: ICliCommandProcessorRegistry, authService?: ICliServerAuthService | undefined);
     get defaultServer(): string | null;
     setDefaultServer(name: string | null): void;
     connectAll(servers: CliServerConfig[], logger?: {
@@ -2487,4 +2632,4 @@ declare function getAccelerator(): ICliWasmAccelerator;
  */
 declare function isWasmAccelerated(): boolean;
 
-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, CliFullScreenManager, 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, CliTimerManager, 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, type InitializeServicesOptions, type InitializeServicesResult, JsFallbackAccelerator, LIBRARY_VERSION, type MultiProxyEntry, OverlayAddon, type ParsedArg, type ParsedToken, ProcessExitedError, ScriptLoaderService, type TerminalSetupResult, type ThemeState, appendOutputToFile, appendStderrToFile, builtinProcessors, computeDiff, contextGlobalParameter, createServerModule, executeOnServer, expandEnvironmentVars, formatDiff, getAccelerator, getCliNameArt, getGreetingBasedOnTime, getTerminalOptions, groupBy, helpGlobalParameter, hotkeysInfo, initWasmAccelerator, initializeServices, initializeTerminal, isWasmAccelerated, miscProcessors, openLink, reconcileArgs, renderServerResponse, renderSingleOutput, substituteVars, systemProcessors, themeInfos, themes, tryExecuteScript, versionGlobalParameter, waitForLayout, welcomeModule, writeOutputToFile, writeStderrToFile };
+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, CliFullScreenManager, CliHelpCommandProcessor, CliHistoryCommandProcessor, CliHotKeysCommandProcessor, CliHtopCommandProcessor, CliHttpClient, CliInputReader, CliJsonCommandProcessor, CliKeyValueStore, CliKeyValueStore_TOKEN, CliKillCommandProcessor, CliLogger, CliLoremCommandProcessor, CliModuleRegistry_TOKEN, CliNanoCommandProcessor, CliNotifier, 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, CliTimerManager, 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, type InitializeServicesOptions, type InitializeServicesResult, JsFallbackAccelerator, LIBRARY_VERSION, type MultiProxyEntry, OverlayAddon, type ParsedArg, type ParsedToken, ProcessExitedError, ScriptLoaderService, SyntaxHighlighterRegistry_TOKEN, type TerminalSetupResult, type ThemeState, appendOutputToFile, appendStderrToFile, builtinProcessors, computeDiff, contextGlobalParameter, createServerModule, executeOnServer, expandEnvironmentVars, formatDiff, getAccelerator, getCliNameArt, getGreetingBasedOnTime, getTerminalOptions, groupBy, helpGlobalParameter, hotkeysInfo, initWasmAccelerator, initializeServices, initializeTerminal, isWasmAccelerated, miscProcessors, openLink, reconcileArgs, renderServerResponse, renderSingleOutput, substituteVars, systemProcessors, themeInfos, themes, tryExecuteScript, versionGlobalParameter, waitForLayout, welcomeModule, writeOutputToFile, writeStderrToFile };

package/public-api.d.ts

@@ -1,7 +1,8 @@
 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, ICliCompletionProvider, ICliFilePickerProvider, CliFullScreenOptions, ICliProcessRegistry, ICliBackgroundService, ICliServiceContext, ICliBackgroundServiceInfo, ICliServiceLogEntry, CliServiceEventHandler, ICliGlobalParameterHandler, CliForegroundColor, CliBackgroundColor, CliProvider, CliTableOptions, CliLogLevel, CliPercentageProgressBarUpdateValueOptions, CliTextAnimatorOptions, ICliModule, CliModuleRegistry, Package, ICliPingServerService, CliLineOptions, CliSelectOption, CliSelectOptions, CliMultiSelectOption, CliMultiSelectOptions, CliNumberOptions, CliDateOptions, CliFilePickerOptions, CliFileResult, ICliProcessRegisterOptions, ICliProcessEntry, ICliDragDropService, CliState, CliEngineSnapshot, CliServerConfig, CliServerCommandDescriptor, CliServerCapabilities, CliServerResponse, CliServerOutput, 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, ICliHttpClient, ICliNotifier, ICliManagedInterval, ICliManagedTimer, ICliKeyValueStore, ICliCompletionProvider, ICliFilePickerProvider, CliFullScreenOptions, ICliProcessRegistry, ICliBackgroundService, ICliServiceContext, ICliBackgroundServiceInfo, ICliServiceLogEntry, CliServiceEventHandler, ICliGlobalParameterHandler, CliForegroundColor, CliBackgroundColor, CliProvider, CliTableOptions, CliLogLevel, CliPercentageProgressBarUpdateValueOptions, CliTextAnimatorOptions, ICliModule, CliModuleRegistry, Package, ICliPingServerService, CliLineOptions, CliSelectOption, CliSelectOptions, CliMultiSelectOption, CliMultiSelectOptions, CliNumberOptions, CliDateOptions, CliFilePickerOptions, CliFileResult, ICliProcessRegisterOptions, ICliProcessEntry, ICliDragDropService, CliHttpRequestOptions, CliNotification, CliState, CliEngineSnapshot, CliServerConfig, ICliServerAuthService, CliServerCommandDescriptor, CliServerCapabilities, CliServerResponse, CliServerOutput, CliIcon } from '@qodalis/cli-core';
 export { ICliUserSessionService_TOKEN, ICliUsersStoreService_TOKEN } from '@qodalis/cli-core';
 import { ITheme, Terminal, ITerminalAddon, ITerminalOptions, ITerminalInitOnlyOptions } from '@xterm/xterm';
+import * as rxjs from 'rxjs';
 import { Subject, Observable, Subscription } from 'rxjs';
 import { FitAddon } from '@xterm/addon-fit';
 import { SerializeAddon } from '@xterm/addon-serialize';
@@ -141,8 +142,18 @@ declare const CliBackgroundServiceRegistry_TOKEN = "cli-background-service-regis
  * Used as a key in the service provider to retrieve the package manager.
  */
 declare const CliPackageManagerService_TOKEN = "cli-package-manager-service";
+/**
+ * Framework-agnostic token for the CLI key-value store.
+ * Used as a key in the service provider to retrieve the persistent storage.
+ */
+declare const CliKeyValueStore_TOKEN = "cli-key-value-store";
+/**
+ * Framework-agnostic token for the syntax highlighter registry.
+ * Used as a key in the service provider to retrieve the syntax highlighter registry.
+ */
+declare const SyntaxHighlighterRegistry_TOKEN = "syntax-highlighter-registry";
 
-declare const LIBRARY_VERSION = "2.0.0-beta.11";
+declare const LIBRARY_VERSION = "2.0.0-beta.13";
 declare const API_VERSION = 2;
 
 declare class CliAliasCommandProcessor implements ICliCommandProcessor {
@@ -910,6 +921,8 @@ declare class CliCommandExecutionContext implements ICliExecutionContext {
     translator: ICliTranslationService;
     reader: ICliInputReader;
     readonly backgroundServices: ICliBackgroundServiceRegistry;
+    http: ICliHttpClient;
+    notifier: ICliNotifier;
     get promptLength(): number;
     set promptLength(value: number);
     get currentLine(): string;
@@ -928,6 +941,7 @@ declare class CliCommandExecutionContext implements ICliExecutionContext {
     exitFullScreenMode: () => void;
     createInterval: (callback: () => void, ms: number) => ICliManagedInterval;
     createTimeout: (callback: () => void, ms: number) => ICliManagedTimer;
+    submitCommand: (command: string) => Promise<void>;
     constructor(context: ICliExecutionContext, processor: ICliCommandProcessor);
 }
 
@@ -1189,10 +1203,25 @@ declare class CliExecutionContext implements ICliExecutionContext, InputModeHost
     readonly services: ICliServiceProvider;
     readonly translator: ICliTranslationService;
     readonly backgroundServices: ICliBackgroundServiceRegistry;
+    http: ICliHttpClient;
+    readonly notifier: ICliNotifier;
     promptPathProvider?: () => string | null;
     readonly completionEngine: CliCompletionEngine;
     promptLength: number;
     readonly reader: ICliInputReader;
+    /**
+     * Result of the most recently executed command.
+     * Updated by the command executor after each command completes.
+     */
+    lastCommandResult?: {
+        command: string;
+        success: boolean;
+    };
+    /**
+     * Whether a command is currently being executed.
+     * Set by the command executor at start/end of executeCommand().
+     */
+    isExecuting: boolean;
     readonly lineBuffer: CliLineBuffer;
     readonly lineRenderer: CliTerminalLineRenderer;
     readonly commandHistory: CliCommandHistory;
@@ -1218,6 +1247,12 @@ declare class CliExecutionContext implements ICliExecutionContext, InputModeHost
         newLine?: boolean;
         keepCurrentLine?: boolean;
     }): void;
+    /**
+     * Submit and execute a command — shared by interactive Enter key
+     * and programmatic engine.execute(). Adds to history, runs the
+     * command, and shows a new prompt afterwards.
+     */
+    submitCommand(command: string): Promise<void>;
     clearCurrentLine(): void;
     refreshCurrentLine(previousContentLength?: number): void;
     /**
@@ -1349,6 +1384,11 @@ declare class CliTimerManager {
 interface ICliExecutionHost extends ICliExecutionContext {
     contextProcessor?: ICliCommandProcessor;
     abort?(): void;
+    lastCommandResult?: {
+        command: string;
+        success: boolean;
+    };
+    isExecuting?: boolean;
 }
 declare class CliCommandExecutor implements ICliCommandExecutorService {
     protected readonly registry: ICliCommandProcessorRegistry;
@@ -1524,18 +1564,58 @@ declare function expandEnvironmentVars(command: string, context: ICliExecutionCo
  * and `get()` returns an array of resolved values.
  */
 declare class CliServiceContainer implements ICliServiceProvider {
-    /** Stores single-value providers (resolved or pending). */
+    /** Stores single-value providers (resolved singletons). */
     private readonly services;
     /** Stores multi-provider arrays. */
     private readonly multiServices;
+    /** Tokens that cannot be overwritten by subsequent `set()` calls. */
+    private readonly sealedTokens;
+    /** Stores provider recipes for transient tokens (re-resolved on every get). */
+    private readonly transientRecipes;
     /**
      * Retrieve a service by its token.
+     * Returns `undefined` when no provider is registered for the token.
+     * For multi-provider tokens, returns the last registered value (use `getAll` for the full array).
+     *
+     * @param token The token used to register the service.
+     * @returns The resolved service instance, or `undefined` if not registered.
+     */
+    get<T>(token: any): T | undefined;
+    /**
+     * Retrieve all registered services for a multi-provider token.
+     * Returns an empty array when no provider is registered for the token.
      *
      * @param token The token used to register the service.
-     * @returns The resolved service instance (or array for multi providers).
+     * @returns Array of all resolved service instances.
+     */
+    getAll<T>(token: any): T[];
+    /**
+     * Retrieve a service by its token, throwing if not registered.
+     * Use this when the service is required and its absence is a programming error.
+     * For multi-provider tokens, returns the last registered value (use `getAll` for the full array).
+     *
+     * @param token The token used to register the service.
+     * @returns The resolved service instance.
      * @throws Error if the token has not been registered.
      */
-    get<T>(token: any): T;
+    getRequired<T>(token: any): T;
+    /**
+     * Check whether a service is registered for the given token.
+     */
+    has(token: any): boolean;
+    /**
+     * Mark a token as sealed so it cannot be overwritten by future `set()` calls.
+     * Only available on the concrete container — not exposed on `ICliServiceProvider`.
+     */
+    seal(token: any): void;
+    /**
+     * Mark multiple tokens as sealed at once.
+     */
+    sealAll(tokens: any[]): void;
+    /**
+     * Check whether a token is sealed.
+     */
+    isSealed(token: any): boolean;
     /**
      * Register one or more providers.
      *
@@ -1554,6 +1634,10 @@ declare class CliServiceContainer implements ICliServiceProvider {
         type: string;
         multi: boolean;
     }[];
+    /**
+     * Convert a token to a human-readable string for diagnostics/errors.
+     */
+    private tokenToString;
     /**
      * Describe a resolved value for diagnostic display.
      */
@@ -1564,6 +1648,9 @@ declare class CliServiceContainer implements ICliServiceProvider {
     private registerProvider;
     /**
      * Resolve a provider definition to a concrete value.
+     *
+     * Note: `deps` are resolved eagerly at registration time, so
+     * dependency tokens must be registered before the provider that needs them.
      */
     private resolveProvider;
 }
@@ -1938,6 +2025,49 @@ declare class CliDragDropService implements ICliDragDropService {
     destroy(): void;
 }
 
+/**
+ * Default HTTP client implementation.
+ *
+ * Wraps the global `fetch()` and automatically merges an abort signal
+ * so that in-flight requests are cancelled when the user presses Ctrl+C.
+ *
+ * Created per-command by the executor — each instance is bound to the
+ * command's own AbortSignal.
+ */
+declare class CliHttpClient implements ICliHttpClient {
+    private readonly signal?;
+    constructor(signal?: AbortSignal | undefined);
+    fetch(url: string, init?: RequestInit): Promise<Response>;
+    get<T = any>(url: string, options?: CliHttpRequestOptions): Promise<T>;
+    post<T = any>(url: string, body?: any, options?: CliHttpRequestOptions): Promise<T>;
+    put<T = any>(url: string, body?: any, options?: CliHttpRequestOptions): Promise<T>;
+    patch<T = any>(url: string, body?: any, options?: CliHttpRequestOptions): Promise<T>;
+    delete<T = any>(url: string, options?: CliHttpRequestOptions): Promise<T>;
+    head(url: string, options?: CliHttpRequestOptions): Promise<Response>;
+    options<T = any>(url: string, options?: CliHttpRequestOptions): Promise<T>;
+    private jsonRequest;
+    private isRawBody;
+    /**
+     * Merge the command signal with any additional signals (caller, timeout).
+     * Uses AbortSignal.any() when available, falls back to a manual composite
+     * controller for older browsers (pre-Chrome 116 / Safari 17.4).
+     */
+    private mergeSignal;
+}
+
+declare class CliNotifier implements ICliNotifier {
+    private _current;
+    private readonly _change$;
+    readonly change$: rxjs.Observable<CliNotification | undefined>;
+    get current(): CliNotification | undefined;
+    info(message: string): void;
+    success(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    clear(): void;
+    private set;
+}
+
 declare class OverlayAddon implements ITerminalAddon {
     private terminal;
     private overlayNode;
@@ -2034,6 +2164,7 @@ declare class CliEngine {
     private resizeScheduled;
     private bootService?;
     private dragDropService?;
+    private _startedAt?;
     constructor(container: HTMLElement, options?: CliEngineOptions | undefined);
     /**
      * Register a CLI module to be loaded on start().
@@ -2084,7 +2215,13 @@ declare class CliEngine {
      */
     getRegistry(): CliCommandProcessorRegistry;
     /**
-     * Execute a command programmatically.
+     * Timestamp (ms since epoch) when the engine finished starting.
+     */
+    get startedAt(): number | undefined;
+    /**
+     * Execute a command programmatically, behaving the same as if the user
+     * typed it and pressed Enter: echoes the command, adds it to history,
+     * executes it, and shows a new prompt afterwards.
      */
     execute(command: string): Promise<void>;
     /**
@@ -2178,6 +2315,7 @@ declare class CliServerConnection {
     private readonly _config;
     private readonly _backgroundServices?;
     private readonly _logger?;
+    private readonly _authService?;
     private _connected;
     private _commands;
     private _capabilities;
@@ -2194,12 +2332,18 @@ declare class CliServerConnection {
     private static readonly HEALTH_CHECK_MAX_ATTEMPTS;
     onDisconnect?: () => void;
     onReconnected?: () => void;
-    constructor(_config: CliServerConfig, _backgroundServices?: ICliBackgroundServiceRegistry | undefined, _logger?: ICliLogger | undefined);
+    constructor(_config: CliServerConfig, _backgroundServices?: ICliBackgroundServiceRegistry | undefined, _logger?: ICliLogger | undefined, _authService?: ICliServerAuthService | undefined);
     get config(): CliServerConfig;
     get connected(): boolean;
     get commands(): CliServerCommandDescriptor[];
     get capabilities(): CliServerCapabilities | null;
     get apiVersion(): number;
+    /**
+     * Resolve auth headers for this server connection.
+     * Uses the auth service (which merges config headers with registered
+     * ICliServerAuthTokenProviders), or falls back to config headers directly.
+     */
+    resolveAuthHeaders(): Record<string, string>;
     connect(): Promise<void>;
     disconnect(): void;
     startHealthCheck(): void;
@@ -2285,12 +2429,13 @@ declare class CliServerMultiProxyProcessor implements ICliCommandProcessor {
 declare const CliServerManager_TOKEN = "cli-server-manager";
 declare class CliServerManager implements DefaultServerProvider {
     private readonly registry;
+    private readonly authService?;
     readonly connections: Map<string, CliServerConnection>;
     private _logger?;
     private _cliLogger?;
     private _defaultServer;
     private _backgroundServices?;
-    constructor(registry: ICliCommandProcessorRegistry);
+    constructor(registry: ICliCommandProcessorRegistry, authService?: ICliServerAuthService | undefined);
     get defaultServer(): string | null;
     setDefaultServer(name: string | null): void;
     connectAll(servers: CliServerConfig[], logger?: {
@@ -2487,4 +2632,4 @@ declare function getAccelerator(): ICliWasmAccelerator;
  */
 declare function isWasmAccelerated(): boolean;
 
-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, CliFullScreenManager, 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, CliTimerManager, 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, type InitializeServicesOptions, type InitializeServicesResult, JsFallbackAccelerator, LIBRARY_VERSION, type MultiProxyEntry, OverlayAddon, type ParsedArg, type ParsedToken, ProcessExitedError, ScriptLoaderService, type TerminalSetupResult, type ThemeState, appendOutputToFile, appendStderrToFile, builtinProcessors, computeDiff, contextGlobalParameter, createServerModule, executeOnServer, expandEnvironmentVars, formatDiff, getAccelerator, getCliNameArt, getGreetingBasedOnTime, getTerminalOptions, groupBy, helpGlobalParameter, hotkeysInfo, initWasmAccelerator, initializeServices, initializeTerminal, isWasmAccelerated, miscProcessors, openLink, reconcileArgs, renderServerResponse, renderSingleOutput, substituteVars, systemProcessors, themeInfos, themes, tryExecuteScript, versionGlobalParameter, waitForLayout, welcomeModule, writeOutputToFile, writeStderrToFile };
+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, CliFullScreenManager, CliHelpCommandProcessor, CliHistoryCommandProcessor, CliHotKeysCommandProcessor, CliHtopCommandProcessor, CliHttpClient, CliInputReader, CliJsonCommandProcessor, CliKeyValueStore, CliKeyValueStore_TOKEN, CliKillCommandProcessor, CliLogger, CliLoremCommandProcessor, CliModuleRegistry_TOKEN, CliNanoCommandProcessor, CliNotifier, 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, CliTimerManager, 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, type InitializeServicesOptions, type InitializeServicesResult, JsFallbackAccelerator, LIBRARY_VERSION, type MultiProxyEntry, OverlayAddon, type ParsedArg, type ParsedToken, ProcessExitedError, ScriptLoaderService, SyntaxHighlighterRegistry_TOKEN, type TerminalSetupResult, type ThemeState, appendOutputToFile, appendStderrToFile, builtinProcessors, computeDiff, contextGlobalParameter, createServerModule, executeOnServer, expandEnvironmentVars, formatDiff, getAccelerator, getCliNameArt, getGreetingBasedOnTime, getTerminalOptions, groupBy, helpGlobalParameter, hotkeysInfo, initWasmAccelerator, initializeServices, initializeTerminal, isWasmAccelerated, miscProcessors, openLink, reconcileArgs, renderServerResponse, renderSingleOutput, substituteVars, systemProcessors, themeInfos, themes, tryExecuteScript, versionGlobalParameter, waitForLayout, welcomeModule, writeOutputToFile, writeStderrToFile };