foliko 1.0.74 → 1.0.76

package/plugins/ambient-agent/GoalManager.js

@@ -0,0 +1,197 @@
+/**
+ * GoalManager - 管理目标及其生命周期状态
+ */
+
+const { logger } = require('../../src/utils/logger')
+const { GoalState } = require('./constants')
+const { generateId } = require('../../src/utils/id')
+
+const log = logger.child('Ambient:GoalManager')
+
+class GoalManager {
+  constructor(stateStore) {
+    this._goals = new Map()
+    this._stateStore = stateStore
+    this._loadGoals()
+  }
+
+  _loadGoals() {
+    const savedGoals = this._stateStore.loadGoals()
+    for (const goal of savedGoals) {
+      this._goals.set(goal.id, goal)
+    }
+  }
+
+  _persist() {
+    const goalsArray = Array.from(this._goals.values())
+    this._stateStore.saveGoals(goalsArray)
+  }
+
+  /**
+   * 创建新目标
+   * @param {Object} goalData - 目标数据
+   * @returns {Object} 创建的目标
+   */
+  createGoal(goalData) {
+    const actions = goalData.actions || []
+    const goal = {
+      id: generateId(),
+      title: goalData.title || '未命名目标',
+      description: goalData.description || '',
+      priority: goalData.priority || 5,
+      state: GoalState.PENDING,
+      actions: actions,
+      _originalActions: actions.slice(),  // 保存原始 actions，用于事件驱动目标重置
+      conditions: goalData.conditions || {},
+      createdAt: new Date(),
+      updatedAt: new Date(),
+      activatedAt: null,
+      completedAt: null,
+      failedAt: null,
+      attempts: 0,
+      maxAttempts: goalData.maxAttempts || 10,
+      consecutiveSameActions: 0,
+      lastActionId: null,
+      eventsReceived: []
+    }
+    this._goals.set(goal.id, goal)
+    this._persist()
+    return goal
+  }
+
+  /**
+   * 获取目标
+   * @param {string} id - 目标ID
+   * @returns {Object|null} 目标对象
+   */
+  getGoal(id) {
+    return this._goals.get(id)
+  }
+
+  /**
+   * 获取所有目标
+   * @returns {Array} 所有目标数组
+   */
+  getAllGoals() {
+    return Array.from(this._goals.values())
+  }
+
+  /**
+   * 获取活跃目标
+   * @returns {Array} 活跃目标数组
+   */
+  getActiveGoals() {
+    return Array.from(this._goals.values()).filter(g => g.state === GoalState.ACTIVE)
+  }
+
+  /**
+   * 获取待处理目标
+   * @returns {Array} 待处理目标数组
+   */
+  getPendingGoals() {
+    return Array.from(this._goals.values()).filter(g => g.state === GoalState.PENDING)
+  }
+
+  /**
+   * 更新目标
+   * @param {string} id - 目标ID
+   * @param {Object} updates - 更新数据
+   * @returns {Object|null} 更新后的目标
+   */
+  updateGoal(id, updates) {
+    const goal = this._goals.get(id)
+    if (!goal) return null
+    Object.assign(goal, updates, { updatedAt: new Date() })
+    this._persist()
+    return goal
+  }
+
+  /**
+   * 激活目标
+   * @param {string} id - 目标ID
+   * @returns {Object|null} 激活后的目标
+   */
+  activateGoal(id) {
+    const goal = this._goals.get(id)
+    if (!goal || goal.state !== GoalState.PENDING) return null
+    goal.state = GoalState.ACTIVE
+    goal.activatedAt = new Date()
+    goal.updatedAt = new Date()
+    this._persist()
+    return goal
+  }
+
+  /**
+   * 标记目标为已完成
+   * @param {string} id - 目标ID
+   * @returns {Object|null} 目标对象
+   */
+  completeGoal(id) {
+    const goal = this._goals.get(id)
+    if (!goal) return null
+    goal.state = GoalState.COMPLETED
+    goal.completedAt = new Date()
+    goal.updatedAt = new Date()
+    this._persist()
+    return goal
+  }
+
+  /**
+   * 标记目标为失败
+   * @param {string} id - 目标ID
+   * @param {string} reason - 失败原因
+   * @returns {Object|null} 目标对象
+   */
+  failGoal(id, reason) {
+    const goal = this._goals.get(id)
+    if (!goal) return null
+    goal.state = GoalState.FAILED
+    goal.failedAt = new Date()
+    goal.failureReason = reason
+    goal.updatedAt = new Date()
+    this._persist()
+    return goal
+  }
+
+  /**
+   * 删除目标
+   * @param {string} id - 目标ID
+   * @returns {boolean} 是否删除成功
+   */
+  deleteGoal(id) {
+    const deleted = this._goals.delete(id)
+    if (deleted) this._persist()
+    return deleted
+  }
+
+  /**
+   * 向目标添加事件（带去重）
+   * @param {string} goalId - 目标ID
+   * @param {Object} event - 事件数据
+   */
+  addEventToGoal(goalId, event) {
+    const goal = this._goals.get(goalId)
+    if (!goal) return
+
+    // 通用去重：如果最近 2 秒内已有相同类型的事件，跳过
+    const now = Date.now()
+    const recentSameEvent = goal.eventsReceived.find(e =>
+      e.event === event.type && (now - new Date(e.timestamp).getTime()) < 2000
+    )
+    if (recentSameEvent) {
+      log.info(`跳过重复事件: ${event.type} (2秒内不重复添加)`)
+      return
+    }
+
+    // event 格式: { type: 'email:received', email: {...}, timestamp: ... }
+    // 需要提取 type 和 data（email 对象）
+    goal.eventsReceived.push({
+      event: event.type,
+      data: event.data || event.email || event,
+      timestamp: new Date()
+    })
+    this._persist()
+  }
+}
+
+module.exports = { GoalManager }

