@cicctencent/agent-core 0.1.1

package/dist/skill/manager.d.ts

@@ -0,0 +1,95 @@
+import type { Skill, SkillManifest, SkillSource } from './types.ts';
+/** 懒加载配置 */
+interface LazyLoadConfig {
+    /** content LRU 缓存容量（默认 30） */
+    cacheSize?: number;
+    /** 是否在启动时就加载 content（false=懒加载，默认 true 保持向后兼容） */
+    lazy?: boolean;
+}
+export declare class SkillManager {
+    /** 轻量清单索引（仅 front matter，不含 content） */
+    private manifests;
+    /** content LRU 缓存（懒加载时按需填充） */
+    private contentCache;
+    /** 是否启用懒加载 */
+    private lazy;
+    /** 记录加载的目录，用于 reload */
+    private loadedDirs;
+    constructor(config?: LazyLoadConfig);
+    /**
+     * 将连接器 ID 和 Skill ID 拼接为内部存储 key
+     * 格式：`{connectorId}__{skillId}`
+     */
+    static connectorSkillKey(connectorId: string, skillId: string): string;
+    /**
+     * 拆分连接器 Skill key，返回 [connectorId, skillId]，无连接器则返回 null
+     */
+    static splitConnectorSkillKey(key: string): [string, string] | null;
+    /**
+     * 从目录加载 Skill 文件
+     *
+     * - lazy=true：仅解析 front matter（manifest），不读 content，毫秒级完成
+     * - lazy=false（默认）：全量读取，保持向后兼容
+     */
+    loadFromDir(dir: string, source: SkillSource, connectorId?: string): void;
+    /** 手动注册 Skill（全量，含 content） */
+    register(skill: Skill): void;
+    /** 注销 Skill */
+    unregister(id: string): void;
+    /**
+     * 获取指定 Skill（含 content）
+     *
+     * - 缓存命中：直接返回
+     * - 缓存未命中 + 有 filePath：从磁盘懒加载 content
+     * - 缓存未命中 + 无 filePath：返回空 content（仅 manifest）
+     */
+    get(id: string): Skill | undefined;
+    /**
+     * 获取 Skill 清单（不含 content，用于路由目录构建和 UI 展示）
+     */
+    getManifest(id: string): SkillManifest | undefined;
+    /**
+     * 获取所有 Skill 清单（不含 content）
+     * 适用于 SkillRouter 构建路由目录、Engine 构建 skill catalog、UI 列表展示
+     */
+    getAllManifests(): SkillManifest[];
+    /** 获取所有已注册 Skill（含 content，触发懒加载） */
+    getAll(): Skill[];
+    /** 按标签过滤 */
+    getByTag(tag: string): Skill[];
+    /** 检查某个目录是否已在加载列表中 */
+    hasLoadedDir(dir: string): boolean;
+    /** 获取缓存统计信息 */
+    getCacheStats(): {
+        manifestCount: number;
+        cachedContentCount: number;
+        lazyMode: boolean;
+    };
+    /** 重新加载（文件变更后刷新） */
+    reload(): void;
+    /**
+     * 从磁盘懒加载 content
+     * 支持 Markdown 文件（含 front matter）和纯文本
+     */
+    private loadContent;
+    /**
+     * 预加载引用的 Skills（referencedSkills）
+     * 当某个 Skill 被加载时，自动加载它引用的其他 Skills
+     */
+    private preloadReferencedSkills;
+    /** 从 Skill 对象提取清单（剥离 content） */
+    private toManifest;
+    /**
+     * 仅解析 front matter（不读 content），用于懒加载模式
+     * 通过读取文件前 N 字节提取 YAML front matter，避免加载整个文件
+     */
+    private parseManifest;
+    /** 解析完整的 Markdown 文件（含 content），用于兼容模式 */
+    private parse;
+    /** 解析 referenced_skills 字段 */
+    private parseReferencedSkills;
+    private extractField;
+    private parseTags;
+}
+export {};
+//# sourceMappingURL=manager.d.ts.map

