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

package/dist/src/mcp/providers/jobs-provider.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JobsMcpToolProvider = void 0;
+exports.resolveJobId = resolveJobId;
+const cli_server_auth_1 = require("../../auth/cli-server-auth");
+const mcp_types_1 = require("../mcp-types");
+const errorMessage = (err) => err?.message ?? String(err);
+/**
+ * Resolves a job by id, or by a unique name (exact, then case-insensitive).
+ * Returns the id, or an error message (not found / ambiguous name).
+ */
+function resolveJobId(scheduler, idOrName) {
+    if (scheduler.get(idOrName))
+        return { id: idOrName };
+    const jobs = scheduler.getAll();
+    let matches = jobs.filter((j) => j.name === idOrName);
+    if (matches.length === 0) {
+        const lower = idOrName.toLowerCase();
+        matches = jobs.filter((j) => j.name.toLowerCase() === lower);
+    }
+    if (matches.length === 1)
+        return { id: matches[0].id };
+    if (matches.length > 1)
+        return { error: `Job name '${idOrName}' is ambiguous (${matches.length} jobs); use the job id` };
+    return { error: 'Job not found' };
+}
+/**
+ * Jobs tools over the jobs plugin's scheduler: `jobs_list`, `jobs_get`,
+ * `jobs_history` (`jobs:read`) and `jobs_trigger|pause|resume|stop|cancel`
+ * (`jobs:manage`).
+ */
+class JobsMcpToolProvider {
+    scheduler;
+    name = 'jobs';
+    constructor(scheduler) {
+        this.scheduler = scheduler;
+    }
+    getTools() {
+        const s = this.scheduler;
+        const idProp = { id: { type: 'string', description: 'Job id or unique job name' } };
+        const resolve = (idOrName) => resolveJobId(s, idOrName);
+        const action = (name, description, fn, annotations) => ({
+            name,
+            description,
+            inputSchema: (0, mcp_types_1.mcpObjectSchema)(idProp, ['id']),
+            requiredPermissions: [cli_server_auth_1.CliServerPermissions.JobsManage],
+            ...(annotations ? { annotations } : {}),
+            call: async (args) => {
+                const job = resolve(args.id);
+                if ('error' in job)
+                    return (0, mcp_types_1.mcpError)(job.error);
+                try {
+                    await fn(job.id);
+                    return (0, mcp_types_1.mcpJson)({ ok: true, id: job.id }, `${name.slice('jobs_'.length)}: ok`);
+                }
+                catch (err) {
+                    return (0, mcp_types_1.mcpError)(errorMessage(err));
+                }
+            },
+        });
+        return [
+            {
+                name: 'jobs_list',
+                description: 'List the scheduled jobs',
+                inputSchema: (0, mcp_types_1.mcpObjectSchema)(),
+                requiredPermissions: [cli_server_auth_1.CliServerPermissions.JobsRead],
+                annotations: { readOnlyHint: true },
+                call: async () => {
+                    const jobs = s.getAll();
+                    const text = jobs.map((j) => `${j.id} | ${j.name} | ${j.status}${j.schedule ? ` | ${j.schedule}` : j.interval ? ` | every ${j.interval}` : ''}`).join('\n');
+                    return (0, mcp_types_1.mcpJson)({ jobs }, text || 'No jobs');
+                },
+            },
+            {
+                name: 'jobs_get',
+                description: 'Details of a job',
+                inputSchema: (0, mcp_types_1.mcpObjectSchema)(idProp, ['id']),
+                requiredPermissions: [cli_server_auth_1.CliServerPermissions.JobsRead],
+                annotations: { readOnlyHint: true },
+                call: async (args) => {
+                    const job = resolve(args.id);
+                    if ('error' in job)
+                        return (0, mcp_types_1.mcpError)(job.error);
+                    return (0, mcp_types_1.mcpJson)({ ...s.get(job.id) });
+                },
+            },
+            {
+                name: 'jobs_history',
+                description: 'Recent executions of a job (newest first)',
+                inputSchema: (0, mcp_types_1.mcpObjectSchema)({ ...idProp, limit: { type: 'integer', description: 'Maximum executions (1-100)', default: 20 } }, ['id']),
+                requiredPermissions: [cli_server_auth_1.CliServerPermissions.JobsRead],
+                annotations: { readOnlyHint: true },
+                call: async (args) => {
+                    const job = resolve(args.id);
+                    if ('error' in job)
+                        return (0, mcp_types_1.mcpError)(job.error);
+                    const id = job.id;
+                    const limit = Math.min(Math.max(args.limit ?? 20, 1), 100);
+                    try {
+                        const result = await s.storage.getExecutions(id, { limit, offset: 0 });
+                        const items = result.items.map((exec) => {
+                            const { logs, ...rest } = exec;
+                            return { ...rest, logCount: logs?.length ?? 0 };
+                        });
+                        return (0, mcp_types_1.mcpJson)({ items, total: result.total, limit });
+                    }
+                    catch (err) {
+                        return (0, mcp_types_1.mcpError)(errorMessage(err));
+                    }
+                },
+            },
+            action('jobs_trigger', 'Run a job now', (id) => s.triggerAsync(id)),
+            action('jobs_pause', 'Pause a job schedule', (id) => s.pauseAsync(id)),
+            action('jobs_resume', 'Resume a paused job', (id) => s.resumeAsync(id)),
+            action('jobs_stop', 'Stop a job (and cancel its current run)', (id) => s.stopJobAsync(id), { destructiveHint: true }),
+            action('jobs_cancel', 'Cancel the current run of a job', (id) => s.cancelCurrentAsync(id), { destructiveHint: true }),
+        ];
+    }
+}
+exports.JobsMcpToolProvider = JobsMcpToolProvider;
+//# sourceMappingURL=jobs-provider.js.map