package/plugins/ambient-agent/Reflector.js

@@ -0,0 +1,95 @@
+/**
+ * Reflector - 评估操作结果，更新目标状态
+ */
+
+const { logger } = require('../../src/utils/logger')
+
+const log = logger.child('Ambient:Reflector')
+
+class Reflector {
+  constructor(goalManager) {
+    this._goalManager = goalManager
+  }
+
+  /**
+   * 评估操作结果
+   * @param {Object} goal - 目标对象
+   * @param {Object} actionResult - 操作结果
+   * @returns {Object} 评估结果 { shouldContinue, goalComplete, actionTaken }
+   */
+  evaluateOutcome(goal, actionResult) {
+    if (!goal) return null
+
+    // 检查是否是事件驱动目标
+    const isEventDriven = goal.conditions?.events && goal.conditions.events.length > 0
+
+    // 检查错误
+    if (actionResult && actionResult.error) {
+      // 增加尝试次数但不立即失败
+      goal.attempts++
+      // 事件驱动目标：错误不导致失败或完成
+      if (isEventDriven) {
+        return { shouldContinue: true, goalComplete: false }
+      }
+      return {
+        shouldContinue: goal.attempts < goal.maxAttempts,
+        actionTaken: false
+      }
+    }
+
+    // 检查是否成功完成
+    if (actionResult && actionResult.success === true) {
+      goal.attempts++
+
+      // 事件驱动目标：永远不会完成，持续等待下一事件
+      if (isEventDriven) {
+        return { shouldContinue: true, goalComplete: false }
+      }
+
+      // 检查目标是否完成
+      if (goal.actions.length === 0 || goal.attempts >= goal.maxAttempts) {
+        return { shouldContinue: false, goalComplete: true }
+      }
+
+      return { shouldContinue: true, actionTaken: true }
+    }
+
+    // 工具执行无错误 - 视为成功
+    goal.attempts++
+
+    // 事件驱动目标：永远不会完成
+    if (isEventDriven) {
+      return { shouldContinue: true, goalComplete: false }
+    }
+
+    // 检查目标是否完成（没有更多操作）
+    if (goal.actions.length === 0 || goal.attempts >= goal.maxAttempts) {
+      return { shouldContinue: false, goalComplete: true }
+    }
+
+    return { shouldContinue: true, actionTaken: true }
+  }
+
+  /**
+   * 检查循环检测
+   * @param {Object} goal - 目标对象
+   * @param {string} actionId - 操作ID
+   * @returns {boolean} 是否检测到循环
+   */
+  checkLoopDetection(goal, actionId) {
+    // 如果同一操作连续重复3次，则目标失败
+    if (goal.lastActionId === actionId) {
+      goal.consecutiveSameActions++
+      if (goal.consecutiveSameActions >= 3) {
+        this._goalManager.failGoal(goal.id, '检测到循环：同一操作连续重复3次')
+        return true
+      }
+    } else {
+      goal.consecutiveSameActions = 1
+      goal.lastActionId = actionId
+    }
+    return false
+  }
+}
+
+module.exports = { Reflector }

