@ai-setting/roy-agent-core 1.3.10 → 1.3.11

package/src/env/agent/agent-config-registration.test.ts

@@ -1,226 +0,0 @@
-/**
- * @fileoverview Agent Component 配置注册测试
- * 
- * TDD: 先写测试，验证配置注册机制
- */
-
-import { describe, it, expect, beforeEach } from "vitest";
-import { ConfigComponent } from "../../config/config-component";
-import { AgentComponent } from "./agent-component";
-import { AGENT_CONFIG_REGISTRATION, AGENT_DEFAULTS } from "./agent-config-registration";
-
-describe("Agent Config Registration", () => {
-  let configComponent: ConfigComponent;
-  let component: AgentComponent;
-
-  beforeEach(() => {
-    configComponent = new ConfigComponent();
-    component = new AgentComponent();
-  });
-
-  describe("AGENT_CONFIG_REGISTRATION", () => {
-    it("应该包含正确的 name", () => {
-      expect(AGENT_CONFIG_REGISTRATION.name).toBe("agent");
-    });
-
-    it("应该包含 env source 配置", () => {
-      const envSource = AGENT_CONFIG_REGISTRATION.sources.find(
-        (s) => s.type === "env"
-      );
-      expect(envSource).toBeDefined();
-      expect(envSource?.envPrefix).toBe("AGENT");
-      expect(envSource?.priority).toBe(20);
-    });
-
-    it("应该包含所有配置 keys", () => {
-      const keys = AGENT_CONFIG_REGISTRATION.keys;
-      expect(keys).toContainEqual(
-        expect.objectContaining({ key: "agent.defaultAgent.model" })
-      );
-      expect(keys).toContainEqual(
-        expect.objectContaining({ key: "agent.defaultAgent.maxIterations" })
-      );
-      expect(keys).toContainEqual(
-        expect.objectContaining({ key: "agent.defaultAgent.temperature" })
-      );
-      expect(keys).toContainEqual(
-        expect.objectContaining({ key: "agent.defaultAgent.systemPrompt" })
-      );
-    });
-  });
-
-  describe("AGENT_DEFAULTS", () => {
-    it("应该包含 maxIterations 默认值（完整格式）", () => {
-      expect(AGENT_DEFAULTS["agent.defaultAgent.maxIterations"]).toBe(200);
-    });
-
-    it("应该包含 temperature 默认值（完整格式）", () => {
-      expect(AGENT_DEFAULTS["agent.defaultAgent.temperature"]).toBe(0);
-    });
-
-    it("应该包含 timeout 默认值（完整格式）", () => {
-      expect(AGENT_DEFAULTS["agent.defaultAgent.timeout"]).toBe(300000);
-    });
-  });
-
-  describe("配置注册到 ConfigComponent", () => {
-    it("应该能够注册 AGENT_CONFIG_REGISTRATION", () => {
-      configComponent.registerComponent(AGENT_CONFIG_REGISTRATION);
-      expect(() => configComponent.registerComponent(AGENT_CONFIG_REGISTRATION)).not.toThrow();
-    });
-  });
-
-  describe("Component 配置加载", () => {
-    it("应该需要 ConfigComponent 初始化", async () => {
-      await expect(
-        component.init({
-          options: {},
-        } as any)
-      ).rejects.toThrow("ConfigComponent is required");
-    });
-
-    it("应该能够使用 ConfigComponent 初始化", async () => {
-      await component.init({
-        options: {
-          configComponent,
-        },
-      } as any);
-      
-      expect(component.name).toBe("agent");
-      expect(component.version).toBe("1.0.0");
-    });
-
-    it("应该能够通过 config 对象传入配置", async () => {
-      await component.init({
-        options: {
-          configComponent,
-          config: {
-            defaultAgent: {
-              maxIterations: 100,
-              temperature: 0.7,
-            },
-          },
-        },
-      } as any);
-      
-      expect(component.name).toBe("agent");
-    });
-  });
-
-  describe("环境变量覆盖", () => {
-    it("应该能够通过环境变量覆盖配置", async () => {
-      // 设置环境变量
-      const originalValue = process.env.AGENT_AGENT_DEFAULT_AGENT_MAX_ITERATIONS;
-      process.env.AGENT_AGENT_DEFAULT_AGENT_MAX_ITERATIONS = "200";
-      
-      try {
-        await component.init({
-          options: {
-            configComponent,
-          },
-        } as any);
-        
-        expect(component.name).toBe("agent");
-      } finally {
-        // 恢复环境变量
-        if (originalValue !== undefined) {
-          process.env.AGENT_AGENT_DEFAULT_AGENT_MAX_ITERATIONS = originalValue;
-        } else {
-          delete process.env.AGENT_AGENT_DEFAULT_AGENT_MAX_ITERATIONS;
-        }
-      }
-    });
-  });
-
-  /**
-   * 核心验收标准测试
-   * 根据 component-config-unification-guide.md 的设计目标
-   */
-  describe("核心验收标准", () => {
-    it("✅ 应该通过 configComponent.get() 返回默认值", async () => {
-      await component.init({
-        options: {
-          configComponent,
-        },
-      } as any);
-      
-      // 验收标准1: configComponent.get("component.key") 返回默认值（无用户配置时）
-      expect(configComponent.get("agent.defaultAgent.maxIterations")).toBe(200);
-      expect(configComponent.get("agent.defaultAgent.temperature")).toBe(0);
-      expect(configComponent.get("agent.defaultAgent.timeout")).toBe(300000);
-      expect(configComponent.get("agent.defaultAgent.streaming")).toBe(false);
-    });
-
-    it("✅ config 对象应该覆盖默认值", async () => {
-      await component.init({
-        options: {
-          configComponent,
-          config: {
-            defaultAgent: {
-              maxIterations: 100,
-              temperature: 0.8,
-            },
-          },
-        },
-      } as any);
-      
-      // 验收标准3: config 对象覆盖默认值
-      expect(configComponent.get("agent.defaultAgent.maxIterations")).toBe(100);
-      expect(configComponent.get("agent.defaultAgent.temperature")).toBe(0.8);
-    });
-
-    it("✅ 环境变量应该覆盖默认值", async () => {
-      // 设置环境变量
-      const originalMaxIterations = process.env.AGENT_AGENT_DEFAULT_AGENT_MAX_ITERATIONS;
-      process.env.AGENT_AGENT_DEFAULT_AGENT_MAX_ITERATIONS = "75";
-      
-      try {
-        await component.init({
-          options: {
-            configComponent,
-          },
-        } as any);
-        
-        // 验收标准3: 环境变量覆盖默认值（环境变量返回字符串，需要类型转换）
-        // 注意：ConfigComponent.get() 返回的是字符串，环境变量值是字符串
-        // 实际类型转换应该在 buildConfig 中处理
-        const value = configComponent.get("agent.defaultAgent.maxIterations");
-        expect(value !== null && value !== undefined).toBe(true);
-      } finally {
-        if (originalMaxIterations !== undefined) {
-          process.env.AGENT_AGENT_DEFAULT_AGENT_MAX_ITERATIONS = originalMaxIterations;
-        } else {
-          delete process.env.AGENT_AGENT_DEFAULT_AGENT_MAX_ITERATIONS;
-        }
-      }
-    });
-
-    it("✅ 配置优先级: config对象 > 环境变量 > 默认值", async () => {
-      // 设置环境变量
-      const originalMaxIterations = process.env.AGENT_AGENT_DEFAULT_AGENT_MAX_ITERATIONS;
-      process.env.AGENT_AGENT_DEFAULT_AGENT_MAX_ITERATIONS = "60";
-      
-      try {
-        await component.init({
-          options: {
-            configComponent,
-            config: {
-              defaultAgent: {
-                maxIterations: 80,
-              },
-            },
-          },
-        } as any);
-        
-        // config 对象优先级最高
-        expect(configComponent.get("agent.defaultAgent.maxIterations")).toBe(80);
-      } finally {
-        if (originalMaxIterations !== undefined) {
-          process.env.AGENT_AGENT_DEFAULT_AGENT_MAX_ITERATIONS = originalMaxIterations;
-        } else {
-          delete process.env.AGENT_AGENT_DEFAULT_AGENT_MAX_ITERATIONS;
-        }
-      }
-    });
-  });
-});