package/dist/src/mcp/providers/jobs-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs-provider.js","sourceRoot":"","sources":["../../../../src/mcp/providers/jobs-provider.ts"],"names":[],"mappings":"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"}

package/dist/src/mcp/providers/server-provider.d.ts

@@ -0,0 +1,19 @@
+import { ICliCommandRegistry } from '../../services/cli-command-registry';
+import { McpTool, McpToolProvider } from '../mcp-types';
+export interface ServerInfoSource {
+    registry: ICliCommandRegistry;
+    serverName: string;
+    version: string;
+    /** Live capabilities (shell state, …). */
+    capabilities: () => Record<string, unknown>;
+    /** Live list of enabled features. */
+    features: () => string[];
+}
+/** `server_info`: version, capabilities, enabled features and registered command names. */
+export declare class ServerMcpToolProvider implements McpToolProvider {
+    private readonly source;
+    readonly name = "server";
+    constructor(source: ServerInfoSource);
+    getTools(): McpTool[];
+}
+//# sourceMappingURL=server-provider.d.ts.map

package/dist/src/mcp/providers/server-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-provider.d.ts","sourceRoot":"","sources":["../../../../src/mcp/providers/server-provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,eAAe,EAA4B,MAAM,cAAc,CAAC;AAElF,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,YAAY,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,qCAAqC;IACrC,QAAQ,EAAE,MAAM,MAAM,EAAE,CAAC;CAC5B;AAED,2FAA2F;AAC3F,qBAAa,qBAAsB,YAAW,eAAe;IAG7C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,QAAQ,CAAC,IAAI,YAAY;gBAEI,MAAM,EAAE,gBAAgB;IAErD,QAAQ,IAAI,OAAO,EAAE;CAyBxB"}

package/dist/src/mcp/providers/server-provider.js

