@cicctencent/agent-core 0.1.1 → 0.1.3

package/dist/esm/skill/router.js.map

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

package/dist/esm/skill/types.d.ts

@@ -0,0 +1,55 @@
+export type SkillSource = 'system' | 'user' | 'remote';
+/**
+ * Skill 轻量清单（仅 front matter，不含 content）
+ * 用于大规模 Skill 库的索引、路由和 UI 展示
+ */
+export interface SkillManifest {
+    /** 唯一标识 */
+    id: string;
+    /** 显示名称 */
+    name: string;
+    /** 功能描述（LLM 路由和 UI 展示用） */
+    description: string;
+    /** 关键词标签（用于关键词路由匹配） */
+    tags: string[];
+    /** 别名/同义词 */
+    aliases: string[];
+    /** 来源 */
+    source: SkillSource;
+    /** 版本号 */
+    version?: string;
+    /** 作者信息 */
+    author?: string;
+    /** 依赖的 MCP 工具名列表 */
+    requires?: string[];
+    /** 引用的其他 Skill ID 列表（懒加载，使用时自动加载） */
+    referencedSkills?: string[];
+    /** 文件路径（懒加载时从此路径读取 content） */
+    filePath?: string;
+    /** content 字符数（预估，用于 UI 展示和预算管理） */
+    contentSize?: number;
+    /** 扩展元数据 */
+    metadata?: Record<string, unknown>;
+}
+export interface Skill extends SkillManifest {
+    /** Skill 正文内容（懒加载时可能为空，需通过 SkillManager.get() 触发加载） */
+    content: string;
+}
+export type MatchType = 'explicit' | 'keyword' | 'custom';
+export interface RouteResult {
+    /** 匹配到的 Skill（null 表示无匹配，使用裸 Agent） */
+    skill: Skill | null;
+    /** 路由后实际传给 Agent 的消息（显式调用时会剥离 /command 前缀） */
+    message: string;
+    /** 匹配方式 */
+    matchType: MatchType;
+    /** 匹配置信度（0-1） */
+    confidence: number;
+}
+/** 自定义路由策略接口 */
+export interface RouteStrategy {
+    name: string;
+    /** 执行路由，返回 RouteResult 或 null（交给下一策略） */
+    match(message: string, skills: Skill[]): Promise<RouteResult | null>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/skill/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/skill/types.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW;IACX,EAAE,EAAE,MAAM,CAAC;IACX,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB;IACvB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,aAAa;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS;IACT,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU;IACV,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,qCAAqC;IACrC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,KAAM,SAAQ,aAAa;IAC1C,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE1D,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,SAAS,EAAE,SAAS,CAAC;IACrB,iBAAiB;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,gBAAgB;AAChB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CACtE"}

package/dist/esm/skill/types.js

@@ -0,0 +1,5 @@
+// ============================================================
+// Skill System 类型定义
+// ============================================================
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/skill/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/skill/types.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,oBAAoB;AACpB,+DAA+D"}

package/dist/esm/tool/delegate.d.ts

@@ -0,0 +1,34 @@
+import type { RegisteredTool, ToolContext } from './types.ts';
+import type { StructuredAgentOutput, WorkflowRole } from '../agent/workflow.ts';
+/**
+ * 子 Agent 执行器接口
+ * 由上层（agent.service.ts）实现，Core 层只定义接口
+ */
+export interface SubAgentRunOptions {
+    role?: WorkflowRole | string;
+    structured?: boolean;
+}
+export interface SubAgentRunResult {
+    content: string;
+    structured?: StructuredAgentOutput;
+}
+export type SubAgentRunResponse = string | SubAgentRunResult;
+export interface SubAgentRunner {
+    /** 子 Agent 的标识名（用于 LLM 选择） */
+    name: string;
+    /** 子 Agent 的领域描述（用于 LLM 理解其能力） */
+    description: string;
+    /** 执行子任务，返回结果文本或结构化结果 */
+    run(task: string, context: ToolContext, options?: SubAgentRunOptions): Promise<SubAgentRunResponse>;
+}
+/**
+ * 创建 delegate_task 工具
+ *
+ * 根据可用的子 Agent 列表动态生成工具定义：
+ * - LLM 会看到所有子 Agent 的 name + description，据此选择分发目标
+ * - executor 根据 LLM 选择的 agent name 调用对应的 SubAgentRunner
+ *
+ * @param runners 可用的子 Agent 列表（由上层注入）
+ */
+export declare function createDelegateTool(runners: SubAgentRunner[]): RegisteredTool | null;
+//# sourceMappingURL=delegate.d.ts.map

package/dist/esm/tool/delegate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegate.d.ts","sourceRoot":"","sources":["../../../src/tool/delegate.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEhF;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,qBAAqB,CAAC;CACpC;AAED,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,iBAAiB,CAAC;AAE7D,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACrG;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,cAAc,GAAG,IAAI,CA+DnF"}

package/dist/esm/tool/delegate.js

@@ -0,0 +1,75 @@
+// ============================================================
+// DelegateTool — 任务分发工具（默认 Agent 将子任务委托给专业 Agent）
+// ============================================================
+/**
+ * 创建 delegate_task 工具
+ *
+ * 根据可用的子 Agent 列表动态生成工具定义：
+ * - LLM 会看到所有子 Agent 的 name + description，据此选择分发目标
+ * - executor 根据 LLM 选择的 agent name 调用对应的 SubAgentRunner
+ *
+ * @param runners 可用的子 Agent 列表（由上层注入）
+ */
+export function createDelegateTool(runners) {
+    if (runners.length === 0)
+        return null;
+    // 动态生成 agent 参数的 enum 和描述
+    const agentOptions = runners.map(r => r.name);
+    const agentDescriptions = runners
+        .map(r => `  - ${r.name}: ${r.description}`)
+        .join('\n');
+    return {
+        definition: {
+            type: 'function',
+            function: {
+                name: 'delegate_task',
+                description: `Delegate a complex task to a specialized agent. Use smart routing: delegate for complex/domain tasks (multi-step analysis, specialized output), handle directly for simple queries (single data point, general chat). Specialists have optimized prompts, curated tools, and domain skills. Available agents:\n${agentDescriptions}`,
+                parameters: {
+                    type: 'object',
+                    properties: {
+                        agent: {
+                            type: 'string',
+                            description: `The specialist agent to delegate to. Available: ${agentOptions.join(', ')}`,
+                            enum: agentOptions,
+                        },
+                        task: {
+                            type: 'string',
+                            description: 'A clear, self-contained description of the subtask. KEEP UNDER 2000 chars. For longer tasks: write details to a file first (write_file), then reference it: "Read task_brief.md and execute..."',
+                        },
+                        role: {
+                            type: 'string',
+                            description: 'Optional workflow role for this delegation, such as researcher, implementer, reviewer, critic, risk_checker, or final_approver',
+                            enum: ['researcher', 'implementer', 'reviewer', 'critic', 'risk_checker', 'final_approver'],
+                        },
+                        structured: {
+                            type: 'boolean',
+                            description: 'Set true when the result should include structured findings, risks, recommendation, confidence, and next_actions',
+                        },
+                    },
+                    required: ['agent', 'task'],
+                },
+            },
+        },
+        executor: async (args, ctx) => {
+            const agentName = args.agent;
+            const task = args.task;
+            const role = args.role;
+            const structured = args.structured === true;
+            const runner = runners.find(r => r.name === agentName);
+            if (!runner) {
+                return `Error: Agent "${agentName}" not found. Available agents: ${agentOptions.join(', ')}`;
+            }
+            try {
+                const result = await runner.run(task, ctx, { role, structured });
+                return typeof result === 'string' ? result : result.content;
+            }
+            catch (err) {
+                return `Error delegating to ${agentName}: ${err.message || err}`;
+            }
+        },
+        category: 'builtin',
+        concurrent: true, // 支持 LLM 同一轮并行调用多个 delegate_task
+        metadata: { type: 'delegate', agentCount: runners.length },
+    };
+}
+//# sourceMappingURL=delegate.js.map

package/dist/esm/tool/delegate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegate.js","sourceRoot":"","sources":["../../../src/tool/delegate.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,kDAAkD;AAClD,+DAA+D;AA8B/D;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAyB;IAC1D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEtC,0BAA0B;IAC1B,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,iBAAiB,GAAG,OAAO;SAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;SAC3C,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;QACL,UAAU,EAAE;YACV,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE;gBACR,IAAI,EAAE,eAAe;gBACrB,WAAW,EAAE,kTAAkT,iBAAiB,EAAE;gBAClV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,mDAAmD,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;4BACzF,IAAI,EAAE,YAAY;yBACnB;wBACD,IAAI,EAAE;4BACJ,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,iMAAiM;yBAC/M;wBACD,IAAI,EAAE;4BACJ,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,gIAAgI;4BAC7I,IAAI,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,EAAE,gBAAgB,CAAC;yBAC5F;wBACD,UAAU,EAAE;4BACV,IAAI,EAAE,SAAS;4BACf,WAAW,EAAE,kHAAkH;yBAChI;qBACF;oBACD,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC;iBAC5B;aACF;SACF;QACD,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAmB,EAAE;YAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAe,CAAC;YACvC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAc,CAAC;YACjC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAyC,CAAC;YAC5D,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,KAAK,IAAI,CAAC;YAE5C,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;YACvD,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO,iBAAiB,SAAS,kCAAkC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/F,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;gBACjE,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;YAC9D,CAAC;YAAC,OAAO,GAAQ,EAAE,CAAC;gBAClB,OAAO,uBAAuB,SAAS,KAAK,GAAG,CAAC,OAAO,IAAI,GAAG,EAAE,CAAC;YACnE,CAAC;QACH,CAAC;QACD,QAAQ,EAAE,SAAS;QACnB,UAAU,EAAE,IAAI,EAAG,iCAAiC;QACpD,QAAQ,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE;KAC3D,CAAC;AACJ,CAAC"}

package/dist/esm/tool/registry.d.ts

@@ -0,0 +1,24 @@
+import type { ToolDefinition, ToolContext, RegisteredTool, ToolCategory } from './types.ts';
+export declare class ToolRegistry {
+    private tools;
+    /** 注册工具 */
+    register(tool: RegisteredTool): void;
+    /** 批量注册 */
+    registerAll(tools: RegisteredTool[]): void;
+    /** 注销工具 */
+    unregister(name: string): void;
+    /** 获取指定工具 */
+    get(name: string): RegisteredTool | undefined;
+    /** 获取所有工具定义（传给 LLM） */
+    getDefinitions(filter?: {
+        category?: ToolCategory;
+        names?: string[];
+    }): ToolDefinition[];
+    /** 执行工具（内部调用，AgentEngine 使用） */
+    execute(name: string, args: Record<string, unknown>, ctx: ToolContext): Promise<string>;
+    /** 列出所有已注册工具名称 */
+    listNames(): string[];
+    /** 检查工具是否存在 */
+    has(name: string): boolean;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/esm/tool/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/tool/registry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAgB,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1G,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAqC;IAElD,WAAW;IACX,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAKpC,WAAW;IACX,WAAW,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,IAAI;IAM1C,WAAW;IACX,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI9B,aAAa;IACb,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI7C,uBAAuB;IACvB,cAAc,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,YAAY,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,cAAc,EAAE;IAcxF,gCAAgC;IAC1B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAM7F,kBAAkB;IAClB,SAAS,IAAI,MAAM,EAAE;IAIrB,eAAe;IACf,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAG3B"}

package/dist/esm/tool/registry.js

@@ -0,0 +1,53 @@
+// ============================================================
+// ToolRegistry — 统一工具注册表
+// ============================================================
+export class ToolRegistry {
+    tools = new Map();
+    /** 注册工具 */
+    register(tool) {
+        const name = tool.definition.function.name;
+        this.tools.set(name, tool);
+    }
+    /** 批量注册 */
+    registerAll(tools) {
+        for (const tool of tools) {
+            this.register(tool);
+        }
+    }
+    /** 注销工具 */
+    unregister(name) {
+        this.tools.delete(name);
+    }
+    /** 获取指定工具 */
+    get(name) {
+        return this.tools.get(name);
+    }
+    /** 获取所有工具定义（传给 LLM） */
+    getDefinitions(filter) {
+        let tools = [...this.tools.values()];
+        if (filter?.category) {
+            tools = tools.filter((t) => t.category === filter.category);
+        }
+        if (filter?.names && filter.names.length > 0) {
+            const nameSet = new Set(filter.names);
+            tools = tools.filter((t) => nameSet.has(t.definition.function.name));
+        }
+        return tools.map((t) => t.definition);
+    }
+    /** 执行工具（内部调用，AgentEngine 使用） */
+    async execute(name, args, ctx) {
+        const tool = this.tools.get(name);
+        if (!tool)
+            throw new Error(`Unknown tool: ${name}`);
+        return tool.executor(args, ctx);
+    }
+    /** 列出所有已注册工具名称 */
+    listNames() {
+        return [...this.tools.keys()];
+    }
+    /** 检查工具是否存在 */
+    has(name) {
+        return this.tools.has(name);
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/esm/tool/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/tool/registry.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,yBAAyB;AACzB,+DAA+D;AAI/D,MAAM,OAAO,YAAY;IACf,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;IAElD,WAAW;IACX,QAAQ,CAAC,IAAoB;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;QAC3C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,WAAW;IACX,WAAW,CAAC,KAAuB;QACjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,WAAW;IACX,UAAU,CAAC,IAAY;QACrB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,aAAa;IACb,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,uBAAuB;IACvB,cAAc,CAAC,MAAsD;QACnE,IAAI,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAErC,IAAI,MAAM,EAAE,QAAQ,EAAE,CAAC;YACrB,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,MAAM,EAAE,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7C,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACtC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QACvE,CAAC;QAED,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC;IAED,gCAAgC;IAChC,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,IAA6B,EAAE,GAAgB;QACzE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAClC,CAAC;IAED,kBAAkB;IAClB,SAAS;QACP,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,eAAe;IACf,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;CACF"}

package/dist/esm/tool/types.d.ts

@@ -0,0 +1,101 @@
+import type { EnvInfo } from '../context/types.ts';
+export interface ToolDefinition {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: 'object';
+            properties: Record<string, {
+                type: string;
+                description: string;
+                enum?: string[];
+                items?: unknown;
+                [key: string]: unknown;
+            }>;
+            required?: string[];
+        };
+    };
+}
+/** Shell 执行器接口（上层提供 SSH / local PTY 实现） */
+export interface ShellExecutor {
+    exec(command: string, timeout?: number): Promise<string>;
+    write(data: string): void;
+    read(lines?: number): string;
+}
+/** 文件系统执行器接口 */
+export interface FileSystemExecutor {
+    readFile(path: string): Promise<string>;
+    /** 读取二进制文件（可选实现，用于 PDF/图片等二进制 Artifact） */
+    readFileBuffer?(path: string): Promise<Buffer>;
+    writeFile(path: string, content: string): Promise<void>;
+    /** 追加内容到文件（文件不存在则创建） */
+    appendFile?(path: string, content: string): Promise<void>;
+    listDir(path: string): Promise<string[]>;
+}
+/** 子 Agent 事件转发回调（由上层 SSE 流注入） */
+export type SubAgentEventEmitter = (event: {
+    /** 父级 delegate_task 的 callId */
+    parentToolCallId: string;
+    /** 子 Agent 名称 */
+    agentName: string;
+    /** 子 Agent 事件类型 */
+    eventType: string;
+    /** 事件数据 */
+    data: Record<string, unknown>;
+}) => void;
+/** Widget 事件发射回调（由上层 SSE 流注入，供 show_widget 工具使用） */
+export type WidgetEventEmitter = (event: {
+    widgetId: string;
+    html: string;
+    title: string;
+    height?: number;
+}) => void;
+/** 文件 Artifact 数据（由 save_artifact 工具生成，前端用于展示/下载） */
+export interface ArtifactData {
+    artifactId: string;
+    filename: string;
+    mimeType: string;
+    size: number;
+    /** HTTP URL 用于下载或预览 */
+    url: string;
+    description?: string;
+}
+/** Artifact 事件发射回调（由上层 SSE 流注入，供 save_artifact 工具使用） */
+export type ArtifactEventEmitter = (artifact: ArtifactData) => void;
+/** 工具执行上下文（由 AgentEngine 注入） */
+export interface ToolContext {
+    sessionId: string;
+    /** Shell 执行能力（上层提供 SSH / local PTY 实现） */
+    shell: ShellExecutor;
+    /** 文件系统操作能力 */
+    fs?: FileSystemExecutor;
+    /** 环境信息 */
+    env?: EnvInfo;
+    /** 中止信号 */
+    abortSignal: AbortSignal;
+    /** 上层注入的自定义能力 */
+    custom?: Record<string, unknown>;
+    /** 子 Agent 事件转发（由 runAgentStream 注入，delegate_task 使用） */
+    emitSubEvent?: SubAgentEventEmitter;
+    /** Widget 事件发射（由 runAgentStream 注入，show_widget 使用） */
+    emitWidget?: WidgetEventEmitter;
+    /** Artifact 事件发射（由 runAgentStream 注入，save_artifact 使用） */
+    emitArtifact?: ArtifactEventEmitter;
+    /** 当前工具调用的 callId（由引擎注入） */
+    currentToolCallId?: string;
+}
+/** 工具执行器签名 */
+export type ToolExecutor = (args: Record<string, unknown>, ctx: ToolContext) => Promise<string>;
+export type ToolCategory = 'builtin' | 'skill' | 'mcp' | 'custom';
+export interface RegisteredTool {
+    definition: ToolDefinition;
+    executor: ToolExecutor;
+    /** 工具分类 */
+    category?: ToolCategory;
+    /** 扩展元数据（如 MCP server name） */
+    metadata?: Record<string, unknown>;
+    /** 是否可与其他工具并行执行（默认 false） */
+    concurrent?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/tool/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tool/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAInD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ,CAAC;YACf,UAAU,EAAE,MAAM,CAChB,MAAM,EACN;gBACE,IAAI,EAAE,MAAM,CAAC;gBACb,WAAW,EAAE,MAAM,CAAC;gBACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;gBAChB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;aACxB,CACF,CAAC;YACF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;SACrB,CAAC;KACH,CAAC;CACH;AAID,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACzD,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9B;AAED,gBAAgB;AAChB,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,2CAA2C;IAC3C,cAAc,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,wBAAwB;IACxB,UAAU,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC1C;AAED,kCAAkC;AAClC,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE;IACzC,gCAAgC;IAChC,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,KAAK,IAAI,CAAC;AAEX,oDAAoD;AACpD,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,KAAK,IAAI,CAAC;AAEX,qDAAqD;AACrD,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wDAAwD;AACxD,MAAM,MAAM,oBAAoB,GAAG,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;AAEpE,gCAAgC;AAChC,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,KAAK,EAAE,aAAa,CAAC;IACrB,eAAe;IACf,EAAE,CAAC,EAAE,kBAAkB,CAAC;IACxB,WAAW;IACX,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,WAAW;IACX,WAAW,EAAE,WAAW,CAAC;IACzB,iBAAiB;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,yDAAyD;IACzD,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,sDAAsD;IACtD,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,0DAA0D;IAC1D,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,4BAA4B;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,cAAc;AACd,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAIhG,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;AAElE,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,cAAc,CAAC;IAC3B,QAAQ,EAAE,YAAY,CAAC;IACvB,WAAW;IACX,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,6BAA6B;IAC7B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB"}

package/dist/esm/tool/types.js

@@ -0,0 +1,5 @@
+// ============================================================
+// Tool Registry 类型定义
+// ============================================================
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/tool/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tool/types.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,qBAAqB;AACrB,+DAA+D"}

package/dist/esm/types.d.ts

@@ -0,0 +1,150 @@
+/** 消息角色 */
+export type MessageRole = 'system' | 'user' | 'assistant' | 'tool';
+/** LLM 发起的工具调用 */
+export interface ToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+/** LLM 消息 */
+export interface Message {
+    role: MessageRole;
+    content: string | null;
+    /** assistant 消息中的工具调用请求 */
+    tool_calls?: ToolCall[];
+    /** tool 消息对应的 tool_call id */
+    tool_call_id?: string;
+    /** assistant 消息的 name 字段 */
+    name?: string;
+    /** 推理/思考内容（DeepSeek R1 等模型） */
+    reasoning_content?: string | null;
+    /** 扩展字段，上层可附加任意元数据 */
+    metadata?: Record<string, unknown>;
+}
+/** 所有事件的公共基座 */
+export interface BaseEvent {
+    /** 事件时间戳（毫秒） */
+    timestamp: number;
+    /** 会话 ID */
+    sessionId: string;
+    /** 扩展字段 */
+    metadata?: Record<string, unknown>;
+}
+/** LLM 正在思考 */
+export interface ThinkingEvent extends BaseEvent {
+    type: 'thinking';
+    /** 推理文本增量（流式逐字推送） */
+    content?: string;
+}
+/** LLM 请求调用工具 */
+export interface ToolCallEvent extends BaseEvent {
+    type: 'tool_call';
+    tool: string;
+    args: Record<string, unknown>;
+    /** 工具调用 ID（用于关联后续的 tool_result） */
+    callId: string;
+}
+/** 工具执行结果 */
+export interface ToolResultEvent extends BaseEvent {
+    type: 'tool_result';
+    tool: string;
+    result: string;
+    /** 是否执行出错 */
+    isError: boolean;
+    /** 执行耗时（毫秒） */
+    duration: number;
+    callId: string;
+}
+/** LLM 输出文本片段（流式） */
+export interface MessageEvent extends BaseEvent {
+    type: 'message';
+    content: string;
+    /** 是否为增量片段（true=追加，false=完整替换） */
+    delta: boolean;
+}
+/** Agent 执行完成 */
+export interface DoneEvent extends BaseEvent {
+    type: 'done';
+    /** 最终回复文本 */
+    content: string;
+    /** 总迭代轮次 */
+    iterations: number;
+    /** LLM token 消耗统计 */
+    usage?: TokenUsage;
+}
+/** Agent 执行出错 */
+export interface ErrorEvent extends BaseEvent {
+    type: 'error';
+    error: string;
+    /** 是否可恢复（true 时 Agent 可能自动重试） */
+    recoverable: boolean;
+}
+/** Steering 消息注入事件（实时转向） */
+export interface SteeringEvent extends BaseEvent {
+    type: 'steering';
+    /** 注入的 steering 消息列表 */
+    messages: string[];
+    /** 注入的消息数量 */
+    count: number;
+}
+/** LLM 调用重试事件（模型韧性） */
+export interface RetryEvent extends BaseEvent {
+    type: 'retry';
+    /** 当前重试次数（从 1 开始） */
+    attempt: number;
+    /** 最大重试次数 */
+    maxRetries: number;
+    /** 本次重试等待时间（毫秒） */
+    delay: number;
+    /** 失败原因 */
+    error: string;
+    /** 当前使用的 Provider 标识 */
+    provider: string;
+}
+/** Agent 执行事件（discriminated union） */
+export type AgentEvent = ThinkingEvent | ToolCallEvent | ToolResultEvent | MessageEvent | DoneEvent | ErrorEvent | SteeringEvent | RetryEvent;
+/** Token 消耗统计 */
+export interface TokenUsage {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+}
+/** 工具调用记录（审计用） */
+export interface ToolCallRecord {
+    callId: string;
+    tool: string;
+    args: Record<string, unknown>;
+    result: string;
+    isError: boolean;
+    duration: number;
+    timestamp: number;
+}
+/** Agent 执行最终结果 */
+export interface AgentResult {
+    status: 'completed' | 'aborted' | 'max_iterations' | 'error';
+    /** 最终回复内容 */
+    content: string;
+    /** 总迭代轮次 */
+    iterations: number;
+    /** 累计 token 消耗 */
+    usage?: TokenUsage;
+    /** 执行过程中的工具调用记录 */
+    toolCalls: ToolCallRecord[];
+    /** 总耗时（毫秒） */
+    duration: number;
+}
+export type AgentStatus = 'idle' | 'thinking' | 'executing_tool' | 'streaming' | 'aborting';
+/** 会话上下文（上层构建，传给 Core） */
+export interface SessionContext {
+    sessionId: string;
+    /** 环境信息（EnvCollector 采集结果） */
+    env?: import('./context/types.ts').EnvInfo;
+    /** 终端当前输出（最近 N 行） */
+    terminalOutput?: string;
+    /** 自定义上下文（上层注入的任意数据） */
+    custom?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/types.d.ts.map

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

package/dist/esm/types.js

@@ -0,0 +1,5 @@
+// ============================================================
+// Core 全局共享类型
+// ============================================================
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,cAAc;AACd,+DAA+D"}

package/dist/esm/utils/token-counter.d.ts

@@ -0,0 +1,22 @@
+import type { Message } from '../types.ts';
+/**
+ * 计算文本的 token 数量（带 LRU 缓存）
+ * @param text 输入文本
+ * @returns token 数量
+ */
+export declare function countTokens(text: string): number;
+/**
+ * 计算消息数组的总 token 数量（含 overhead）
+ * 每条消息有约 4 token 的 overhead（role 等元数据）
+ * @param messages 消息列表
+ * @returns 总 token 数量
+ */
+export declare function countMessageTokens(messages: Message[]): number;
+/**
+ * 估算文本 token 数（快速估算，不加载 tiktoken）
+ * 适用于对精度要求不高的场景，约 4 字符 = 1 token
+ * @param text 输入文本
+ * @returns 估算 token 数量
+ */
+export declare function estimateTokens(text: string): number;
+//# sourceMappingURL=token-counter.d.ts.map

package/dist/esm/utils/token-counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-counter.d.ts","sourceRoot":"","sources":["../../../src/utils/token-counter.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AA6B3C;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAuBhD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CA0B9D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGnD"}