package/src/env/agent/agent-config-registration.ts

@@ -1,46 +0,0 @@
-/**
- * @fileoverview Agent Component 配置注册
- * 
- * 使用 ConfigComponent.registerComponent() 机制统一管理配置
- */
-
-import type { ComponentRegistration } from "../../config/config-component";
-
-/**
- * Agent Component 默认配置值
- * 
- * 注意：键使用完整格式（带 "agent." 前缀），在 registerConfig 中手动设置
- */
-export const AGENT_DEFAULTS: Record<string, unknown> = {
-  "agent.defaultAgent.maxIterations": 200,
-  "agent.defaultAgent.temperature": 0,
-  "agent.defaultAgent.timeout": 300000,
-  "agent.defaultAgent.streaming": false,
-  "agent.defaultAgent.filterHistory": false,
-};
-
-/**
- * Agent Component 配置注册常量
- * 
- * 定义了所有 Agent 相关的配置项和来源
- */
-export const AGENT_CONFIG_REGISTRATION: ComponentRegistration = {
-  name: "agent",
-  
-  sources: [
-    { type: "env", envPrefix: "AGENT", priority: 20, watch: false },
-  ],
-  
-  keys: [
-    { key: "agent.defaultAgent.model", sources: ["env", "file"] },
-    { key: "agent.defaultAgent.maxIterations", sources: ["env", "file"] },
-    { key: "agent.defaultAgent.temperature", sources: ["env", "file"] },
-    { key: "agent.defaultAgent.timeout", sources: ["env", "file"] },
-    { key: "agent.defaultAgent.systemPrompt", sources: ["env", "file"] },
-    { key: "agent.defaultAgent.streaming", sources: ["env", "file"] },
-    { key: "agent.defaultAgent.tools", sources: ["env", "file"] },
-    { key: "agent.defaultAgent.maxErrorRetries", sources: ["env", "file"] },
-    { key: "agent.defaultAgent.filterHistory", sources: ["env", "file"] },
-  ],
-  // 注意：不使用 defaults 字段，默认值在 registerConfig 中手动 set
-};

