sema-core 1.0.2

package/dist/util/savePath.js

@@ -0,0 +1,189 @@
+"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.getSemaRootDir = getSemaRootDir;
+exports.getModelConfigFilePath = getModelConfigFilePath;
+exports.getProjectConfigFilePath = getProjectConfigFilePath;
+exports.getHistoryDir = getHistoryDir;
+exports.projectPathToDirName = projectPathToDirName;
+exports.getProjectHistoryDir = getProjectHistoryDir;
+exports.getHistoryFilePath = getHistoryFilePath;
+exports.getLogsDir = getLogsDir;
+exports.getLLMLogsDir = getLLMLogsDir;
+exports.getTracksDir = getTracksDir;
+exports.getCacheDir = getCacheDir;
+exports.getLLMCacheFilePath = getLLMCacheFilePath;
+exports.getEventDir = getEventDir;
+exports.getGlobalAgentMdPath = getGlobalAgentMdPath;
+exports.getGlobalMCPFilePath = getGlobalMCPFilePath;
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const time_1 = require("../util/time");
+const file_1 = require("./file");
+const config_1 = require("../constants/config");
+/**
+ * 获取 Sema 根目录路径
+ * 默认为 ~/.sema，可通过环境变量 SEMA_ROOT 自定义
+ * 跨平台兼容：Windows、macOS、Linux
+ */
+function getSemaRootDir() {
+    const customRoot = process.env.SEMA_ROOT;
+    if (customRoot) {
+        // Windows 平台下标准化路径（处理 /c/Users/... 格式）
+        if (process.platform === 'win32') {
+            return (0, file_1.normalizeFilePath)(customRoot);
+        }
+        return path.resolve(customRoot);
+    }
+    // 处理 SEMA_ROOT 常量中的 ~ 符号，跨平台兼容
+    if (config_1.SEMA_ROOT.startsWith('~/')) {
+        return path.join(os.homedir(), config_1.SEMA_ROOT.slice(2));
+    }
+    return path.resolve(config_1.SEMA_ROOT);
+}
+/**
+ * 获取模型配置文件路径
+ */
+function getModelConfigFilePath() {
+    return path.join(getSemaRootDir(), config_1.MODEL_CONF_FILE_PATH);
+}
+/**
+ * 获取项目配置文件路径
+ */
+function getProjectConfigFilePath() {
+    return path.join(getSemaRootDir(), config_1.PROJECT_CONF_FILE_PATH);
+}
+/**
+ * 获取历史记录根目录路径
+ */
+function getHistoryDir() {
+    return path.join(getSemaRootDir(), config_1.HISTORY_DIR_PATH);
+}
+/**
+ * 将项目绝对路径转换为目录名
+ * 规则：路径分隔符替换为 -，开头加 -，Windows盘符的冒号去掉
+ * 例如：
+ *   /Users/xxx/project -> -Users-xxx-project
+ *   C:\Users\xxx\project -> -C-Users-xxx-project
+ * @param projectPath 项目绝对路径
+ */
+function projectPathToDirName(projectPath) {
+    // 标准化路径
+    let normalized = path.normalize(projectPath);
+    // Windows 路径处理：去掉盘符后的冒号 (C: -> C)
+    normalized = normalized.replace(/^([A-Za-z]):/, '$1');
+    // 将路径分隔符（/ 或 \）替换为 -
+    // 使用正则同时匹配正斜杠和反斜杠
+    const dirName = normalized.replace(/[/\\]+/g, '-');
+    // 确保开头有 -（如果原路径以分隔符开头，替换后已经有 -）
+    // 如果是 Windows 路径（如 C-Users-xxx），需要在开头加 -
+    if (!dirName.startsWith('-')) {
+        return '-' + dirName;
+    }
+    return dirName;
+}
+/**
+ * 获取项目的历史记录目录路径
+ * @param projectPath 项目绝对路径
+ */
+function getProjectHistoryDir(projectPath) {
+    const dirName = projectPathToDirName(projectPath);
+    return path.join(getHistoryDir(), dirName);
+}
+/**
+ * 获取历史记录文件路径
+ * @param sessionId 会话ID
+ * @param projectPath 项目绝对路径（可选，如果不提供则使用旧的平铺存储方式）
+ */
+function getHistoryFilePath(sessionId, projectPath) {
+    const dateStr = (0, time_1.getDayTimeString)();
+    const filename = `${dateStr}_${sessionId}.json`;
+    if (projectPath) {
+        return path.join(getProjectHistoryDir(projectPath), filename);
+    }
+    // 兼容旧逻辑
+    return path.join(getHistoryDir(), filename);
+}
+/**
+ * 获取日志目录路径
+ */
+function getLogsDir() {
+    return path.join(getSemaRootDir(), config_1.LOG_DIR_PATH);
+}
+/**
+ * 获取LLM日志目录路径
+ */
+function getLLMLogsDir() {
+    return path.join(getSemaRootDir(), config_1.LLM_LOG_DIR_PATH);
+}
+/**
+ * 获取轨迹归档目录路径
+ */
+function getTracksDir() {
+    return path.join(getSemaRootDir(), config_1.TRACKS_DIR_PATH);
+}
+/**
+ * 获取缓存目录路径
+ */
+function getCacheDir() {
+    return path.join(getSemaRootDir(), 'cache');
+}
+/**
+ * 获取LLM缓存文件路径
+ */
+function getLLMCacheFilePath() {
+    return path.join(getCacheDir(), 'llm-cache.json');
+}
+/**
+ * 获取事件日志目录路径
+ */
+function getEventDir() {
+    return path.join(getSemaRootDir(), config_1.EVENT_DIR_PATH);
+}
+/**
+ * 获取全局 Agent.md 文件路径
+ * 位于根目录下的 /.sema/AGENT.md
+ */
+function getGlobalAgentMdPath() {
+    return path.join(getSemaRootDir(), 'AGENT.md');
+}
+/**
+ * 获取全局 MCP配置 文件路径
+ * 位于根目录下的 /.sema/mcp.json
+ */
+function getGlobalMCPFilePath() {
+    return path.join(getSemaRootDir(), 'mcp.json');
+}
+//# sourceMappingURL=savePath.js.map

