@qodalis/cli-server-node 1.0.0-beta.1 → 1.0.0-beta.10

package/dist/{processors → src/processors}/cli-status-command-processor.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CliStatusCommandProcessor = void 0;
 const abstractions_1 = require("../abstractions");
 const os_1 = __importDefault(require("os"));
+/** Command processor that reports server status including uptime, OS, and Node.js version. */
 class CliStatusCommandProcessor extends abstractions_1.CliCommandProcessor {
     command = 'status';
     description = 'Shows server status information';

package/dist/src/processors/cli-status-command-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-status-command-processor.js","sourceRoot":"","sources":["../../../src/processors/cli-status-command-processor.ts"],"names":[],"mappings":";;;;;;AAAA,kDAAyE;AACzE,4CAAoB;AAEpB,8FAA8F;AAC9F,MAAa,yBAA0B,SAAQ,kCAAmB;IAC9D,OAAO,GAAG,QAAQ,CAAC;IACnB,WAAW,GAAG,iCAAiC,CAAC;IAEhD,KAAK,CAAC,WAAW,CAAC,QAA2B;QACzC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5C,OAAO,4BAA4B,MAAM,UAAU,YAAE,CAAC,IAAI,EAAE,IAAI,YAAE,CAAC,OAAO,EAAE,WAAW,OAAO,CAAC,OAAO,EAAE,CAAC;IAC7G,CAAC;CACJ;AARD,8DAQC"}

package/dist/{processors → src/processors}/cli-system-command-processor.d.ts

@@ -1,5 +1,6 @@
 import { CliCommandProcessor } from '../abstractions/cli-command-processor';
 import { CliProcessCommand } from '../abstractions/cli-process-command';
+/** Command processor that displays detailed system information (hostname, OS, CPU, memory, uptime). */
 export declare class CliSystemCommandProcessor extends CliCommandProcessor {
     command: string;
     description: string;

package/dist/src/processors/cli-system-command-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-system-command-processor.d.ts","sourceRoot":"","sources":["../../../src/processors/cli-system-command-processor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAIxE,uGAAuG;AACvG,qBAAa,yBAA0B,SAAQ,mBAAmB;IAC9D,OAAO,SAAY;IACnB,WAAW,SAAqC;IAE1C,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;CAoBjE"}

package/dist/{processors → src/processors}/cli-system-command-processor.js

@@ -7,6 +7,7 @@ exports.CliSystemCommandProcessor = void 0;
 const os_1 = __importDefault(require("os"));
 const cli_command_processor_1 = require("../abstractions/cli-command-processor");
 const startTime = Date.now();
+/** Command processor that displays detailed system information (hostname, OS, CPU, memory, uptime). */
 class CliSystemCommandProcessor extends cli_command_processor_1.CliCommandProcessor {
     command = 'system';
     description = 'Shows server system information';

package/dist/src/processors/cli-system-command-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-system-command-processor.js","sourceRoot":"","sources":["../../../src/processors/cli-system-command-processor.ts"],"names":[],"mappings":";;;;;;AAAA,4CAAoB;AACpB,iFAA4E;AAG5E,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AAE7B,uGAAuG;AACvG,MAAa,yBAA0B,SAAQ,2CAAmB;IAC9D,OAAO,GAAG,QAAQ,CAAC;IACnB,WAAW,GAAG,iCAAiC,CAAC;IAEhD,KAAK,CAAC,WAAW,CAAC,OAA0B;QACxC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC;QAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACrD,MAAM,OAAO,GAAG,UAAU,GAAG,EAAE,CAAC;QAEhC,MAAM,QAAQ,GAAG,CAAC,YAAE,CAAC,QAAQ,EAAE,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACjE,MAAM,OAAO,GAAG,CAAC,YAAE,CAAC,OAAO,EAAE,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAE/D,MAAM,KAAK,GAAG;YACV,kBAAkB,YAAE,CAAC,QAAQ,EAAE,EAAE;YACjC,kBAAkB,YAAE,CAAC,IAAI,EAAE,IAAI,YAAE,CAAC,OAAO,EAAE,EAAE;YAC7C,kBAAkB,YAAE,CAAC,IAAI,EAAE,EAAE;YAC7B,kBAAkB,YAAE,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE;YACpC,kBAAkB,OAAO,cAAc,QAAQ,WAAW;YAC1D,kBAAkB,OAAO,CAAC,OAAO,EAAE;YACnC,kBAAkB,KAAK,KAAK,OAAO,KAAK,OAAO,GAAG;SACrD,CAAC;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;CACJ;AAxBD,8DAwBC"}

package/dist/{processors → src/processors}/index.d.ts

@@ -1,8 +1,7 @@
-export { CliEchoCommandProcessor } from './cli-echo-command-processor';
+export { CliEchoCommandProcessor, joinShellWords } from './cli-echo-command-processor';
 export { CliStatusCommandProcessor } from './cli-status-command-processor';
 export { CliSystemCommandProcessor } from './cli-system-command-processor';
 export { CliHttpCommandProcessor } from './cli-http-command-processor';
 export { CliHashCommandProcessor } from './cli-hash-command-processor';
 export { CliBase64CommandProcessor } from './cli-base64-command-processor';
-export { CliUuidCommandProcessor } from './cli-uuid-command-processor';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/processors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/processors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACvF,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/{processors → src/processors}/index.js

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CliUuidCommandProcessor = exports.CliBase64CommandProcessor = exports.CliHashCommandProcessor = exports.CliHttpCommandProcessor = exports.CliSystemCommandProcessor = exports.CliStatusCommandProcessor = exports.CliEchoCommandProcessor = void 0;
+exports.CliBase64CommandProcessor = exports.CliHashCommandProcessor = exports.CliHttpCommandProcessor = exports.CliSystemCommandProcessor = exports.CliStatusCommandProcessor = exports.joinShellWords = exports.CliEchoCommandProcessor = void 0;
 var cli_echo_command_processor_1 = require("./cli-echo-command-processor");
 Object.defineProperty(exports, "CliEchoCommandProcessor", { enumerable: true, get: function () { return cli_echo_command_processor_1.CliEchoCommandProcessor; } });
+Object.defineProperty(exports, "joinShellWords", { enumerable: true, get: function () { return cli_echo_command_processor_1.joinShellWords; } });
 var cli_status_command_processor_1 = require("./cli-status-command-processor");
 Object.defineProperty(exports, "CliStatusCommandProcessor", { enumerable: true, get: function () { return cli_status_command_processor_1.CliStatusCommandProcessor; } });
 var cli_system_command_processor_1 = require("./cli-system-command-processor");
@@ -13,6 +14,4 @@ var cli_hash_command_processor_1 = require("./cli-hash-command-processor");
 Object.defineProperty(exports, "CliHashCommandProcessor", { enumerable: true, get: function () { return cli_hash_command_processor_1.CliHashCommandProcessor; } });
 var cli_base64_command_processor_1 = require("./cli-base64-command-processor");
 Object.defineProperty(exports, "CliBase64CommandProcessor", { enumerable: true, get: function () { return cli_base64_command_processor_1.CliBase64CommandProcessor; } });
-var cli_uuid_command_processor_1 = require("./cli-uuid-command-processor");
-Object.defineProperty(exports, "CliUuidCommandProcessor", { enumerable: true, get: function () { return cli_uuid_command_processor_1.CliUuidCommandProcessor; } });
 //# sourceMappingURL=index.js.map

package/dist/src/processors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/processors/index.ts"],"names":[],"mappings":";;;AAAA,2EAAuF;AAA9E,qIAAA,uBAAuB,OAAA;AAAE,4HAAA,cAAc,OAAA;AAChD,+EAA2E;AAAlE,yIAAA,yBAAyB,OAAA;AAClC,+EAA2E;AAAlE,yIAAA,yBAAyB,OAAA;AAClC,2EAAuE;AAA9D,qIAAA,uBAAuB,OAAA;AAChC,2EAAuE;AAA9D,qIAAA,uBAAuB,OAAA;AAChC,+EAA2E;AAAlE,yIAAA,yBAAyB,OAAA"}

package/dist/{server.d.ts.map → src/server.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":""}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":""}

package/dist/{server.js → src/server.js}

@@ -2,15 +2,26 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const create_cli_server_1 = require("./create-cli-server");
+const logger_1 = require("./utils/logger");
+const logger = (0, logger_1.createLogger)('Server');
 const cli_echo_command_processor_1 = require("./processors/cli-echo-command-processor");
 const cli_status_command_processor_1 = require("./processors/cli-status-command-processor");
 const cli_system_command_processor_1 = require("./processors/cli-system-command-processor");
 const cli_http_command_processor_1 = require("./processors/cli-http-command-processor");
 const cli_hash_command_processor_1 = require("./processors/cli-hash-command-processor");
 const cli_base64_command_processor_1 = require("./processors/cli-base64-command-processor");
-const cli_uuid_command_processor_1 = require("./processors/cli-uuid-command-processor");
+const cli_server_plugin_weather_1 = require("@qodalis/cli-server-plugin-weather");
 const port = process.env.PORT ?? 8047;
+// CORS / WebSocket origins, e.g. QCLI_ALLOWED_ORIGINS=http://localhost:4200,http://localhost:4300
+const allowedOrigins = process.env.QCLI_ALLOWED_ORIGINS?.split(',').map((o) => o.trim()).filter(Boolean);
+// Remote shell (no users plugin here): set QCLI_SHELL_TOKEN to enable it in
+// token mode. Clients send `Authorization: Bearer <token>` (browser clients:
+// the server's configured `headers`, forwarded as `_header_Authorization`).
+const shellToken = process.env.QCLI_SHELL_TOKEN?.trim() || undefined;
 const { app, eventSocketManager } = (0, create_cli_server_1.createCliServer)({
+    allowedOrigins,
+    enableShell: !!shellToken,
+    shell: shellToken ? { token: shellToken } : undefined,
     configure: (builder) => {
         builder
             .addProcessor(new cli_echo_command_processor_1.CliEchoCommandProcessor())
@@ -19,18 +30,22 @@ const { app, eventSocketManager } = (0, create_cli_server_1.createCliServer)({
             .addProcessor(new cli_http_command_processor_1.CliHttpCommandProcessor())
             .addProcessor(new cli_hash_command_processor_1.CliHashCommandProcessor())
             .addProcessor(new cli_base64_command_processor_1.CliBase64CommandProcessor())
-            .addProcessor(new cli_uuid_command_processor_1.CliUuidCommandProcessor());
+            .addModule(new cli_server_plugin_weather_1.WeatherModule());
     },
 });
 const server = app.listen(port, () => {
-    console.log(`CLI server (Node.js) listening on http://localhost:${port}`);
-    console.log(`  Commands: http://localhost:${port}/api/cli/commands`);
-    console.log(`  Execute:  http://localhost:${port}/api/cli/execute`);
-    console.log(`  Events:   ws://localhost:${port}/ws/cli/events`);
+    logger.info(`CLI server (Node.js) listening on http://localhost:${port}`);
+    logger.info(`  Commands:     http://localhost:${port}/api/v1/qcli/commands`);
+    logger.info(`  Execute:      http://localhost:${port}/api/v1/qcli/execute`);
+    logger.info(`  Capabilities: http://localhost:${port}/api/v1/qcli/capabilities`);
+    logger.info(`  Events:       ws://localhost:${port}/ws/v1/qcli/events`);
+    if (shellToken) {
+        logger.info(`  Shell:        ws://localhost:${port}/ws/v1/qcli/shell (token mode)`);
+    }
 });
 eventSocketManager.attach(server);
 process.on('SIGINT', async () => {
-    console.log('\nShutting down...');
+    logger.info('Shutting down...');
     await eventSocketManager.broadcastDisconnect();
     server.close();
     process.exit(0);

package/dist/src/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":";;;AAEA,2DAAsD;AACtD,2CAA8C;AAE9C,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,QAAQ,CAAC,CAAC;AACtC,wFAAkF;AAClF,4FAAsF;AACtF,4FAAsF;AACtF,wFAAkF;AAClF,wFAAkF;AAClF,4FAAsF;AACtF,kFAAmE;AAEnE,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC;AAEtC,kGAAkG;AAClG,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAEzG,4EAA4E;AAC5E,6EAA6E;AAC7E,4EAA4E;AAC5E,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;AAErE,MAAM,EAAE,GAAG,EAAE,kBAAkB,EAAE,GAAG,IAAA,mCAAe,EAAC;IAChD,cAAc;IACd,WAAW,EAAE,CAAC,CAAC,UAAU;IACzB,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS;IACrD,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;QACnB,OAAO;aACF,YAAY,CAAC,IAAI,oDAAuB,EAAE,CAAC;aAC3C,YAAY,CAAC,IAAI,wDAAyB,EAAE,CAAC;aAC7C,YAAY,CAAC,IAAI,wDAAyB,EAAE,CAAC;aAC7C,YAAY,CAAC,IAAI,oDAAuB,EAAE,CAAC;aAC3C,YAAY,CAAC,IAAI,oDAAuB,EAAE,CAAC;aAC3C,YAAY,CAAC,IAAI,wDAAyB,EAAE,CAAC;aAC7C,SAAS,CAAC,IAAI,yCAAa,EAAE,CAAC,CAAC;IACxC,CAAC;CACJ,CAAC,CAAC;AAEH,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;IACjC,MAAM,CAAC,IAAI,CAAC,sDAAsD,IAAI,EAAE,CAAC,CAAC;IAC1E,MAAM,CAAC,IAAI,CAAC,oCAAoC,IAAI,uBAAuB,CAAC,CAAC;IAC7E,MAAM,CAAC,IAAI,CAAC,oCAAoC,IAAI,sBAAsB,CAAC,CAAC;IAC5E,MAAM,CAAC,IAAI,CAAC,oCAAoC,IAAI,2BAA2B,CAAC,CAAC;IACjF,MAAM,CAAC,IAAI,CAAC,kCAAkC,IAAI,oBAAoB,CAAC,CAAC;IACxE,IAAI,UAAU,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,kCAAkC,IAAI,gCAAgC,CAAC,CAAC;IACxF,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAElC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;IAC5B,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAChC,MAAM,kBAAkB,CAAC,mBAAmB,EAAE,CAAC;IAC/C,MAAM,CAAC,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;IAC7B,MAAM,kBAAkB,CAAC,mBAAmB,EAAE,CAAC;IAC/C,MAAM,CAAC,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}

package/dist/src/services/cli-command-executor-service.d.ts

@@ -0,0 +1,33 @@
+import { CliProcessCommand, ICliCommandProcessor, ICliProcessorFilter } from '../abstractions';
+import { CliServerResponse } from '../models';
+import { ICliCommandRegistry } from './cli-command-registry';
+/** Service contract for executing parsed CLI commands. */
+export interface ICliCommandExecutorService {
+    /**
+     * Executes a parsed command by routing it to the appropriate processor.
+     * @param command - Parsed command to execute.
+     * @param signal - Optional AbortSignal to cancel the operation.
+     * @returns Structured response with exit code and outputs.
+     */
+    executeAsync(command: CliProcessCommand, signal?: AbortSignal): Promise<CliServerResponse>;
+    /**
+     * Adds a processor filter that can block command execution at runtime.
+     * @param filter - The filter to add.
+     */
+    addFilter(filter: ICliProcessorFilter): void;
+    /**
+     * Returns true if any registered filter blocks the given processor.
+     * @param processor - The processor to check.
+     */
+    isBlocked(processor: ICliCommandProcessor): boolean;
+}
+/** Default executor that resolves processors from the registry and delegates command handling. */
+export declare class CliCommandExecutorService implements ICliCommandExecutorService {
+    private readonly _registry;
+    private readonly _filters;
+    constructor(_registry: ICliCommandRegistry);
+    addFilter(filter: ICliProcessorFilter): void;
+    isBlocked(processor: ICliCommandProcessor): boolean;
+    executeAsync(command: CliProcessCommand, signal?: AbortSignal): Promise<CliServerResponse>;
+}
+//# sourceMappingURL=cli-command-executor-service.d.ts.map

package/dist/src/services/cli-command-executor-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-command-executor-service.d.ts","sourceRoot":"","sources":["../../../src/services/cli-command-executor-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC/F,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAK7D,0DAA0D;AAC1D,MAAM,WAAW,0BAA0B;IACvC;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE3F;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAE7C;;;OAGG;IACH,SAAS,CAAC,SAAS,EAAE,oBAAoB,GAAG,OAAO,CAAC;CACvD;AAED,kGAAkG;AAClG,qBAAa,yBAA0B,YAAW,0BAA0B;IAG5D,OAAO,CAAC,QAAQ,CAAC,SAAS;IAFtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;gBAEzB,SAAS,EAAE,mBAAmB;IAE3D,SAAS,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAI5C,SAAS,CAAC,SAAS,EAAE,oBAAoB,GAAG,OAAO;IAI7C,YAAY,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC;CA8DnG"}

package/dist/src/services/cli-command-executor-service.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CliCommandExecutorService = void 0;
+const logger_1 = require("../utils/logger");
+const logger = (0, logger_1.createLogger)('CommandExecutor');
+/** Default executor that resolves processors from the registry and delegates command handling. */
+class CliCommandExecutorService {
+    _registry;
+    _filters = [];
+    constructor(_registry) {
+        this._registry = _registry;
+    }
+    addFilter(filter) {
+        this._filters.push(filter);
+    }
+    isBlocked(processor) {
+        return this._filters.some(f => !f.isAllowed(processor));
+    }
+    async executeAsync(command, signal) {
+        logger.debug('Executing command: %s', command.command);
+        const processor = this._registry.findProcessor(command.command, command.chainCommands?.length ? command.chainCommands : undefined);
+        if (!processor) {
+            return {
+                exitCode: 1,
+                outputs: [
+                    {
+                        type: 'text',
+                        value: `Unknown command: ${command.command}`,
+                        style: 'error',
+                    },
+                ],
+            };
+        }
+        if (this.isBlocked(processor)) {
+            logger.warn('Command blocked by filter (plugin disabled): %s', command.command);
+            return {
+                exitCode: 1,
+                outputs: [
+                    {
+                        type: 'text',
+                        value: `Command '${command.command}' is currently disabled.`,
+                        style: 'error',
+                    },
+                ],
+            };
+        }
+        try {
+            if (processor.handleStructuredAsync) {
+                const response = await processor.handleStructuredAsync(command, signal);
+                logger.debug('Command completed: %s (exitCode=%d)', command.command, response.exitCode);
+                return response;
+            }
+            const result = await processor.handleAsync(command, signal);
+            const response = {
+                exitCode: 0,
+                outputs: [{ type: 'text', value: result }],
+            };
+            logger.debug('Command completed: %s (exitCode=%d)', command.command, response.exitCode);
+            return response;
+        }
+        catch (err) {
+            logger.error('Command execution failed: %s - %s', command.command, err.message ?? err);
+            return {
+                exitCode: 1,
+                outputs: [
+                    {
+                        type: 'text',
+                        value: `Error executing command: ${err.message ?? err}`,
+                        style: 'error',
+                    },
+                ],
+            };
+        }
+    }
+}
+exports.CliCommandExecutorService = CliCommandExecutorService;
+//# sourceMappingURL=cli-command-executor-service.js.map

package/dist/src/services/cli-command-executor-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-command-executor-service.js","sourceRoot":"","sources":["../../../src/services/cli-command-executor-service.ts"],"names":[],"mappings":"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"}

package/dist/src/services/cli-command-registry.d.ts

@@ -0,0 +1,25 @@
+import { ICliCommandProcessor } from '../abstractions';
+/** Registry that stores and looks up CLI command processors by command name. */
+export interface ICliCommandRegistry {
+    /** All registered top-level processors. */
+    readonly processors: ReadonlyArray<ICliCommandProcessor>;
+    /** Registers a command processor. */
+    register(processor: ICliCommandProcessor): void;
+    /**
+     * Finds a processor by command name, optionally resolving a sub-command chain.
+     * @param command - Top-level command name.
+     * @param chainCommands - Optional sub-command chain to resolve.
+     * @returns Matching processor, or undefined if not found.
+     */
+    findProcessor(command: string, chainCommands?: string[]): ICliCommandProcessor | undefined;
+}
+/** Default in-memory implementation of {@link ICliCommandRegistry}. */
+export declare class CliCommandRegistry implements ICliCommandRegistry {
+    private _processors;
+    get processors(): ReadonlyArray<ICliCommandProcessor>;
+    register(processor: ICliCommandProcessor): void;
+    findProcessor(command: string, chainCommands?: string[]): ICliCommandProcessor | undefined;
+    /** Walks the sub-processor tree to resolve a chain of sub-commands. */
+    private resolveChain;
+}
+//# sourceMappingURL=cli-command-registry.d.ts.map

package/dist/src/services/cli-command-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-command-registry.d.ts","sourceRoot":"","sources":["../../../src/services/cli-command-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAKvD,gFAAgF;AAChF,MAAM,WAAW,mBAAmB;IAChC,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAC;IACzD,qCAAqC;IACrC,QAAQ,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAChD;;;;;OAKG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,oBAAoB,GAAG,SAAS,CAAC;CAC9F;AAED,uEAAuE;AACvE,qBAAa,kBAAmB,YAAW,mBAAmB;IAC1D,OAAO,CAAC,WAAW,CAAgD;IAEnE,IAAI,UAAU,IAAI,aAAa,CAAC,oBAAoB,CAAC,CAEpD;IAED,QAAQ,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI;IAK/C,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,oBAAoB,GAAG,SAAS;IAS1F,uEAAuE;IACvE,OAAO,CAAC,YAAY;CAkBvB"}

package/dist/{services → src/services}/cli-command-registry.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CliCommandRegistry = void 0;
+const logger_1 = require("../utils/logger");
+const logger = (0, logger_1.createLogger)('CommandRegistry');
+/** Default in-memory implementation of {@link ICliCommandRegistry}. */
 class CliCommandRegistry {
     _processors = new Map();
     get processors() {
@@ -8,6 +11,7 @@ class CliCommandRegistry {
     }
     register(processor) {
         this._processors.set(processor.command.toLowerCase(), processor);
+        logger.debug('Registered processor: %s', processor.command);
     }
     findProcessor(command, chainCommands) {
         const processor = this._processors.get(command.toLowerCase());
@@ -16,6 +20,7 @@ class CliCommandRegistry {
         }
         return this.resolveChain(processor, chainCommands);
     }
+    /** Walks the sub-processor tree to resolve a chain of sub-commands. */
     resolveChain(processor, chainCommands) {
         let current = processor;
         for (const sub of chainCommands) {

package/dist/src/services/cli-command-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-command-registry.js","sourceRoot":"","sources":["../../../src/services/cli-command-registry.ts"],"names":[],"mappings":";;;AACA,4CAA+C;AAE/C,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,iBAAiB,CAAC,CAAC;AAiB/C,uEAAuE;AACvE,MAAa,kBAAkB;IACnB,WAAW,GAAsC,IAAI,GAAG,EAAE,CAAC;IAEnE,IAAI,UAAU;QACV,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,QAAQ,CAAC,SAA+B;QACpC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,SAAS,CAAC,CAAC;QACjE,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAChE,CAAC;IAED,aAAa,CAAC,OAAe,EAAE,aAAwB;QACnD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;QAC9D,IAAI,CAAC,SAAS,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC;YACvC,OAAO,SAAS,CAAC;QACrB,CAAC;QAED,OAAO,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IACvD,CAAC;IAED,uEAAuE;IAC/D,YAAY,CAChB,SAA+B,EAC/B,aAAuB;QAEvB,IAAI,OAAO,GAAG,SAAS,CAAC;QAExB,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,EAAE,IAAI,CAClC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,WAAW,EAAE,CACvD,CAAC;YACF,IAAI,CAAC,KAAK,EAAE,CAAC;gBACT,OAAO,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;YAC/D,CAAC;YACD,OAAO,GAAG,KAAK,CAAC;QACpB,CAAC;QAED,OAAO,OAAO,CAAC;IACnB,CAAC;CACJ;AAxCD,gDAwCC"}

package/dist/src/services/cli-event-socket-manager.d.ts

@@ -0,0 +1,77 @@
+import type { Server } from 'http';
+import { CliShellSessionManager } from './cli-shell-session-manager';
+import { CliShellAuthMode, CliShellOptions } from './cli-shell-options';
+import { ICliServerAuth } from '../auth/cli-server-auth';
+/** Information about a connected WebSocket event client. */
+export interface CliWebSocketClientInfo {
+    id: string;
+    connectedAt: string;
+    remoteAddress: string;
+    type: 'events';
+}
+export interface CliEventSocketManagerOptions {
+    /** Accept interactive shell sessions on `/ws/v1/qcli/shell` (default false). */
+    enableShell?: boolean;
+    /** Shell security options (access mode, limits, timeouts, environment). */
+    shell?: CliShellOptions;
+    /**
+     * Trusted reverse-proxy hops (`true` = 1, `false`/0 = none) for `X-Forwarded-*`
+     * headers (shell per-address limits/logs, same-origin checks).
+     */
+    trustProxy?: boolean | number;
+    /** When set, every upgrade with an `Origin` header must come from one of these. */
+    allowedOrigins?: string[];
+}
+/**
+ * Manages WebSocket connections for server-push events and interactive shell sessions.
+ * Handles upgrades on `/ws/v1/qcli/events` and (when `enableShell` is set)
+ * `/ws/v1/qcli/shell`. With an auth provider that protects the server, event
+ * upgrades need a single-use `?ticket=`; `session-kicked` is delivered only to
+ * the affected user. Sockets authenticated with a stored session are bound to
+ * it: once it ends they are closed with 4401 `session ended` (after
+ * `session-kicked` for revocations; see {@link SessionBoundSockets}). Shell
+ * access (modes, limits, session binding) is decided by {@link CliShellSessionManager}.
+ */
+export declare class CliEventSocketManager {
+    private _wss;
+    private readonly _clients;
+    private readonly _clientMeta;
+    private readonly _shellManager;
+    private _nextClientId;
+    private _auth?;
+    private _allowedOrigins?;
+    private readonly _trustProxy;
+    private readonly _sessionBound;
+    constructor(options?: CliEventSocketManagerOptions);
+    /** Installs the auth provider (users plugin) used to authenticate upgrades with tickets. */
+    setAuth(auth: ICliServerAuth | undefined): void;
+    setAllowedOrigins(origins: string[] | undefined): void;
+    setShellEnabled(enabled: boolean): void;
+    get shellEnabled(): boolean;
+    /** Shell access mode (`undefined` while the shell is disabled). */
+    get shellAuthMode(): CliShellAuthMode | undefined;
+    /** The shell session manager (open sessions, limits, binding). */
+    get shellManager(): CliShellSessionManager;
+    private static readonly EVENT_PATHS;
+    private static readonly SHELL_PATHS;
+    /**
+     * Attach to an HTTP server and listen for WebSocket upgrades on
+     * event and shell paths.
+     */
+    attach(server: Server): void;
+    /**
+     * Broadcast an arbitrary message to all connected event clients.
+     */
+    broadcastMessage(message: Record<string, unknown>): void;
+    /**
+     * Broadcast a disconnect event to all connected clients and close sockets.
+     */
+    broadcastDisconnect(): Promise<void>;
+    /**
+     * Return information about all currently connected event clients.
+     */
+    getClients(): CliWebSocketClientInfo[];
+    /** Terminates all connections and closes the WebSocket server. */
+    dispose(): void;
+}
+//# sourceMappingURL=cli-event-socket-manager.d.ts.map

package/dist/src/services/cli-event-socket-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-event-socket-manager.d.ts","sourceRoot":"","sources":["../../../src/services/cli-event-socket-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAmB,MAAM,MAAM,CAAC;AAEpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAExE,OAAO,EAA8C,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAMrG,4DAA4D;AAC5D,MAAM,WAAW,sBAAsB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,QAAQ,CAAC;CAClB;AAUD,MAAM,WAAW,4BAA4B;IACzC,gFAAgF;IAChF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC9B,mFAAmF;IACnF,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAKD;;;;;;;;;GASG;AACH,qBAAa,qBAAqB;IAC9B,OAAO,CAAC,IAAI,CAAgC;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwB;IACjD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqC;IACjE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyB;IACvD,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,KAAK,CAAC,CAAiB;IAC/B,OAAO,CAAC,eAAe,CAAC,CAAW;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmB;IAC/C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgD;gBAElE,OAAO,GAAE,4BAAiC;IAUtD,4FAA4F;IAC5F,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI;IAM/C,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,IAAI;IAItD,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIvC,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,mEAAmE;IACnE,IAAI,aAAa,IAAI,gBAAgB,GAAG,SAAS,CAEhD;IAED,kEAAkE;IAClE,IAAI,YAAY,IAAI,sBAAsB,CAEzC;IAED,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAGhC;IAEH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAGhC;IAEH;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IA+E5B;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAyCxD;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IA0B1C;;OAEG;IACH,UAAU,IAAI,sBAAsB,EAAE;IAkBtC,kEAAkE;IAClE,OAAO,IAAI,IAAI;CAUlB"}