@cicctencent/agent-server 0.2.13 → 0.2.15

package/dist/esm/service/model-config-resolver.d.ts

@@ -0,0 +1,108 @@
+/**
+ * @file DefaultModelConfigResolver — 模型配置解析器默认实现
+ * @description 将 resolveModelConfig/createProviderFromModelConfig 模式下沉到 agent-server，
+ *              供 work_agent 和 omniinsight-bi 等上层应用复用。
+ */
+import type { LLMProvider } from '@cicctencent/agent-core';
+import type { SettingsProvider, ModelProviderConfig, TenantContext } from '../types.js';
+/**
+ * 模型配置解析器默认实现
+ *
+ * 提供统一的模型配置解析和 LLMProvider 创建逻辑：
+ * - resolve(): 根据 modelConfigId 查找对应的 ModelProviderConfig
+ * - createProvider(): 根据 modelConfigId 创建 LLMProvider 实例
+ * - resolveForRole(): 角色分层调度（role_based 策略）
+ * - resolveForScene(): 场景分层调度（如 memory_extraction）
+ * - createFallbackProvider(): 创建降级 Provider
+ *
+ * 上层应用可直接使用此实现，或实现自定义 ModelConfigResolver SPI。
+ */
+export declare class DefaultModelConfigResolver {
+    private settingsProvider;
+    private defaultTenant?;
+    constructor(settingsProvider: SettingsProvider, defaultTenant?: TenantContext);
+    /**
+     * 获取设置（带默认租户）
+     */
+    private getSettings;
+    /**
+     * 解析模型配置
+     *
+     * 解析顺序：
+     * 1. 指定了 modelConfigId → 精确查找
+     * 2. 使用 defaultModelId → 查找默认配置
+     * 3. 从 modelProviders 中找第一个可用的
+     * 4. 回退到全局 apiKeys 设置
+     *
+     * @param modelConfigId 模型配置 ID（可选）
+     * @param tenant 租户上下文（可选）
+     * @returns ModelProviderConfig
+     */
+    resolve(modelConfigId?: string, tenant?: TenantContext): ModelProviderConfig;
+    /**
+     * 根据 modelConfigId 创建 LLMProvider 实例
+     *
+     * 封装 resolve + createLLMProvider 的重复调用模式，
+     * 同时处理代理配置和模型覆盖。
+     *
+     * @param modelConfigId 模型配置 ID（可选）
+     * @param modelOverride 模型名称覆盖（可选，用于 profile.model 覆盖）
+     * @param tenant 租户上下文（可选）
+     * @returns LLMProvider 实例
+     */
+    createProvider(modelConfigId?: string, modelOverride?: string, tenant?: TenantContext): LLMProvider;
+    /**
+     * 根据工作流角色解析对应的 modelConfigId（模型分层调度）
+     *
+     * 当 modelTierStrategy === 'role_based' 时，按角色查找对应的 modelConfigId；
+     * 否则返回 undefined（走默认主流程）。
+     *
+     * @param role WorkflowRole 或场景 key
+     * @param tenant 租户上下文（可选）
+     * @returns modelConfigId，未配置则返回 undefined
+     */
+    resolveForRole(role?: string, tenant?: TenantContext): string | undefined;
+    /**
+     * 根据场景 key 解析对应的 modelConfigId（场景模型分层调度）
+     *
+     * 与 resolveForRole 不同，本方法不依赖 modelTierStrategy === 'role_based'，
+     * 只要 modelTiers 中配置了对应场景 key 即生效。
+     *
+     * 用于记忆提取管道等非主对话场景的独立模型配置。
+     *
+     * @param scene 场景 key（如 'memory_extraction', 'scene_aggregation'）
+     * @param tenant 租户上下文（可选）
+     * @returns modelConfigId，未配置则返回 undefined（走默认主流程）
+     */
+    resolveForScene(scene: string, tenant?: TenantContext): string | undefined;
+    /**
+     * 根据 modelConfigId 创建降级 LLM Provider
+     *
+     * @param modelConfigId 模型配置 ID
+     * @param tenant 租户上下文（可选）
+     * @returns LLMProvider 实例，无有效配置时返回 undefined
+     */
+    createFallbackProvider(modelConfigId: string, tenant?: TenantContext): LLMProvider | undefined;
+    /**
+     * 获取降级模型配置 ID（从 agentConfig.fallbackProvider）
+     *
+     * @param tenant 租户上下文（可选）
+     * @returns fallbackProvider modelConfigId，未配置则返回 undefined
+     */
+    getFallbackModelConfigId(tenant?: TenantContext): string | undefined;
+    /**
+     * 检查 Agent 系统是否可用（API Key 已配置）
+     *
+     * @param tenant 租户上下文（可选）
+     * @returns 是否可用
+     */
+    isAvailable(tenant?: TenantContext): boolean;
+    /**
+     * 获取 Agent 不可用的具体原因
+     *
+     * @param tenant 租户上下文（可选）
+     * @returns 不可用原因描述
+     */
+    getUnavailableReason(tenant?: TenantContext): string;
+}
+//# sourceMappingURL=model-config-resolver.d.ts.map

