@mako10k/shell-server 0.1.0

package/dist/utils/criteria-manager.js

@@ -0,0 +1,228 @@
+import fs from 'fs/promises';
+import path from 'path';
+import { logger } from './helpers.js';
+/**
+ * Default security criteria content
+ */
+const DEFAULT_CRITERIA = `
+## Security Evaluation Criteria
+
+### Primary Goal
+Prevent reckless, careless, or commands that deviate from user intent.
+
+### Evaluation Guidelines
+- **Reckless**: Commands with destructive potential without clear purpose
+- **Careless**: Commands that could cause unintended side effects  
+- **Intent Deviation**: Commands that don't align with established user workflow patterns
+
+### Tool Selection Guidelines
+- **allow()**: Default for routine development operations (builds, tests, file operations in project context)
+- **ai_assistant_confirm()**: Only when genuinely missing critical information
+- **user_confirm()**: For commands with legitimate risk but valid use cases
+- **deny()**: For clearly destructive or malicious commands
+
+### Context Awareness
+Consider command history and established workflow patterns when evaluating commands.
+Match evaluation strictness to actual risk level and maintain development-friendly approach.
+`.trim();
+/**
+ * Get criteria file configuration from environment or defaults
+ */
+export function getCriteriaConfig() {
+    const defaultPath = process.env['MCP_VALIDATION_CRITERIA_PATH'] ||
+        path.join('/tmp', 'mcp-shell-server', 'validation_criteria.txt');
+    return {
+        filePath: defaultPath,
+        backupDir: path.join(path.dirname(defaultPath), 'backups'),
+        defaultContent: DEFAULT_CRITERIA,
+    };
+}
+/**
+ * Ensure directory exists, creating if necessary
+ */
+async function ensureDirectory(dirPath) {
+    try {
+        await fs.access(dirPath);
+    }
+    catch {
+        await fs.mkdir(dirPath, { recursive: true });
+    }
+}
+/**
+ * Create timestamped backup of existing criteria file
+ */
+async function createBackup(config) {
+    try {
+        const content = await fs.readFile(config.filePath, 'utf8');
+        await ensureDirectory(config.backupDir);
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        const backupPath = path.join(config.backupDir, `criteria_${timestamp}.txt`);
+        await fs.writeFile(backupPath, content, 'utf8');
+        return backupPath;
+    }
+    catch (error) {
+        // If original file doesn't exist, no backup needed
+        if (error.code === 'ENOENT') {
+            return null;
+        }
+        throw error;
+    }
+}
+/**
+ * Load security criteria from file
+ */
+export async function loadCriteria() {
+    const config = getCriteriaConfig();
+    try {
+        const content = await fs.readFile(config.filePath, 'utf8');
+        return content.trim();
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            // File doesn't exist, return default criteria
+            return config.defaultContent;
+        }
+        throw error;
+    }
+}
+/**
+ * Save security criteria to file
+ */
+export async function saveCriteria(criteriaText, appendMode = false, backupExisting = true) {
+    const config = getCriteriaConfig();
+    // Validate criteria text
+    const trimmedCriteria = criteriaText.trim();
+    if (!trimmedCriteria) {
+        throw new Error('Criteria text cannot be empty');
+    }
+    // Ensure directory exists
+    await ensureDirectory(path.dirname(config.filePath));
+    // Create backup if requested and file exists
+    let backupPath = null;
+    if (backupExisting) {
+        backupPath = await createBackup(config);
+    }
+    // Prepare content
+    let finalContent;
+    if (appendMode) {
+        try {
+            const existingContent = await fs.readFile(config.filePath, 'utf8');
+            finalContent = `${existingContent.trim()}\n\n${trimmedCriteria}`;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                // File doesn't exist, just use new content
+                finalContent = trimmedCriteria;
+            }
+            else {
+                throw error;
+            }
+        }
+    }
+    else {
+        finalContent = trimmedCriteria;
+    }
+    // Save criteria
+    await fs.writeFile(config.filePath, finalContent, 'utf8');
+    return {
+        backupPath,
+        criteriaPath: config.filePath,
+    };
+}
+/**
+ * Check if criteria file was modified since last read
+ */
+export async function isCriteriaModified(lastModified) {
+    const config = getCriteriaConfig();
+    try {
+        const stats = await fs.stat(config.filePath);
+        return stats.mtime > lastModified;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return false; // File doesn't exist
+        }
+        throw error;
+    }
+}
+/**
+ * Get criteria file status information
+ */
+export async function getCriteriaStatus() {
+    const config = getCriteriaConfig();
+    try {
+        const stats = await fs.stat(config.filePath);
+        return {
+            exists: true,
+            path: config.filePath,
+            lastModified: stats.mtime,
+            size: stats.size,
+        };
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return {
+                exists: false,
+                path: config.filePath,
+            };
+        }
+        throw error;
+    }
+}
+/**
+ * Adjust security evaluation criteria dynamically
+ * Used by both MCP tools and internal validator functions
+ */
+export async function adjustCriteria(criteriaText, appendMode = false, backupExisting = true) {
+    const config = getCriteriaConfig();
+    try {
+        // Create backup if requested and file exists
+        let backupPath;
+        if (backupExisting) {
+            try {
+                const existing = await loadCriteria();
+                if (existing && existing.trim()) {
+                    const backup = await createBackup(config);
+                    backupPath = backup || undefined;
+                }
+            }
+            catch (error) {
+                // Backup failed but continue with criteria update
+                logger.warn('Failed to create backup before criteria adjustment', { error });
+            }
+        }
+        // Prepare new content
+        let newContent;
+        if (appendMode) {
+            try {
+                const existing = await loadCriteria();
+                newContent = existing ? `${existing}\n\n${criteriaText}` : criteriaText;
+            }
+            catch (error) {
+                // If loading fails, treat as new content
+                newContent = criteriaText;
+            }
+        }
+        else {
+            newContent = criteriaText;
+        }
+        // Save new criteria
+        await saveCriteria(newContent);
+        return {
+            success: true,
+            message: appendMode ? 'Criteria successfully appended' : 'Criteria successfully updated',
+            ...(backupPath && { backupPath }),
+            criteriaPath: config.filePath,
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        logger.error('Failed to adjust criteria', { error: errorMessage });
+        return {
+            success: false,
+            message: `Failed to adjust criteria: ${errorMessage}`,
+            criteriaPath: config.filePath,
+        };
+    }
+}
+//# sourceMappingURL=criteria-manager.js.map

package/dist/utils/criteria-manager.js.map

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

package/dist/utils/errors.d.ts

@@ -0,0 +1,27 @@
+import { ErrorCategory, ErrorInfo } from '../types/index.js';
+export declare class MCPShellError extends Error {
+    readonly code: string;
+    readonly category: ErrorCategory;
+    readonly details?: Record<string, unknown>;
+    readonly timestamp: string;
+    readonly requestId?: string;
+    constructor(code: string, message: string, category: ErrorCategory, details?: Record<string, unknown>, requestId?: string);
+    toErrorInfo(): ErrorInfo;
+    static fromError(error: unknown, requestId?: string): MCPShellError;
+}
+export declare class ResourceNotFoundError extends MCPShellError {
+    constructor(resourceType: string, id: string, requestId?: string);
+}
+export declare class ExecutionError extends MCPShellError {
+    constructor(message: string, details?: Record<string, unknown>, requestId?: string);
+}
+export declare class TimeoutError extends MCPShellError {
+    constructor(timeoutSeconds: number, requestId?: string);
+}
+export declare class SecurityError extends MCPShellError {
+    constructor(message: string, details?: Record<string, unknown>, requestId?: string);
+}
+export declare class ResourceLimitError extends MCPShellError {
+    constructor(resource: string, limit: number, requestId?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE7D,qBAAa,aAAc,SAAQ,KAAK;IACtC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,QAAQ,EAAE,aAAa,CAAC;IACxC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClD,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;gBAGjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,SAAS,CAAC,EAAE,MAAM;IAWpB,WAAW,IAAI,SAAS;IAmBxB,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,aAAa;CAuBpE;AAGD,qBAAa,qBAAsB,SAAQ,aAAa;gBAC1C,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CASjE;AAED,qBAAa,cAAe,SAAQ,aAAa;gBACnC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM;CAGnF;AAED,qBAAa,YAAa,SAAQ,aAAa;gBACjC,cAAc,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CASvD;AAED,qBAAa,aAAc,SAAQ,aAAa;gBAClC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM;CAGnF;AAED,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAShE"}

package/dist/utils/errors.js

@@ -0,0 +1,67 @@
+export class MCPShellError extends Error {
+    code;
+    category;
+    details;
+    timestamp;
+    requestId;
+    constructor(code, message, category, details, requestId) {
+        super(message);
+        this.name = 'MCPShellError';
+        this.code = code;
+        this.category = category;
+        this.details = details || {};
+        this.timestamp = new Date().toISOString();
+        this.requestId = requestId || '';
+    }
+    toErrorInfo() {
+        const errorInfo = {
+            code: this.code,
+            message: this.message,
+            category: this.category,
+            timestamp: this.timestamp,
+        };
+        if (this.details && Object.keys(this.details).length > 0) {
+            errorInfo.details = this.details;
+        }
+        if (this.requestId) {
+            errorInfo.request_id = this.requestId;
+        }
+        return errorInfo;
+    }
+    static fromError(error, requestId) {
+        if (error instanceof MCPShellError) {
+            return error;
+        }
+        if (error instanceof Error) {
+            return new MCPShellError('SYSTEM_001', error.message, 'SYSTEM', { stack: error.stack }, requestId);
+        }
+        return new MCPShellError('SYSTEM_001', 'Unknown error occurred', 'SYSTEM', { originalError: String(error) }, requestId);
+    }
+}
+// 定義済みエラー
+export class ResourceNotFoundError extends MCPShellError {
+    constructor(resourceType, id, requestId) {
+        super('RESOURCE_001', `${resourceType} with ID ${id} not found`, 'RESOURCE', { resourceType, id }, requestId);
+    }
+}
+export class ExecutionError extends MCPShellError {
+    constructor(message, details, requestId) {
+        super('EXECUTION_001', message, 'EXECUTION', details, requestId);
+    }
+}
+export class TimeoutError extends MCPShellError {
+    constructor(timeoutSeconds, requestId) {
+        super('EXECUTION_002', `Operation timed out after ${timeoutSeconds} seconds`, 'EXECUTION', { timeoutSeconds }, requestId);
+    }
+}
+export class SecurityError extends MCPShellError {
+    constructor(message, details, requestId) {
+        super('SECURITY_001', message, 'SECURITY', details, requestId);
+    }
+}
+export class ResourceLimitError extends MCPShellError {
+    constructor(resource, limit, requestId) {
+        super('RESOURCE_005', `${resource} limit of ${limit} reached`, 'RESOURCE', { resource, limit }, requestId);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

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

package/dist/utils/helpers.d.ts

@@ -0,0 +1,85 @@
+export declare function generateId(): string;
+export declare function getCurrentTimestamp(): string;
+export declare function isValidPath(filePath: string, allowedPaths?: string[]): boolean;
+export declare function isValidCommand(command: string, allowedCommands?: string[], blockedCommands?: string[]): boolean;
+export declare function getFileSize(filePath: string): Promise<number>;
+export declare function ensureDirectory(dirPath: string): Promise<void>;
+export declare function ensureDirectorySync(dirPath: string): void;
+export declare function safeReadFile(filePath: string, offset?: number, size?: number, encoding?: BufferEncoding): Promise<{
+    content: string;
+    totalSize: number;
+    isTruncated: boolean;
+}>;
+export declare function getSystemInfo(): {
+    platform: NodeJS.Platform;
+    arch: string;
+    hostname: string;
+    loadavg: number[];
+    totalmem: number;
+    freemem: number;
+    uptime: number;
+};
+export declare function getProcessInfo(): {
+    pid: number;
+    ppid: number;
+    platform: NodeJS.Platform;
+    arch: NodeJS.Architecture;
+    version: string;
+    memoryUsage: NodeJS.MemoryUsage;
+    cpuUsage: NodeJS.CpuUsage;
+    uptime: number;
+};
+export declare function getSafeEnvironment(baseEnv?: Record<string, string>, additionalEnv?: Record<string, string>): Record<string, string>;
+export declare function sanitizeString(input: string, maxLength?: number): string;
+export declare function formatBytes(bytes: number): string;
+export declare function formatDuration(milliseconds: number): string;
+export declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3
+}
+export interface LogEntry {
+    timestamp: string;
+    level: LogLevel;
+    message: string;
+    data?: unknown;
+    component?: string;
+}
+export interface LogConfig {
+    enableFileLogging: boolean;
+    logFilePath: string;
+    maxFileSize: number;
+    maxLogFiles: number;
+    enableConsoleLogging: boolean;
+}
+export declare function updateLogConfig(config: Partial<LogConfig>): void;
+export declare function getLogConfig(): LogConfig;
+export declare function internalLog(level: LogLevel, message: string, data?: unknown, component?: string): void;
+export declare function getLogEntries(level?: LogLevel, component?: string, limit?: number): LogEntry[];
+export declare const logger: {
+    debug: (message: string, data?: unknown, component?: string) => void;
+    info: (message: string, data?: unknown, component?: string) => void;
+    warn: (message: string, data?: unknown, component?: string) => void;
+    error: (message: string, data?: unknown, component?: string) => void;
+    getEntries: (level?: LogLevel, component?: string, limit?: number) => LogEntry[];
+    getHistory: (options?: {
+        level?: LogLevel;
+        component?: string;
+        limit?: number;
+        since?: string;
+        until?: string;
+        search?: string;
+    }) => LogEntry[];
+    readLogFile: (lines?: number) => Promise<string[]>;
+    getStats: () => {
+        totalEntries: number;
+        byLevel: Record<string, number>;
+        byComponent: Record<string, number>;
+        oldestEntry: string | null | undefined;
+        newestEntry: string | null | undefined;
+    };
+    configure: typeof updateLogConfig;
+    getConfig: typeof getLogConfig;
+};
+//# sourceMappingURL=helpers.d.ts.map

package/dist/utils/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"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"}