package/dist/util/savePath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"savePath.js","sourceRoot":"","sources":["../../src/util/savePath.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoBA,wCAgBC;AAKD,wDAEC;AAKD,4DAEC;AAKD,sCAEC;AAUD,oDAkBC;AAMD,oDAGC;AAOD,gDAUC;AAKD,gCAEC;AAKD,sCAEC;AAKD,oCAEC;AAKD,kCAEC;AAKD,kDAEC;AAKD,kCAEC;AAMD,oDAEC;AAMD,oDAEC;AAzKD,2CAA6B;AAC7B,uCAAyB;AACzB,uCAAgD;AAChD,iCAA2C;AAC3C,gDAS6B;AAE7B;;;;GAIG;AACH,SAAgB,cAAc;IAC5B,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;IACzC,IAAI,UAAU,EAAE,CAAC;QACf,uCAAuC;QACvC,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YACjC,OAAO,IAAA,wBAAiB,EAAC,UAAU,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;IAED,+BAA+B;IAC/B,IAAI,kBAAS,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,kBAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAS,CAAC,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,SAAgB,sBAAsB;IACpC,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,6BAAoB,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,SAAgB,wBAAwB;IACtC,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,+BAAsB,CAAC,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa;IAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,yBAAgB,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,oBAAoB,CAAC,WAAmB;IACtD,QAAQ;IACR,IAAI,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAE7C,kCAAkC;IAClC,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;IAEtD,qBAAqB;IACrB,kBAAkB;IAClB,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAEnD,gCAAgC;IAChC,yCAAyC;IACzC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,GAAG,GAAG,OAAO,CAAC;IACvB,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,SAAgB,oBAAoB,CAAC,WAAmB;IACtD,MAAM,OAAO,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,SAAiB,EAAE,WAAoB;IACxE,MAAM,OAAO,GAAG,IAAA,uBAAgB,GAAE,CAAC;IACnC,MAAM,QAAQ,GAAG,GAAG,OAAO,IAAI,SAAS,OAAO,CAAC;IAEhD,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC;IAChE,CAAC;IAED,QAAQ;IACR,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,SAAgB,UAAU;IACxB,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,qBAAY,CAAC,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa;IAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,yBAAgB,CAAC,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY;IAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,wBAAe,CAAC,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW;IACzB,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB;IACjC,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,gBAAgB,CAAC,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW;IACzB,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,uBAAc,CAAC,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,SAAgB,oBAAoB;IAClC,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,UAAU,CAAC,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,SAAgB,oBAAoB;IAClC,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,UAAU,CAAC,CAAC;AACjD,CAAC"}

package/dist/util/secureFile.d.ts