package/dist/esm/service/model-config-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-config-resolver.d.ts","sourceRoot":"","sources":["../../../src/service/model-config-resolver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAuB,MAAM,yBAAyB,CAAC;AAChF,OAAO,KAAK,EAAE,gBAAgB,EAAkB,mBAAmB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAExG;;;;;;;;;;;GAWG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,aAAa,CAAC,CAAgB;gBAE1B,gBAAgB,EAAE,gBAAgB,EAAE,aAAa,CAAC,EAAE,aAAa;IAK7E;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,mBAAmB;IAmC5E;;;;;;;;;;OAUG;IACH,cAAc,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,WAAW;IAoBnG;;;;;;;;;OASG;IACH,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS;IAmBzE;;;;;;;;;;;OAWG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS;IAO1E;;;;;;OAMG;IACH,sBAAsB,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,WAAW,GAAG,SAAS;IAM9F;;;;;OAKG;IACH,wBAAwB,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS;IAKpE;;;;;OAKG;IACH,WAAW,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO;IAkB5C;;;;;OAKG;IACH,oBAAoB,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,MAAM;CA0BrD"}

package/dist/esm/service/model-config-resolver.js

@@ -0,0 +1,227 @@
+/**
+ * @file DefaultModelConfigResolver — 模型配置解析器默认实现
+ * @description 将 resolveModelConfig/createProviderFromModelConfig 模式下沉到 agent-server，
+ *              供 work_agent 和 omniinsight-bi 等上层应用复用。
+ */
+import { createLLMProvider, resolveProxyAgentForCategory } from '@cicctencent/agent-core';
+/**
+ * 模型配置解析器默认实现
+ *
+ * 提供统一的模型配置解析和 LLMProvider 创建逻辑：
+ * - resolve(): 根据 modelConfigId 查找对应的 ModelProviderConfig
+ * - createProvider(): 根据 modelConfigId 创建 LLMProvider 实例
+ * - resolveForRole(): 角色分层调度（role_based 策略）
+ * - resolveForScene(): 场景分层调度（如 memory_extraction）
+ * - createFallbackProvider(): 创建降级 Provider
+ *
+ * 上层应用可直接使用此实现，或实现自定义 ModelConfigResolver SPI。
+ */
+export class DefaultModelConfigResolver {
+    settingsProvider;
+    defaultTenant;
+    constructor(settingsProvider, defaultTenant) {
+        this.settingsProvider = settingsProvider;
+        this.defaultTenant = defaultTenant;
+    }
+    /**
+     * 获取设置（带默认租户）
+     */
+    getSettings(tenant) {
+        return this.settingsProvider.getSettings(tenant ?? this.defaultTenant);
+    }
+    /**
+     * 解析模型配置
+     *
+     * 解析顺序：
+     * 1. 指定了 modelConfigId → 精确查找
+     * 2. 使用 defaultModelId → 查找默认配置
+     * 3. 从 modelProviders 中找第一个可用的
+     * 4. 回退到全局 apiKeys 设置
+     *
+     * @param modelConfigId 模型配置 ID（可选）
+     * @param tenant 租户上下文（可选）
+     * @returns ModelProviderConfig
+     */
+    resolve(modelConfigId, tenant) {
+        const s = this.getSettings(tenant);
+        // 指定了具体 modelConfigId，精确查找
+        if (modelConfigId && s.modelProviders) {
+            const found = s.modelProviders.find(mp => mp.id === modelConfigId);
+            if (found)
+                return found;
+        }
+        // 使用 defaultModelId 查找
+        if (s.defaultModelId && s.modelProviders) {
+            const found = s.modelProviders.find(mp => mp.id === s.defaultModelId);
+            if (found)
+                return found;
+        }
+        // 默认模型：从 modelProviders 中找一个可用的
+        if (s.modelProviders && s.modelProviders.length > 0) {
+            const available = s.modelProviders.find(mp => mp.apiKey || mp.provider === 'ollama') || s.modelProviders[0];
+            return available;
+        }
+        // 回退到全局设置
+        const providerName = s.apiKeys?.provider || 'openai';
+        return {
+            id: '__global__',
+            name: '全局设置',
+            provider: providerName,
+            model: s.apiKeys?.customModel || process.env.LLM_MODEL || (providerName === 'anthropic' ? 'claude-sonnet-4-20250514' : 'gpt-4'),
+            apiKey: providerName === 'anthropic'
+                ? (s.apiKeys?.anthropic || process.env.ANTHROPIC_API_KEY || '')
+                : (s.apiKeys?.openai || process.env.OPENAI_API_KEY || ''),
+            baseUrl: s.apiKeys?.customEndpoint || process.env.OPENAI_BASE_URL || undefined,
+        };
+    }
+    /**
+     * 根据 modelConfigId 创建 LLMProvider 实例
+     *
+     * 封装 resolve + createLLMProvider 的重复调用模式，
+     * 同时处理代理配置和模型覆盖。
+     *
+     * @param modelConfigId 模型配置 ID（可选）
+     * @param modelOverride 模型名称覆盖（可选，用于 profile.model 覆盖）
+     * @param tenant 租户上下文（可选）
+     * @returns LLMProvider 实例
+     */
+    createProvider(modelConfigId, modelOverride, tenant) {
+        const s = this.getSettings(tenant);
+        const modelConfig = this.resolve(modelConfigId, tenant);
+        // 解析 LLM 代理配置
+        const llmProxy = resolveProxyAgentForCategory(s.proxySettings?.llm, 'LLM');
+        return createLLMProvider({
+            provider: modelConfig.provider,
+            model: modelOverride || modelConfig.model,
+            name: modelConfig.name || `${modelConfig.provider} / ${modelConfig.model}`,
+            apiKey: modelConfig.apiKey,
+            baseUrl: modelConfig.baseUrl,
+            temperature: modelConfig.temperature,
+            maxTokens: modelConfig.maxTokens,
+            timeout: modelConfig.timeout,
+            proxy: llmProxy,
+        });
+    }
+    /**
+     * 根据工作流角色解析对应的 modelConfigId（模型分层调度）
+     *
+     * 当 modelTierStrategy === 'role_based' 时，按角色查找对应的 modelConfigId；
+     * 否则返回 undefined（走默认主流程）。
+     *
+     * @param role WorkflowRole 或场景 key
+     * @param tenant 租户上下文（可选）
+     * @returns modelConfigId，未配置则返回 undefined
+     */
+    resolveForRole(role, tenant) {
+        const s = this.getSettings(tenant);
+        const strategy = s.agentConfig?.modelTierStrategy;
+        if (strategy !== 'role_based' || !role)
+            return undefined;
+        const tiers = s.agentConfig?.modelTiers;
+        if (!tiers)
+            return undefined;
+        // 精确匹配角色
+        if (tiers[role])
+            return tiers[role];
+        // 分组映射：bull/bear 归为 researcher 层
+        if ((role === 'bull_researcher' || role === 'bear_researcher') && tiers['researcher']) {
+            return tiers['researcher'];
+        }
+        return undefined;
+    }
+    /**
+     * 根据场景 key 解析对应的 modelConfigId（场景模型分层调度）
+     *
+     * 与 resolveForRole 不同，本方法不依赖 modelTierStrategy === 'role_based'，
+     * 只要 modelTiers 中配置了对应场景 key 即生效。
+     *
+     * 用于记忆提取管道等非主对话场景的独立模型配置。
+     *
+     * @param scene 场景 key（如 'memory_extraction', 'scene_aggregation'）
+     * @param tenant 租户上下文（可选）
+     * @returns modelConfigId，未配置则返回 undefined（走默认主流程）
+     */
+    resolveForScene(scene, tenant) {
+        const s = this.getSettings(tenant);
+        const tiers = s.agentConfig?.modelTiers;
+        if (!tiers)
+            return undefined;
+        return tiers[scene] || undefined;
+    }
+    /**
+     * 根据 modelConfigId 创建降级 LLM Provider
+     *
+     * @param modelConfigId 模型配置 ID
+     * @param tenant 租户上下文（可选）
+     * @returns LLMProvider 实例，无有效配置时返回 undefined
+     */
+    createFallbackProvider(modelConfigId, tenant) {
+        const modelConfig = this.resolve(modelConfigId, tenant);
+        if (!modelConfig.provider || !modelConfig.apiKey)
+            return undefined;
+        return this.createProvider(modelConfigId, undefined, tenant);
+    }
+    /**
+     * 获取降级模型配置 ID（从 agentConfig.fallbackProvider）
+     *
+     * @param tenant 租户上下文（可选）
+     * @returns fallbackProvider modelConfigId，未配置则返回 undefined
+     */
+    getFallbackModelConfigId(tenant) {
+        const s = this.getSettings(tenant);
+        return s.agentConfig?.fallbackProvider;
+    }
+    /**
+     * 检查 Agent 系统是否可用（API Key 已配置）
+     *
+     * @param tenant 租户上下文（可选）
+     * @returns 是否可用
+     */
+    isAvailable(tenant) {
+        const s = this.getSettings(tenant);
+        const modelConfig = this.resolve(undefined, tenant);
+        const provider = modelConfig.provider || 'openai';
+        // Ollama 本地服务始终可用
+        if (provider === 'ollama')
+            return true;
+        // 优先使用解析后的 modelConfig.apiKey（已涵盖 modelProviders 配置）
+        if (modelConfig.apiKey)
+            return true;
+        // 回退检查全局 apiKeys
+        if (provider === 'anthropic') {
+            return !!(s.apiKeys?.anthropic || process.env.ANTHROPIC_API_KEY);
+        }
+        return !!(s.apiKeys?.openai || process.env.OPENAI_API_KEY);
+    }
+    /**
+     * 获取 Agent 不可用的具体原因
+     *
+     * @param tenant 租户上下文（可选）
+     * @returns 不可用原因描述
+     */
+    getUnavailableReason(tenant) {
+        const s = this.getSettings(tenant);
+        const modelConfig = this.resolve(undefined, tenant);
+        const provider = modelConfig.provider || 'openai';
+        if (provider === 'ollama') {
+            const endpoint = modelConfig.baseUrl || s.apiKeys?.customEndpoint || 'http://localhost:11434';
+            return `Ollama 服务不可用，请确认 Ollama 已启动并监听 ${endpoint}`;
+        }
+        if (provider === 'anthropic') {
+            const hasKey = !!(modelConfig.apiKey || s.apiKeys?.anthropic || process.env.ANTHROPIC_API_KEY);
+            if (!hasKey) {
+                return `当前供应商为 Anthropic，但未配置 API Key。请在「设置」页面填写 Anthropic API Key，或设置环境变量 ANTHROPIC_API_KEY`;
+            }
+        }
+        else {
+            // openai 或兼容供应商
+            const hasKey = !!(modelConfig.apiKey || s.apiKeys?.openai || process.env.OPENAI_API_KEY);
+            if (!hasKey) {
+                const providerLabel = provider === 'openai' ? 'OpenAI' : provider;
+                return `当前供应商为 ${providerLabel}，但未配置 API Key。请在「设置」页面填写 API Key，或设置环境变量 OPENAI_API_KEY`;
+            }
+        }
+        return 'AI 服务不可用，请检查设置中的供应商和 API Key 配置';
+    }
+}
+//# sourceMappingURL=model-config-resolver.js.map

