sema-core 1.0.2

package/dist/core/RunTools.js

@@ -0,0 +1,244 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runToolsConcurrently = runToolsConcurrently;
+exports.runToolsSerially = runToolsSerially;
+exports.runToolUse = runToolUse;
+exports.checkPermissionsAndCallTool = checkPermissionsAndCallTool;
+const message_1 = require("../util/message");
+const log_1 = require("../util/log");
+const format_1 = require("../util/format");
+const PermissionManager_1 = require("../manager/PermissionManager");
+const EventSystem_1 = require("../events/EventSystem");
+// 并发运行工具
+async function* runToolsConcurrently(toolUseMessages, assistantMessage, agentContext) {
+    // 简化版并发执行 - 实际项目中可能需要更复杂的并发控制
+    const results = await Promise.all(toolUseMessages.map(async (toolUse) => {
+        const messages = [];
+        for await (const message of runToolUse(toolUse, assistantMessage, agentContext)) {
+            messages.push(message);
+        }
+        return messages;
+    }));
+    // 按顺序输出结果
+    for (const messageGroup of results) {
+        for (const message of messageGroup) {
+            yield message;
+        }
+    }
+}
+// 串行运行工具
+async function* runToolsSerially(toolUseMessages, assistantMessage, agentContext) {
+    // 按顺序逐个执行工具
+    for (const toolUse of toolUseMessages) {
+        yield* runToolUse(toolUse, assistantMessage, agentContext);
+    }
+}
+// 执行单个工具使用
+async function* runToolUse(toolUse, assistantMessage, agentContext) {
+    const { abortController, tools } = agentContext;
+    const toolName = toolUse.name;
+    // 查找对应的工具实例
+    const tool = tools.find(t => t.name === toolName);
+    // 检查工具是否存在
+    if (!tool) {
+        // 发送工具出错事件 但不会阻塞agent继续执行
+        const toolErrorData = {
+            agentId: agentContext.agentId,
+            toolName: toolName,
+            title: toolName,
+            content: `Error: No such tool available: ${toolName}`,
+        };
+        (0, EventSystem_1.getEventBus)().emit('tool:execution:error', toolErrorData);
+        // 返回工具不存在的错误消息
+        yield (0, message_1.createUserMessage)([
+            {
+                type: 'tool_result',
+                content: `Error: No such tool available: ${toolName}`,
+                is_error: true,
+                tool_use_id: toolUse.id,
+            },
+        ]);
+        return;
+    }
+    const toolInput = toolUse.input;
+    try {
+        // 检查点3: 单个工具开始前
+        if (abortController.signal.aborted) {
+            // 在工具开始前就已经中断，说明是因为前面的工具被拒绝/取消导致的
+            // 这种情况应该返回 CANCEL_MESSAGE
+            const message = (0, message_1.createUserMessage)([
+                (0, message_1.createToolResultStopMessage)(toolUse.id),
+            ]);
+            yield message;
+            return;
+        }
+        // 检查权限并调用工具
+        for await (const message of checkPermissionsAndCallTool(tool, toolUse.id, toolInput, agentContext, assistantMessage)) {
+            // 检查点4: 工具执行期间
+            if (abortController.signal.aborted) {
+                // 如果是因为用户点击"拒绝"导致的中断，消息已由 checkPermissionsAndCallTool 正确生成
+                // 直接 yield 原消息（包含 REJECT_MESSAGE），不需要覆盖
+                const abortReason = abortController.signal.reason;
+                if (abortReason === 'refuse') {
+                    yield message;
+                    return;
+                }
+                // 其他原因的中断，返回取消消息
+                const resultMessage = (0, message_1.createUserMessage)([
+                    (0, message_1.createToolResultStopMessage)(toolUse.id),
+                ]);
+                yield resultMessage;
+                return;
+            }
+            yield message; // 生成消息
+        }
+    }
+    catch (e) {
+        (0, log_1.logError)(e); // 记录错误
+        // 即使在错误情况下，也要确保生成工具结果以清除状态
+        const errorContent = `Tool execution failed: ${e instanceof Error ? e.message : String(e)}`;
+        const errorMessage = (0, message_1.createUserMessage)([
+            {
+                type: 'tool_result',
+                content: errorContent,
+                is_error: true,
+                tool_use_id: toolUse.id,
+            },
+        ]);
+        yield errorMessage;
+    }
+}
+// 检查权限并调用工具
+async function* checkPermissionsAndCallTool(tool, toolUseID, input, agentContext, assistantMessage) {
+    const { abortController } = agentContext;
+    // 使用 zod 验证输入类型
+    const isValidInput = tool.inputSchema.safeParse(input);
+    if (!isValidInput.success) {
+        // 为常见情况创建更有帮助的错误消息
+        let errorMessage = `InputValidationError: ${isValidInput.error.message}`;
+        // 发送工具出错事件 但不会阻塞agent继续执行
+        const toolErrorData = {
+            agentId: agentContext.agentId,
+            toolName: tool.name,
+            title: tool.getDisplayTitle?.(input) || tool.name,
+            content: errorMessage,
+        };
+        (0, EventSystem_1.getEventBus)().emit('tool:execution:error', toolErrorData);
+        // 返回输入验证错误
+        yield (0, message_1.createUserMessage)([
+            {
+                type: 'tool_result',
+                content: errorMessage,
+                is_error: true,
+                tool_use_id: toolUseID,
+            },
+        ]);
+        return;
+    }
+    // 验证输入值。每个工具都有自己的验证逻辑
+    const isValidCall = await tool.validateInput?.(input, agentContext);
+    if (isValidCall?.result === false) {
+        // 发送工具出错事件 但不会阻塞agent继续执行
+        const errorMessage = isValidCall.message || '工具调用验证失败';
+        const toolErrorData = {
+            agentId: agentContext.agentId,
+            toolName: tool.name,
+            title: tool.getDisplayTitle?.(input) || tool.name,
+            content: errorMessage,
+        };
+        (0, EventSystem_1.getEventBus)().emit('tool:execution:error', toolErrorData);
+        // 返回验证失败消息
+        yield (0, message_1.createUserMessage)([
+            {
+                type: 'tool_result',
+                content: errorMessage,
+                is_error: true,
+                tool_use_id: toolUseID,
+            },
+        ]);
+        return;
+    }
+    // 权限检查
+    if (!tool.isReadOnly?.()) {
+        // 在权限检查前，先检查是否已经被中断
+        // 如果已经中断，说明是因为前面的工具被拒绝/取消，后续工具应该返回 CANCEL_MESSAGE
+        if (abortController.signal.aborted) {
+            yield (0, message_1.createUserMessage)([
+                (0, message_1.createToolResultStopMessage)(toolUseID),
+            ]);
+            return;
+        }
+        const permissionResult = await (0, PermissionManager_1.hasPermissionsToUseTool)(tool, input, abortController, assistantMessage, agentContext.agentId);
+        if (!permissionResult.result) {
+            // 权限被拒绝，返回拒绝消息
+            // 注意：这里的 permissionResult.message 可能是 REJECT_MESSAGE 或 CANCEL_MESSAGE
+            // 取决于 PermissionManager 中的处理逻辑
+            yield (0, message_1.createUserMessage)([
+                {
+                    type: 'tool_result',
+                    content: permissionResult.message,
+                    is_error: true,
+                    tool_use_id: toolUseID,
+                },
+            ]);
+            return;
+        }
+    }
+    // 调用工具
+    try {
+        // 直接执行工具调用，传递 agentContext
+        const generator = tool.call(input, agentContext);
+        for await (const result of generator) {
+            switch (result.type) {
+                case 'result':
+                    if (tool.genToolResultMessage) {
+                        const toolResult = tool.genToolResultMessage(result.data, input);
+                        const toolCompleteData = {
+                            agentId: agentContext.agentId,
+                            toolName: tool.name,
+                            title: toolResult.title,
+                            summary: toolResult.summary,
+                            content: toolResult.content,
+                        };
+                        (0, EventSystem_1.getEventBus)().emit('tool:execution:complete', toolCompleteData);
+                    }
+                    // 提取控制信号（如果存在）
+                    const controlSignal = result.data?.controlSignal;
+                    // 生成工具结果消息
+                    yield (0, message_1.createUserMessage)([
+                        {
+                            type: 'tool_result',
+                            content: result.resultForAssistant || String(result.data),
+                            tool_use_id: toolUseID,
+                        },
+                    ], {
+                        data: result.data,
+                        resultForAssistant: result.resultForAssistant || String(result.data),
+                    }, controlSignal);
+                    return; // 工具执行完成，返回
+            }
+        }
+    }
+    catch (error) {
+        const content = (0, format_1.formatError)(error); // 格式化错误信息
+        (0, log_1.logError)(error); // 记录错误
+        // 发送工具出错事件 但不会阻塞agent继续执行
+        const toolErrorData = {
+            agentId: agentContext.agentId,
+            toolName: tool.name,
+            title: tool.getDisplayTitle?.(input) || tool.name,
+            content: content,
+        };
+        (0, EventSystem_1.getEventBus)().emit('tool:execution:error', toolErrorData);
+        // 返回工具执行错误消息
+        yield (0, message_1.createUserMessage)([
+            {
+                type: 'tool_result',
+                content,
+                is_error: true,
+                tool_use_id: toolUseID,
+            },
+        ]);
+    }
+}
+//# sourceMappingURL=RunTools.js.map

