autosnippet 3.2.9 → 3.2.11

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

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

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

@@ -0,0 +1,208 @@
+/**
+ * Strategies — Agent 执行策略
+ *
+ * 核心思想: "如何组织工作" 与 "能做什么" 正交。
+ *
+ * 四种策略:
+ *   1. SingleStrategy   — 单次 ReAct 循环 (最简单，用于对话)
+ *   2. PipelineStrategy — 顺序多阶段 + 质量门控 (分析→提交)
+ *   3. FanOutStrategy   — 并行执行 + 合并 (多维度冷启动)
+ *   4. AdaptiveStrategy — 运行时自动选择策略 (智能模式)
+ *
+ * 这就是为什么 "冷启动" 和 "扫描" 产出一致:
+ *   - 冷启动 = FanOut(items=dimensions, itemStrategy=Pipeline(analyze→gate→produce))
+ *   - 扫描   = Pipeline(analyze→gate→produce)
+ *   - 唯一区别: 作用域 (全项目 vs 单目录) 和并行度
+ *
+ * 借鉴:
+ *   - Anthropic: Prompt Chaining, Parallelization, Orchestrator-Worker
+ *   - LangGraph: StateGraph, parallel branches
+ *   - AutoGen: Sequential/Parallel teams
+ *
+ * @module strategies
+ */
+import { AgentMessage } from './AgentMessage.js';
+/** Minimal runtime interface used by strategies (avoids circular import with AgentRuntime) */
+interface StrategyRuntime {
+    id: string;
+    reactLoop(prompt: string, opts?: Record<string, unknown>): Promise<StrategyResult>;
+}
+/** Strategy execution result */
+interface StrategyResult {
+    reply: string;
+    toolCalls: Array<Record<string, unknown>>;
+    tokenUsage: {
+        input: number;
+        output: number;
+    };
+    iterations: number;
+    [key: string]: unknown;
+}
+/** Fan-out sub-task item descriptor */
+interface FanOutItem {
+    id: string;
+    label: string;
+    tier?: number;
+    prompt?: string;
+    guide?: string;
+}
+/** Result of a single fan-out item execution */
+interface ItemResult {
+    id: string;
+    label: string;
+    status: 'completed' | 'failed';
+    reply: string;
+    toolCalls: Array<Record<string, unknown>>;
+    tokenUsage: {
+        input: number;
+        output: number;
+    };
+    iterations?: number;
+    error?: string;
+    [key: string]: unknown;
+}
+/** FanOutStrategy constructor options */
+interface FanOutOpts {
+    itemStrategy?: Strategy;
+    tiers?: Record<string, {
+        concurrency: number;
+    }>;
+    merge?: (results: ItemResult[]) => StrategyResult;
+}
+/** Options passed to FanOutStrategy.execute */
+interface FanOutExecuteOpts {
+    items?: FanOutItem[];
+    dimension?: FanOutItem;
+    [key: string]: unknown;
+}
+/** AdaptiveStrategy constructor options */
+interface AdaptiveStrategies {
+    single?: Strategy;
+    pipeline?: Strategy;
+    fanOut?: Strategy;
+}
+/** Options for strategy execution with routing context */
+interface StrategyExecuteOpts {
+    items?: FanOutItem[];
+    [key: string]: unknown;
+}
+/**
+ * Strategy 基类 — 定义 Agent 如何组织工作
+ */
+export declare class Strategy {
+    /** @type {string} */
+    get name(): string;
+    /**
+     * 执行策略
+     *
+     * @param {Object} _runtime - AgentRuntime 实例
+     * @param {import('./AgentMessage.js').AgentMessage} _message 输入消息
+     * @param {Object} [_opts] 策略特定选项
+     * @returns {Promise<StrategyResult>}
+     *
+     * @typedef {Object} StrategyResult
+     * @property {string} reply 最终文本回复
+     * @property {Array} toolCalls 所有工具调用记录
+     * @property {Object} tokenUsage - Token 统计
+     * @property {number} iterations 总循环次数
+     * @property {Object} [phases] 阶段详情 (Pipeline/FanOut)
+     */
+    execute(_runtime: StrategyRuntime, _message: AgentMessage, _opts?: Record<string, unknown>): Promise<StrategyResult>;
+}
+/**
+ * 最简单的策略: 直接运行 ReAct 循环。
+ *
+ * 适合: 用户对话、简单分析、任何单步骤任务。
+ *
+ * 等价于 Anthropic 的 "Augmented LLM" 模式。
+ */
+export declare class SingleStrategy extends Strategy {
+    get name(): string;
+    execute(runtime: StrategyRuntime, message: AgentMessage, opts?: Record<string, unknown>): Promise<StrategyResult>;
+}
+/**
+ * 并行执行多个子任务，每个子任务使用 itemStrategy (通常是 Pipeline)。
+ * 支持分层并发控制 (Tier)。
+ *
+ * 适合: 冷启动多维度、批量分析
+ *
+ * 等价于 Anthropic 的 "Parallelization" + "Orchestrator-Worker" 组合。
+ *
+ * @example
+ * new FanOutStrategy({
+ *   itemStrategy: new PipelineStrategy({
+ *     stages: [
+ *       { name: 'analyze', capabilities: ['code_analysis'], budget: { maxIterations: 24 } },
+ *       { name: 'gate', gate: { minEvidenceLength: 500, minFileRefs: 3 } },
+ *       { name: 'produce', capabilities: ['knowledge_production'], budget: { maxIterations: 24 },
+ *         promptTransform: (_, prev) => `将以下分析转为知识候选:\n${prev.analyze.reply}` },
+ *     ],
+ *   }),
+ *   tiers: { 1: { concurrency: 3 }, 2: { concurrency: 2 }, 3: { concurrency: 1 } },
+ * })
+ */
+export declare class FanOutStrategy extends Strategy {
+    #private;
+    /**
+     * @param {Object} opts
+     * @param {Strategy} opts.itemStrategy 每个子任务使用的策略
+     * @param {Object} [opts.tiers] - { 1: { concurrency: 3 }, 2: { concurrency: 2 }, ... }
+     * @param {Function} [opts.merge] 自定义合并函数 (results[]) => finalResult
+     */
+    constructor({ itemStrategy, tiers, merge }?: FanOutOpts);
+    get name(): string;
+    /**
+     * @param {Object} runtime
+     * @param {import('./AgentMessage.js').AgentMessage} message
+     * @param {Object} opts
+     * @param {Array<{id: string, label: string, tier?: number, prompt?: string, guide?: string}>} opts.items 子任务列表
+     */
+    execute(runtime: StrategyRuntime, message: AgentMessage, opts?: FanOutExecuteOpts): Promise<StrategyResult>;
+}
+/**
+ * 根据输入复杂度自动选择合适的策略。
+ *
+ * 判断逻辑:
+ *   - 简单问答 → SingleStrategy
+ *   - 单模块深度分析 → PipelineStrategy
+ *   - 多维度/全项目 → FanOutStrategy
+ *
+ * 等价于 LangGraph 的 Router 节点 + 条件边。
+ *
+ * @example
+ * new AdaptiveStrategy({
+ *   single: new SingleStrategy(),
+ *   pipeline: new PipelineStrategy({ stages: [...] }),
+ *   fanOut: new FanOutStrategy({ itemStrategy: ..., tiers: ... }),
+ * })
+ */
+export declare class AdaptiveStrategy extends Strategy {
+    #private;
+    /**
+     * @param {Object} [strategies]
+     * @param {Strategy} [strategies.single]
+     * @param {Strategy} [strategies.pipeline]
+     * @param {Strategy} [strategies.fanOut]
+     */
+    constructor(strategies?: AdaptiveStrategies);
+    get name(): string;
+    execute(runtime: StrategyRuntime, message: AgentMessage, opts?: StrategyExecuteOpts): Promise<StrategyResult>;
+}
+export declare const StrategyRegistry: {
+    _registry: Map<string, typeof Strategy>;
+    create(name: string, opts?: Record<string, unknown>): Strategy;
+    register(name: string, cls: typeof Strategy): void;
+};
+declare const _default: {
+    Strategy: typeof Strategy;
+    SingleStrategy: typeof SingleStrategy;
+    FanOutStrategy: typeof FanOutStrategy;
+    AdaptiveStrategy: typeof AdaptiveStrategy;
+    StrategyRegistry: {
+        _registry: Map<string, typeof Strategy>;
+        create(name: string, opts?: Record<string, unknown>): Strategy;
+        register(name: string, cls: typeof Strategy): void;
+    };
+};
+export default _default;
+//# sourceMappingURL=strategies.d.ts.map

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

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

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