package/dist/esm/service/model-config-resolver.js.map

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

package/dist/esm/tool/tools/automation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"automation.d.ts","sourceRoot":"","sources":["../../../../src/tool/tools/automation.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,wBAAgB,qBAAqB,IAAI,cAAc,EAAE,CAyJxD"}
+{"version":3,"file":"automation.d.ts","sourceRoot":"","sources":["../../../../src/tool/tools/automation.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAI9D,wBAAgB,qBAAqB,IAAI,cAAc,EAAE,CAsJxD"}

package/dist/esm/tool/tools/automation.js

@@ -1,6 +1,7 @@
 // ============================================================
 // 自动化任务工具：create_automation, list_automations, delete_automation
 // ============================================================
+import { getAutomationStore } from "../../store/app-stores.js";
 export function createAutomationTools() {
     return [
         // ---- create_automation ----
@@ -27,18 +28,13 @@ export function createAutomationTools() {
                     },
                 },
             },
-            executor: async (args) => {
+            executor: async (args, ctx) => {
                 try {
                     const cron = await import('node-cron');
                     const schedule = args.schedule;
                     if (!cron.validate(schedule)) {
                         return `ERROR: Invalid cron expression "${schedule}". Use 5-field format: min hour day month weekday.\nExamples: "0 9 * * *" (daily 9AM), "0 9 * * 1" (Monday 9AM), "*/30 * * * *" (every 30min)`;
                     }
-                    // @ts-ignore — application-layer module
-                    const { getAutomationStore } = await import("../../store/automation-store.js");
-                    // @ts-ignore — application-layer module
-                    // @ts-ignore — application-layer module
-                    const { refreshScheduler } = await import("../../service/automation.service.js");
                     const store = getAutomationStore();
                     const item = store.create({
                         name: args.name,
@@ -48,7 +44,11 @@ export function createAutomationTools() {
                         enabled: args.enabled !== false,
                         lastStatus: 'idle',
                     });
-                    refreshScheduler();
+                    // 通过 SPI Provider 刷新调度器
+                    const automationProvider = ctx.custom?.automationProvider;
+                    if (automationProvider?.refreshScheduler) {
+                        automationProvider.refreshScheduler();
+                    }
                     return `Automation created successfully!\n  Name: ${item.name}\n  Schedule: ${schedule}\n  ID: ${item.id}\n  Enabled: ${item.enabled}\n\nThe task will trigger automatically according to the schedule.`;
                 }
                 catch (e) {
@@ -77,8 +77,6 @@ export function createAutomationTools() {
             },
             executor: async (args) => {
                 try {
-                    // @ts-ignore — application-layer module
-                    const { getAutomationStore } = await import("../../store/automation-store.js");
                     const store = getAutomationStore();
                     let items = store.list();
                     if (args.enabledOnly) {
@@ -125,21 +123,20 @@ export function createAutomationTools() {
                     },
                 },
             },
-            executor: async (args) => {
+            executor: async (args, ctx) => {
                 try {
                     const id = args.id;
-                    // @ts-ignore — application-layer module
-                    const { getAutomationStore } = await import("../../store/automation-store.js");
-                    // @ts-ignore — application-layer module
-                    // @ts-ignore — application-layer module
-                    const { refreshScheduler } = await import("../../service/automation.service.js");
                     const store = getAutomationStore();
                     const existing = store.findById(id);
                     if (!existing) {
                         return `ERROR: Automation task with ID ${id} not found.`;
                     }
                     store.remove(id);
-                    refreshScheduler();
+                    // 通过 SPI Provider 刷新调度器
+                    const automationProvider = ctx.custom?.automationProvider;
+                    if (automationProvider?.refreshScheduler) {
+                        automationProvider.refreshScheduler();
+                    }
                     return `Automation task "${existing.name}" (ID: ${id}) has been deleted successfully.`;
                 }
                 catch (e) {

package/dist/esm/tool/tools/automation.js.map

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

package/dist/esm/tool/tools/communication.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"communication.d.ts","sourceRoot":"","sources":["../../../../src/tool/tools/communication.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAW,MAAM,yBAAyB,CAAC;AAEvE,wBAAgB,wBAAwB,IAAI,cAAc,EAAE,CAwQ3D"}
+{"version":3,"file":"communication.d.ts","sourceRoot":"","sources":["../../../../src/tool/tools/communication.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAW,MAAM,yBAAyB,CAAC;AAOvE,wBAAgB,wBAAwB,IAAI,cAAc,EAAE,CAsQ3D"}

package/dist/esm/tool/tools/communication.js

@@ -1,6 +1,10 @@
 // ============================================================
 // 通信工具：send_email, create_event, list_events
 // ============================================================
+import { resolveArtifactPath } from "../../service/artifact.service.js";
+import { getProjectDataPath } from "../../utils/data-dir.js";
+import * as fs from 'fs';
+import * as path from 'path';
 export function createCommunicationTools() {
     return [
         // ---- send_email ----
@@ -40,12 +44,12 @@ export function createCommunicationTools() {
                 },
             },
             executor: async (args, ctx) => {
-                // @ts-ignore — application-layer module
-                const { getEmailProvider } = await import("../../email/smtp-provider.js");
-                const fs = await import('fs');
-                const path = await import('path');
+                // 从 ToolContext 获取 EmailProvider SPI
+                const emailProvider = ctx.custom?.emailProvider;
+                if (!emailProvider) {
+                    return 'ERROR: Email provider not configured. Please add an email connector in the Connectors page.';
+                }
                 try {
-                    const provider = await getEmailProvider();
                     // 处理附件：支持本地文件路径、artifact URL、沙箱内相对路径
                     const attachments = [];
                     if (args.attachments && Array.isArray(args.attachments)) {
@@ -58,12 +62,7 @@ export function createCommunicationTools() {
                             const artifactMatch = filePath.match(/\/artifacts\/([^/]+)\/([^/]+)\/(.+)$/);
                             if (artifactMatch) {
                                 const [, sessionId, artifactId, filename] = artifactMatch;
-                                try {
-                                    // @ts-ignore — application-layer module
-                                    const { resolveArtifactPath } = await import("../../service/artifact.service.js");
-                                    resolvedPath = resolveArtifactPath(sessionId, artifactId, decodeURIComponent(filename)) || '';
-                                }
-                                catch { /* ignore */ }
+                                resolvedPath = resolveArtifactPath(sessionId, artifactId, decodeURIComponent(filename)) || '';
                             }
                             // 2. 如果是本地绝对路径且文件存在
                             if (!resolvedPath && path.isAbsolute(filePath) && fs.existsSync(filePath)) {
@@ -88,28 +87,24 @@ export function createCommunicationTools() {
                             }
                             // 5. 尝试从 data/sandboxes 下搜索
                             if (!resolvedPath) {
-                                try {
-                                    const { getProjectDataPath } = await import("../../utils/data-dir.js");
-                                    const sandboxesBase = getProjectDataPath('sandboxes');
-                                    if (fs.existsSync(sandboxesBase)) {
-                                        // 搜索所有沙箱目录下的 artifacts 子目录
-                                        for (const sessionDir of fs.readdirSync(sandboxesBase)) {
-                                            const artifactsDir = path.join(sandboxesBase, sessionDir, '_artifacts');
-                                            if (!fs.existsSync(artifactsDir))
-                                                continue;
-                                            for (const artDir of fs.readdirSync(artifactsDir)) {
-                                                const candidate = path.join(artifactsDir, artDir, path.basename(filePath));
-                                                if (fs.existsSync(candidate)) {
-                                                    resolvedPath = candidate;
-                                                    break;
-                                                }
-                                            }
-                                            if (resolvedPath)
+                                const sandboxesBase = getProjectDataPath('sandboxes');
+                                if (fs.existsSync(sandboxesBase)) {
+                                    // 搜索所有沙箱目录下的 artifacts 子目录
+                                    for (const sessionDir of fs.readdirSync(sandboxesBase)) {
+                                        const artifactsDir = path.join(sandboxesBase, sessionDir, '_artifacts');
+                                        if (!fs.existsSync(artifactsDir))
+                                            continue;
+                                        for (const artDir of fs.readdirSync(artifactsDir)) {
+                                            const candidate = path.join(artifactsDir, artDir, path.basename(filePath));
+                                            if (fs.existsSync(candidate)) {
+                                                resolvedPath = candidate;
                                                 break;
+                                            }
                                         }
+                                        if (resolvedPath)
+                                            break;
                                     }
                                 }
-                                catch { /* ignore */ }
                             }
                             if (!resolvedPath || !fs.existsSync(resolvedPath)) {
                                 return `ERROR: Attachment file not found: ${filePath}. ` +
@@ -128,7 +123,7 @@ export function createCommunicationTools() {
                             attachments.push({ filename, content, contentType });
                         }
                     }
-                    await provider.send({
+                    await emailProvider.send({
                         to: args.to,
                         cc: args.cc,
                         subject: args.subject,
@@ -153,7 +148,7 @@ export function createCommunicationTools() {
                 function: {
                     name: 'create_event',
                     description: 'Create a calendar event with title, start/end time, description, location, and attendees. ' +
-                        'Generates an .ics file as a downloadable artifact. ' +
+                        'May generate an .ics file as a downloadable artifact if the calendar provider supports iCal export. ' +
                         'Optionally sets a reminder (in minutes before start).',
                     parameters: {
                         type: 'object',
@@ -172,13 +167,14 @@ export function createCommunicationTools() {
                 },
             },
             executor: async (args, ctx) => {
-                // @ts-ignore — application-layer module
-                const { getCalendarStore, generateICal } = await import("../../calendar/calendar-service.js");
+                const calendarProvider = ctx.custom?.calendarProvider;
+                if (!calendarProvider) {
+                    return 'ERROR: Calendar provider not configured. Please add a calendar connector in the Connectors page.';
+                }
                 try {
-                    const store = getCalendarStore();
                     const start = args.start;
                     const end = args.end || new Date(new Date(start).getTime() + 3600000).toISOString();
-                    const event = await store.create({
+                    const event = await calendarProvider.create({
                         title: args.title,
                         description: args.description,
                         start, end,
@@ -187,18 +183,21 @@ export function createCommunicationTools() {
                         attendees: args.attendees,
                         reminderMinutes: args.reminderMinutes,
                     });
-                    const icsContent = await generateICal([event]);
-                    const filename = `event_${event.id}.ics`;
-                    const sandbox = ctx.custom?.sandbox;
-                    if (sandbox) {
-                        const fsExec = sandbox.getFileSystemExecutor();
-                        await fsExec.writeFile(filename, icsContent);
-                        const emitArtifact = ctx.emitArtifact;
-                        if (emitArtifact) {
-                            emitArtifact({ artifactId: event.id, filename, mimeType: 'text/calendar', size: icsContent.length, url: `/api/work/files/${filename}`, description: `Calendar event: ${event.title}` });
+                    // 生成 iCal 文件（如果 provider 支持）
+                    if (calendarProvider.generateICal) {
+                        const icsContent = await calendarProvider.generateICal([event]);
+                        const filename = `event_${event.id}.ics`;
+                        const sandbox = ctx.custom?.sandbox;
+                        if (sandbox) {
+                            const fsExec = sandbox.getFileSystemExecutor();
+                            await fsExec.writeFile(filename, icsContent);
+                            const emitArtifact = ctx.emitArtifact;
+                            if (emitArtifact) {
+                                emitArtifact({ artifactId: event.id, filename, mimeType: 'text/calendar', size: icsContent.length, url: `/api/work/files/${filename}`, description: `Calendar event: ${event.title}` });
+                            }
                         }
                     }
-                    return `Event created: "${event.title}" starting ${event.start}.\nICS file: ${filename}\nEvent ID: ${event.id}`;
+                    return `Event created: "${event.title}" starting ${event.start}.\nEvent ID: ${event.id}`;
                 }
                 catch (e) {
                     return `ERROR creating event: ${e.message || e}`;
@@ -225,15 +224,16 @@ export function createCommunicationTools() {
                     },
                 },
             },
-            executor: async (args) => {
-                // @ts-ignore — application-layer module
-                const { getCalendarStore } = await import("../../calendar/calendar-service.js");
+            executor: async (args, ctx) => {
+                const calendarProvider = ctx.custom?.calendarProvider;
+                if (!calendarProvider) {
+                    return 'ERROR: Calendar provider not configured. Please add a calendar connector in the Connectors page.';
+                }
                 try {
-                    const store = getCalendarStore();
                     const now = new Date();
                     const startTime = args.startTime || now.toISOString();
                     const endTime = args.endTime || new Date(now.getTime() + 30 * 86400000).toISOString();
-                    const events = await store.list(startTime, endTime);
+                    const events = await calendarProvider.list(startTime, endTime);
                     if (events.length === 0)
                         return 'No events found in the specified time range.';
                     const lines = events.map((e, i) => {