@agentdevjs/core 0.1.0

package/dist/chunk-TIJV6GJW.js

@@ -0,0 +1,51 @@
+import {
+  AgentBase
+} from "./chunk-YFSM6IYU.js";
+
+// src/agents/system/BasicAgent.ts
+import { existsSync } from "fs";
+import { cwd, platform } from "process";
+var BasicAgent = class extends AgentBase {
+  _systemContext;
+  /**
+   * 构造函数
+   *
+   * @param config 基础配置（llm 必传）
+   */
+  constructor(config) {
+    const workspaceDir = config.workspaceDir ?? cwd();
+    const systemContext = {
+      SYSTEM_WORKING_DIR: workspaceDir,
+      SYSTEM_IS_GIT_REPOSITORY: existsSync(workspaceDir + "/.git"),
+      SYSTEM_PLATFORM: platform,
+      SYSTEM_SHELL_ENV: platform === "win32" ? "Git bash" : platform === "darwin" ? "Bash (macOS)" : "Bash",
+      SYSTEM_DATE: (/* @__PURE__ */ new Date()).toISOString().split("T")[0],
+      // YYYY-MM-DD
+      SYSTEM_CURRENT_MODEL: config.llm.modelName ?? "unknown"
+    };
+    const agentConfig = {
+      llm: config.llm,
+      tools: config.tools ?? [],
+      maxTurns: Infinity,
+      systemMessage: config.systemMessage,
+      name: config.name,
+      projectRoot: config.projectRoot,
+      workspaceDir,
+      features: config.features
+    };
+    super(agentConfig);
+    this._systemContext = systemContext;
+    this.setSystemContext(systemContext);
+  }
+  /**
+   * 获取系统环境信息
+   */
+  getSystemContext() {
+    return this._systemContext;
+  }
+};
+
+export {
+  BasicAgent
+};
+//# sourceMappingURL=chunk-TIJV6GJW.js.map