package/dist/skill/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/skill/manager.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAiDpE,YAAY;AACZ,UAAU,cAAc;IACtB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,qBAAa,YAAY;IACvB,wCAAwC;IACxC,OAAO,CAAC,SAAS,CAAoC;IACrD,+BAA+B;IAC/B,OAAO,CAAC,YAAY,CAAmB;IACvC,cAAc;IACd,OAAO,CAAC,IAAI,CAAU;IACtB,wBAAwB;IACxB,OAAO,CAAC,UAAU,CAAyE;gBAE/E,MAAM,CAAC,EAAE,cAAc;IAKnC;;;OAGG;IACH,MAAM,CAAC,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAItE;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAMnE;;;;;OAKG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAqCzE,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAO5B,eAAe;IACf,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK5B;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAkBlC;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIlD;;;OAGG;IACH,eAAe,IAAI,aAAa,EAAE;IAIlC,qCAAqC;IACrC,MAAM,IAAI,KAAK,EAAE;IAIjB,YAAY;IACZ,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,EAAE;IAM9B,sBAAsB;IACtB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAYlC,eAAe;IACf,aAAa,IAAI;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE;IAQzF,oBAAoB;IACpB,MAAM,IAAI,IAAI;IAYd;;;OAGG;IACH,OAAO,CAAC,WAAW;IAiBnB;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAe/B,iCAAiC;IACjC,OAAO,CAAC,UAAU;IASlB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAyDrB,0CAA0C;IAC1C,OAAO,CAAC,KAAK;IA8Cb,8BAA8B;IAC9B,OAAO,CAAC,qBAAqB;IAM7B,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,SAAS;CASlB"}

package/dist/skill/router.d.ts

@@ -0,0 +1,26 @@
+import type { RouteResult, RouteStrategy } from './types.ts';
+import type { SkillManager } from './manager.ts';
+export declare class SkillRouter {
+    private strategies;
+    private skillManager;
+    constructor(skillManager: SkillManager);
+    /**
+     * 路由：自定义策略 → 显式调用 → 关键词匹配
+     * 命中即停，全部未命中返回 { skill: null }（由 Engine 注入 skill catalog，Agent 自主调用 load_skill）
+     */
+    route(message: string): Promise<RouteResult>;
+    /** 注册自定义路由策略（优先级高于内置三级路由） */
+    addStrategy(strategy: RouteStrategy): void;
+    /** 移除自定义策略 */
+    removeStrategy(name: string): void;
+    private matchExplicit;
+    /**
+     * 获取 Skill 在 SkillManager 中的存储 key
+     * 通过 metadata.connectorId 判断是否为连接器 Skill
+     */
+    private getSkillStorageKey;
+    /** 获取 Manifest 在 SkillManager 中的存储 key（同 getSkillStorageKey，但用 manifest 类型） */
+    private getManifestStorageKey;
+    private matchByKeywords;
+}
+//# sourceMappingURL=router.d.ts.map

package/dist/skill/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/skill/router.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAwB,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACnF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,qBAAa,WAAW;IACtB,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,YAAY,CAAe;gBAEvB,YAAY,EAAE,YAAY;IAItC;;;OAGG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA0BlD,6BAA6B;IAC7B,WAAW,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAI1C,cAAc;IACd,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMlC,OAAO,CAAC,aAAa;IA+CrB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAK1B,+EAA+E;IAC/E,OAAO,CAAC,qBAAqB;IAO7B,OAAO,CAAC,eAAe;CAgCxB"}

package/dist/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/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/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/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/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/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/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/tool/types.d.ts.map

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

package/dist/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/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/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/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"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@cicctencent/agent-core",
+  "version": "0.1.1",
+  "description": "Core engine for AI agent — LLM orchestration, tool execution, MCP, skill routing, security, and memory pipeline.",
+  "type": "module",
+  "main": "src/index.ts",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./src/index.ts"
+    },
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "default": "./src/*"
+    }
+  },
+  "scripts": {
+    "build": "tsc --emitDeclarationOnly --declaration --noEmit false --outDir dist --allowImportingTsExtensions",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "js-tiktoken": "^1.0.21",
+    "socks-proxy-agent": "^10.0.0",
+    "undici": "^8.4.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.20",
+    "typescript": "~5.8.3"
+  },
+  "peerDependencies": {},
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "src/**/*",
+    "dist/**/*",
+    "README.md",
+    "package.json"
+  ],
+  "license": "MIT"
+}