@@ -0,0 +1,316 @@
+/**
+ * Strategies — Agent 执行策略
+ *
+ * 核心思想: "如何组织工作" 与 "能做什么" 正交。
+ *
+ * 四种策略:
+ *   1. SingleStrategy   — 单次 ReAct 循环 (最简单，用于对话)
+ *   2. PipelineStrategy — 顺序多阶段 + 质量门控 (分析→提交)
+ *   3. FanOutStrategy   — 并行执行 + 合并 (多维度冷启动)
+ *   4. AdaptiveStrategy — 运行时自动选择策略 (智能模式)
+ *
+ * 这就是为什么 "冷启动" 和 "扫描" 产出一致:
+ *   - 冷启动 = FanOut(items=dimensions, itemStrategy=Pipeline(analyze→gate→produce))
+ *   - 扫描   = Pipeline(analyze→gate→produce)
+ *   - 唯一区别: 作用域 (全项目 vs 单目录) 和并行度
+ *
+ * 借鉴:
+ *   - Anthropic: Prompt Chaining, Parallelization, Orchestrator-Worker
+ *   - LangGraph: StateGraph, parallel branches
+ *   - AutoGen: Sequential/Parallel teams
+ *
+ * @module strategies
+ */
+import { createLimit } from '#shared/concurrency.js';
+import { AgentEventBus, AgentEvents } from './AgentEventBus.js';
+import { AgentMessage } from './AgentMessage.js';
+// ─── Base Strategy ─────────────────────────────
+/**
+ * Strategy 基类 — 定义 Agent 如何组织工作
+ */
+export class Strategy {
+    /** @type {string} */
+    get name() {
+        throw new Error('Subclass must implement name');
+    }
+    /**
+     * 执行策略
+     *
+     * @param {Object} _runtime - AgentRuntime 实例
+     * @param {import('./AgentMessage.js').AgentMessage} _message 输入消息
+     * @param {Object} [_opts] 策略特定选项
+     * @returns {Promise<StrategyResult>}
+     *
+     * @typedef {Object} StrategyResult
+     * @property {string} reply 最终文本回复
+     * @property {Array} toolCalls 所有工具调用记录
+     * @property {Object} tokenUsage - Token 统计
+     * @property {number} iterations 总循环次数
+     * @property {Object} [phases] 阶段详情 (Pipeline/FanOut)
+     */
+    async execute(_runtime, _message, _opts) {
+        throw new Error('Subclass must implement execute()');
+    }
+}
+// PipelineStrategy 已提取到独立模块: ./PipelineStrategy.js
+// 注意: 不在此处 re-export，因为 PipelineStrategy 需要 import Strategy 形成循环依赖
+// ─── SingleStrategy — 直接 ReAct ─────────────
+/**
+ * 最简单的策略: 直接运行 ReAct 循环。
+ *
+ * 适合: 用户对话、简单分析、任何单步骤任务。
+ *
+ * 等价于 Anthropic 的 "Augmented LLM" 模式。
+ */
+export class SingleStrategy extends Strategy {
+    get name() {
+        return 'single';
+    }
+    async execute(runtime, message, opts = {}) {
+        return runtime.reactLoop(message.content, {
+            history: message.history,
+            context: message.metadata.context || {},
+            ...opts,
+        });
+    }
+}
+// ─── FanOutStrategy — 并行执行 ──────────────
+/**
+ * 并行执行多个子任务，每个子任务使用 itemStrategy (通常是 Pipeline)。
+ * 支持分层并发控制 (Tier)。
+ *
+ * 适合: 冷启动多维度、批量分析
+ *
+ * 等价于 Anthropic 的 "Parallelization" + "Orchestrator-Worker" 组合。
+ *
+ * @example
+ * new FanOutStrategy({
+ *   itemStrategy: new PipelineStrategy({
+ *     stages: [
+ *       { name: 'analyze', capabilities: ['code_analysis'], budget: { maxIterations: 24 } },
+ *       { name: 'gate', gate: { minEvidenceLength: 500, minFileRefs: 3 } },
+ *       { name: 'produce', capabilities: ['knowledge_production'], budget: { maxIterations: 24 },
+ *         promptTransform: (_, prev) => `将以下分析转为知识候选:\n${prev.analyze.reply}` },
+ *     ],
+ *   }),
+ *   tiers: { 1: { concurrency: 3 }, 2: { concurrency: 2 }, 3: { concurrency: 1 } },
+ * })
+ */
+export class FanOutStrategy extends Strategy {
+    /** @type {Strategy} 每个子任务的执行策略 */
+    #itemStrategy;
+    /** @type {Record<string, { concurrency: number }>} 分层并发配置 */
+    #tiers;
+    /** @type {(results: ItemResult[]) => StrategyResult} 结果合并函数 */
+    #merge;
+    /**
+     * @param {Object} opts
+     * @param {Strategy} opts.itemStrategy 每个子任务使用的策略
+     * @param {Object} [opts.tiers] - { 1: { concurrency: 3 }, 2: { concurrency: 2 }, ... }
+     * @param {Function} [opts.merge] 自定义合并函数 (results[]) => finalResult
+     */
+    constructor({ itemStrategy, tiers, merge } = {}) {
+        super();
+        this.#itemStrategy = itemStrategy || new SingleStrategy();
+        this.#tiers = tiers || { 1: { concurrency: 3 } };
+        this.#merge = merge || FanOutStrategy.#defaultMerge;
+    }
+    get name() {
+        return 'fan_out';
+    }
+    /**
+     * @param {Object} runtime
+     * @param {import('./AgentMessage.js').AgentMessage} message
+     * @param {Object} opts
+     * @param {Array<{id: string, label: string, tier?: number, prompt?: string, guide?: string}>} opts.items 子任务列表
+     */
+    async execute(runtime, message, opts = {}) {
+        const { items = [] } = opts;
+        const bus = AgentEventBus.getInstance();
+        if (items.length === 0) {
+            return {
+                reply: 'No items to process',
+                toolCalls: [],
+                tokenUsage: { input: 0, output: 0 },
+                iterations: 0,
+            };
+        }
+        // 按 tier 分组
+        const tierGroups = this.#groupByTier(items);
+        const allResults = [];
+        for (const [tier, tierItems] of Object.entries(tierGroups).sort(([a], [b]) => Number(a) - Number(b))) {
+            const tierConfig = this.#tiers[tier] || this.#tiers[1] || { concurrency: 2 };
+            bus.publish(AgentEvents.PROGRESS, {
+                type: 'fan_out_tier_start',
+                tier: Number(tier),
+                count: tierItems.length,
+                concurrency: tierConfig.concurrency,
+            });
+            // p-limit 并发控制（替代手动 chunk 分批）
+            const limit = createLimit(tierConfig.concurrency);
+            const tierResults = await Promise.all(tierItems.map((item) => limit(async () => {
+                const itemMessage = AgentMessage.internal(item.prompt ||
+                    `${message.content}\n\n## 当前维度: ${item.label}\n${item.guide || ''}`, {
+                    sessionId: message.session.id,
+                    dimension: item.id,
+                    parentAgentId: runtime.id,
+                    history: message.history,
+                    metadata: { ...message.metadata, dimension: item },
+                });
+                bus.publish(AgentEvents.PROGRESS, {
+                    type: 'fan_out_item_start',
+                    itemId: item.id,
+                    label: item.label,
+                });
+                try {
+                    const result = await this.#itemStrategy.execute(runtime, itemMessage, {
+                        dimension: item,
+                    });
+                    return { id: item.id, label: item.label, status: 'completed', ...result };
+                }
+                catch (err) {
+                    return {
+                        id: item.id,
+                        label: item.label,
+                        status: 'failed',
+                        error: err instanceof Error ? err.message : String(err),
+                        reply: '',
+                        toolCalls: [],
+                        tokenUsage: { input: 0, output: 0 },
+                    };
+                }
+            })));
+            allResults.push(...tierResults);
+            bus.publish(AgentEvents.PROGRESS, {
+                type: 'fan_out_tier_done',
+                tier: Number(tier),
+                completed: allResults.filter((r) => r.status === 'completed').length,
+                failed: allResults.filter((r) => r.status === 'failed').length,
+            });
+        }
+        return this.#merge(allResults);
+    }
+    #groupByTier(items) {
+        const groups = {};
+        for (const item of items) {
+            const tier = item.tier || 1;
+            if (!groups[tier]) {
+                groups[tier] = [];
+            }
+            groups[tier].push(item);
+        }
+        return groups;
+    }
+    static #defaultMerge(results) {
+        const successful = results.filter((r) => r.status === 'completed');
+        const failed = results.filter((r) => r.status === 'failed');
+        return {
+            reply: [
+                `## 执行总结\n完成: ${successful.length}, 失败: ${failed.length}\n`,
+                ...successful.map((r) => `### ${r.label}\n${r.reply || '(无输出)'}`),
+                ...failed.map((r) => `### ${r.label} ❌\n${r.error}`),
+            ].join('\n\n'),
+            toolCalls: results.flatMap((r) => r.toolCalls || []),
+            tokenUsage: {
+                input: results.reduce((sum, r) => sum + (r.tokenUsage?.input || 0), 0),
+                output: results.reduce((sum, r) => sum + (r.tokenUsage?.output || 0), 0),
+            },
+            iterations: results.reduce((sum, r) => sum + (r.iterations || 0), 0),
+            itemResults: results,
+        };
+    }
+}
+// ─── AdaptiveStrategy — 智能自适应 ──────────
+/**
+ * 根据输入复杂度自动选择合适的策略。
+ *
+ * 判断逻辑:
+ *   - 简单问答 → SingleStrategy
+ *   - 单模块深度分析 → PipelineStrategy
+ *   - 多维度/全项目 → FanOutStrategy
+ *
+ * 等价于 LangGraph 的 Router 节点 + 条件边。
+ *
+ * @example
+ * new AdaptiveStrategy({
+ *   single: new SingleStrategy(),
+ *   pipeline: new PipelineStrategy({ stages: [...] }),
+ *   fanOut: new FanOutStrategy({ itemStrategy: ..., tiers: ... }),
+ * })
+ */
+export class AdaptiveStrategy extends Strategy {
+    #strategies;
+    /**
+     * @param {Object} [strategies]
+     * @param {Strategy} [strategies.single]
+     * @param {Strategy} [strategies.pipeline]
+     * @param {Strategy} [strategies.fanOut]
+     */
+    constructor(strategies = {}) {
+        super();
+        this.#strategies = {
+            single: strategies.single || new SingleStrategy(),
+            pipeline: strategies.pipeline || null,
+            fanOut: strategies.fanOut || null,
+        };
+    }
+    get name() {
+        return 'adaptive';
+    }
+    async execute(runtime, message, opts = {}) {
+        const complexity = this.#assessComplexity(message, opts);
+        const bus = AgentEventBus.getInstance();
+        bus.publish(AgentEvents.PROGRESS, {
+            type: 'adaptive_classification',
+            complexity,
+            selectedStrategy: complexity,
+        });
+        // fan_out → pipeline → single 降级链
+        if (complexity === 'fan_out' && this.#strategies.fanOut) {
+            return this.#strategies.fanOut.execute(runtime, message, opts);
+        }
+        if ((complexity === 'fan_out' || complexity === 'pipeline') && this.#strategies.pipeline) {
+            return this.#strategies.pipeline.execute(runtime, message, opts);
+        }
+        return this.#strategies.single.execute(runtime, message, opts);
+    }
+    /**
+     * 复杂度评估
+     */
+    #assessComplexity(message, opts) {
+        const text = message.content.toLowerCase();
+        // 有显式 items → fan_out
+        if ((opts.items?.length ?? 0) > 1) {
+            return 'fan_out';
+        }
+        // 关键词启发
+        if (/冷启动|cold[\s-]?start|bootstrap|全项目|所有.*维度|all.*dimensions/i.test(text)) {
+            return 'fan_out';
+        }
+        if (/深度.*分析|扫描|审计|scan|deep.*analy|audit|知识提取|extract/i.test(text)) {
+            return 'pipeline';
+        }
+        return 'single';
+    }
+}
+// ─── Strategy 注册表 ─────────────────────────
+export const StrategyRegistry = {
+    _registry: new Map([
+        ['single', SingleStrategy],
+        // 'pipeline' 由 PipelineStrategy.js 自注册 (避免循环依赖)
+        ['fan_out', FanOutStrategy],
+        ['adaptive', AdaptiveStrategy],
+    ]),
+    create(name, opts = {}) {
+        const Cls = this._registry.get(name);
+        if (!Cls) {
+            throw new Error(`Unknown strategy: ${name}`);
+        }
+        return Reflect.construct(Cls, [opts]);
+    },
+    register(name, cls) {
+        this._registry.set(name, cls);
+    },
+};
+export default { Strategy, SingleStrategy, FanOutStrategy, AdaptiveStrategy, StrategyRegistry };
+//# sourceMappingURL=strategies.js.map

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

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

