sema-core 1.0.2

package/dist/manager/StateManager.js

@@ -0,0 +1,357 @@
+"use strict";
+/**
+ * 子代理不触发 conversation:usage、message:chunk、state:update、todos:update、topic:update
+ * 子代理相关事件 message:complete、tool:execution:complete、tool:execution:error、session:interrupted、tool:permission:request 有agentId字段
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getStateManager = exports.StateManager = exports.MAIN_AGENT_ID = void 0;
+const EventSystem_1 = require("../events/EventSystem");
+const log_1 = require("../util/log");
+const history_1 = require("../util/history");
+const ConfManager_1 = require("./ConfManager");
+// 主代理固定 ID
+exports.MAIN_AGENT_ID = 'main';
+/**
+ * 全局状态管理器
+ * 负责管理会话状态并发送状态更新事件
+ *
+ * 隔离状态（按 agentId）：
+ * - statesMap: 代理状态 (currentState/previousState)
+ * - messageHistoryMap: 消息历史
+ * - readFileTimestampsMap: 文件读取时间戳
+ * - todosMap: todos 列表
+ *
+ * 共享状态：
+ * - sessionId: 会话ID
+ * - globalEditPermissionGranted: 全局编辑权限
+ * - currentAbortController: 中断控制器
+ */
+class StateManager {
+    constructor() {
+        // === 隔离状态（按 agentId） ===
+        this.statesMap = new Map();
+        this.messageHistoryMap = new Map();
+        this.readFileTimestampsMap = new Map();
+        this.todosMap = new Map();
+        // === 共享状态 ===
+        this.sessionId = null;
+        this.globalEditPermissionGranted = false;
+        this.planModeInfoSent = false;
+        this.currentAbortController = null;
+        // 私有构造函数，确保单例模式
+    }
+    /**
+     * 获取StateManager实例（单例模式）
+     */
+    static getInstance() {
+        if (!StateManager.instance) {
+            StateManager.instance = new StateManager();
+        }
+        return StateManager.instance;
+    }
+    /**
+     * 获取当前会话ID
+     */
+    getSessionId() {
+        return this.sessionId;
+    }
+    /**
+     * 设置会话ID
+     */
+    setSessionId(sessionId) {
+        this.sessionId = sessionId;
+        // 新建会话时重置全局编辑权限
+        this.globalEditPermissionGranted = false;
+        (0, log_1.logInfo)(`会话ID已设置: ${sessionId}，全局编辑权限已重置`);
+    }
+    // ============================================================
+    // 消息历史管理（按代理隔离）
+    // ============================================================
+    /**
+     * 设置消息历史
+     */
+    setMessageHistory(messages, agentId = exports.MAIN_AGENT_ID) {
+        this.messageHistoryMap.set(agentId, messages);
+        // 主代理设置消息历史时自动保存
+        if (agentId === exports.MAIN_AGENT_ID && this.sessionId && messages.length > 0) {
+            this.saveSessionHistory();
+        }
+    }
+    /**
+     * 获取消息历史
+     */
+    getMessageHistory(agentId = exports.MAIN_AGENT_ID) {
+        return this.messageHistoryMap.get(agentId) || [];
+    }
+    // ============================================================
+    // 文件读取时间戳管理（按代理隔离）
+    // ============================================================
+    /**
+     * 获取文件读取时间戳
+     */
+    getReadFileTimestamps(agentId = exports.MAIN_AGENT_ID) {
+        let timestamps = this.readFileTimestampsMap.get(agentId);
+        if (!timestamps) {
+            timestamps = {};
+            this.readFileTimestampsMap.set(agentId, timestamps);
+        }
+        return timestamps;
+    }
+    /**
+     * 设置单个文件的读取时间戳
+     */
+    setReadFileTimestamp(filePath, timestamp, agentId = exports.MAIN_AGENT_ID) {
+        const timestamps = this.getReadFileTimestamps(agentId);
+        timestamps[filePath] = timestamp;
+    }
+    /**
+     * 获取单个文件的读取时间戳
+     */
+    getReadFileTimestamp(filePath, agentId = exports.MAIN_AGENT_ID) {
+        return this.getReadFileTimestamps(agentId)[filePath];
+    }
+    // ============================================================
+    // todos 管理（按代理隔离）
+    // ============================================================
+    /**
+     * 获取 todos 列表
+     */
+    getTodos(agentId = exports.MAIN_AGENT_ID) {
+        return this.todosMap.get(agentId) || [];
+    }
+    /**
+     * 设置 todos 列表
+     */
+    setTodos(todos, agentId = exports.MAIN_AGENT_ID) {
+        this.todosMap.set(agentId, todos);
+    }
+    /**
+     * 清理指定代理的 todos
+     */
+    clearAgentTodos(agentId) {
+        if (agentId !== exports.MAIN_AGENT_ID) {
+            this.todosMap.delete(agentId);
+            (0, log_1.logInfo)(`[${agentId}] todos已清理`);
+        }
+    }
+    /**
+     * 智能更新 todos 列表
+     * 如果传入的 todos 都有 id 且是现有 todos 的子集，则进行子集更新，否则进行完全替换
+     */
+    updateTodosIntelligently(newTodos, agentId = exports.MAIN_AGENT_ID) {
+        const currentTodos = this.todosMap.get(agentId) || [];
+        if (newTodos.length === 0) {
+            // 空数组直接替换
+            this.todosMap.set(agentId, newTodos);
+            (0, log_1.logInfo)(`[${agentId}] todos完全替换: ${newTodos.length} 项`);
+            // 只有主代理才发送事件
+            if (agentId === exports.MAIN_AGENT_ID) {
+                this.emitTodosUpdateEvent(newTodos);
+            }
+            return;
+        }
+        // 检查是否为子集更新
+        const isSubsetUpdate = newTodos.every(todo => todo.id && currentTodos.some(existing => existing.id === todo.id));
+        if (isSubsetUpdate && currentTodos.length > 0) {
+            // 子集更新：更新现有 todos 中匹配的项
+            const updatedTodos = currentTodos.map(existing => {
+                const update = newTodos.find(todo => todo.id === existing.id);
+                return update || existing;
+            });
+            this.todosMap.set(agentId, updatedTodos);
+            (0, log_1.logInfo)(`[${agentId}] todos子集更新: ${newTodos.length} 项更新，总共 ${updatedTodos.length} 项`);
+            // 只有主代理才发送事件
+            if (agentId === exports.MAIN_AGENT_ID) {
+                this.emitTodosUpdateEvent(newTodos);
+            }
+        }
+        else {
+            // 完全替换：有新的 id 或没有 id 的情况
+            this.todosMap.set(agentId, newTodos);
+            (0, log_1.logInfo)(`[${agentId}] todos完全替换: ${newTodos.length} 项`);
+            // 只有主代理才发送事件
+            if (agentId === exports.MAIN_AGENT_ID) {
+                this.emitTodosUpdateEvent(newTodos);
+            }
+        }
+    }
+    /**
+     * 发送 todos 更新事件
+     */
+    emitTodosUpdateEvent(todos) {
+        const eventBus = (0, EventSystem_1.getEventBus)();
+        eventBus.emit('todos:update', todos);
+    }
+    // ============================================================
+    // 代理状态管理（按代理隔离）
+    // ============================================================
+    /**
+     * 获取代理状态
+     */
+    getAgentState(agentId) {
+        let state = this.statesMap.get(agentId);
+        if (!state) {
+            state = { currentState: 'idle', previousState: 'idle' };
+            this.statesMap.set(agentId, state);
+        }
+        return state;
+    }
+    /**
+     * 更新状态并发送事件
+     * - 只有主代理 (agentId === MAIN_AGENT_ID) 才会发送全局状态事件
+     */
+    updateState(newState, agentId = exports.MAIN_AGENT_ID) {
+        const agentState = this.getAgentState(agentId);
+        // 添加调试日志
+        (0, log_1.logInfo)(`updateState: agentId=${agentId}, current=${agentState.currentState}, new=${newState}, sessionId=${this.sessionId}`);
+        if (agentState.currentState !== newState) {
+            agentState.previousState = agentState.currentState;
+            agentState.currentState = newState;
+            // 只有主代理才发送全局状态更新事件（直接使用 eventBus，参见方法注释）
+            if (agentId === exports.MAIN_AGENT_ID) {
+                const eventBus = (0, EventSystem_1.getEventBus)();
+                const stateData = {
+                    state: newState
+                };
+                eventBus.emit('state:update', stateData);
+                (0, log_1.logInfo)(`状态更新: ${agentState.previousState} → ${newState}`);
+            }
+            else {
+                (0, log_1.logInfo)(`[${agentId}] 状态更新: ${agentState.previousState} → ${newState}`);
+            }
+        }
+        else {
+            (0, log_1.logInfo)(`updateState: 状态未变化`);
+        }
+    }
+    /**
+     * 获取当前状态
+     */
+    getCurrentState(agentId = exports.MAIN_AGENT_ID) {
+        return this.getAgentState(agentId).currentState;
+    }
+    /**
+     * 清空所有状态数据
+     */
+    clearAllState() {
+        // 清空所有隔离状态的 Map
+        this.statesMap.clear();
+        this.messageHistoryMap.clear();
+        this.readFileTimestampsMap.clear();
+        this.todosMap.clear();
+        // 重置共享状态
+        this.currentAbortController = null;
+        this.globalEditPermissionGranted = false;
+        this.planModeInfoSent = false;
+        (0, log_1.logInfo)('所有状态数据已清空');
+    }
+    /**
+     * 清理指定代理的所有隔离状态
+     */
+    clearAgentState(agentId) {
+        if (agentId !== exports.MAIN_AGENT_ID) {
+            this.statesMap.delete(agentId);
+            this.messageHistoryMap.delete(agentId);
+            this.readFileTimestampsMap.delete(agentId);
+            this.todosMap.delete(agentId);
+            (0, log_1.logInfo)(`[${agentId}] 所有隔离状态已清理`);
+        }
+    }
+    /**
+     * 保存会话历史到文件
+     */
+    async saveSessionHistory() {
+        try {
+            const messageHistory = this.getMessageHistory();
+            const todos = this.getTodos();
+            const workingDir = (0, ConfManager_1.getConfManager)().getCoreConfig()?.workingDir;
+            if (this.sessionId && messageHistory.length > 0) {
+                await (0, history_1.saveHistory)(this.sessionId, messageHistory, todos, workingDir);
+                // logInfo(`saveHistory: ${JSON.stringify(messageHistory, null, 2)}`)
+                (0, log_1.logInfo)(`会话历史已保存: ${this.sessionId}`);
+            }
+        }
+        catch (error) {
+            (0, log_1.logInfo)(`保存会话历史失败: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * 获取全局编辑权限状态
+     */
+    hasGlobalEditPermission() {
+        return this.globalEditPermissionGranted;
+    }
+    /**
+     * 授予全局编辑权限
+     */
+    grantGlobalEditPermission() {
+        this.globalEditPermissionGranted = true;
+        (0, log_1.logInfo)('全局编辑权限已授予');
+    }
+    /**
+     * 检查 Plan 模式信息是否已发送
+     */
+    isPlanModeInfoSent() {
+        return this.planModeInfoSent;
+    }
+    /**
+     * 标记 Plan 模式信息已发送
+     */
+    markPlanModeInfoSent() {
+        this.planModeInfoSent = true;
+        (0, log_1.logInfo)('Plan 模式信息已标记为已发送');
+    }
+    /**
+     * 重置 Plan 模式信息发送状态
+     */
+    resetPlanModeInfoSent() {
+        this.planModeInfoSent = false;
+        (0, log_1.logInfo)('Plan 模式信息发送状态已重置');
+    }
+    /**
+     * 为指定 agentId 创建状态访问代理对象
+     * 返回一个封装了该 agentId 所有状态操作的对象
+     */
+    forAgent(agentId) {
+        const isSubagent = agentId !== exports.MAIN_AGENT_ID;
+        return {
+            // Todos 管理
+            getTodos: () => this.getTodos(agentId),
+            setTodos: (todos) => this.setTodos(todos, agentId),
+            updateTodosIntelligently: (todos) => this.updateTodosIntelligently(todos, agentId),
+            clearTodos: () => {
+                if (isSubagent) {
+                    this.clearAgentTodos(agentId);
+                }
+            },
+            // 消息历史管理
+            getMessageHistory: () => this.getMessageHistory(agentId),
+            setMessageHistory: (messages) => this.setMessageHistory(messages, agentId),
+            finalizeMessages: (messages) => {
+                this.setMessageHistory(messages, agentId);
+                this.updateState('idle', agentId);
+            },
+            // 文件读取时间戳管理
+            getReadFileTimestamps: () => this.getReadFileTimestamps(agentId),
+            getReadFileTimestamp: (filePath) => this.getReadFileTimestamp(filePath, agentId),
+            setReadFileTimestamp: (filePath, timestamp) => this.setReadFileTimestamp(filePath, timestamp, agentId),
+            // 状态管理
+            getCurrentState: () => this.getCurrentState(agentId),
+            updateState: (state) => this.updateState(state, agentId),
+            // 清理
+            clearAllState: () => {
+                if (isSubagent) {
+                    this.clearAgentState(agentId);
+                }
+            },
+        };
+    }
+}
+exports.StateManager = StateManager;
+StateManager.instance = null;
+/**
+ * 获取 StateManager 单例实例
+ */
+const getStateManager = () => StateManager.getInstance();
+exports.getStateManager = getStateManager;
+//# sourceMappingURL=StateManager.js.map

package/dist/manager/StateManager.js.map

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

package/dist/services/agents/agentsManager.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Agents 管理器
+ *
+ * 管理自定义 Agent 的全局注册和查找
+ * 实现优先级：项目级 > 用户级 > 内置
+ */
+import { AgentConfig, AgentInfo } from '../../types/agent';
+/**
+ * Agents 管理器类 - 单例模式
+ */
+declare class AgentsManager {
+    private userAgentsDir;
+    private projectAgentsDir;
+    private agentConfigs;
+    private fileCache;
+    private agentConfigsArrayCache;
+    constructor(userAgentsDir: string, projectAgentsDir: string);
+    /**
+     * 使数组缓存失效
+     */
+    private invalidateCache;
+    /**
+     * 初始化 Agents 配置（异步）
+     * 按优先级加载：内置 -> 用户级 -> 项目级
+     */
+    init(): Promise<void>;
+    /**
+     * 加载内置 agents
+     */
+    private loadBuiltInAgents;
+    /**
+     * 从指定目录加载 agent 配置（异步，支持缓存）
+     */
+    private loadAgentsFromDir;
+    /**
+     * 解析 Agent Markdown 文件（异步，支持缓存）
+     * 格式：
+     * ---
+     * name: agent-name
+     * description: "agent description"
+     * tools: Glob, Grep, Read
+     * model: haiku
+     * ---
+     *
+     * Agent prompt content here...
+     */
+    private parseAgentFile;
+    /**
+     * 获取所有 Agent 配置（带缓存）
+     */
+    getAgentsConfs(): AgentConfig[];
+    /**
+     * 获取所有 Agent 信息
+     */
+    getAgentsInfo(): AgentInfo[];
+    /**
+     * 根据名称获取 Agent 配置
+     */
+    getAgentConfig(name: string): AgentConfig | undefined;
+    /**
+     * 获取所有子代理的类型描述
+     * 格式: "- AgentName: description"
+     */
+    getAgentTypesDescription(): string;
+    /**
+     * 保存 Agent 配置到文件
+     */
+    private saveAgentToFile;
+    /**
+     * 生成 Agent 文件内容（Markdown 格式）
+     */
+    private generateAgentFileContent;
+    /**
+     * 添加 Agent 配置
+     */
+    addAgentConf(agentConf: AgentConfig): Promise<boolean>;
+    /**
+     * 清理资源
+     */
+    dispose(): void;
+}
+/**
+ * 获取 Agents Manager 实例（单例模式）
+ */
+export declare function getAgentsManager(): AgentsManager;
+/**
+ * 初始化 Agents Manager（异步）
+ */
+export declare function initAgentsManager(): Promise<void>;
+/**
+ * 获取所有 Agent 配置
+ */
+export declare function getAgentsConfs(): AgentConfig[];
+/**
+ * 获取所有 Agent 信息
+ */
+export declare function getAgentsInfo(): AgentInfo[];
+/**
+ * 根据名称获取 Agent 配置
+ */
+export declare function getAgentConfig(name: string): AgentConfig | undefined;
+/**
+ * 添加 Agent 配置
+ */
+export declare function addAgentConf(agentConf: AgentConfig): Promise<boolean>;
+export { AgentsManager };
+/**
+ * 获取所有子代理的类型描述（用于 Task 工具的 prompt）
+ * 格式: "- AgentName: description"
+ */
+export declare function getAgentTypesDescription(): string;
+//# sourceMappingURL=agentsManager.d.ts.map

package/dist/services/agents/agentsManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentsManager.d.ts","sourceRoot":"","sources":["../../../src/services/agents/agentsManager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAe1D;;GAEG;AACH,cAAM,aAAa;IACjB,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,gBAAgB,CAAQ;IAChC,OAAO,CAAC,YAAY,CAAsC;IAE1D,OAAO,CAAC,SAAS,CAAyC;IAE1D,OAAO,CAAC,sBAAsB,CAA6B;gBAE/C,aAAa,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM;IAK3D;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;OAEG;YACW,iBAAiB;IAsC/B;;;;;;;;;;;OAWG;YACW,cAAc;IAgE5B;;OAEG;IACH,cAAc,IAAI,WAAW,EAAE;IAO/B;;OAEG;IACH,aAAa,IAAI,SAAS,EAAE;IAU5B;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIrD;;;OAGG;IACH,wBAAwB,IAAI,MAAM;IAUlC;;OAEG;YACW,eAAe;IAuB7B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAoChC;;OAEG;IACG,YAAY,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IA4B5D;;OAEG;IACH,OAAO,IAAI,IAAI;CAKhB;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAQhD;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAGvD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,WAAW,EAAE,CAG9C;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,SAAS,EAAE,CAG3C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAGpE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAG3E;AAED,OAAO,EAAE,aAAa,EAAE,CAAA;AAExB;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAGjD"}