autosnippet 3.2.10 → 3.2.11

package/dist/lib/service/agent/AgentRouter.js

@@ -0,0 +1,224 @@
+/**
+ * AgentRouter — Intent → Preset 解析器
+ *
+ * 在统一架构下，Router 的职责简化为:
+ *   - 理解用户意图 (intent classification)
+ *   - 映射到正确的 Preset (配置组合)
+ *   - 创建 AgentRuntime 并执行
+ *
+ * 路由策略 (优先级递减):
+ *   1. 手动指定 (API `preset` 参数)
+ *   2. 渠道特征 (如飞书终端命令以 > 开头 → remote-exec)
+ *   3. 关键词匹配 (零延迟正则)
+ *   4. LLM 意图分类 (精确但需 AI 调用)
+ *   5. 默认 → chat
+ *
+ * 关键区别 (vs 旧 AgentRouter):
+ *   - 旧版路由到 AgentMode (chat/bootstrap/scan/lark_bridge) → 4 种 Agent 类型
+ *   - 新版路由到 Preset (chat/insight/remote-exec) → 同一 Runtime 的不同配置
+ *   - 不再存在 "LarkBridge" 模式 — 飞书和前端共享同一 Preset
+ *
+ * @module AgentRouter
+ */
+import Logger from '../../infrastructure/logging/Logger.js';
+import { AgentEventBus } from './AgentEventBus.js';
+import { Channel } from './AgentMessage.js';
+/**
+ * Preset 名称枚举
+ */
+export const PresetName = Object.freeze({
+    CHAT: 'chat',
+    INSIGHT: 'insight',
+    LARK: 'lark',
+    REMOTE_EXEC: 'remote-exec',
+});
+/**
+ * 关键词 → Preset 映射 (零延迟快速路径)
+ */
+const KEYWORD_ROUTES = [
+    {
+        preset: PresetName.INSIGHT,
+        keywords: [
+            /冷启动|cold[\s-]?start|初始化知识库|bootstrap/i,
+            /重建知识库|rebuild.*knowledge/i,
+            /全项目.*分析|analyze.*entire.*project/i,
+            /扫描|scan|分析.*目录|分析.*文件夹|analyze.*folder/i,
+            /检查.*target|审计.*模块|audit.*module/i,
+            /深度分析.*路径|知识提取/i,
+        ],
+    },
+    {
+        preset: PresetName.REMOTE_EXEC,
+        keywords: [
+            /^[>$]\s*/, // 以 > 或 $ 开头 = 终端命令
+            /运行命令|执行命令|run.*command|exec.*command/i,
+        ],
+    },
+];
+/**
+ * LLM 路由分类 Schema
+ */
+const ROUTE_CLASSIFICATION_SCHEMA = {
+    name: 'classify_intent',
+    description: 'Classify user intent to determine which agent preset to use',
+    parameters: {
+        type: 'object',
+        properties: {
+            preset: {
+                type: 'string',
+                enum: ['chat', 'insight', 'lark', 'remote-exec'],
+                description: 'The preset to route to. chat=conversation, insight=code analysis and knowledge extraction, lark=Lark knowledge management, remote-exec=terminal commands',
+            },
+            confidence: {
+                type: 'number',
+                description: 'Confidence score 0-1',
+            },
+            reasoning: {
+                type: 'string',
+                description: 'Brief reasoning for the classification',
+            },
+        },
+        required: ['preset', 'confidence'],
+    },
+};
+export class AgentRouter {
+    #logger;
+    #bus;
+    /** @type {RouterAiProvider|null} */
+    #aiProvider = null;
+    /** @type {AgentExecutor|null} */
+    #executor = null;
+    constructor() {
+        this.#logger = Logger.getInstance();
+        this.#bus = AgentEventBus.getInstance();
+    }
+    /**
+     * 设置 AI Provider (用于 LLM 路由)
+     * @param {RouterAiProvider} provider
+     */
+    setAiProvider(provider) {
+        this.#aiProvider = provider;
+    }
+    /**
+     * 设置执行器 — Factory 提供的 (presetName, message, opts) => AgentResult
+     * @param {AgentExecutor} executor
+     */
+    setExecutor(executor) {
+        this.#executor = executor;
+    }
+    /**
+     * 路由并执行
+     *
+     * @param {import('./AgentMessage.js').AgentMessage} message 统一消息
+     * @param {Object} [opts]
+     * @param {string} [opts.preset] 手动指定 Preset (跳过路由)
+     * @param {Object} [opts.strategyOpts] 策略特定选项 (如 FanOut 的 items)
+     * @returns {Promise<{preset: string, result: Object}>}
+     */
+    async route(message, opts = {}) {
+        // 1. 手动指定
+        let preset = opts.preset || message.metadata?.mode;
+        // 2. 渠道特征路由
+        if (!preset) {
+            preset = this.#matchChannel(message);
+            if (preset) {
+                this.#logger.info(`[AgentRouter] Channel match → ${preset}`);
+            }
+        }
+        // 3. 关键词匹配
+        if (!preset) {
+            preset = this.#matchKeyword(message.content);
+            if (preset) {
+                this.#logger.info(`[AgentRouter] Keyword match → ${preset}`);
+            }
+        }
+        // 4. LLM 分类
+        if (!preset && this.#aiProvider) {
+            preset = await this.#classifyWithLLM(message.content);
+            if (preset) {
+                this.#logger.info(`[AgentRouter] LLM classification → ${preset}`);
+            }
+        }
+        // 5. 默认 → chat
+        if (!preset) {
+            preset = PresetName.CHAT;
+        }
+        // 执行
+        if (!this.#executor) {
+            throw new Error('[AgentRouter] No executor set. Call setExecutor() first.');
+        }
+        this.#logger.info(`[AgentRouter] Dispatching → preset="${preset}" channel=${message.channel}`);
+        const result = await this.#executor(preset, message, opts);
+        return { preset, result };
+    }
+    /**
+     * 仅分类意图，不执行
+     * @param {import('./AgentMessage.js').AgentMessage} message
+     * @returns {Promise<string>} preset name
+     */
+    async classify(message) {
+        let preset = message.metadata?.mode;
+        if (!preset) {
+            preset = this.#matchChannel(message);
+        }
+        if (!preset) {
+            preset = this.#matchKeyword(message.content);
+        }
+        if (!preset && this.#aiProvider) {
+            preset = await this.#classifyWithLLM(message.content);
+        }
+        return preset || PresetName.CHAT;
+    }
+    // ─── 私有方法 ────────────────────────────────
+    /**
+     * 渠道特征路由
+     * 飞书消息默认 → lark preset (知识管理对话)
+     * 飞书终端命令 (> 开头) → remote-exec
+     */
+    #matchChannel(message) {
+        if (message.channel === Channel.LARK) {
+            const text = message.content.trim();
+            // 飞书消息以 > 或 $ 开头 → 终端命令
+            if (/^[>$]\s*/.test(text)) {
+                return PresetName.REMOTE_EXEC;
+            }
+            // 默认走 lark preset (知识管理对话)
+            return PresetName.LARK;
+        }
+        return null;
+    }
+    #matchKeyword(prompt) {
+        for (const route of KEYWORD_ROUTES) {
+            for (const re of route.keywords) {
+                if (re.test(prompt)) {
+                    return route.preset;
+                }
+            }
+        }
+        return null;
+    }
+    async #classifyWithLLM(prompt) {
+        try {
+            const result = await this.#aiProvider.chatWithTools(`Classify this user message into the correct preset: "${prompt.slice(0, 300)}"`, {
+                messages: [],
+                toolSchemas: [ROUTE_CLASSIFICATION_SCHEMA],
+                toolChoice: 'required',
+                systemPrompt: 'You classify user intents for an AI coding assistant. Respond by calling the classify_intent function.',
+                temperature: 0,
+                maxTokens: 200,
+            });
+            if (result.functionCalls?.[0]?.args?.preset) {
+                const classified = result.functionCalls[0].args;
+                if (classified.confidence > 0.6) {
+                    return classified.preset;
+                }
+            }
+        }
+        catch (err) {
+            this.#logger.warn(`[AgentRouter] LLM classification failed: ${err.message}`);
+        }
+        return null;
+    }
+}
+export default AgentRouter;
+//# sourceMappingURL=AgentRouter.js.map