package/src/env/agent/agent-reminder-plugin.integration.test.ts

@@ -1,243 +0,0 @@
-/**
- * @fileoverview AgentComponent + ReminderPlugin 集成测试
- * 
- * 验证 ReminderPlugin 真正集成到 AgentComponent 的 before.llm hook 中
- */
-
-import { describe, it, expect, vi, beforeEach } from "vitest";
-import { AgentComponent } from "./agent-component";
-import { ConfigComponent } from "../../config/config-component";
-import type { Environment } from "../interface";
-import type { HookContext, Plugin } from "./types";
-
-// ============================================================================
-// Mock Environment
-// ============================================================================
-
-function createMockEnvironment() {
-  let llmInvokeCount = 0;
-  
-  const mockLLMComponent = {
-    name: "llm",
-    version: "1.0.0",
-    invoke: vi.fn().mockImplementation(() => {
-      llmInvokeCount++;
-      // 第一次调用返回 toolCalls（继续迭代），第二次返回 stop（结束）
-      if (llmInvokeCount < 2) {
-        return Promise.resolve({
-          output: {
-            content: "",
-            finishReason: "tool-calls",
-            toolCalls: [
-              {
-                id: "call_1",
-                function: { name: "test_tool", arguments: "{}" },
-              },
-            ],
-          },
-        });
-      } else {
-        return Promise.resolve({
-          output: {
-            content: "Final response",
-            finishReason: "stop",
-          },
-        });
-      }
-    }),
-  };
-
-  const mockEnv: Environment = {
-    name: "test-env",
-    version: "1.0.0",
-    getConfig: vi.fn(() => ({ name: "test-env", version: "1.0.0", enabled: true })),
-    registerComponent: vi.fn(),
-    unregisterComponent: vi.fn(),
-    getComponent: vi.fn((name: string) => {
-      if (name === "config") return configComponent;
-      if (name === "llm") return mockLLMComponent;
-      return undefined;
-    }),
-    hasComponent: vi.fn((name: string) => name === "config" || name === "llm"),
-    listComponents: vi.fn(() => ["config", "llm"]),
-    handle_query: vi.fn(),
-    handle_action: vi.fn(),
-    subscribe: vi.fn(() => () => {}),
-    subscribeTo: vi.fn(() => () => {}),
-    subscribeAll: vi.fn(() => () => {}),
-    pushEnvEvent: vi.fn(),
-  };
-
-  return { mockEnv, mockLLMComponent };
-}
-
-// ============================================================================
-// Tests
-// ============================================================================
-
-describe("AgentComponent + ReminderPlugin Integration", () => {
-  let agentComponent: AgentComponent;
-  let configComponent: ConfigComponent;
-  let mockEnv: ReturnType<typeof createMockEnvironment>["mockEnv"];
-  let mockLLMComponent: ReturnType<typeof createMockEnvironment>["mockLLMComponent"];
-
-  beforeEach(() => {
-    vi.clearAllMocks();
-    agentComponent = new AgentComponent();
-    configComponent = new ConfigComponent();
-    const env = createMockEnvironment();
-    mockEnv = env.mockEnv;
-    mockLLMComponent = env.mockLLMComponent;
-  });
-
-  describe("ReminderPlugin hook integration", () => {
-    it("ReminderPlugin 应该在每次 before.llm hook 时被调用", async () => {
-      await agentComponent.init({ env: mockEnv, options: { configComponent } });
-      agentComponent.registerAgent("test-agent", { type: "primary" });
-
-      // 创建并注册 ReminderPlugin
-      const reminderPlugin: Plugin = {
-        name: "ReminderPlugin",
-        version: "1.0.0",
-        hooks: [{ point: "agent:before.llm", priority: 100 }],
-        execute: vi.fn().mockResolvedValue({ continue: true }),
-      };
-      agentComponent.registerPlugin("test-agent", reminderPlugin);
-
-      // Mock 工具
-      const mockTool = {
-        name: "test_tool",
-        description: "Test tool",
-        execute: vi.fn().mockResolvedValue({ success: true, output: "tool result" }),
-      };
-      agentComponent.setDefaultTools([mockTool as any]);
-
-      await agentComponent.run("test-agent", "Test query");
-
-      // 验证：ReminderPlugin 被调用了 2 次（2 次 LLM 调用）
-      expect(reminderPlugin.execute).toHaveBeenCalledTimes(2);
-    });
-
-    it("ReminderPlugin 应该能访问 iteration 和 maxIterations 信息", async () => {
-      const capturedContexts: HookContext[] = [];
-
-      await agentComponent.init({ env: mockEnv, options: { configComponent } });
-      agentComponent.registerAgent("test-agent", { type: "primary", maxIterations: 5 });
-
-      const plugin: Plugin = {
-        name: "ContextInspector",
-        version: "1.0.0",
-        hooks: [{ point: "agent:before.llm" }],
-        execute: vi.fn().mockImplementation(async (ctx: HookContext) => {
-          capturedContexts.push(ctx);
-          return { continue: true };
-        }),
-      };
-      agentComponent.registerPlugin("test-agent", plugin);
-
-      await agentComponent.run("test-agent", "Test");
-
-      // 验证：捕获了 hook 调用
-      expect(capturedContexts.length).toBeGreaterThan(0);
-
-      // 验证：每次 hook 调用都能正确获取 iteration 和 maxIterations
-      for (const ctx of capturedContexts) {
-        expect(typeof ctx.iteration).toBe("number");
-        expect(typeof ctx.maxIterations).toBe("number");
-        expect(ctx.maxIterations).toBe(5);
-      }
-    });
-
-    it("当 iteration === maxIterations 时，hook 应该检测到是最后一次迭代", async () => {
-      const isLastIterationTracker: boolean[] = [];
-
-      await agentComponent.init({ env: mockEnv, options: { configComponent } });
-      // 设置 maxIterations = 1，确保只运行 1 次
-      agentComponent.registerAgent("test-agent", { type: "primary", maxIterations: 1 });
-
-      const plugin: Plugin = {
-        name: "LastCheck",
-        version: "1.0.0",
-        hooks: [{ point: "agent:before.llm" }],
-        execute: vi.fn().mockImplementation(async (ctx: HookContext) => {
-          const isLast = ctx.iteration >= ctx.maxIterations;
-          isLastIterationTracker.push(isLast);
-          return { continue: true };
-        }),
-      };
-      agentComponent.registerPlugin("test-agent", plugin);
-
-      await agentComponent.run("test-agent", "Test");
-
-      // 验证：1 次 hook 调用，且是最后一次
-      expect(isLastIterationTracker).toEqual([true]);
-    });
-
-    it("ReminderPlugin 应该能修改 messages 数组注入提醒", async () => {
-      await agentComponent.init({ env: mockEnv, options: { configComponent } });
-      agentComponent.registerAgent("test-agent", { type: "primary", maxIterations: 1 });
-
-      const plugin: Plugin = {
-        name: "MessageInjector",
-        version: "1.0.0",
-        hooks: [{ point: "agent:before.llm" }],
-        execute: vi.fn().mockImplementation(async (ctx: HookContext) => {
-          if (ctx.iteration >= ctx.maxIterations) {
-            ctx.messages.push({
-              role: "user",
-              content: "INJECTED_REMINDER_MESSAGE",
-            } as any);
-          }
-          return { continue: true };
-        }),
-      };
-      agentComponent.registerPlugin("test-agent", plugin);
-
-      await agentComponent.run("test-agent", "Test");
-
-      // 验证：plugin 被调用了 1 次
-      expect(plugin.execute).toHaveBeenCalledTimes(1);
-
-      // 验证：LLM 被调用时，messages 中包含了注入的消息
-      const llmCall = mockLLMComponent.invoke.mock.calls[0][0];
-      const messages = llmCall.messages;
-
-      // 检查是否有注入的消息
-      const injectedMessage = messages.find(
-        (m: any) => typeof m.content === "string" && m.content.includes("INJECTED_REMINDER_MESSAGE")
-      );
-      expect(injectedMessage).toBeDefined();
-    });
-  });
-
-  describe("maxIterations 在 ReAct 循环中的行为", () => {
-    it("应该正确计算最后一次迭代的 iteration 值", async () => {
-      const iterations: number[] = [];
-
-      await agentComponent.init({ env: mockEnv, options: { configComponent } });
-      agentComponent.registerAgent("test-agent", { type: "primary", maxIterations: 3 });
-
-      const plugin: Plugin = {
-        name: "IterationTracker",
-        version: "1.0.0",
-        hooks: [{ point: "agent:before.llm" }],
-        execute: vi.fn().mockImplementation(async (ctx: HookContext) => {
-          iterations.push(ctx.iteration);
-          return { continue: true };
-        }),
-      };
-      agentComponent.registerPlugin("test-agent", plugin);
-
-      await agentComponent.run("test-agent", "Test");
-
-      // 验证：捕获了正确的迭代次数
-      // 第一次 LLM 调用返回 toolCalls → 第二次调用 → 第二次返回 stop
-      expect(iterations.length).toBe(2);
-      expect(iterations[0]).toBe(1);
-      expect(iterations[1]).toBe(2);
-
-      // 验证：最后一次迭代时 iteration === maxIterations - 1（因为只运行了 2 次）
-      expect(iterations[1]).toBeLessThan(3);
-    });
-  });
-});

package/src/env/agent/index.ts

@@ -1,10 +0,0 @@
-/**
- * @fileoverview Agent Component Module
- * 
- * 导出 AgentComponent 及其相关类型
- */
-
-export { AgentComponent, AgentComponentConfigSchema, type AgentComponentConfig } from "./agent-component";
-export { SummaryAgent } from "./summary-agent";  // (new)
-export * from "./types";
-export type { LLMOutput } from "../llm/types";