package/dist/core/RunTools.js.map

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

package/dist/core/SemaCore.d.ts

@@ -0,0 +1,49 @@
+import { SemaCoreConfig, ModelConfig, TaskConfig, FetchModelsParams, FetchModelsResult, ApiTestParams, ApiTestResult, ModelUpdateData, UpdatableCoreConfigKeys, UpdatableCoreConfig } from '../types';
+import { ToolInfo } from '../types/index';
+import { MCPServerConfig, MCPScopeType, MCPServerInfo } from '../types/mcp';
+import { SkillInfo } from '../types/skill';
+import { AgentInfo, AgentConfig } from '../types/agent';
+import { ToolPermissionResponse, AskQuestionResponseData, PlanExitResponseData } from '../events/types';
+import { CustomCommand } from '../types/command';
+/**
+ * Sema 核心 API 类
+ * 提供简洁的公共接口，内部委托给 SemaEngine 处理业务逻辑
+ */
+export declare class SemaCore {
+    private readonly engine;
+    private configPromise;
+    constructor(config?: SemaCoreConfig);
+    on: <T>(event: string, listener: (data: T) => void) => this;
+    once: <T>(event: string, listener: (data: T) => void) => this;
+    off: <T>(event: string, listener: (data: T) => void) => this;
+    respondToToolPermission: (response: ToolPermissionResponse) => boolean;
+    respondToAskQuestion: (response: AskQuestionResponseData) => boolean;
+    respondToPlanExit: (response: PlanExitResponseData) => boolean;
+    createSession: (sessionId?: string) => Promise<void>;
+    processUserInput: (input: string, originalInput?: string) => void;
+    interruptSession: () => void;
+    addModel: (config: ModelConfig, skipValidation?: boolean) => Promise<ModelUpdateData>;
+    delModel: (ModelName: string) => Promise<ModelUpdateData>;
+    switchModel: (ModelName: string) => Promise<ModelUpdateData>;
+    applyTaskModel: (config: TaskConfig) => Promise<ModelUpdateData>;
+    getModelData: () => Promise<ModelUpdateData>;
+    updateCoreConfByKey: <K extends UpdatableCoreConfigKeys>(key: K, value: SemaCoreConfig[K]) => void;
+    updateCoreConfig: (config: UpdatableCoreConfig) => void;
+    updateUseTools: (toolNames: string[] | null) => void;
+    updateAgentMode: (mode: "Agent" | "Plan") => void;
+    getToolInfos: () => ToolInfo[];
+    fetchAvailableModels: (params: FetchModelsParams) => Promise<FetchModelsResult>;
+    testApiConnection: (params: ApiTestParams) => Promise<ApiTestResult>;
+    addOrUpdateMCPServer: (config: MCPServerConfig, scope: MCPScopeType) => Promise<MCPServerInfo>;
+    removeMCPServer: (name: string, scope: MCPScopeType) => Promise<boolean>;
+    getMCPServerConfigs: () => Map<MCPScopeType, MCPServerInfo[]>;
+    connectMCPServer: (name: string) => Promise<MCPServerInfo>;
+    updateMCPUseTools: (name: string, toolNames: string[] | null) => boolean;
+    getSkillsInfo: () => SkillInfo[];
+    getAgentsInfo: () => AgentInfo[];
+    addAgentConf: (agentConf: AgentConfig) => Promise<boolean>;
+    getCustomCommands: () => Promise<CustomCommand[]>;
+    reloadCustomCommands: () => void;
+    dispose: () => Promise<void>;
+}
+//# sourceMappingURL=SemaCore.d.ts.map