@@ -0,0 +1,73 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServerMcpToolProvider = void 0;
+const os = __importStar(require("os"));
+const mcp_types_1 = require("../mcp-types");
+/** `server_info`: version, capabilities, enabled features and registered command names. */
+class ServerMcpToolProvider {
+    source;
+    name = 'server';
+    constructor(source) {
+        this.source = source;
+    }
+    getTools() {
+        return [
+            {
+                name: 'server_info',
+                description: 'Server version, capabilities, enabled features and registered command names',
+                inputSchema: (0, mcp_types_1.mcpObjectSchema)(),
+                requiredPermissions: [],
+                annotations: { readOnlyHint: true },
+                call: async () => {
+                    const platform = os.platform();
+                    return (0, mcp_types_1.mcpJson)({
+                        name: this.source.serverName,
+                        version: this.source.version,
+                        capabilities: {
+                            os: platform === 'win32' ? 'win32' : platform === 'darwin' ? 'darwin' : 'linux',
+                            streaming: true,
+                            ...this.source.capabilities(),
+                        },
+                        features: this.source.features(),
+                        commands: this.source.registry.processors.map((p) => p.command),
+                    });
+                },
+            },
+        ];
+    }
+}
+exports.ServerMcpToolProvider = ServerMcpToolProvider;
+//# sourceMappingURL=server-provider.js.map

package/dist/src/mcp/providers/server-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-provider.js","sourceRoot":"","sources":["../../../../src/mcp/providers/server-provider.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AAEzB,4CAAkF;AAYlF,2FAA2F;AAC3F,MAAa,qBAAqB;IAGD;IAFpB,IAAI,GAAG,QAAQ,CAAC;IAEzB,YAA6B,MAAwB;QAAxB,WAAM,GAAN,MAAM,CAAkB;IAAG,CAAC;IAEzD,QAAQ;QACJ,OAAO;YACH;gBACI,IAAI,EAAE,aAAa;gBACnB,WAAW,EAAE,6EAA6E;gBAC1F,WAAW,EAAE,IAAA,2BAAe,GAAE;gBAC9B,mBAAmB,EAAE,EAAE;gBACvB,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;gBACnC,IAAI,EAAE,KAAK,IAAI,EAAE;oBACb,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;oBAC/B,OAAO,IAAA,mBAAO,EAAC;wBACX,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;wBAC5B,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;wBAC5B,YAAY,EAAE;4BACV,EAAE,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO;4BAC/E,SAAS,EAAE,IAAI;4BACf,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE;yBAChC;wBACD,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE;wBAChC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;qBAClE,CAAC,CAAC;gBACP,CAAC;aACJ;SACJ,CAAC;IACN,CAAC;CACJ;AA9BD,sDA8BC"}

package/dist/{models → src/models}/cli-server-command-descriptor.d.ts