@@ -0,0 +1,136 @@
+/**
+ * 安全文件系统操作服务
+ * 解决文件系统操作中缺少适当验证和错误处理的问题
+ */
+export declare class SecureFileService {
+    private static instance;
+    private allowedBasePaths;
+    private maxFileSize;
+    private allowedExtensions;
+    private constructor();
+    static getInstance(): SecureFileService;
+    /**
+     * 验证文件路径是否安全
+     * @param filePath 文件路径
+     * @returns 验证结果
+     */
+    validateFilePath(filePath: string): {
+        isValid: boolean;
+        normalizedPath: string;
+        error?: string;
+    };
+    /**
+     * 安全地检查文件是否存在
+     * @param filePath 文件路径
+     * @returns 文件是否存在
+     */
+    safeExists(filePath: string): boolean;
+    /**
+     * 安全地读取文件
+     * @param filePath 文件路径
+     * @param options 读取选项
+     * @returns 读取结果
+     */
+    safeReadFile(filePath: string, options?: {
+        encoding?: BufferEncoding;
+        maxFileSize?: number;
+        allowedExtensions?: string[];
+        checkFileExtension?: boolean;
+    }): {
+        success: boolean;
+        content?: string | Buffer;
+        error?: string;
+        stats?: any;
+    };
+    /**
+     * 安全地写入文件
+     * @param filePath 文件路径
+     * @param content 文件内容
+     * @param options 写入选项
+     * @returns 写入结果
+     */
+    safeWriteFile(filePath: string, content: string | Buffer, options?: {
+        encoding?: BufferEncoding;
+        createDirectory?: boolean;
+        atomic?: boolean;
+        mode?: number;
+        allowedExtensions?: string[];
+        checkFileExtension?: boolean;
+        maxSize?: number;
+    }): {
+        success: boolean;
+        error?: string;
+    };
+    /**
+     * 安全地删除文件
+     * @param filePath 文件路径
+     * @returns 删除结果
+     */
+    safeDeleteFile(filePath: string): {
+        success: boolean;
+        error?: string;
+    };
+    /**
+     * 安全地创建目录
+     * @param dirPath 目录路径
+     * @param mode 目录权限
+     * @returns 创建结果
+     */
+    safeCreateDirectory(dirPath: string, mode?: number): {
+        success: boolean;
+        error?: string;
+    };
+    /**
+     * 安全地获取文件信息
+     * @param filePath 文件路径
+     * @returns 文件信息
+     */
+    safeGetFileInfo(filePath: string): {
+        success: boolean;
+        stats?: {
+            size: number;
+            isFile: boolean;
+            isDirectory: boolean;
+            mode: number;
+            atime: Date;
+            mtime: Date;
+            ctime: Date;
+        };
+        error?: string;
+    };
+    /**
+     * 添加允许的基础路径
+     * @param basePath 基础路径
+     */
+    addAllowedBasePath(basePath: string): {
+        success: boolean;
+        error?: string;
+    };
+    /**
+     * 设置最大文件大小
+     * @param maxSize 最大文件大小（字节）
+     */
+    setMaxFileSize(maxSize: number): void;
+    /**
+     * 添加允许的文件扩展名
+     * @param extensions 文件扩展名数组
+     */
+    addAllowedExtensions(extensions: string[]): void;
+    /**
+     * 检查文件是否在允许的基础路径中
+     * @param filePath 文件路径
+     * @returns 是否允许
+     */
+    isPathAllowed(filePath: string): boolean;
+    /**
+     * 验证文件名安全性
+     * @param filename 文件名
+     * @returns 验证结果
+     */
+    validateFileName(filename: string): {
+        isValid: boolean;
+        error?: string;
+    };
+}
+export declare const secureFileService: SecureFileService;
+//# sourceMappingURL=secureFile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"secureFile.d.ts","sourceRoot":"","sources":["../../src/util/secureFile.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAmB;IAC1C,OAAO,CAAC,gBAAgB,CAAa;IACrC,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,iBAAiB,CAAa;IAEtC,OAAO;WAsBO,WAAW,IAAI,iBAAiB;IAO9C;;;;OAIG;IACI,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAoGvG;;;;OAIG;IACI,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAa5C;;;;;OAKG;IACI,YAAY,CACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;QACP,QAAQ,CAAC,EAAE,cAAc,CAAC;QAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC7B,kBAAkB,CAAC,EAAE,OAAO,CAAC;KACzB,GACL;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,GAAG,CAAA;KAAE;IAyE/E;;;;;;OAMG;IACI,aAAa,CAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,OAAO,GAAE;QACP,QAAQ,CAAC,EAAE,cAAc,CAAC;QAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC7B,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;KACb,GACL;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAqFvC;;;;OAIG;IACI,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAoC7E;;;;;OAKG;IACI,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAc,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IA2BvG;;;;OAIG;IACI,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG;QACxC,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE;YACN,IAAI,EAAE,MAAM,CAAC;YACb,MAAM,EAAE,OAAO,CAAC;YAChB,WAAW,EAAE,OAAO,CAAC;YACrB,IAAI,EAAE,MAAM,CAAC;YACb,KAAK,EAAE,IAAI,CAAC;YACZ,KAAK,EAAE,IAAI,CAAC;YACZ,KAAK,EAAE,IAAI,CAAC;SACb,CAAC;QACF,KAAK,CAAC,EAAE,MAAM,CAAA;KACf;IAmCD;;;OAGG;IACI,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAmBjF;;;OAGG;IACI,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5C;;;OAGG;IACI,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI;IASvD;;;;OAIG;IACI,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAK/C;;;;OAIG;IACI,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;CAwChF;AAGD,eAAO,MAAM,iBAAiB,mBAAkC,CAAA"}