package/dist/core/SemaCore.d.ts.map

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

package/dist/core/SemaCore.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SemaCore = void 0;
+const apiUtil_1 = require("../services/api/apiUtil");
+const MCPManager_1 = require("../services/mcp/MCPManager");
+const skillRegistry_1 = require("../services/skill/skillRegistry");
+const agentsManager_1 = require("../services/agents/agentsManager");
+const customCommands_1 = require("../services/plugins/customCommands");
+const SemaEngine_1 = require("./SemaEngine");
+const ConfManager_1 = require("../manager/ConfManager");
+const ModelManager_1 = require("../manager/ModelManager");
+const tools_1 = require("../tools/base/tools");
+const log_1 = require("../util/log");
+/**
+ * Sema 核心 API 类
+ * 提供简洁的公共接口，内部委托给 SemaEngine 处理业务逻辑
+ */
+class SemaCore {
+    constructor(config) {
+        this.configPromise = null;
+        // ==================== 事件接口 ====================
+        // 监听事件接口 - 暴露所有监听能力
+        this.on = (event, listener) => (this.engine.on(event, listener), this);
+        this.once = (event, listener) => (this.engine.once(event, listener), this);
+        this.off = (event, listener) => (this.engine.off(event, listener), this);
+        // 权限响应接口 - 只暴露必要的发送能力
+        this.respondToToolPermission = (response) => this.engine.emit('tool:permission:response', response);
+        this.respondToAskQuestion = (response) => this.engine.emit('ask:question:response', response);
+        this.respondToPlanExit = (response) => this.engine.emit('plan:exit:response', response);
+        // ==================== 会话 ====================
+        // 异步操作，通过事件通知结果
+        this.createSession = async (sessionId) => {
+            // 等待配置设置完成
+            if (this.configPromise) {
+                await this.configPromise;
+                this.configPromise = null;
+            }
+            return this.engine.createSession(sessionId);
+        };
+        this.processUserInput = (input, originalInput) => this.engine.processUserInput(input, originalInput);
+        // ==================== 中断 ====================
+        // 同步操作，立即执行
+        this.interruptSession = () => this.engine.interruptSession();
+        // ==================== 模型管理 ====================
+        // 异步操作，返回结果并通过 model:update 事件通知
+        this.addModel = (config, skipValidation) => (0, ModelManager_1.getModelManager)().addNewModel(config, skipValidation);
+        this.delModel = (ModelName) => (0, ModelManager_1.getModelManager)().deleteModel(ModelName);
+        this.switchModel = (ModelName) => (0, ModelManager_1.getModelManager)().switchCurrentModel(ModelName);
+        this.applyTaskModel = (config) => (0, ModelManager_1.getModelManager)().applyTaskModelConfig(config);
+        this.getModelData = () => (0, ModelManager_1.getModelManager)().getModelData();
+        // ==================== 配置管理 ====================
+        // 更新核心配置
+        this.updateCoreConfByKey = (key, value) => (0, ConfManager_1.getConfManager)().updateCoreConfByKey(key, value);
+        this.updateCoreConfig = (config) => (0, ConfManager_1.getConfManager)().updateCoreConfig(config);
+        this.updateUseTools = (toolNames) => (0, ConfManager_1.getConfManager)().updateUseTools(toolNames);
+        this.updateAgentMode = (mode) => this.engine.updateAgentMode(mode);
+        this.getToolInfos = () => (0, tools_1.getToolInfos)();
+        // ==================== 工具API ====================
+        // 独立的工具函数，不依赖会话状态
+        this.fetchAvailableModels = (params) => (0, apiUtil_1.fetchModels)(params);
+        this.testApiConnection = (params) => (0, apiUtil_1.testApiConnection)(params);
+        // ==================== MCP 管理 ====================
+        this.addOrUpdateMCPServer = (config, scope) => (0, MCPManager_1.getMCPManager)().addOrUpdateServer(config, scope);
+        this.removeMCPServer = (name, scope) => (0, MCPManager_1.getMCPManager)().removeServer(name, scope);
+        this.getMCPServerConfigs = () => (0, MCPManager_1.getMCPManager)().getMCPServerConfigs();
+        this.connectMCPServer = (name) => (0, MCPManager_1.getMCPManager)().connectMCPServer(name);
+        this.updateMCPUseTools = (name, toolNames) => (0, MCPManager_1.getMCPManager)().updateMCPUseTools(name, toolNames);
+        // ==================== Skill 管理 ====================
+        this.getSkillsInfo = () => (0, skillRegistry_1.getSkillsInfo)();
+        // ==================== Agents 管理 ====================
+        // getAgentsConfs = (): AgentConfig[] => getAgentsConfs();
+        this.getAgentsInfo = () => (0, agentsManager_1.getAgentsInfo)();
+        this.addAgentConf = (agentConf) => (0, agentsManager_1.addAgentConf)(agentConf);
+        // ==================== Custom Commands 管理 ====================
+        this.getCustomCommands = () => (0, customCommands_1.getCachedCustomCommands)();
+        this.reloadCustomCommands = () => (0, customCommands_1.reloadCustomCommands)();
+        // ==================== 资源管理 ====================
+        // 清理所有资源并停止 Sema 核心服务
+        this.dispose = async () => {
+            await (0, MCPManager_1.getMCPManager)().dispose();
+            this.engine.dispose();
+        };
+        this.configPromise = (0, ConfManager_1.getConfManager)().setCoreConfig(config || {});
+        this.engine = new SemaEngine_1.SemaEngine();
+        this.configPromise = this.configPromise.then(async () => {
+            await Promise.all([
+                (0, MCPManager_1.initMCPManager)()
+            ]);
+        });
+        (0, log_1.logInfo)(`初始化SemaCore: ${JSON.stringify(config, null, 2)}`);
+    }
+}
+exports.SemaCore = SemaCore;
+//# sourceMappingURL=SemaCore.js.map