@@ -1,3 +1,4 @@
+/** Serializable DTO describing a command parameter for API responses. */
 export interface CliServerCommandParameterDescriptorDto {
     name: string;
     aliases?: string[];
@@ -6,6 +7,7 @@ export interface CliServerCommandParameterDescriptorDto {
     type: string;
     defaultValue?: any;
 }
+/** Serializable DTO describing a registered command processor for API responses. */
 export interface CliServerCommandDescriptor {
     command: string;
     description?: string;

package/dist/src/models/cli-server-command-descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-server-command-descriptor.d.ts","sourceRoot":"","sources":["../../../src/models/cli-server-command-descriptor.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,MAAM,WAAW,sCAAsC;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,GAAG,CAAC;CACtB;AAED,oFAAoF;AACpF,MAAM,WAAW,0BAA0B;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,sCAAsC,EAAE,CAAC;IACtD,UAAU,CAAC,EAAE,0BAA0B,EAAE,CAAC;CAC7C"}

package/dist/src/models/cli-server-command-descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-server-command-descriptor.js","sourceRoot":"","sources":["../../../src/models/cli-server-command-descriptor.ts"],"names":[],"mappings":""}

package/dist/src/models/cli-server-output.d.ts

@@ -0,0 +1,2 @@
+export type { CliStructuredOutput as CliServerOutput } from '@qodalis/cli-server-abstractions';
+//# sourceMappingURL=cli-server-output.d.ts.map

package/dist/src/models/cli-server-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-server-output.d.ts","sourceRoot":"","sources":["../../../src/models/cli-server-output.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,mBAAmB,IAAI,eAAe,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/src/models/cli-server-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-server-output.js","sourceRoot":"","sources":["../../../src/models/cli-server-output.ts"],"names":[],"mappings":""}

package/dist/src/models/cli-server-response.d.ts

@@ -0,0 +1,2 @@
+export type { CliStructuredResponse as CliServerResponse } from '@qodalis/cli-server-abstractions';
+//# sourceMappingURL=cli-server-response.d.ts.map

package/dist/src/models/cli-server-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-server-response.d.ts","sourceRoot":"","sources":["../../../src/models/cli-server-response.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,qBAAqB,IAAI,iBAAiB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/src/models/cli-server-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-server-response.js","sourceRoot":"","sources":["../../../src/models/cli-server-response.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/models/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,0BAA0B,EAAE,sCAAsC,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/{models → src/models}/index.js.map

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

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

@@ -1,6 +1,7 @@
 import { CliCommandProcessor } from '../abstractions/cli-command-processor';
 import { CliProcessCommand } from '../abstractions/cli-process-command';
 import { ICliCommandProcessor } from '../abstractions/cli-command-processor';
+/** Command processor for Base64 encoding and decoding with `encode` and `decode` sub-commands. */
 export declare class CliBase64CommandProcessor extends CliCommandProcessor {
     command: string;
     description: string;

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-base64-command-processor.d.ts","sourceRoot":"","sources":["../../../src/processors/cli-base64-command-processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAiC7E,kGAAkG;AAClG,qBAAa,yBAA0B,SAAQ,mBAAmB;IAC9D,OAAO,SAAY;IACnB,WAAW,SAAoC;IAC/C,qBAAqB,UAAS;IAC9B,UAAU,EAAE,oBAAoB,EAAE,CAA8D;IAE1F,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;CAGjE"}

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

@@ -2,21 +2,26 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CliBase64CommandProcessor = void 0;
 const cli_command_processor_1 = require("../abstractions/cli-command-processor");
+const abstractions_1 = require("../abstractions");
+/** Sub-processor that encodes text to Base64. */
 class Base64EncodeProcessor extends cli_command_processor_1.CliCommandProcessor {
     command = 'encode';
     description = 'Encodes text to Base64';
+    acceptsValue = true;
     async handleAsync(command) {
-        const text = command.value;
+        const text = (0, abstractions_1.getPositionalText)(command);
         if (!text)
             return 'Usage: base64 encode <text>';
         return Buffer.from(text, 'utf8').toString('base64');
     }
 }
+/** Sub-processor that decodes Base64 to text. */
 class Base64DecodeProcessor extends cli_command_processor_1.CliCommandProcessor {
     command = 'decode';
     description = 'Decodes Base64 to text';
+    acceptsValue = true;
     async handleAsync(command) {
-        const text = command.value;
+        const text = (0, abstractions_1.getPositionalText)(command);
         if (!text)
             return 'Usage: base64 decode <base64string>';
         try {
@@ -27,6 +32,7 @@ class Base64DecodeProcessor extends cli_command_processor_1.CliCommandProcessor
         }
     }
 }
+/** Command processor for Base64 encoding and decoding with `encode` and `decode` sub-commands. */
 class CliBase64CommandProcessor extends cli_command_processor_1.CliCommandProcessor {
     command = 'base64';
     description = 'Encodes or decodes Base64 text';

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-base64-command-processor.js","sourceRoot":"","sources":["../../../src/processors/cli-base64-command-processor.ts"],"names":[],"mappings":";;;AAAA,iFAA4E;AAG5E,kDAAoD;AAEpD,iDAAiD;AACjD,MAAM,qBAAsB,SAAQ,2CAAmB;IACnD,OAAO,GAAG,QAAQ,CAAC;IACnB,WAAW,GAAG,wBAAwB,CAAC;IACvC,YAAY,GAAG,IAAI,CAAC;IAEpB,KAAK,CAAC,WAAW,CAAC,OAA0B;QACxC,MAAM,IAAI,GAAG,IAAA,gCAAiB,EAAC,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI;YAAE,OAAO,6BAA6B,CAAC;QAChD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACxD,CAAC;CACJ;AAED,iDAAiD;AACjD,MAAM,qBAAsB,SAAQ,2CAAmB;IACnD,OAAO,GAAG,QAAQ,CAAC;IACnB,WAAW,GAAG,wBAAwB,CAAC;IACvC,YAAY,GAAG,IAAI,CAAC;IAEpB,KAAK,CAAC,WAAW,CAAC,OAA0B;QACxC,MAAM,IAAI,GAAG,IAAA,gCAAiB,EAAC,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI;YAAE,OAAO,qCAAqC,CAAC;QACxD,IAAI,CAAC;YACD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,6BAA6B,CAAC;QACzC,CAAC;IACL,CAAC;CACJ;AAED,kGAAkG;AAClG,MAAa,yBAA0B,SAAQ,2CAAmB;IAC9D,OAAO,GAAG,QAAQ,CAAC;IACnB,WAAW,GAAG,gCAAgC,CAAC;IAC/C,qBAAqB,GAAG,KAAK,CAAC;IAC9B,UAAU,GAA2B,CAAC,IAAI,qBAAqB,EAAE,EAAE,IAAI,qBAAqB,EAAE,CAAC,CAAC;IAEhG,KAAK,CAAC,WAAW,CAAC,OAA0B;QACxC,OAAO,oCAAoC,CAAC;IAChD,CAAC;CACJ;AATD,8DASC"}

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

@@ -1,4 +1,6 @@
 import { CliCommandProcessor, CliProcessCommand } from '../abstractions';
+export { joinShellWords, splitShellWords } from '../abstractions';
+/** Command processor that echoes back the input text, as a shell's echo prints it. */
 export declare class CliEchoCommandProcessor extends CliCommandProcessor {
     command: string;
     description: string;

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-echo-command-processor.d.ts","sourceRoot":"","sources":["../../../src/processors/cli-echo-command-processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAqB,MAAM,iBAAiB,CAAC;AAG5F,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElE,sFAAsF;AACtF,qBAAa,uBAAwB,SAAQ,mBAAmB;IAC5D,OAAO,SAAU;IACjB,WAAW,SAAgC;IAC3C,aAAa,UAAQ;IAEf,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;CAIjE"}

package/dist/src/processors/cli-echo-command-processor.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CliEchoCommandProcessor = exports.splitShellWords = exports.joinShellWords = void 0;
+const abstractions_1 = require("../abstractions");
+// The shell-word helpers live in the abstractions package so plugins can use them too
+var abstractions_2 = require("../abstractions");
+Object.defineProperty(exports, "joinShellWords", { enumerable: true, get: function () { return abstractions_2.joinShellWords; } });
+Object.defineProperty(exports, "splitShellWords", { enumerable: true, get: function () { return abstractions_2.splitShellWords; } });
+/** Command processor that echoes back the input text, as a shell's echo prints it. */
+class CliEchoCommandProcessor extends abstractions_1.CliCommandProcessor {
+    command = 'echo';
+    description = 'Echoes back the input text';
+    valueRequired = true;
+    async handleAsync(command) {
+        // The positional words joined by one space: `echo "a" "b"` prints a b
+        return (0, abstractions_1.getPositionalText)(command);
+    }
+}
+exports.CliEchoCommandProcessor = CliEchoCommandProcessor;
+//# sourceMappingURL=cli-echo-command-processor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-echo-command-processor.js","sourceRoot":"","sources":["../../../src/processors/cli-echo-command-processor.ts"],"names":[],"mappings":";;;AAAA,kDAA4F;AAE5F,sFAAsF;AACtF,gDAAkE;AAAzD,8GAAA,cAAc,OAAA;AAAE,+GAAA,eAAe,OAAA;AAExC,sFAAsF;AACtF,MAAa,uBAAwB,SAAQ,kCAAmB;IAC5D,OAAO,GAAG,MAAM,CAAC;IACjB,WAAW,GAAG,4BAA4B,CAAC;IAC3C,aAAa,GAAG,IAAI,CAAC;IAErB,KAAK,CAAC,WAAW,CAAC,OAA0B;QACxC,sEAAsE;QACtE,OAAO,IAAA,gCAAiB,EAAC,OAAO,CAAC,CAAC;IACtC,CAAC;CACJ;AATD,0DASC"}

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

@@ -1,9 +1,11 @@
 import { CliCommandProcessor } from '../abstractions/cli-command-processor';
 import { CliCommandParameterDescriptor } from '../abstractions/cli-command-parameter-descriptor';
 import { CliProcessCommand } from '../abstractions/cli-process-command';
+/** Command processor that computes cryptographic hashes (md5, sha1, sha256, sha512) of input text. */
 export declare class CliHashCommandProcessor extends CliCommandProcessor {
     command: string;
     description: string;
+    acceptsValue: boolean;
     parameters: CliCommandParameterDescriptor[];
     handleAsync(command: CliProcessCommand): Promise<string>;
 }

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-hash-command-processor.d.ts","sourceRoot":"","sources":["../../../src/processors/cli-hash-command-processor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,EAAE,6BAA6B,EAAE,MAAM,kDAAkD,CAAC;AACjG,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAKxE,sGAAsG;AACtG,qBAAa,uBAAwB,SAAQ,mBAAmB;IAC5D,OAAO,SAAU;IACjB,WAAW,SAAqC;IAChD,YAAY,UAAQ;IACpB,UAAU,kCASR;IAEI,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;CAYjE"}

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

@@ -7,15 +7,18 @@ exports.CliHashCommandProcessor = void 0;
 const crypto_1 = __importDefault(require("crypto"));
 const cli_command_processor_1 = require("../abstractions/cli-command-processor");
 const cli_command_parameter_descriptor_1 = require("../abstractions/cli-command-parameter-descriptor");
+const abstractions_1 = require("../abstractions");
 const SUPPORTED_ALGORITHMS = ['md5', 'sha1', 'sha256', 'sha512'];
+/** Command processor that computes cryptographic hashes (md5, sha1, sha256, sha512) of input text. */
 class CliHashCommandProcessor extends cli_command_processor_1.CliCommandProcessor {
     command = 'hash';
     description = 'Computes hash of the input text';
+    acceptsValue = true;
     parameters = [
         new cli_command_parameter_descriptor_1.CliCommandParameterDescriptor('algorithm', `Hash algorithm (${SUPPORTED_ALGORITHMS.join(', ')})`, false, 'string', ['-a'], 'sha256'),
     ];
     async handleAsync(command) {
-        const text = command.value;
+        const text = (0, abstractions_1.getPositionalText)(command);
         if (!text)
             return 'Usage: hash <text> [--algorithm sha256]';
         const algo = (command.args?.algorithm ?? 'sha256').toLowerCase();

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-hash-command-processor.js","sourceRoot":"","sources":["../../../src/processors/cli-hash-command-processor.ts"],"names":[],"mappings":";;;;;;AAAA,oDAA4B;AAC5B,iFAA4E;AAC5E,uGAAiG;AAEjG,kDAAoD;AAEpD,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAEjE,sGAAsG;AACtG,MAAa,uBAAwB,SAAQ,2CAAmB;IAC5D,OAAO,GAAG,MAAM,CAAC;IACjB,WAAW,GAAG,iCAAiC,CAAC;IAChD,YAAY,GAAG,IAAI,CAAC;IACpB,UAAU,GAAG;QACT,IAAI,gEAA6B,CAC7B,WAAW,EACX,mBAAmB,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EACrD,KAAK,EACL,QAAQ,EACR,CAAC,IAAI,CAAC,EACN,QAAQ,CACX;KACJ,CAAC;IAEF,KAAK,CAAC,WAAW,CAAC,OAA0B;QACxC,MAAM,IAAI,GAAG,IAAA,gCAAiB,EAAC,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI;YAAE,OAAO,yCAAyC,CAAC;QAE5D,MAAM,IAAI,GAAG,CAAE,OAAO,CAAC,IAAI,EAAE,SAAoB,IAAI,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7E,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACvC,OAAO,0BAA0B,IAAI,gBAAgB,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3F,CAAC;QAED,MAAM,MAAM,GAAG,gBAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1E,OAAO,GAAG,IAAI,KAAK,MAAM,EAAE,CAAC;IAChC,CAAC;CACJ;AA3BD,0DA2BC"}

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

@@ -1,6 +1,7 @@
 import { CliCommandProcessor } from '../abstractions/cli-command-processor';
 import { CliProcessCommand } from '../abstractions/cli-process-command';
 import { ICliCommandProcessor } from '../abstractions/cli-command-processor';
+/** Command processor for server-side HTTP requests with `get` and `post` sub-commands. */
 export declare class CliHttpCommandProcessor extends CliCommandProcessor {
     command: string;
     description: string;

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-http-command-processor.d.ts","sourceRoot":"","sources":["../../../src/processors/cli-http-command-processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAE5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAiL7E,0FAA0F;AAC1F,qBAAa,uBAAwB,SAAQ,mBAAmB;IAC5D,OAAO,SAAU;IACjB,WAAW,SAAyC;IACpD,qBAAqB,UAAS;IAC9B,UAAU,EAAE,oBAAoB,EAAE,CAAqD;IAEjF,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;CAGjE"}

package/dist/src/processors/cli-http-command-processor.js

@@ -0,0 +1,161 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CliHttpCommandProcessor = void 0;
+const cli_command_processor_1 = require("../abstractions/cli-command-processor");
+const cli_command_parameter_descriptor_1 = require("../abstractions/cli-command-parameter-descriptor");
+const abstractions_1 = require("../abstractions");
+/** Sub-processor that performs HTTP GET requests. */
+class HttpGetProcessor extends cli_command_processor_1.CliCommandProcessor {
+    command = 'get';
+    acceptsValue = true;
+    description = 'Performs an HTTP GET request';
+    parameters = [
+        new cli_command_parameter_descriptor_1.CliCommandParameterDescriptor('headers', 'Show response headers', false, 'boolean'),
+    ];
+    async handleAsync(command, signal) {
+        const url = (0, abstractions_1.getPositionals)(command)[0];
+        if (!url)
+            return 'Usage: http get <url>';
+        return doRequest(url, 'GET', undefined, 'headers' in (command.args ?? {}), signal);
+    }
+    async handleStreamAsync(command, emit, signal) {
+        const url = (0, abstractions_1.getPositionals)(command)[0];
+        if (!url) {
+            emit({ type: 'text', value: 'Usage: http get <url>' });
+            return 1;
+        }
+        return doStreamRequest(url, 'GET', undefined, 'headers' in (command.args ?? {}), emit, signal);
+    }
+}
+/** Sub-processor that performs HTTP POST requests. */
+class HttpPostProcessor extends cli_command_processor_1.CliCommandProcessor {
+    command = 'post';
+    acceptsValue = true;
+    description = 'Performs an HTTP POST request';
+    parameters = [
+        new cli_command_parameter_descriptor_1.CliCommandParameterDescriptor('body', 'Request body (JSON string)', false, 'string', ['-b']),
+        new cli_command_parameter_descriptor_1.CliCommandParameterDescriptor('headers', 'Show response headers', false, 'boolean'),
+    ];
+    async handleAsync(command, signal) {
+        const url = (0, abstractions_1.getPositionals)(command)[0];
+        if (!url)
+            return "Usage: http post <url> --body '{\"key\":\"value\"}'";
+        const body = command.args?.body;
+        return doRequest(url, 'POST', body, 'headers' in (command.args ?? {}), signal);
+    }
+    async handleStreamAsync(command, emit, signal) {
+        const url = (0, abstractions_1.getPositionals)(command)[0];
+        if (!url) {
+            emit({ type: 'text', value: "Usage: http post <url> --body '{\"key\":\"value\"}'" });
+            return 1;
+        }
+        const body = command.args?.body;
+        return doStreamRequest(url, 'POST', body, 'headers' in (command.args ?? {}), emit, signal);
+    }
+}
+/**
+ * Executes an HTTP request and formats the response as a human-readable string.
+ * @param url - Target URL.
+ * @param method - HTTP method (GET, POST, etc.).
+ * @param body - Optional JSON request body.
+ * @param showHeaders - Whether to include response headers in output.
+ * @returns Formatted response string (truncated to 5000 chars).
+ */
+async function doRequest(url, method, body, showHeaders, signal) {
+    try {
+        const timeoutSignal = AbortSignal.timeout(30000);
+        const combinedSignal = signal
+            ? AbortSignal.any([signal, timeoutSignal])
+            : timeoutSignal;
+        const init = {
+            method,
+            headers: body ? { 'Content-Type': 'application/json' } : undefined,
+            body: body ?? undefined,
+            signal: combinedSignal,
+        };
+        const resp = await fetch(url, init);
+        const contentType = resp.headers.get('content-type') ?? 'unknown';
+        let respBody = await resp.text();
+        const lines = [
+            `Status: ${resp.status}`,
+            `Content-Type: ${contentType}`,
+        ];
+        if (showHeaders) {
+            lines.push('Headers:');
+            resp.headers.forEach((value, key) => {
+                lines.push(`  ${key}: ${value}`);
+            });
+        }
+        lines.push('');
+        if (contentType.includes('json')) {
+            try {
+                respBody = JSON.stringify(JSON.parse(respBody), null, 2);
+            }
+            catch { /* keep raw */ }
+        }
+        lines.push(respBody.substring(0, 5000));
+        return lines.join('\n');
+    }
+    catch (err) {
+        return `Error: ${err.message ?? err}`;
+    }
+}
+/**
+ * Executes an HTTP request and emits output incrementally via the `emit` callback.
+ * @param url - Target URL.
+ * @param method - HTTP method (GET, POST, etc.).
+ * @param body - Optional JSON request body.
+ * @param showHeaders - Whether to include response headers in output.
+ * @param emit - Callback to send a single output chunk.
+ * @returns Exit code (0 for success, 1 for error).
+ */
+async function doStreamRequest(url, method, body, showHeaders, emit, signal) {
+    try {
+        emit({ type: 'text', value: `Fetching ${method} ${url}...`, style: 'info' });
+        const timeoutSignal = AbortSignal.timeout(30000);
+        const combinedSignal = signal
+            ? AbortSignal.any([signal, timeoutSignal])
+            : timeoutSignal;
+        const init = {
+            method,
+            headers: body ? { 'Content-Type': 'application/json' } : undefined,
+            body: body ?? undefined,
+            signal: combinedSignal,
+        };
+        const resp = await fetch(url, init);
+        const contentType = resp.headers.get('content-type') ?? 'unknown';
+        emit({ type: 'text', value: `Status: ${resp.status}` });
+        emit({ type: 'text', value: `Content-Type: ${contentType}` });
+        if (showHeaders) {
+            emit({ type: 'text', value: 'Headers:' });
+            resp.headers.forEach((value, key) => {
+                emit({ type: 'text', value: `  ${key}: ${value}` });
+            });
+        }
+        let respBody = await resp.text();
+        if (contentType.includes('json')) {
+            try {
+                respBody = JSON.stringify(JSON.parse(respBody), null, 2);
+            }
+            catch { /* keep raw */ }
+        }
+        emit({ type: 'text', value: respBody.substring(0, 5000) });
+        return 0;
+    }
+    catch (err) {
+        emit({ type: 'text', value: `Error: ${err.message ?? err}`, style: 'error' });
+        return 1;
+    }
+}
+/** Command processor for server-side HTTP requests with `get` and `post` sub-commands. */
+class CliHttpCommandProcessor extends cli_command_processor_1.CliCommandProcessor {
+    command = 'http';
+    description = 'Makes HTTP requests from the server';
+    allowUnlistedCommands = false;
+    processors = [new HttpGetProcessor(), new HttpPostProcessor()];
+    async handleAsync(command) {
+        return 'Usage: http get|post <url> [--body <json>] [--headers]';
+    }
+}
+exports.CliHttpCommandProcessor = CliHttpCommandProcessor;
+//# sourceMappingURL=cli-http-command-processor.js.map

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

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

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

@@ -1,4 +1,5 @@
 import { CliCommandProcessor, CliProcessCommand } from '../abstractions';
+/** Command processor that reports server status including uptime, OS, and Node.js version. */
 export declare class CliStatusCommandProcessor extends CliCommandProcessor {
     command: string;
     description: string;

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-status-command-processor.d.ts","sourceRoot":"","sources":["../../../src/processors/cli-status-command-processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGzE,8FAA8F;AAC9F,qBAAa,yBAA0B,SAAQ,mBAAmB;IAC9D,OAAO,SAAY;IACnB,WAAW,SAAqC;IAE1C,WAAW,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;CAIlE"}