sema-core 1.0.2

package/dist/util/secureFile.js

@@ -0,0 +1,496 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.secureFileService = exports.SecureFileService = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_os_1 = require("node:os");
+const file_1 = require("./file");
+const cwd_1 = require("./cwd");
+/**
+ * 安全文件系统操作服务
+ * 解决文件系统操作中缺少适当验证和错误处理的问题
+ */
+class SecureFileService {
+    constructor() {
+        // 默认最大文件大小 (2MB)
+        this.maxFileSize = 2 * 1024 * 1024;
+        // 允许的文件扩展名
+        this.allowedExtensions = new Set([
+            '.txt', '.md', '.json', '.js', '.ts', '.tsx', '.jsx',
+            '.yaml', '.yml', '.toml', '.ini', '.env', '.log',
+            '.html', '.css', '.scss', '.less', '.xml', '.csv',
+            '.py', '.go', '.rs', '.java', '.cpp', '.c', '.h',
+            '.sh', '.bash', '.zsh', '.fish', '.ps1', '.bat',
+            '.dockerfile', '.gitignore', '.npmignore', '.eslintignore'
+        ]);
+        // 静态基础路径（不包含动态工作目录）
+        this.allowedBasePaths = new Set([
+            (0, node_os_1.homedir)(),
+            '/tmp',
+            '/var/tmp'
+        ]);
+    }
+    static getInstance() {
+        if (!SecureFileService.instance) {
+            SecureFileService.instance = new SecureFileService();
+        }
+        return SecureFileService.instance;
+    }
+    /**
+     * 验证文件路径是否安全
+     * @param filePath 文件路径
+     * @returns 验证结果
+     */
+    validateFilePath(filePath) {
+        try {
+            // 使用我们的路径标准化函数，支持Unix风格路径
+            const normalizedPath = (0, file_1.normalizeFilePath)(filePath);
+            // 检查路径长度
+            if (normalizedPath.length > 4096) {
+                return {
+                    isValid: false,
+                    normalizedPath,
+                    error: 'Path too long (max 4096 characters)'
+                };
+            }
+            // 检查是否包含路径遍历字符
+            if (normalizedPath.includes('..') || normalizedPath.includes('~')) {
+                return {
+                    isValid: false,
+                    normalizedPath,
+                    error: 'Path contains traversal characters'
+                };
+            }
+            // 检查是否包含可疑的字符序列
+            const suspiciousPatterns = [
+                /\.\./, // 父目录
+                /~/, // 用户目录
+                /\$\{/, // 环境变量
+                /`/, // 命令执行
+                /\|/, // 管道符
+                /;/, // 命令分隔符
+                /&/, // 后台执行
+                />/, // 输出重定向
+                /</, // 输入重定向
+            ];
+            for (const pattern of suspiciousPatterns) {
+                if (pattern.test(normalizedPath)) {
+                    return {
+                        isValid: false,
+                        normalizedPath,
+                        error: `Path contains suspicious pattern: ${pattern}`
+                    };
+                }
+            }
+            // normalizeFilePath已经返回绝对路径，直接使用
+            const absolutePath = normalizedPath;
+            // 检查是否在允许的基础路径中
+            // 动态构建允许的基础路径列表，包含当前工作目录
+            const currentAllowedPaths = [
+                (0, cwd_1.getCwd)(), // 动态获取当前工作目录
+                ...Array.from(this.allowedBasePaths) // 静态基础路径
+            ];
+            const isInAllowedPath = currentAllowedPaths.some((basePath, index) => {
+                // console.log(`[SecureFileService] 检查基础路径 ${index + 1}: ${basePath}`)
+                // 统一标准化基础路径，确保Unix风格路径被正确处理
+                const base = (0, file_1.normalizeFilePath)(basePath);
+                // console.log(`[SecureFileService] 标准化基础路径: ${base}`)
+                const rel = (0, node_path_1.relative)(base, absolutePath);
+                // console.log(`[SecureFileService] 相对路径: "${rel}"`)
+                if (!rel || rel === '') {
+                    // console.log(`[SecureFileService] ✅ 相同路径，允许访问`)
+                    return true;
+                }
+                if (rel.startsWith('..')) {
+                    console.log(`[SecureFileService] ❌ 向上跳出路径，拒绝访问`);
+                    return false;
+                }
+                if ((0, node_path_1.isAbsolute)(rel)) {
+                    console.log(`[SecureFileService] ❌ 绝对相对路径，拒绝访问`);
+                    return false;
+                }
+                // console.log(`[SecureFileService] ✅ 子路径，允许访问`)
+                return true;
+            });
+            if (!isInAllowedPath) {
+                return {
+                    isValid: false,
+                    normalizedPath,
+                    error: 'Path is outside allowed directories'
+                };
+            }
+            return { isValid: true, normalizedPath: absolutePath };
+        }
+        catch (error) {
+            return {
+                isValid: false,
+                normalizedPath: filePath,
+                error: `Path validation failed: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+    /**
+     * 安全地检查文件是否存在
+     * @param filePath 文件路径
+     * @returns 文件是否存在
+     */
+    safeExists(filePath) {
+        const validation = this.validateFilePath(filePath);
+        if (!validation.isValid) {
+            return false;
+        }
+        try {
+            return (0, node_fs_1.existsSync)(validation.normalizedPath);
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    /**
+     * 安全地读取文件
+     * @param filePath 文件路径
+     * @param options 读取选项
+     * @returns 读取结果
+     */
+    safeReadFile(filePath, options = {}) {
+        const validation = this.validateFilePath(filePath);
+        if (!validation.isValid) {
+            return { success: false, error: validation.error };
+        }
+        try {
+            const normalizedPath = validation.normalizedPath;
+            // 检查文件扩展名（如果启用）
+            if (options.checkFileExtension !== false) {
+                const ext = (0, node_path_1.extname)(normalizedPath).toLowerCase();
+                const allowedExts = options.allowedExtensions ||
+                    Array.from(this.allowedExtensions);
+                if (allowedExts.length > 0 && !allowedExts.includes(ext)) {
+                    return {
+                        success: false,
+                        error: `File extension '${ext}' is not allowed`
+                    };
+                }
+            }
+            // 检查文件是否存在
+            if (!(0, node_fs_1.existsSync)(normalizedPath)) {
+                return { success: false, error: `File '${normalizedPath}' does not exist` };
+            }
+            // 获取文件信息
+            const stats = (0, node_fs_1.statSync)(normalizedPath);
+            const maxSize = options.maxFileSize || this.maxFileSize;
+            // 检查文件大小
+            if (stats.size > maxSize) {
+                return {
+                    success: false,
+                    error: `File too large (${stats.size} bytes, max ${maxSize} bytes)`
+                };
+            }
+            // 检查文件类型
+            if (!stats.isFile()) {
+                return { success: false, error: 'Path is not a file' };
+            }
+            // 检查文件权限
+            if ((stats.mode & parseInt('400', 8)) === 0) { // 检查读权限
+                return { success: false, error: 'No read permission' };
+            }
+            // 读取文件内容
+            const content = (0, node_fs_1.readFileSync)(normalizedPath, {
+                encoding: options.encoding || 'utf8'
+            });
+            return {
+                success: true,
+                content,
+                stats: {
+                    size: stats.size,
+                    mtime: stats.mtime,
+                    atime: stats.atime,
+                    mode: stats.mode
+                }
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Failed to read file: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+    /**
+     * 安全地写入文件
+     * @param filePath 文件路径
+     * @param content 文件内容
+     * @param options 写入选项
+     * @returns 写入结果
+     */
+    safeWriteFile(filePath, content, options = {}) {
+        const validation = this.validateFilePath(filePath);
+        if (!validation.isValid) {
+            return { success: false, error: validation.error };
+        }
+        try {
+            const normalizedPath = validation.normalizedPath;
+            // 检查文件扩展名（如果启用）
+            if (options.checkFileExtension !== false) {
+                const ext = (0, node_path_1.extname)(normalizedPath).toLowerCase();
+                const allowedExts = options.allowedExtensions ||
+                    Array.from(this.allowedExtensions);
+                if (allowedExts.length > 0 && !allowedExts.includes(ext)) {
+                    return {
+                        success: false,
+                        error: `File extension '${ext}' is not allowed`
+                    };
+                }
+            }
+            // 检查内容大小
+            const contentSize = typeof content === 'string' ?
+                Buffer.byteLength(content, options.encoding || 'utf8') :
+                content.length;
+            const maxSize = options.maxSize || this.maxFileSize;
+            if (contentSize > maxSize) {
+                return {
+                    success: false,
+                    error: `Content too large (${contentSize} bytes, max ${maxSize} bytes)`
+                };
+            }
+            // 创建目录（如果需要）
+            if (options.createDirectory) {
+                const dir = (0, node_path_1.dirname)(normalizedPath);
+                if (!(0, node_fs_1.existsSync)(dir)) {
+                    (0, node_fs_1.mkdirSync)(dir, { recursive: true, mode: 0o755 });
+                }
+            }
+            // 原子写入（如果启用）
+            if (options.atomic) {
+                const tempPath = `${normalizedPath}.tmp.${Date.now()}`;
+                try {
+                    // 写入临时文件
+                    (0, node_fs_1.writeFileSync)(tempPath, content, {
+                        encoding: options.encoding || 'utf8',
+                        mode: options.mode || 0o644
+                    });
+                    // 重命名为目标文件
+                    (0, node_fs_1.renameSync)(tempPath, normalizedPath);
+                }
+                catch (renameError) {
+                    // 清理临时文件
+                    try {
+                        if ((0, node_fs_1.existsSync)(tempPath)) {
+                            (0, node_fs_1.unlinkSync)(tempPath);
+                        }
+                    }
+                    catch {
+                        // 忽略清理错误
+                    }
+                    throw renameError;
+                }
+            }
+            else {
+                // 直接写入
+                (0, node_fs_1.writeFileSync)(normalizedPath, content, {
+                    encoding: options.encoding || 'utf8',
+                    mode: options.mode || 0o644
+                });
+            }
+            return { success: true };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Failed to write file: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+    /**
+     * 安全地删除文件
+     * @param filePath 文件路径
+     * @returns 删除结果
+     */
+    safeDeleteFile(filePath) {
+        const validation = this.validateFilePath(filePath);
+        if (!validation.isValid) {
+            return { success: false, error: validation.error };
+        }
+        try {
+            const normalizedPath = validation.normalizedPath;
+            // 检查文件是否存在
+            if (!(0, node_fs_1.existsSync)(normalizedPath)) {
+                return { success: false, error: 'File does not exist' };
+            }
+            // 检查文件类型
+            const stats = (0, node_fs_1.statSync)(normalizedPath);
+            if (!stats.isFile()) {
+                return { success: false, error: 'Path is not a file' };
+            }
+            // 检查写权限
+            if ((stats.mode & parseInt('200', 8)) === 0) {
+                return { success: false, error: 'No write permission' };
+            }
+            // 安全删除
+            (0, node_fs_1.unlinkSync)(normalizedPath);
+            return { success: true };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Failed to delete file: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+    /**
+     * 安全地创建目录
+     * @param dirPath 目录路径
+     * @param mode 目录权限
+     * @returns 创建结果
+     */
+    safeCreateDirectory(dirPath, mode = 0o755) {
+        const validation = this.validateFilePath(dirPath);
+        if (!validation.isValid) {
+            return { success: false, error: validation.error };
+        }
+        try {
+            const normalizedPath = validation.normalizedPath;
+            if ((0, node_fs_1.existsSync)(normalizedPath)) {
+                const stats = (0, node_fs_1.statSync)(normalizedPath);
+                if (!stats.isDirectory()) {
+                    return { success: false, error: 'Path already exists and is not a directory' };
+                }
+                return { success: true };
+            }
+            (0, node_fs_1.mkdirSync)(normalizedPath, { recursive: true, mode });
+            return { success: true };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Failed to create directory: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+    /**
+     * 安全地获取文件信息
+     * @param filePath 文件路径
+     * @returns 文件信息
+     */
+    safeGetFileInfo(filePath) {
+        const validation = this.validateFilePath(filePath);
+        if (!validation.isValid) {
+            return { success: false, error: validation.error };
+        }
+        try {
+            const normalizedPath = validation.normalizedPath;
+            if (!(0, node_fs_1.existsSync)(normalizedPath)) {
+                return { success: false, error: `File '${normalizedPath}' does not exist` };
+            }
+            const stats = (0, node_fs_1.statSync)(normalizedPath);
+            return {
+                success: true,
+                stats: {
+                    size: stats.size,
+                    isFile: stats.isFile(),
+                    isDirectory: stats.isDirectory(),
+                    mode: stats.mode,
+                    atime: stats.atime,
+                    mtime: stats.mtime,
+                    ctime: stats.ctime
+                }
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Failed to get file info: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+    /**
+     * 添加允许的基础路径
+     * @param basePath 基础路径
+     */
+    addAllowedBasePath(basePath) {
+        try {
+            const normalized = (0, node_path_1.normalize)((0, node_path_1.resolve)(basePath));
+            // 验证路径是否存在
+            if (!(0, node_fs_1.existsSync)(normalized)) {
+                return { success: false, error: 'Base path does not exist' };
+            }
+            this.allowedBasePaths.add(normalized);
+            return { success: true };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Failed to add base path: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+    /**
+     * 设置最大文件大小
+     * @param maxSize 最大文件大小（字节）
+     */
+    setMaxFileSize(maxSize) {
+        this.maxFileSize = maxSize;
+    }
+    /**
+     * 添加允许的文件扩展名
+     * @param extensions 文件扩展名数组
+     */
+    addAllowedExtensions(extensions) {
+        extensions.forEach(ext => {
+            if (!ext.startsWith('.')) {
+                ext = '.' + ext;
+            }
+            this.allowedExtensions.add(ext.toLowerCase());
+        });
+    }
+    /**
+     * 检查文件是否在允许的基础路径中
+     * @param filePath 文件路径
+     * @returns 是否允许
+     */
+    isPathAllowed(filePath) {
+        const validation = this.validateFilePath(filePath);
+        return validation.isValid;
+    }
+    /**
+     * 验证文件名安全性
+     * @param filename 文件名
+     * @returns 验证结果
+     */
+    validateFileName(filename) {
+        // 检查文件名长度
+        if (filename.length === 0) {
+            return { isValid: false, error: 'Filename cannot be empty' };
+        }
+        if (filename.length > 255) {
+            return { isValid: false, error: 'Filename too long (max 255 characters)' };
+        }
+        // 检查文件名字符
+        const invalidChars = /[<>:"/\\|?*\x00-\x1F]/;
+        if (invalidChars.test(filename)) {
+            return { isValid: false, error: 'Filename contains invalid characters' };
+        }
+        // 检查保留文件名
+        const reservedNames = [
+            'CON', 'PRN', 'AUX', 'NUL',
+            'COM1', 'COM2', 'COM3', 'COM4', 'COM5', 'COM6', 'COM7', 'COM8', 'COM9',
+            'LPT1', 'LPT2', 'LPT3', 'LPT4', 'LPT5', 'LPT6', 'LPT7', 'LPT8', 'LPT9'
+        ];
+        const baseName = filename.split('.')[0].toUpperCase();
+        if (reservedNames.includes(baseName)) {
+            return { isValid: false, error: 'Filename is reserved' };
+        }
+        // 检查是否以点开头或结尾
+        if (filename.startsWith('.') || filename.endsWith('.')) {
+            return { isValid: false, error: 'Filename cannot start or end with a dot' };
+        }
+        // 检查是否以空格开头或结尾
+        if (filename.startsWith(' ') || filename.endsWith(' ')) {
+            return { isValid: false, error: 'Filename cannot start or end with spaces' };
+        }
+        return { isValid: true };
+    }
+}
+exports.SecureFileService = SecureFileService;
+// 导出单例实例
+exports.secureFileService = SecureFileService.getInstance();
+//# sourceMappingURL=secureFile.js.map

package/dist/util/secureFile.js.map

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

package/dist/util/session.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 会话管理工具函数
+ */
+/**
+ * 从历史路径中解析 sessionId
+ * 历史路径格式: ~/.sema/history/2025-01-01_{sessionId}.json
+ * @param historyPath 历史文件路径
+ * @returns sessionId 或 null（如果解析失败）
+ */
+export declare function parseSessionIdFromHistoryPath(historyPath: string): string | null;
+/**
+ * 生成新的 sessionId
+ * @returns 新的短 UUID 格式的 sessionId（8位）
+ */
+export declare function generateSessionId(): string;
+/**
+ * 初始化 sessionId
+ * 如果提供了 historyPath 且能成功解析出 sessionId，则使用解析出的 sessionId
+ * 否则生成新的 sessionId
+ * @param historyPath 可选的历史文件路径
+ * @returns sessionId
+ */
+export declare function initializeSessionId(historyPath?: string): string;
+/**
+ * 验证 sessionId 格式
+ * @param sessionId 要验证的 sessionId
+ * @returns 是否为有效的短 UUID 格式
+ */
+export declare function validateSessionId(sessionId: string): boolean;
+/**
+ * 根据 sessionId 生成历史文件路径
+ * @param sessionId 会话ID
+ * @param baseDir 基础目录，默认使用 path.ts 中的统一配置
+ * @returns 历史文件路径
+ */
+export declare function generateHistoryPath(sessionId: string, baseDir?: string): string;
+//# sourceMappingURL=session.d.ts.map

package/dist/util/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/util/session.ts"],"names":[],"mappings":"AAKA;;GAEG;AAEH;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoBhF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAShE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAG5D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAS/E"}

package/dist/util/session.js

@@ -0,0 +1,120 @@
+"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.parseSessionIdFromHistoryPath = parseSessionIdFromHistoryPath;
+exports.generateSessionId = generateSessionId;
+exports.initializeSessionId = initializeSessionId;
+exports.validateSessionId = validateSessionId;
+exports.generateHistoryPath = generateHistoryPath;
+const crypto = __importStar(require("crypto"));
+const path = __importStar(require("path"));
+const time_1 = require("./time");
+const savePath_1 = require("./savePath");
+/**
+ * 会话管理工具函数
+ */
+/**
+ * 从历史路径中解析 sessionId
+ * 历史路径格式: ~/.sema/history/2025-01-01_{sessionId}.json
+ * @param historyPath 历史文件路径
+ * @returns sessionId 或 null（如果解析失败）
+ */
+function parseSessionIdFromHistoryPath(historyPath) {
+    try {
+        const fileName = path.basename(historyPath, '.json');
+        const underscoreIndex = fileName.lastIndexOf('_');
+        if (underscoreIndex === -1) {
+            return null;
+        }
+        const sessionId = fileName.substring(underscoreIndex + 1);
+        // 验证 sessionId 格式（8位短 UUID 格式）
+        const shortIdRegex = /^[0-9a-f]{8}$/i;
+        if (!shortIdRegex.test(sessionId)) {
+            return null;
+        }
+        return sessionId;
+    }
+    catch (error) {
+        return null;
+    }
+}
+/**
+ * 生成新的 sessionId
+ * @returns 新的短 UUID 格式的 sessionId（8位）
+ */
+function generateSessionId() {
+    return crypto.randomUUID().replace(/-/g, '').substring(0, 8);
+}
+/**
+ * 初始化 sessionId
+ * 如果提供了 historyPath 且能成功解析出 sessionId，则使用解析出的 sessionId
+ * 否则生成新的 sessionId
+ * @param historyPath 可选的历史文件路径
+ * @returns sessionId
+ */
+function initializeSessionId(historyPath) {
+    if (historyPath) {
+        const parsedSessionId = parseSessionIdFromHistoryPath(historyPath);
+        if (parsedSessionId) {
+            return parsedSessionId;
+        }
+    }
+    return generateSessionId();
+}
+/**
+ * 验证 sessionId 格式
+ * @param sessionId 要验证的 sessionId
+ * @returns 是否为有效的短 UUID 格式
+ */
+function validateSessionId(sessionId) {
+    const shortIdRegex = /^[0-9a-f]{8}$/i;
+    return shortIdRegex.test(sessionId);
+}
+/**
+ * 根据 sessionId 生成历史文件路径
+ * @param sessionId 会话ID
+ * @param baseDir 基础目录，默认使用 path.ts 中的统一配置
+ * @returns 历史文件路径
+ */
+function generateHistoryPath(sessionId, baseDir) {
+    if (baseDir) {
+        const today = (0, time_1.getDayTimeString)(); // YYYY-MM-DD 格式
+        const fileName = `${today}_${sessionId}.json`;
+        return path.join(baseDir, fileName);
+    }
+    // 使用 path.ts 中统一的路径获取函数
+    return (0, savePath_1.getHistoryFilePath)(sessionId);
+}
+//# sourceMappingURL=session.js.map