package/dist/core/SemaCore.js.map

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

package/dist/core/SemaEngine.d.ts

@@ -0,0 +1,54 @@
+import { EventBus } from '../events/EventSystem';
+/**
+ * Sema 引擎 - 处理核心业务逻辑
+ */
+export declare class SemaEngine {
+    private eventBus;
+    emit: <T>(event: string, data: T) => boolean;
+    on: <T>(event: string, listener: (data: T) => void) => EventBus;
+    once: <T>(event: string, listener: (data: T) => void) => EventBus;
+    off: <T>(event: string, listener: (data: T) => void) => EventBus;
+    /**
+     * 创建会话
+     */
+    createSession(sessionId?: string): Promise<void>;
+    /**
+     * 处理用户输入
+     */
+    processUserInput(input: string, originalInput?: string): void;
+    /**
+     * 处理查询逻辑
+     */
+    private processQuery;
+    /**
+     * 构建 additionalReminders：文件引用、首次查询、Plan 模式信息
+     */
+    private buildAdditionalReminders;
+    /**
+     * 中止当前正在进行的请求（仅处理 AbortController）
+     * 不更新状态，用于内部调用
+     */
+    private abortCurrentRequest;
+    /**
+     * 中断当前会话并更新状态为 idle
+     */
+    interruptSession(): void;
+    /**
+     * 更新 Agent 模式
+     */
+    updateAgentMode(mode: 'Agent' | 'Plan'): void;
+    /**
+     * 后台异步检测话题，不阻塞主流程
+     */
+    private detectTopicInBackground;
+    /**
+     * 初始化 Skill 注册表 & 加载自定义命令，不阻塞会话创建
+     */
+    private initializePlugins;
+    private initialize;
+    /**
+     * 清理资源和停止所有活动
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=SemaEngine.d.ts.map

package/dist/core/SemaEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SemaEngine.d.ts","sourceRoot":"","sources":["../../src/core/SemaEngine.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAajD;;GAEG;AACH,qBAAa,UAAU;IAErB,OAAO,CAAC,QAAQ,CAA0B;IAC1C,IAAI,GAAI,CAAC,EAAE,OAAO,MAAM,EAAE,MAAM,CAAC,aAA4D;IAC7F,EAAE,GAAI,CAAC,EAAE,OAAO,MAAM,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,cAAuC;IAC1F,IAAI,GAAI,CAAC,EAAE,OAAO,MAAM,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,cAAyC;IAC9F,GAAG,GAAI,CAAC,EAAE,OAAO,MAAM,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,cAAwC;IAE5F;;OAEG;IACG,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkDtD;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI;IAqC7D;;OAEG;YACW,YAAY;IAiF1B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA8BhC;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAU3B;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAMxB;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IAgB7C;;OAEG;YACW,uBAAuB;IA6BrC;;OAEG;YACW,iBAAiB;YAqBjB,UAAU;IAwCxB;;OAEG;IACH,OAAO,IAAI,IAAI;CAehB"}