package/plugins/ambient-agent/StateStore.js

@@ -0,0 +1,90 @@
+/**
+ * StateStore - 持久化目标和记忆到文件系统
+ */
+
+const fs = require('fs')
+const path = require('path')
+const { logger } = require('../../src/utils/logger')
+
+const log = logger.child('Ambient:StateStore')
+
+class StateStore {
+  constructor(persistencePath) {
+    this._persistencePath = persistencePath
+    this._ensureDir()
+  }
+
+  _ensureDir() {
+    if (!fs.existsSync(this._persistencePath)) {
+      fs.mkdirSync(this._persistencePath, { recursive: true })
+    }
+  }
+
+  _getGoalsPath() {
+    return path.join(this._persistencePath, 'goals.json')
+  }
+
+  _getMemoriesPath() {
+    return path.join(this._persistencePath, 'memories.json')
+  }
+
+  /**
+   * 保存目标列表到文件
+   * @param {Array} goals - 目标数组
+   */
+  saveGoals(goals) {
+    try {
+      fs.writeFileSync(this._getGoalsPath(), JSON.stringify(goals, null, 2))
+    } catch (err) {
+      log.error('保存目标失败:', err.message)
+    }
+  }
+
+  /**
+   * 从文件加载目标列表
+   * @returns {Array} 目标数组
+   */
+  loadGoals() {
+    try {
+      const filePath = this._getGoalsPath()
+      if (fs.existsSync(filePath)) {
+        const data = fs.readFileSync(filePath, 'utf-8')
+        return JSON.parse(data)
+      }
+    } catch (err) {
+      log.error('加载目标失败:', err.message)
+    }
+    return []
+  }
+
+  /**
+   * 保存记忆列表到文件
+   * @param {Array} memories - 记忆数组
+   */
+  saveMemories(memories) {
+    try {
+      fs.writeFileSync(this._getMemoriesPath(), JSON.stringify(memories, null, 2))
+    } catch (err) {
+      log.error('保存记忆失败:', err.message)
+    }
+  }
+
+  /**
+   * 从文件加载记忆列表
+   * @returns {Array} 记忆数组
+   */
+  loadMemories() {
+    try {
+      const filePath = this._getMemoriesPath()
+      if (fs.existsSync(filePath)) {
+        const data = fs.readFileSync(filePath, 'utf-8')
+        return JSON.parse(data)
+      }
+    } catch (err) {
+      log.error('加载记忆失败:', err.message)
+    }
+    return []
+  }
+}
+
+module.exports = { StateStore }

package/plugins/ambient-agent/constants.js