package/dist/chunk-TIJV6GJW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agents/system/BasicAgent.ts"],"sourcesContent":["/**\n * BasicAgent - 基础 Agent 纯基类\n *\n * 只负责：系统环境信息上下文、AgentConfig 组装。\n * 不内置任何 Feature 装配，也不自动创建 LLM——LLM 实现位于\n * @agentdevjs/llm（core 零重 SDK 纪律），由宿主显式传入：\n *\n *   import { loadConfigSync } from '@agentdevjs/core';\n *   import { createLLM } from '@agentdevjs/llm';\n *   new BasicAgent({ llm: createLLM(loadConfigSync()) })\n */\n\nimport { Agent } from '../../core/agent.js';\nimport type { AgentConfig, LLMClient, Tool } from '../../core/types.js';\nimport { existsSync } from 'fs';\nimport { cwd, platform } from 'process';\n\n/**\n * 系统环境信息上下文\n */\nexport interface SystemContext {\n  /** 当前工作目录 */\n  SYSTEM_WORKING_DIR: string;\n  /** 是否是 Git 仓库 */\n  SYSTEM_IS_GIT_REPOSITORY: boolean;\n  /** 操作系统平台 */\n  SYSTEM_PLATFORM: NodeJS.Platform;\n  /** Shell 环境描述 */\n  SYSTEM_SHELL_ENV: string;\n  /** 当前日期 (YYYY-MM-DD) */\n  SYSTEM_DATE: string;\n  /** 当前使用的模型名称 */\n  SYSTEM_CURRENT_MODEL: string;\n  /** 索引签名，允许作为 PlaceholderContext 使用 */\n  [key: string]: any;\n}\n\n/**\n * BasicAgent 配置选项\n *\n * llm 必传（LLM 装配权在宿主）；其余参数可选。\n * 需要工具或上下文注入时，构造后通过 use() 显式挂载 Feature。\n */\nexport interface BasicAgentConfig {\n  /** LLM 客户端（必传；实现见 @agentdevjs/llm 的 createLLM） */\n  llm: LLMClient;\n  /** Agent 显示名称（可选） */\n  name?: string;\n  /** 系统提示词（可选，后续可通过 setPrompt() 设置） */\n  systemMessage?: string;\n  /** 自定义工具集（可选，默认为空） */\n  tools?: Tool[];\n  /** Feature 特定配置（可选） */\n  features?: AgentConfig['features'];\n  /** 调试器和模板解析使用的项目根目录 */\n  projectRoot?: string;\n  /** 工具默认操作的工作目录 */\n  workspaceDir?: string;\n}\n\n/**\n * 基础 Agent 类\n *\n * 纯基类：集成系统环境信息，零内置 Feature 装配、零 LLM 自动创建。\n */\nexport class BasicAgent extends Agent {\n  protected _systemContext: SystemContext;\n\n  /**\n   * 构造函数\n   *\n   * @param config 基础配置（llm 必传）\n   */\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_SHELL_ENV: platform === 'win32' ? 'Git bash' : (platform === 'darwin' ? 'Bash (macOS)' : 'Bash'),\n      SYSTEM_DATE: new Date().toISOString().split('T')[0], // YYYY-MM-DD\n      SYSTEM_CURRENT_MODEL: config.llm.modelName ?? 'unknown',\n    };\n\n    // 构建完整的 Agent 配置\n    const agentConfig: AgentConfig = {\n      llm: config.llm,\n      tools: config.tools ?? [],\n      maxTurns: Infinity,\n      systemMessage: config.systemMessage,\n      name: config.name,\n      projectRoot: config.projectRoot,\n      workspaceDir,\n      features: config.features,\n    };\n\n    super(agentConfig);\n\n    // 保存配置（必须在 super() 之后）\n    this._systemContext = systemContext;\n    this.setSystemContext(systemContext);\n  }\n\n  /**\n   * 获取系统环境信息\n   */\n  getSystemContext(): SystemContext {\n    return this._systemContext;\n  }\n}\n"],"mappings":";;;;;AAcA,SAAS,kBAAkB;AAC3B,SAAS,KAAK,gBAAgB;AAkDvB,IAAM,aAAN,cAAyB,UAAM;AAAA,EAC1B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOV,YAAY,QAA0B;AACpC,UAAM,eAAe,OAAO,gBAAgB,IAAI;AAEhD,UAAM,gBAA+B;AAAA,MACnC,oBAAoB;AAAA,MACpB,0BAA0B,WAAW,eAAe,OAAO;AAAA,MAC3D,iBAAiB;AAAA,MACjB,kBAAkB,aAAa,UAAU,aAAc,aAAa,WAAW,iBAAiB;AAAA,MAChG,cAAa,oBAAI,KAAK,GAAE,YAAY,EAAE,MAAM,GAAG,EAAE,CAAC;AAAA;AAAA,MAClD,sBAAsB,OAAO,IAAI,aAAa;AAAA,IAChD;AAGA,UAAM,cAA2B;AAAA,MAC/B,KAAK,OAAO;AAAA,MACZ,OAAO,OAAO,SAAS,CAAC;AAAA,MACxB,UAAU;AAAA,MACV,eAAe,OAAO;AAAA,MACtB,MAAM,OAAO;AAAA,MACb,aAAa,OAAO;AAAA,MACpB;AAAA,MACA,UAAU,OAAO;AAAA,IACnB;AAEA,UAAM,WAAW;AAGjB,SAAK,iBAAiB;AACtB,SAAK,iBAAiB,aAAa;AAAA,EACrC;AAAA;AAAA;AAAA;AAAA,EAKA,mBAAkC;AAChC,WAAO,KAAK;AAAA,EACd;AACF;","names":[]}

package/dist/chunk-UCEIJEM5.js

@@ -0,0 +1,61 @@
+import {
+  AgentBase,
+  TemplateComposer
+} from "./chunk-YFSM6IYU.js";
+
+// src/agents/system/ExplorerAgent.ts
+import { existsSync } from "fs";
+import { cwd, platform } from "process";
+var ExplorerAgent = class extends AgentBase {
+  _systemContext;
+  /**
+   * 构造函数
+   *
+   * @param config 探索者配置（llm 必传）
+   */
+  constructor(config) {
+    const systemContext = {
+      SYSTEM_WORKING_DIR: cwd(),
+      SYSTEM_IS_GIT_REPOSITORY: existsSync(cwd() + "/.git"),
+      SYSTEM_PLATFORM: platform,
+      SYSTEM_SHELL_ENV: platform === "win32" ? "Git bash" : platform === "darwin" ? "Bash (macOS)" : "Bash",
+      SYSTEM_DATE: (/* @__PURE__ */ new Date()).toISOString().split("T")[0],
+      // YYYY-MM-DD
+      SYSTEM_CURRENT_MODEL: config.llm.modelName ?? "unknown"
+    };
+    const agentConfig = {
+      llm: config.llm,
+      tools: [],
+      // 工具由宿主装配
+      maxTurns: Infinity,
+      // 无限交互次数
+      systemMessage: config.systemMessage,
+      name: config.name
+    };
+    super(agentConfig);
+    this._systemContext = systemContext;
+    this.setSystemContext(systemContext);
+  }
+  /**
+   * Agent 初始化钩子
+   * 默认系统提示词（explorer.md + 系统环境）
+   */
+  async onInitiate() {
+    if (!this.systemMessage) {
+      this.setSystemPrompt(
+        new TemplateComposer().add({ file: ".agentdev/prompts/explorer.md" }).add("\n\n## \u7CFB\u7EDF\u73AF\u5883\n\n").add("- \u5DE5\u4F5C\u76EE\u5F55: `{{SYSTEM_WORKING_DIR}}`\n").add("- Git \u4ED3\u5E93: {{SYSTEM_IS_GIT_REPOSITORY}}\n").add("- \u64CD\u4F5C\u7CFB\u7EDF: {{SYSTEM_PLATFORM}}\n").add("- bash\u7248\u672C\uFF1APowerShell 5.1\n").add("- \u5F53\u524D\u65E5\u671F: {{SYSTEM_DATE}}\n")
+      );
+    }
+  }
+  /**
+   * 获取系统环境信息
+   */
+  getSystemContext() {
+    return this._systemContext;
+  }
+};
+
+export {
+  ExplorerAgent
+};
+//# sourceMappingURL=chunk-UCEIJEM5.js.map

package/dist/chunk-UCEIJEM5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agents/system/ExplorerAgent.ts"],"sourcesContent":["/**\n * ExplorerAgent - 代码探索者 Agent 纯基类\n *\n * 专注于代码库探索和理解的轻量级 Agent 基类。\n * 纯基类：零内置 Feature 装配，也不自动创建 LLM（core 零重 SDK 纪律，\n * LLM 实现位于 @agentdevjs/llm，由宿主显式传入）。只读定位通过装配层的\n * 工具裁剪实现，本类不代劳。\n */\n\nimport { Agent } from '../../core/agent.js';\nimport type { AgentConfig, LLMClient } from '../../core/types.js';\nimport { existsSync } from 'fs';\nimport { cwd, platform } from 'process';\nimport { TemplateComposer } from '../../template/composer.js';\n\n/**\n * 系统环境信息上下文\n */\nexport interface SystemContext {\n  /** 当前工作目录 */\n  SYSTEM_WORKING_DIR: string;\n  /** 是否是 Git 仓库 */\n  SYSTEM_IS_GIT_REPOSITORY: boolean;\n  /** 操作系统平台 */\n  SYSTEM_PLATFORM: NodeJS.Platform;\n  /** Shell 环境描述 */\n  SYSTEM_SHELL_ENV: string;\n  /** 当前日期 (YYYY-MM-DD) */\n  SYSTEM_DATE: string;\n  /** 当前使用的模型名称 */\n  SYSTEM_CURRENT_MODEL: string;\n  /** 索引签名，允许作为 PlaceholderContext 使用 */\n  [key: string]: any;\n}\n\n/**\n * ExplorerAgent 配置选项\n *\n * llm 必传（LLM 装配权在宿主）；其余参数可选。\n */\nexport interface ExplorerAgentConfig {\n  /** LLM 客户端（必传；实现见 @agentdevjs/llm 的 createLLM） */\n  llm: LLMClient;\n  /** Agent 显示名称（可选） */\n  name?: string;\n  /** 系统提示词（可选，默认使用 explorer.md） */\n  systemMessage?: string;\n}\n\n/**\n * 代码探索者 Agent\n *\n * 轻量级代码探索 Agent 基类，专注于：\n * - 代码库结构分析\n * - 代码审查和理解\n * - 文档生成\n * - 依赖关系梳理\n */\nexport class ExplorerAgent extends Agent {\n  protected _systemContext: SystemContext;\n\n  /**\n   * 构造函数\n   *\n   * @param config 探索者配置（llm 必传）\n   */\n  constructor(config: ExplorerAgentConfig) {\n    // 建立系统环境信息\n    const systemContext: SystemContext = {\n      SYSTEM_WORKING_DIR: cwd(),\n      SYSTEM_IS_GIT_REPOSITORY: existsSync(cwd() + '/.git'),\n      SYSTEM_PLATFORM: platform,\n      SYSTEM_SHELL_ENV: platform === 'win32' ? 'Git bash' : (platform === 'darwin' ? 'Bash (macOS)' : 'Bash'),\n      SYSTEM_DATE: new Date().toISOString().split('T')[0], // YYYY-MM-DD\n      SYSTEM_CURRENT_MODEL: config.llm.modelName ?? 'unknown',\n    };\n\n    // 构建完整的 Agent 配置\n    const agentConfig: AgentConfig = {\n      llm: config.llm,\n      tools: [],              // 工具由宿主装配\n      maxTurns: Infinity,     // 无限交互次数\n      systemMessage: config.systemMessage,\n      name: config.name,\n    };\n\n    super(agentConfig);\n\n    // 保存配置（必须在 super() 之后）\n    this._systemContext = systemContext;\n    this.setSystemContext(systemContext);\n  }\n\n  /**\n   * Agent 初始化钩子\n   * 默认系统提示词（explorer.md + 系统环境）\n   */\n  protected override async onInitiate(): Promise<void> {\n    // 配置系统提示词\n    if (!this.systemMessage) {\n      this.setSystemPrompt(new TemplateComposer()\n        .add({ file: '.agentdev/prompts/explorer.md' })\n        .add('\\n\\n## 系统环境\\n\\n')\n        .add('- 工作目录: `{{SYSTEM_WORKING_DIR}}`\\n')\n        .add('- Git 仓库: {{SYSTEM_IS_GIT_REPOSITORY}}\\n')\n        .add('- 操作系统: {{SYSTEM_PLATFORM}}\\n')\n        .add('- bash版本：PowerShell 5.1\\n')\n        .add('- 当前日期: {{SYSTEM_DATE}}\\n')\n      );\n    }\n  }\n\n  /**\n   * 获取系统环境信息\n   */\n  getSystemContext(): SystemContext {\n    return this._systemContext;\n  }\n}\n"],"mappings":";;;;;;AAWA,SAAS,kBAAkB;AAC3B,SAAS,KAAK,gBAAgB;AA8CvB,IAAM,gBAAN,cAA4B,UAAM;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOV,YAAY,QAA6B;AAEvC,UAAM,gBAA+B;AAAA,MACnC,oBAAoB,IAAI;AAAA,MACxB,0BAA0B,WAAW,IAAI,IAAI,OAAO;AAAA,MACpD,iBAAiB;AAAA,MACjB,kBAAkB,aAAa,UAAU,aAAc,aAAa,WAAW,iBAAiB;AAAA,MAChG,cAAa,oBAAI,KAAK,GAAE,YAAY,EAAE,MAAM,GAAG,EAAE,CAAC;AAAA;AAAA,MAClD,sBAAsB,OAAO,IAAI,aAAa;AAAA,IAChD;AAGA,UAAM,cAA2B;AAAA,MAC/B,KAAK,OAAO;AAAA,MACZ,OAAO,CAAC;AAAA;AAAA,MACR,UAAU;AAAA;AAAA,MACV,eAAe,OAAO;AAAA,MACtB,MAAM,OAAO;AAAA,IACf;AAEA,UAAM,WAAW;AAGjB,SAAK,iBAAiB;AACtB,SAAK,iBAAiB,aAAa;AAAA,EACrC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAyB,aAA4B;AAEnD,QAAI,CAAC,KAAK,eAAe;AACvB,WAAK;AAAA,QAAgB,IAAI,iBAAiB,EACvC,IAAI,EAAE,MAAM,gCAAgC,CAAC,EAC7C,IAAI,qCAAiB,EACrB,IAAI,wDAAoC,EACxC,IAAI,oDAA0C,EAC9C,IAAI,mDAA+B,EACnC,IAAI,0CAA2B,EAC/B,IAAI,+CAA2B;AAAA,MAClC;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,mBAAkC;AAChC,WAAO,KAAK;AAAA,EACd;AACF;","names":[]}