package/dist/lib/service/agent/AgentRouter.js.map

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

package/dist/lib/service/agent/AgentRuntime.d.ts

@@ -0,0 +1,247 @@
+/**
+ * AgentRuntime — 统一 Agent 执行引擎 (The Brain)
+ *
+ * 核心思想: 不存在类型分野，只有 ONE Runtime。
+ * 只有 ONE Runtime，由 Capability + Strategy + Policy 配置驱动。
+ *
+ * AgentRuntime 是:
+ *   - ReAct 循环的宿主 (Thought → Action → Observation)
+ *   - Capability 的组合容器 (加载哪些技能)
+ *   - Policy 的执行者 (遵守哪些约束)
+ *   - Strategy 的被委托者 (Strategy 调用 runtime.reactLoop())
+ *
+ * 认知架构 (CoALA):
+ *   Perception → Working Memory → Reasoning → Action → Reflection
+ *   │             │                │           │         │
+ *   AgentMessage   history+memory   LLM call    Tools    Policy.validateAfter
+ *
+ * 引擎级能力:
+ *   - ContextWindow: 三级递进压缩，动态 token 预算 (可选注入)
+ *   - ExplorationTracker: 阶段状态机 + 信号收集 + Nudge + Graceful exit (可选注入)
+ *   - AI 错误恢复: consecutiveAiErrors 2-strike → context reset → forced summary
+ *   - 空响应重试: consecutiveEmptyResponses + rollback (system 场景)
+ *   - 熔断器感知: _circuitState === 'OPEN' → 直接合成摘要
+ *   - 工具调用数量限制: MAX_TOOL_CALLS_PER_ITER = 8
+ *   - 提交去重: submittedTitles / submittedPatterns
+ *   - cleanFinalAnswer: 去除 nudge 噪声
+ *
+ * @module AgentRuntime
+ */
+import { AgentEventBus } from './AgentEventBus.js';
+import type { AgentMessage } from './AgentMessage.js';
+import { AgentState } from './AgentState.js';
+import { Capability } from './capabilities.js';
+import { PolicyEngine } from './policies.js';
+/** Tool call entry recorded during execution */
+interface ToolCallEntry {
+    tool: string;
+    name?: string;
+    args: Record<string, unknown>;
+    result: unknown;
+    durationMs: number;
+}
+/** Progress event emitted to listeners */
+interface ProgressEvent {
+    type: string;
+    agentId: string;
+    preset: string;
+    timestamp: number;
+    [key: string]: unknown;
+}
+/** File cache entry */
+interface FileCacheEntry {
+    relativePath: string;
+    content?: string;
+    name?: string;
+}
+interface RuntimeConfig {
+    id?: string;
+    presetName?: string;
+    aiProvider: import('../../external/ai/AiProvider.js').AiProvider;
+    toolRegistry: import('./tools/ToolRegistry.js').ToolRegistry;
+    container?: Record<string, unknown> | null;
+    capabilities?: Capability[];
+    strategy: import('./strategies.js').Strategy;
+    policies?: PolicyEngine;
+    persona?: Record<string, unknown>;
+    memory?: Record<string, unknown>;
+    onProgress?: ((event: ProgressEvent) => void) | null;
+    onToolCall?: ToolCallHook | null;
+    lang?: string | null;
+    projectRoot?: string;
+    additionalTools?: string[];
+}
+type ToolCallHook = (name: string, args: Record<string, unknown>, result: unknown, iteration: number) => void;
+interface AgentResult {
+    reply: string;
+    toolCalls: ToolCallEntry[];
+    tokenUsage: {
+        input: number;
+        output: number;
+    };
+    iterations: number;
+    durationMs: number;
+    phases?: Record<string, unknown>;
+    state: Record<string, unknown>;
+    qualityWarning?: string;
+    [key: string]: unknown;
+}
+interface ReactLoopOpts {
+    history?: Array<{
+        role: string;
+        content: string;
+    }>;
+    context?: Record<string, unknown>;
+    capabilityOverride?: string[];
+    budgetOverride?: Record<string, unknown>;
+    systemPromptOverride?: string;
+    onToolCall?: ToolCallHook | null;
+    contextWindow?: import('./context/ContextWindow.js').ContextWindow;
+    tracker?: Record<string, unknown>;
+    trace?: Record<string, unknown>;
+    memoryCoordinator?: Record<string, unknown>;
+    sharedState?: Record<string, unknown>;
+    source?: string;
+    toolChoiceOverride?: string | null;
+    [key: string]: unknown;
+}
+/**
+ * @typedef {Object} RuntimeConfig
+ * @property {string} [id] 运行时唯一 ID
+ * @property {string} [presetName] 使用的 Preset 名称 (仅标识)
+ * @property {import('../../external/ai/AiProvider.js').AiProvider} aiProvider - LLM 提供商
+ * @property {import('./tools/ToolRegistry.js').ToolRegistry} toolRegistry 工具注册表
+ * @property {Object} [container] - DI 容器
+ * @property {Capability[]} capabilities 已实例化的 Capability 列表
+ * @property {import('./strategies.js').Strategy} strategy 执行策略
+ * @property {PolicyEngine} policies 策略引擎
+ * @property {Object} [persona] 人格配置
+ * @property {Object} [memory] 记忆配置
+ * @property {Function} [onProgress] 进度回调
+ * @property {Function} [onToolCall] 工具调用通知钩子 (name, args, result, iteration)
+ * @property {string} [lang] 语言偏好
+ * @property {string} [projectRoot] 项目根目录 (传入工具上下文)
+ */
+export declare class AgentRuntime {
+    #private;
+    onToolCall: ToolCallHook | null;
+    /** @type {string} */
+    id: string;
+    /** @type {string} */
+    presetName: string;
+    /** @type {AgentState} */
+    state: AgentState;
+    /** @type {AgentEventBus} */
+    bus: AgentEventBus;
+    /** @type {import('../../external/ai/AiProvider.js').AiProvider} */
+    aiProvider: import("../../external/ai/AiProvider.js").AiProvider;
+    /** @type {import('./tools/ToolRegistry.js').ToolRegistry} */
+    toolRegistry: import("./tools/ToolRegistry.js").ToolRegistry;
+    /** @type {Object} */
+    container: Record<string, unknown> | null;
+    /** @type {Capability[]} */
+    capabilities: Capability[];
+    /** @type {import('./strategies.js').Strategy} */
+    strategy: import("./strategies.js").Strategy;
+    /** @type {PolicyEngine} */
+    policies: PolicyEngine;
+    /** @type {Object} */
+    persona: Record<string, unknown>;
+    /** @type {Object} */
+    memoryConfig: Record<string, unknown>;
+    /** @type {Function|null} */
+    onProgress: ((event: ProgressEvent) => void) | null;
+    /** @type {string|null} */
+    lang: string | null;
+    /** @type {import('winston').Logger} */
+    logger: import("winston").Logger;
+    iterationCount: number;
+    toolCallHistory: ToolCallEntry[];
+    tokenUsage: {
+        input: number;
+        output: number;
+    };
+    startTime: number;
+    /**
+     * @param {RuntimeConfig} config
+     */
+    constructor(config: RuntimeConfig);
+    /**
+     * 执行 Agent — 入口
+     *
+     * @param {import('./AgentMessage.js').AgentMessage} message 统一消息
+     * @param {Object} [opts] 策略特定选项 (如 FanOut 的 items)
+     * @returns {Promise<AgentResult>}
+     *
+     * @typedef {Object} AgentResult
+     * @property {string} reply 最终文本回复
+     * @property {Array} toolCalls 工具调用记录
+     * @property {Object} tokenUsage - Token 用量
+     * @property {number} iterations 循环次数
+     * @property {number} durationMs 执行耗时
+     * @property {Object} [phases] - Pipeline/FanOut 阶段详情
+     * @property {Object} state 状态快照
+     */
+    execute(message: AgentMessage, opts?: Record<string, unknown>): Promise<AgentResult>;
+    /**
+     * 核心 ReAct 循环。Strategy 调用此方法执行实际的 LLM + Tool 交互。
+     *
+     * 引擎级能力通过可选参数注入:
+     *   - contextWindow → 三级递进压缩 + 动态工具结果限额
+     *   - tracker → ExplorationTracker 阶段管理 + Nudge + Graceful exit
+     *   - trace → ActiveContext 推理链记录
+     *   - memoryCoordinator → 缓存/动态提示/观察记录
+     *   - sharedState → 提交去重 { submittedTitles, submittedPatterns }
+     *   - source → 'user' | 'system' (影响错误恢复 + 强制摘要行为)
+     *
+     * 向后兼容: 以上参数均为可选。不提供时退化为原始裸循环。
+     *
+     * @param {string} prompt 用户/系统提示
+     * @param {Object} [opts]
+     * @param {Array} [opts.history] 对话历史
+     * @param {Object} [opts.context] 额外上下文
+     * @param {string[]} [opts.capabilityOverride] 临时覆盖 capability (Pipeline 阶段用)
+     * @param {Object} [opts.budgetOverride] 临时覆盖 budget
+     * @param {string} [opts.systemPromptOverride] 完全覆盖系统提示词 (Bootstrap 阶段专用)
+     * @param {Function} [opts.onToolCall] 本轮独立的工具调用钩子，优先于 runtime 级
+     * @param {import('./context/ContextWindow.js').ContextWindow} [opts.contextWindow] 上下文窗口管理器
+     * @param {Object} [opts.tracker] - ExplorationTracker 实例
+     * @param {Object} [opts.trace] - ActiveContext 实例
+     * @param {Object} [opts.memoryCoordinator] - MemoryCoordinator 实例
+     * @param {Object} [opts.sharedState] 共享状态 { submittedTitles, submittedPatterns }
+     * @param {string} [opts.source] - 'user' | 'system'
+     * @param {string} [opts.toolChoiceOverride] 首轮 toolChoice 覆盖 ('required'/'auto'/'none')
+     *   首轮强制 LLM 生成 tool call（LLM 自行决定调哪个工具、传什么参数）。
+     *   这不是替 LLM 做决定，而是告诉 LLM "你必须调用某个工具"。
+     *   仅在第一轮生效，后续轮次恢复正常 toolChoice 逻辑。
+     * @returns {Promise<AgentResult>}
+     */
+    reactLoop(prompt: string, opts?: ReactLoopOpts): Promise<{
+        reply: string;
+        toolCalls: any[];
+        tokenUsage: {
+            input: number;
+            output: number;
+        };
+        iterations: number;
+    }>;
+    /**
+     * 中止执行
+     */
+    abort(reason?: string): void;
+    /**
+     * 注入内存文件缓存（bootstrap 场景: allFiles 已在内存中，避免重复磁盘读取）
+     * @param {Array|null} files - [{ relativePath, content, name }]
+     */
+    setFileCache(files: FileCacheEntry[] | null): void;
+    /** 项目根目录 (供 ToolExecutionPipeline 等访问) */
+    get projectRoot(): string;
+    /** 文件缓存 (供 ToolExecutionPipeline 等访问) */
+    get fileCache(): FileCacheEntry[] | null;
+    /**
+     * 发送进度事件 (公开方法，供 ToolExecutionPipeline 中间件调用)
+     */
+    emitProgress(type: string, data?: Record<string, unknown>): void;
+}
+export default AgentRuntime;
+//# sourceMappingURL=AgentRuntime.d.ts.map

package/dist/lib/service/agent/AgentRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRuntime.d.ts","sourceRoot":"","sources":["../../../../lib/service/agent/AgentRuntime.ts"],"names":[],"mappings":"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"}