agentdev 0.1.9 → 0.2.1

package/dist/chunk-5T4C2XRT.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/agents/system/BasicAgent.ts"],"sourcesContent":["/**\r\n * BasicAgent - 基础 Agent 类\r\n *\r\n * 集成了常用 Feature 和系统环境信息\r\n * 适用于大多数 Agent 场景\r\n *\r\n * 默认自动加载配置文件，开箱即用\r\n */\r\n\r\nimport { Agent } from '../../core/agent.js';\r\nimport { MCPFeature, SkillFeature, SubAgentFeature, OpencodeBasicFeature } from '../../features/index.js';\r\nimport type { AgentConfig, LLMClient, Tool } from '../../core/types.js';\r\nimport type { AgentConfigFile } from '../../core/config.js';\r\nimport { loadConfigSync } from '../../core/config.js';\r\nimport { createLLM } from '../../llm/index.js';\r\nimport { existsSync } from 'fs';\r\nimport { cwd, platform } from 'process';\r\nimport { getDefaultMCPConfigDir } from '../../mcp/config.js';\r\n\r\n/**\r\n * 系统环境信息上下文\r\n */\r\nexport interface SystemContext {\r\n  /** 当前工作目录 */\r\n  SYSTEM_WORKING_DIR: string;\r\n  /** 是否是 Git 仓库 */\r\n  SYSTEM_IS_GIT_REPOSITORY: boolean;\r\n  /** 操作系统平台 */\r\n  SYSTEM_PLATFORM: NodeJS.Platform;\r\n  /** 当前日期 (YYYY-MM-DD) */\r\n  SYSTEM_DATE: string;\r\n  /** 当前使用的模型名称 */\r\n  SYSTEM_CURRENT_MODEL: string;\r\n  /** 索引签名，允许作为 PlaceholderContext 使用 */\r\n  [key: string]: any;\r\n}\r\n\r\n/**\r\n * BasicAgent 配置选项\r\n *\r\n * 所有参数都是可选的，默认会自动同步加载配置文件\r\n */\r\nexport interface BasicAgentConfig {\n  /** LLM 客户端（可选，不传则自动同步加载配置创建） */\r\n  llm?: LLMClient;\r\n  /** 配置文件名（可选，默认 'default'） */\r\n  configName?: string;\r\n  /** Agent 显示名称（可选） */\r\n  name?: string;\r\n  /** 系统提示词（可选，后续可通过 setPrompt() 设置） */\r\n  systemMessage?: string;\r\n  /** MCP 配置：传字符串时加载指定配置；传 false 时禁用自动加载；不传时若 .agentdev/mcps 存在则自动加载全部 */\r\n  mcpServer?: string | false;\r\n  /** MCP 运行时上下文（可选，如 GitHub Token） */\r\n  mcpContext?: Record<string, unknown>;\r\n  /** 自动扫描 MCP 时排除的 serverId 列表 */\r\n  excludeMcpServers?: string[];\r\n  /** 自定义工具集（可选，默认使用 Feature 提供的工具） */\r\n  tools?: Tool[];\r\n  /** Skills 目录（可选，默认使用 .agentdev/skills） */\n  skillsDir?: string;\n  /** 调试器和模板解析使用的项目根目录 */\n  projectRoot?: string;\n  /** 工具默认操作的工作目录 */\n  workspaceDir?: string;\n}\n\r\n/**\r\n * 基础 Agent 类\r\n *\r\n * 集成常用 Feature 和系统环境信息，开箱即用\r\n * 构造函数不传任何参数时，会自动同步加载配置文件创建 LLM\r\n */\r\nexport class BasicAgent extends Agent {\r\n  protected _systemContext: SystemContext;\r\n  protected _mcpServer?: string | false;\r\n  protected _mcpContext?: Record<string, unknown>;\r\n  protected _config?: AgentConfigFile;\r\n  protected _skillsDir?: string;\r\n  protected _mcpFeature?: MCPFeature;\r\n\r\n  /**\r\n   * 构造函数\r\n   *\r\n   * @param config 基础配置（全部可选，不传则使用默认配置）\r\n   */\r\n  constructor(config: BasicAgentConfig = {}) {\n    const workspaceDir = config.workspaceDir ?? cwd();\n    // 建立系统环境信息\n    const systemContext: SystemContext = {\n      SYSTEM_WORKING_DIR: workspaceDir,\n      SYSTEM_IS_GIT_REPOSITORY: existsSync(workspaceDir + '/.git'),\n      SYSTEM_PLATFORM: platform,\n      SYSTEM_DATE: new Date().toISOString().split('T')[0], // YYYY-MM-DD\r\n      SYSTEM_CURRENT_MODEL: 'unknown', // 稍后更新\r\n    };\r\n\r\n    // 准备 LLM：如果没传入，同步加载配置\r\n    let llm = config.llm;\r\n    let fileConfig: AgentConfigFile | undefined;\r\n    if (!llm) {\r\n      const configName = config.configName ?? 'default';\r\n      fileConfig = loadConfigSync(configName);\r\n      llm = createLLM(fileConfig);\r\n      systemContext.SYSTEM_CURRENT_MODEL = fileConfig.defaultModel.model;\r\n      console.log(`[BasicAgent] 已加载配置: ${configName}, 模型: ${fileConfig.defaultModel.model}`);\r\n    }\r\n\r\n    // 构建完整的 Agent 配置\r\n    const agentConfig: AgentConfig = {\r\n      llm: llm!,\r\n      tools: config.tools ?? [],\r\n      maxTurns: Infinity,\n      systemMessage: config.systemMessage,\n      name: config.name,\n      projectRoot: config.projectRoot,\n      workspaceDir,\n    };\n\r\n    super(agentConfig);\r\n\r\n    // 保存配置（必须在 super() 之后）\r\n    this._systemContext = systemContext;\r\n    this._config = fileConfig;\r\n    this._mcpServer = config.mcpServer;\r\n    this._mcpContext = config.mcpContext;\r\n    this._skillsDir = config.skillsDir;\r\n    this.setSystemContext(systemContext);\r\n\r\n    const hasDefaultMCPConfigs = existsSync(getDefaultMCPConfigDir());\r\n    const shouldEnableMCP = config.mcpServer !== false && (typeof config.mcpServer === 'string' || hasDefaultMCPConfigs);\r\n    if (shouldEnableMCP) {\r\n      this._mcpFeature = typeof config.mcpServer === 'string'\r\n        ? new MCPFeature(config.mcpServer)\r\n        : new MCPFeature(undefined, { excludeServers: config.excludeMcpServers });\r\n      if (config.mcpContext) {\r\n        this._mcpFeature.setMCPContext(config.mcpContext);\r\n      }\r\n      this.use(this._mcpFeature);\r\n    }\r\n\r\n    // 注册 OpencodeBasicFeature（文件操作工具集）\r\n    this.use(new OpencodeBasicFeature({ workspaceDir }));\n\r\n    // 注册 SkillFeature（invokeSkill 工具和 skills 上下文注入）\r\n    this.use(new SkillFeature(config.skillsDir));\r\n\r\n    // 注册 SubAgentFeature（子代理工具和消息处理）\r\n    this.use(new SubAgentFeature());\r\n\r\n    // 预禁用不需要的子代理工具，确保首次快照与运行时一致\r\n    this.getTools().disable('list_agents');\r\n    this.getTools().disable('close_agent');\r\n\r\n    // 注册可创建的子代理类型\r\n    this.registerAgentType('BasicAgent', () => new BasicAgent({ llm: this.llm }));\r\n    this.registerAgentType('ExplorerAgent', () => import('./ExplorerAgent.js').then(m => new m.ExplorerAgent({ llm: this.llm })));\r\n  }\r\n\r\n  /**\r\n   * 获取系统环境信息\r\n   */\r\n  getSystemContext(): SystemContext {\r\n    return this._systemContext;\r\n  }\r\n\r\n  /**\r\n   * 获取 MCP 服务器配置\r\n   */\r\n  getMcpServer(): string | false | undefined {\r\n    return this._mcpServer;\r\n  }\r\n\r\n  /**\r\n   * 获取 MCP 上下文\r\n   */\r\n  getMcpContext(): Record<string, unknown> | undefined {\r\n    return this._mcpContext;\r\n  }\r\n}\r\n"],"mappings":";;;;;;;;;;;;AAeA,SAAS,kBAAkB;AAC3B,SAAS,KAAK,gBAAgB;AAyDvB,IAAM,aAAN,MAAM,oBAAmB,UAAM;AAAA,EAC1B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOV,YAAY,SAA2B,CAAC,GAAG;AACzC,UAAM,eAAe,OAAO,gBAAgB,IAAI;AAEhD,UAAM,gBAA+B;AAAA,MACnC,oBAAoB;AAAA,MACpB,0BAA0B,WAAW,eAAe,OAAO;AAAA,MAC3D,iBAAiB;AAAA,MACjB,cAAa,oBAAI,KAAK,GAAE,YAAY,EAAE,MAAM,GAAG,EAAE,CAAC;AAAA;AAAA,MAClD,sBAAsB;AAAA;AAAA,IACxB;AAGA,QAAI,MAAM,OAAO;AACjB,QAAI;AACJ,QAAI,CAAC,KAAK;AACR,YAAM,aAAa,OAAO,cAAc;AACxC,mBAAa,eAAe,UAAU;AACtC,YAAM,UAAU,UAAU;AAC1B,oBAAc,uBAAuB,WAAW,aAAa;AAC7D,cAAQ,IAAI,gDAAuB,UAAU,mBAAS,WAAW,aAAa,KAAK,EAAE;AAAA,IACvF;AAGA,UAAM,cAA2B;AAAA,MAC/B;AAAA,MACA,OAAO,OAAO,SAAS,CAAC;AAAA,MACxB,UAAU;AAAA,MACV,eAAe,OAAO;AAAA,MACtB,MAAM,OAAO;AAAA,MACb,aAAa,OAAO;AAAA,MACpB;AAAA,IACF;AAEA,UAAM,WAAW;AAGjB,SAAK,iBAAiB;AACtB,SAAK,UAAU;AACf,SAAK,aAAa,OAAO;AACzB,SAAK,cAAc,OAAO;AAC1B,SAAK,aAAa,OAAO;AACzB,SAAK,iBAAiB,aAAa;AAEnC,UAAM,uBAAuB,WAAW,uBAAuB,CAAC;AAChE,UAAM,kBAAkB,OAAO,cAAc,UAAU,OAAO,OAAO,cAAc,YAAY;AAC/F,QAAI,iBAAiB;AACnB,WAAK,cAAc,OAAO,OAAO,cAAc,WAC3C,IAAI,WAAW,OAAO,SAAS,IAC/B,IAAI,WAAW,QAAW,EAAE,gBAAgB,OAAO,kBAAkB,CAAC;AAC1E,UAAI,OAAO,YAAY;AACrB,aAAK,YAAY,cAAc,OAAO,UAAU;AAAA,MAClD;AACA,WAAK,IAAI,KAAK,WAAW;AAAA,IAC3B;AAGA,SAAK,IAAI,IAAI,qBAAqB,EAAE,aAAa,CAAC,CAAC;AAGnD,SAAK,IAAI,IAAI,aAAa,OAAO,SAAS,CAAC;AAG3C,SAAK,IAAI,IAAI,gBAAgB,CAAC;AAG9B,SAAK,SAAS,EAAE,QAAQ,aAAa;AACrC,SAAK,SAAS,EAAE,QAAQ,aAAa;AAGrC,SAAK,kBAAkB,cAAc,MAAM,IAAI,YAAW,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC;AAC5E,SAAK,kBAAkB,iBAAiB,MAAM,OAAO,6BAAoB,EAAE,KAAK,OAAK,IAAI,EAAE,cAAc,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC;AAAA,EAC9H;AAAA;AAAA;AAAA;AAAA,EAKA,mBAAkC;AAChC,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,eAA2C;AACzC,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,gBAAqD;AACnD,WAAO,KAAK;AAAA,EACd;AACF;","names":[]}