package/dist/lib/service/agent/tools/ToolRegistry.d.ts

@@ -0,0 +1,68 @@
+/**
+ * ToolRegistry — 统一工具注册表
+ *
+ * 管理 Agent 可调用的所有工具定义。
+ * 每个工具包含: name, description, parameters(JSON Schema), handler
+ *
+ * 设计原则:
+ * - 所有 AI 能力均封装为 Tool，不再散落在各处
+ * - Tool handler 仅做参数整理 + 调用已有 Service，不含业务逻辑
+ * - 支持 Agent ReAct 循环调用（通过 LLM 推理决定工具调用）
+ */
+/** 工具定义输入 */
+interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters?: Record<string, unknown>;
+    handler: Function;
+}
+export declare class ToolRegistry {
+    #private;
+    constructor();
+    /**
+     * 注册一个工具
+     * @param {object} toolDef
+     * @param {string} toolDef.name        工具唯一名称 (snake_case)
+     * @param {string} toolDef.description  给 LLM 看的工具描述
+     * @param {object} toolDef.parameters   - JSON Schema 格式的参数定义
+     * @param {Function} toolDef.handler    - async (params, context) => result
+     */
+    register(toolDef: ToolDefinition): void;
+    /**
+     * 批量注册
+     * @param {Array<object>} defs
+     */
+    registerAll(defs: ToolDefinition[]): void;
+    /**
+     * 获取工具定义（不含 handler，给 LLM prompt 使用）
+     * @param {string[]} [allowedTools] 限制返回的工具列表（不传则返回全部）
+     * @returns {Array<{name: string, description: string, parameters: object}>}
+     */
+    getToolSchemas(allowedTools?: readonly unknown[] | null): {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    }[];
+    /**
+     * 直接执行某个工具
+     * @param {string} name
+     * @param {object} params
+     * @param {object} context - { container, aiProvider, projectRoot, ... }
+     * @returns {Promise<any>}
+     */
+    execute(name: string, params: Record<string, unknown>, context?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * 检查工具是否存在
+     */
+    has(name: string): boolean;
+    /**
+     * 获取所有工具名
+     */
+    getToolNames(): string[];
+    /**
+     * 工具数量
+     */
+    get size(): number;
+}
+export default ToolRegistry;
+//# sourceMappingURL=ToolRegistry.d.ts.map

package/dist/lib/service/agent/tools/ToolRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolRegistry.d.ts","sourceRoot":"","sources":["../../../../../lib/service/agent/tools/ToolRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,aAAa;AACb,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAErC,OAAO,EAAE,QAAQ,CAAC;CACnB;AA+CD,qBAAa,YAAY;;;IAQvB;;;;;;;OAOG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc;IAahC;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,cAAc,EAAE;IAOlC;;;;OAIG;IACH,cAAc,CAAC,YAAY,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI;cAC9B,MAAM;qBAAe,MAAM;oBAAc,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;IAezF;;;;;;OAMG;IACG,OAAO,CACX,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAsFvC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM;IAIhB;;OAEG;IACH,YAAY;IAIZ;;OAEG;IACH,IAAI,IAAI,WAEP;CACF;AAED,eAAe,YAAY,CAAC"}