@@ -0,0 +1,101 @@
+/**
+ * Ambient Agent 常量定义
+ */
+
+// 目标生命周期状态
+const GoalState = {
+  PENDING: 'pending',      // 待激活
+  ACTIVE: 'active',        // 执行中
+  COMPLETED: 'completed',   // 已完成
+  FAILED: 'failed'         // 已失败
+}
+
+// 事件描述（用于生成插件描述）
+const EventDescriptions = {
+  'tool:result': '工具执行结果事件 - 参数: name(工具名), args(执行参数), result(执行结果), error(错误信息)',
+  'scheduler:reminder': '定时提醒事件 - 参数: taskId(任务ID), message(提醒消息), time(触发时间)',
+  'scheduler:task_completed': '任务完成事件 - 参数: taskId(任务ID), result(任务结果)',
+  'scheduler:task_failed': '任务失败事件 - 参数: taskId(任务ID), error(错误信息)',
+  'agent:message': '代理消息事件 - 参数: content(消息内容), sessionId(会话ID), agentId(代理ID)',
+  'think:thought_completed': '思考完成事件 - 参数: mode(思考模式), topic(思考主题), thought(思考内容), depth(思考深度)',
+  'email:received': '收到邮件事件 - 参数: from(发件人), to(收件人), subject(主题), text(正文), body(HTML正文), messageId(消息ID), timestamp(时间戳)',
+  'webhook:received': 'Webhook接收事件 - 参数: headers(HTTP头), body(请求体), query(查询参数), path(请求路径)'
+}
+
+// 监听的事件类型列表
+const DefaultEvents = [
+  'tool:result',
+  'scheduler:reminder',
+  'agent:message',
+  'think:thought_completed',
+  'email:received',
+  'webhook:received'
+]
+
+// 系统提示词模板
+const SystemPrompts = {
+  ambientWorker: `你是 ambient-worker，一个专门执行后台任务的子 agent。
+
+你的职责：
+1. 执行 LLM 调用的任务（如生成回复、发送消息）
+2. 不主动思考，只执行给定任务
+3. 快速响应，不等待用户交互
+
+当收到任务时，直接执行并返回结果。`
+}
+
+// 思考模式提示词
+const ThinkModePrompts = {
+  reflect: (goal, topic) => `作为Ambient Agent，反思当前目标：
+标题: ${goal.title}
+描述: ${goal.description || '无'}
+优先级: ${goal.priority}
+状态: ${goal.state}
+尝试次数: ${goal.attempts}
+
+${topic ? `额外关注点: ${topic}` : ''}
+
+请反思：
+1. 这个目标仍然相关且可实现吗？
+2. 操作是否适合这个目标？
+3.有什么可以改进的？`,
+
+  brainstorm: (goal, topic) => `为Ambient Agent目标头脑风暴新方法：
+标题: ${goal.title}
+${goal.description ? `描述: ${goal.description}` : ''}
+计划的操作数: ${goal.actions ? goal.actions.length : 0}
+
+${topic ? `关注点: ${topic}` : '生成关于如何更有效地追求这个目标的新想法。'}`,
+
+  plan: (goal, topic) => `为Ambient Agent目标制定更精细的计划：
+标题: ${goal.title}
+${goal.description ? `描述: ${goal.description}` : ''}
+${topic ? `额外上下文: ${topic}` : ''}
+
+制定一个清晰、可操作的计划。`,
+
+  analyze: (goal, topic) => `分析Ambient Agent目标：
+标题: ${goal.title}
+状态: ${goal.state}
+优先级: ${goal.priority}
+操作: ${goal.actions ? JSON.stringify(goal.actions) : '无'}
+
+${topic ? `分析重点: ${topic}` : '这个目标的优势、劣势和潜在问题是什么？'}`
+}
+
+// 自由思考提示词
+const FreeThinkPrompts = {
+  reflect: (topic) => `Ambient Agent反思: ${topic || '思考系统和目标的当前状态。有什么可以改进的？'}`,
+  brainstorm: (topic) => `Ambient Agent头脑风暴: ${topic || '生成关于新目标或方法的有创意想法。'}`,
+  plan: (topic) => `Ambient Agent计划: ${topic || '为待实现的目标制定计划。'}`,
+  analyze: (topic) => `Ambient Agent分析: ${topic || '分析当前目标及其进展。'}`
+}
+
+module.exports = {
+  GoalState,
+  EventDescriptions,
+  DefaultEvents,
+  SystemPrompts,
+  ThinkModePrompts,
+  FreeThinkPrompts
+}