@cicctencent/agent-core 0.1.1

package/dist/agent/engine.d.ts

@@ -0,0 +1,113 @@
+import type { AgentEvent, AgentStatus, Message } from '../types.ts';
+import type { ToolRegistry } from '../tool/registry.ts';
+import type { AgentConfig, RunOptions } from './types.ts';
+import type { HookEvent, HookContext, HookResult } from '../hooks/types.ts';
+export declare class AgentEngine {
+    private config;
+    /** sessionId → AgentStatus */
+    private statusMap;
+    /** sessionId → AbortController (internal) */
+    private abortMap;
+    /** sessionId → steering messages（实时转向队列） */
+    private steeringMap;
+    /** 子模块：历史管理器 */
+    private historyManager;
+    /** 子模块：LLM 调用器 */
+    private llmCaller;
+    /** 子模块：工具执行器 */
+    private toolExecutor;
+    /** 数据获取类工具集合（用于循环检测） */
+    private dataFetchTools;
+    /** 产出型工具集合（有这些调用时不触发数据获取循环检测） */
+    private outputTools;
+    constructor(config: AgentConfig);
+    /** 获取当前 Agent 的 ToolRegistry（供 read_tool_doc 等内置工具使用） */
+    getToolRegistry(): ToolRegistry;
+    /** 动态调整最大迭代上限（用于子 Agent 场景，避免子任务消耗过多迭代） */
+    setMaxIterations(max: number): void;
+    /** 获取当前 Agent 的 SkillManager（供 load_skill 等内置工具使用，确保 scope 内操作） */
+    getSkillManager(): import('../skill/manager.ts').SkillManager | undefined;
+    /**
+     * 注入会话历史（从外部恢复，如持久化存储）
+     * 用于跨引擎实例保持对话上下文
+     */
+    setHistory(sessionId: string, messages: Message[]): void;
+    /**
+     * 获取会话历史副本（用于持久化保存）
+     */
+    getHistorySnapshot(sessionId: string): Message[];
+    /**
+     * 执行 Agent 任务（流式推送事件）
+     * 上层通过 for-await-of 消费事件流
+     */
+    run(options: RunOptions): AsyncGenerator<AgentEvent>;
+    /** 解析 Skill 路由，返回 Skill 内容、实际消息和路由命中状态 */
+    private resolveSkill;
+    /** 构建初始消息列表（system + history + user） */
+    private buildInitialMessages;
+    /** 获取工具定义列表（含预过滤 + 渐进式发现） */
+    private resolveToolDefs;
+    /** 构建 ToolContext */
+    private buildToolContext;
+    /** 汇总准备阶段，生成 LoopState */
+    private prepareRun;
+    /** 主循环：迭代调用 LLM → 执行工具 → 直到完成或达到上限 */
+    private agentLoop;
+    /**
+     * 向运行中的 Agent 注入 steering 消息
+     * 消息将在下次 LLM 调用前注入对话上下文
+     */
+    steer(sessionId: string, message: string): boolean;
+    /** 消费当前会话的 steering 消息，注入到 messages 中 */
+    private drainSteering;
+    /**
+     * 进度叙述提醒
+     * 当 LLM 连续 2 次迭代仅发出 tool_calls 而无 content 时，注入 user 消息提醒输出进度说明。
+     * 确保用户在对话中有可见的文字输出，而不是所有内容都收在执行步骤中。
+     */
+    private injectProgressNudge;
+    /**
+     * 迭代预算提醒
+     * 当剩余迭代不足 30% 时，注入 user 消息提醒 LLM 停止数据收集、转向完成任务。
+     * 解决 agent 在数据查询循环中耗尽迭代、永远无法进入文档生成/委托阶段的问题。
+     */
+    private injectIterationGuard;
+    /**
+     * 数据获取循环检测 + 连续失败熔断
+     *
+     * 两类触发条件：
+     * 1. 数据获取循环：最近 3+ 条工具调用全部是数据获取类且无产出型工具
+     * 2. 连续失败熔断：最近 5+ 条工具调用中 4+ 条失败，强制停止试错、转向产出
+     */
+    private checkDataFetchLoop;
+    /** 注入数据获取循环/连续失败熔断提示 */
+    private injectDataFetchGuard;
+    /**
+     * 任务继续提示
+     * 当 LLM 在工具调用后提前停止（无新工具调用也无明确总结）时，注入提示让其继续完成剩余任务。
+     * 典型场景：多步委托任务中，第一步数据采集完成后 LLM 未生成后续步骤的 delegate_task。
+     */
+    private injectContinuationNudge;
+    /**
+     * 渐进式结果交付
+     * 当主 Agent 并行分发了多个 delegate_task 后，注入提示让 LLM 逐步呈现每个子任务的结果，
+     * 而不是等所有结果全部返回后才开始输出。减少用户感知等待时间。
+     */
+    private injectProgressiveNudge;
+    /** 执行指定事件类型的所有 Hook */
+    runHooks(event: HookEvent, ctx: HookContext): Promise<HookResult[]>;
+    /** 执行中间件的 before/after 阶段 */
+    private runMiddlewarePhase;
+    /** 执行中间件的 onToolBefore/onToolAfter 阶段 */
+    runMiddlewareToolPhase(phase: 'onToolBefore' | 'onToolAfter', ctx: HookContext): Promise<HookResult[]>;
+    private emitDone;
+    /** 中断指定会话的 Agent 执行 */
+    abort(sessionId: string): void;
+    /** 查询指定会话的 Agent 状态 */
+    getStatus(sessionId: string): AgentStatus;
+    /** 销毁引擎，释放所有会话资源 */
+    destroy(): void;
+    createEvent(sessionId: string, event: Record<string, unknown>): AgentEvent;
+    private createNoopShell;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/agent/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/agent/engine.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAuD,MAAM,aAAa,CAAC;AAGzH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAe,MAAM,YAAY,CAAC;AAEvE,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AA4D5E,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAA4G;IAC1H,8BAA8B;IAC9B,OAAO,CAAC,SAAS,CAAkC;IACnD,6CAA6C;IAC7C,OAAO,CAAC,QAAQ,CAAsC;IACtD,4CAA4C;IAC5C,OAAO,CAAC,WAAW,CAA+B;IAElD,gBAAgB;IAChB,OAAO,CAAC,cAAc,CAAiB;IACvC,kBAAkB;IAClB,OAAO,CAAC,SAAS,CAAY;IAC7B,gBAAgB;IAChB,OAAO,CAAC,YAAY,CAAoB;IAExC,wBAAwB;IACxB,OAAO,CAAC,cAAc,CAAc;IACpC,iCAAiC;IACjC,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,EAAE,WAAW;IAiD/B,yDAAyD;IACzD,eAAe,IAAI,YAAY;IAI/B,2CAA2C;IAC3C,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAInC,mEAAmE;IACnE,eAAe,IAAI,OAAO,qBAAqB,EAAE,YAAY,GAAG,SAAS;IAIzE;;;OAGG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI;IAIxD;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,EAAE;IAIhD;;;OAGG;IACI,GAAG,CAAC,OAAO,EAAE,UAAU,GAAG,cAAc,CAAC,UAAU,CAAC;IAoC3D,0CAA0C;YAC5B,YAAY;IAe1B,wCAAwC;IACxC,OAAO,CAAC,oBAAoB;IAoD5B,6BAA6B;IAC7B,OAAO,CAAC,eAAe;IAyCvB,qBAAqB;IACrB,OAAO,CAAC,gBAAgB;IAmBxB,0BAA0B;YACZ,UAAU;IAyBxB,sCAAsC;YACvB,SAAS;IAgJxB;;;OAGG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IASlD,yCAAyC;IACzC,OAAO,CAAC,aAAa;IAgBrB;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAoB3B;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAuC5B;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;IAiC1B,wBAAwB;IACxB,OAAO,CAAC,oBAAoB;IAsC5B;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;IAuB/B;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IA2B9B,uBAAuB;IACjB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAkBzE,6BAA6B;YACf,kBAAkB;IAwBhC,yCAAyC;IACnC,sBAAsB,CAAC,KAAK,EAAE,cAAc,GAAG,aAAa,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAqB5G,OAAO,CAAC,QAAQ;IAkBhB,uBAAuB;IACvB,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAQ9B,uBAAuB;IACvB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW;IAIzC,oBAAoB;IACpB,OAAO,IAAI,IAAI;IAYf,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU;IAI1E,OAAO,CAAC,eAAe;CAOxB"}

package/dist/agent/history-manager.d.ts

@@ -0,0 +1,78 @@
+import type { Message } from '../types.ts';
+import type { ToolResultStore } from './types.ts';
+/** 历史管理配置 */
+export interface HistoryManagerConfig {
+    /** 消息历史上限（滑动窗口），默认 50 */
+    maxMessages: number;
+    /** 上下文压缩配置 */
+    contextBudget?: {
+        maxToolOutput?: number;
+        compactThreshold?: number;
+        maxContextTokens?: number;
+    };
+    /** 工具结果存储（可选） */
+    toolResultStore?: ToolResultStore;
+}
+/**
+ * 会话历史管理器
+ *
+ * 职责：
+ * - 维护 per-session 的消息历史（滑动窗口）
+ * - 多级智能压缩（token 感知）
+ * - Offload 大工具结果到外部存储
+ */
+export declare class HistoryManager {
+    private config;
+    /** sessionId → Message[]（会话历史，滑动窗口） */
+    private historyMap;
+    /** sessionId → 当前 token 总数（增量维护，避免全量重算） */
+    private tokenCountMap;
+    constructor(config: HistoryManagerConfig);
+    /** 注入会话历史（从外部恢复，如持久化存储） */
+    setHistory(sessionId: string, messages: Message[]): void;
+    /** 获取会话历史副本（用于持久化保存） */
+    getHistorySnapshot(sessionId: string): Message[];
+    /** 获取会话历史副本（用于构建 LLM 请求） */
+    getHistory(sessionId: string): Message[];
+    /** 追加消息到会话历史（含自动压缩） */
+    addHistory(sessionId: string, msg: Message): void;
+    /** 清理指定会话的历史 */
+    clearHistory(sessionId: string): void;
+    /** 清理所有会话历史 */
+    clearAll(): void;
+    /** 不应被 offload 的读取类工具（避免 offload → read → offload 无限链） */
+    private static READ_THROUGH_TOOLS;
+    /**
+     * 处理工具输出：
+     * - 小结果直接返回
+     * - 大结果写入 OffloadStore，返回摘要标签（保留 100% 可溯源）
+     * - 无 OffloadStore 时回退到截断
+     */
+    processToolOutput(output: string, callId: string, toolName?: string, sessionId?: string): string;
+    /**
+     * 压缩消息列表（公开接口，供 LLMCaller 在上下文过长时调用）
+     *
+     * 使用与 addHistory 相同的多级压缩策略，但直接作用于传入的 messages 数组。
+     * 返回压缩后的 token 估算值。
+     */
+    compressMessages(messages: Message[], targetTokens?: number): number;
+    /** Level 1: 智能压缩（token 感知多级压缩管道） */
+    private compactHistorySmart;
+    /** 压缩阶段 1: 卸载超长工具参数 */
+    private offloadToolArguments;
+    /** 压缩阶段 2: 卸载 base64 数据块 */
+    private offloadBase64Content;
+    /** 压缩阶段 3: 非破坏性卸载大工具结果 */
+    private offloadLargeToolResults;
+    /** 压缩阶段 4: 截断大工具结果 */
+    private truncateLargeToolResults;
+    /** Level 2: 成对裁剪历史（移除最早的 assistant + 关联 tool 消息） */
+    private compactHistoryPairs;
+    /** 截断工具输出（保留首尾，中间省略） */
+    private truncateOutput;
+    /** 根据 tool_call_id 从历史中查找工具名 */
+    static findToolNameForCallId(callId: string, history: Message[]): string;
+    /** DJB2 哈希（用于生成短 nodeId） */
+    static simpleHash(str: string): number;
+}
+//# sourceMappingURL=history-manager.d.ts.map

package/dist/agent/history-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-manager.d.ts","sourceRoot":"","sources":["../../src/agent/history-manager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAY,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAgB,MAAM,YAAY,CAAC;AAGhE,aAAa;AACb,MAAM,WAAW,oBAAoB;IACnC,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc;IACd,aAAa,CAAC,EAAE;QACd,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,iBAAiB;IACjB,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAuB;IACrC,uCAAuC;IACvC,OAAO,CAAC,UAAU,CAAgC;IAClD,2CAA2C;IAC3C,OAAO,CAAC,aAAa,CAA6B;gBAEtC,MAAM,EAAE,oBAAoB;IAMxC,2BAA2B;IAC3B,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI;IAMxD,wBAAwB;IACxB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,EAAE;IAIhD,4BAA4B;IAC5B,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,EAAE;IAIxC,uBAAuB;IACvB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI;IAiCjD,gBAAgB;IAChB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKrC,eAAe;IACf,QAAQ,IAAI,IAAI;IAOhB,0DAA0D;IAC1D,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAiD;IAElF;;;;;OAKG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;IA6ChG;;;;;OAKG;IACH,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM;IAUpE,oCAAoC;IACpC,OAAO,CAAC,mBAAmB;IAqB3B,uBAAuB;IACvB,OAAO,CAAC,oBAAoB;IAuB5B,4BAA4B;IAC5B,OAAO,CAAC,oBAAoB;IAW5B,0BAA0B;IAC1B,OAAO,CAAC,uBAAuB;IA0B/B,sBAAsB;IACtB,OAAO,CAAC,wBAAwB;IAahC,oDAAoD;IACpD,OAAO,CAAC,mBAAmB;IAY3B,wBAAwB;IACxB,OAAO,CAAC,cAAc;IAYtB,gCAAgC;IAChC,MAAM,CAAC,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM;IAUxE,4BAA4B;IAC5B,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAOvC"}

package/dist/agent/llm-caller.d.ts

@@ -0,0 +1,58 @@
+import type { AgentEvent, Message, TokenUsage } from '../types.ts';
+import type { LLMProvider } from '../llm/types.ts';
+import type { ToolDefinition } from '../tool/types.ts';
+import type { RetryPolicy } from './types.ts';
+import type { HookEvent, HookContext, HookResult } from '../hooks/types.ts';
+import type { HistoryManager } from './history-manager.ts';
+/** LLM 调用配置 */
+export interface LLMCallerConfig {
+    /** 主 LLM Provider */
+    llmProvider: LLMProvider;
+    /** 降级 LLM Provider（可选） */
+    fallbackProvider?: LLMProvider;
+    /** 重试策略 */
+    retryPolicy?: RetryPolicy;
+    /** LLM 推理超时（毫秒） */
+    llmTimeout: number;
+    /** Hook 执行器（由 Engine 注入） */
+    runHooks: (event: HookEvent, ctx: HookContext) => Promise<HookResult[]>;
+    /** 事件创建辅助（由 Engine 注入） */
+    createEvent: (sessionId: string, event: Record<string, unknown>) => AgentEvent;
+    /** 历史管理器（可选，用于上下文过长时压缩） */
+    historyManager?: HistoryManager;
+}
+/** 单次 LLM 调用结果 */
+export interface LLMCallResult {
+    /** 完整的 assistant message */
+    assistant: Message;
+    /** 本次调用消耗的 token */
+    usage?: TokenUsage;
+}
+/**
+ * LLM 调用管理器
+ *
+ * 职责：
+ * - 流式调用 LLM（支持 tool_calls 累积）
+ * - 重试 + 指数退避
+ * - 主 Provider → Fallback Provider 降级
+ */
+export declare class LLMCaller {
+    private config;
+    constructor(config: LLMCallerConfig);
+    /** 更新主 Provider（热更新场景） */
+    updateProvider(provider: LLMProvider): void;
+    /**
+     * 带重试和降级的 LLM 调用
+     * 返回 assistant message 或 null（所有尝试失败）
+     *
+     * 特殊处理：当 API 返回“输入过长”错误时，自动压缩历史并重试（最多一次）
+     */
+    callWithRetry(sessionId: string, messages: Message[], toolDefs: ToolDefinition[], abortSignal: AbortSignal): AsyncGenerator<AgentEvent, Message | null>;
+    /** 是否为“上下文过长”错误 */
+    private isContextTooLongError;
+    /** 单次 LLM 调用（流式），带诊断信息 */
+    private callOnceWithDiag;
+    /** 单次 LLM 调用（流式），返回 assistant message 或 null（保留向后兼容） */
+    private callOnce;
+}
+//# sourceMappingURL=llm-caller.d.ts.map

package/dist/agent/llm-caller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-caller.d.ts","sourceRoot":"","sources":["../../src/agent/llm-caller.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAY,UAAU,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,eAAe;AACf,MAAM,WAAW,eAAe;IAC9B,qBAAqB;IACrB,WAAW,EAAE,WAAW,CAAC;IACzB,0BAA0B;IAC1B,gBAAgB,CAAC,EAAE,WAAW,CAAC;IAC/B,WAAW;IACX,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,mBAAmB;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACxE,0BAA0B;IAC1B,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,UAAU,CAAC;IAC/E,2BAA2B;IAC3B,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,kBAAkB;AAClB,MAAM,WAAW,aAAa;IAC5B,4BAA4B;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAkB;gBAEpB,MAAM,EAAE,eAAe;IAInC,0BAA0B;IAC1B,cAAc,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI;IAI3C;;;;;OAKG;IACI,aAAa,CAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,OAAO,EAAE,EACnB,QAAQ,EAAE,cAAc,EAAE,EAC1B,WAAW,EAAE,WAAW,GACvB,cAAc,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC;IAuE7C,mBAAmB;IACnB,OAAO,CAAC,qBAAqB;IAO7B,0BAA0B;YACX,gBAAgB;IAkH/B,wDAAwD;YACzC,QAAQ;CAkHxB"}

package/dist/agent/tool-executor.d.ts

@@ -0,0 +1,95 @@
+import type { AgentEvent, Message, ToolCall, ToolCallRecord } from '../types.ts';
+import type { ToolRegistry } from '../tool/registry.ts';
+import type { ToolContext } from '../tool/types.ts';
+import type { SecurityGuard } from '../security/guard.ts';
+import type { HookEvent, HookContext, HookResult } from '../hooks/types.ts';
+import type { Middleware } from '../middleware/types.ts';
+import type { HistoryManager } from './history-manager.ts';
+/** 工具执行配置 */
+export interface ToolExecutorConfig {
+    /** Tool Registry */
+    toolRegistry: ToolRegistry;
+    /** 安全守卫（可选） */
+    securityGuard?: SecurityGuard;
+    /** 单工具执行超时（毫秒） */
+    toolTimeout: number;
+    /** Hook 执行器 */
+    runHooks: (event: HookEvent, ctx: HookContext) => Promise<HookResult[]>;
+    /** 中间件工具阶段执行器 */
+    runMiddlewareToolPhase: (phase: 'onToolBefore' | 'onToolAfter', ctx: HookContext) => Promise<HookResult[]>;
+    /** 事件创建辅助 */
+    createEvent: (sessionId: string, event: Record<string, unknown>) => AgentEvent;
+    /** 历史管理器 */
+    historyManager: HistoryManager;
+    /** 中间件列表 */
+    getMiddleware: () => Middleware[] | undefined;
+}
+/** 工具执行结果 */
+export interface ToolExecResult {
+    result: string;
+    isError: boolean;
+    actualArgs: Record<string, unknown>;
+    duration: number;
+    call: ToolCall;
+}
+/** LoopState 接口（与 Engine 交互的最小契约） */
+export interface ToolLoopState {
+    sessionId: string;
+    messages: Message[];
+    toolContext: ToolContext;
+    internalAbort: AbortController;
+    iteration: number;
+    toolCallRecords: ToolCallRecord[];
+    consecutiveToolFailures: Map<string, number>;
+}
+/**
+ * 工具执行管理器
+ *
+ * 职责：
+ * - 按并发属性分组执行 tool_calls
+ * - 串行/并行执行 + 超时保护
+ * - 熔断器（连续失败自动阻断）
+ * - 安全检查（execute_command）
+ * - Hook/Middleware 生命周期集成
+ */
+export declare class AgentToolExecutor {
+    private config;
+    /** 连续失败熔断阈值：同一工具连续失败超过此值后自动阻断（降低以加速失败重试终止） */
+    private static readonly CIRCUIT_BREAKER_THRESHOLD;
+    constructor(config: ToolExecutorConfig);
+    /** 执行一批 tool_calls（按并发属性分组） */
+    executeToolCalls(state: ToolLoopState, toolCalls: ToolCall[]): AsyncGenerator<AgentEvent>;
+    /** 按并发属性将 tool_calls 分组 */
+    private groupByConcurrency;
+    /** 并行执行一组工具（按顺序推送事件和结果） */
+    private executeToolGroupParallel;
+    /** 串行执行单个工具调用（含安全检查 + Hooks） */
+    private executeOneToolCall;
+    /** 带超时的工具执行 */
+    private runWithTimeout;
+    private emitUnavailableToolResult;
+    /** 检查工具是否被熔断 */
+    private isCircuitBroken;
+    /** 更新工具连续失败计数 */
+    private updateFailureCount;
+    /**
+     * 从截断的 JSON 中抢救 run_script 的参数。
+     * 当 LLM 生成过长的 code 导致 JSON 被截断时，尝试提取 language 和 code 字段并修复执行。
+     * 返回 null 表示抢救失败。
+     */
+    private rescueRunScriptArgs;
+    /**
+     * 从截断的 JSON 中抢救 delegate_task 的参数。
+     * delegate_task 的 task 字段可能很长（包含数据、指令），导致 JSON 被截断。
+     * 抢救策略：提取 agent（短字段，不会被截断）和 task（可能不完整但仍可执行）。
+     * 返回 null 表示抢救失败。
+     */
+    private rescueDelegateTaskArgs;
+    /**
+     * 从截断的 JSON 中抢救 write_file / append_file 的参数。
+     * 当 LLM 生成过长的 content 导致 JSON 被截断时，尝试提取 path 和部分内容并写入。
+     * 返回 null 表示抢救失败。
+     */
+    private rescueWriteFileArgs;
+}
+//# sourceMappingURL=tool-executor.d.ts.map

package/dist/agent/tool-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-executor.d.ts","sourceRoot":"","sources":["../../src/agent/tool-executor.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,kBAAkB,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,aAAa;AACb,MAAM,WAAW,kBAAkB;IACjC,oBAAoB;IACpB,YAAY,EAAE,YAAY,CAAC;IAC3B,eAAe;IACf,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,kBAAkB;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe;IACf,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACxE,iBAAiB;IACjB,sBAAsB,EAAE,CAAC,KAAK,EAAE,cAAc,GAAG,aAAa,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC3G,aAAa;IACb,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,UAAU,CAAC;IAC/E,YAAY;IACZ,cAAc,EAAE,cAAc,CAAC;IAC/B,YAAY;IACZ,aAAa,EAAE,MAAM,UAAU,EAAE,GAAG,SAAS,CAAC;CAC/C;AAQD,aAAa;AACb,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED,qCAAqC;AACrC,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,WAAW,EAAE,WAAW,CAAC;IACzB,aAAa,EAAE,eAAe,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,uBAAuB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9C;AAED;;;;;;;;;GASG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAqB;IAEnC,8CAA8C;IAC9C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,yBAAyB,CAAK;gBAE1C,MAAM,EAAE,kBAAkB;IAItC,+BAA+B;IACxB,gBAAgB,CAAC,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,cAAc,CAAC,UAAU,CAAC;IAmBhG,2BAA2B;IAC3B,OAAO,CAAC,kBAAkB;IA0B1B,2BAA2B;YACZ,wBAAwB;IAoEvC,gCAAgC;YACjB,kBAAkB;IAwQjC,eAAe;YACD,cAAc;YA0Db,yBAAyB;IA0BxC,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAIvB,iBAAiB;IACjB,OAAO,CAAC,kBAAkB;IAQ1B;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IA6C3B;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAoD9B;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;CAyC5B"}

package/dist/agent/types.d.ts

@@ -0,0 +1,128 @@
+import type { LLMProvider } from '../llm/types.ts';
+import type { ToolRegistry } from '../tool/registry.ts';
+import type { SkillManager } from '../skill/manager.ts';
+import type { SkillRouter } from '../skill/router.ts';
+import type { ContextManager } from '../context/manager.ts';
+import type { SecurityGuard } from '../security/guard.ts';
+import type { SessionContext } from '../types.ts';
+import type { Hook } from '../hooks/types.ts';
+import type { Middleware } from '../middleware/types.ts';
+/** 上下文卸载条目（工具结果摘要 + 原文引用，用于非破坏性压缩） */
+export interface OffloadEntry {
+    /** 唯一引用 ID，格式：{toolName}_{timestamp}_{hash} */
+    nodeId: string;
+    /** 工具名称 */
+    toolName: string;
+    /** 摘要标签内容（注入到上下文中的轻量摘要） */
+    summary: string;
+    /** 原文存储路径 */
+    filePath: string;
+    /** 创建时间（毫秒时间戳） */
+    createdAt: number;
+    /** 原文字符数 */
+    charCount: number;
+    /** 所属会话 ID */
+    sessionId: string;
+}
+/** 工具结果存储接口（超大结果写入文件，按需读取） */
+export interface ToolResultStore {
+    /** 写入工具结果，返回存储路径 */
+    write(callId: string, content: string): string;
+    /** 读取工具结果 */
+    read(callId: string): string | null;
+    /** 检查是否存在 */
+    has(callId: string): boolean;
+    /** 写入上下文卸载条目（content 为原文，entry.summary 为摘要标签），返回存储路径 */
+    writeOffload(entry: Omit<OffloadEntry, 'filePath'>, content: string): string;
+    /** 读取卸载条目的原文 */
+    readOffload(nodeId: string): string | null;
+    /** 列出指定会话的所有卸载条目 */
+    listOffloads(sessionId: string): OffloadEntry[];
+}
+/** LLM 重试策略配置 */
+export interface RetryPolicy {
+    /** 最大重试次数，默认 3 */
+    maxRetries?: number;
+    /** 首次重试延迟（毫秒），默认 1000 */
+    initialDelay?: number;
+    /** 最大延迟（毫秒），默认 30000 */
+    maxDelay?: number;
+    /** 退避因子（每次延迟乘以此值），默认 2 */
+    backoffFactor?: number;
+}
+/** AgentEngine 构造参数 */
+export interface AgentConfig {
+    /** 单次任务最大迭代轮次，默认 15 */
+    maxIterations?: number;
+    /** 消息历史上限（滑动窗口），默认 50 */
+    maxMessages?: number;
+    /** 单工具执行超时（毫秒），默认 30000 */
+    toolTimeout?: number;
+    /** LLM 推理超时（毫秒），默认 120000 */
+    llmTimeout?: number;
+    /** Agent 系统提示词基础模板 */
+    basePrompt?: string;
+    /** LLM Provider 实例 */
+    llmProvider: LLMProvider;
+    /** Tool Registry 实例 */
+    toolRegistry: ToolRegistry;
+    /** Skill Manager 实例（可选） */
+    skillManager?: SkillManager;
+    /** Skill Router 实例（可选） */
+    skillRouter?: SkillRouter;
+    /** Context Manager 实例 */
+    contextManager: ContextManager;
+    /** Security Guard 实例（可选） */
+    securityGuard?: SecurityGuard;
+    /** 默认工具列表（静态注入） */
+    defaultTools?: string[];
+    /** 上下文压缩配置 */
+    contextBudget?: {
+        /** 单条工具输出最大字符数，默认 8000 */
+        maxToolOutput?: number;
+        /** 历史消息数达到此阈值时触发压缩，默认 maxMessages * 0.8 */
+        compactThreshold?: number;
+        /** 上下文总 token 预算，超过此值触发智能压缩，默认 100000 */
+        maxContextTokens?: number;
+    };
+    /** 全局禁止的工具名列表（从 LLM 视野中移除） */
+    deniedTools?: string[];
+    /** 生命周期钩子列表 */
+    hooks?: Hook[];
+    /** 中间件管道（与 Hook 共存，提供更结构化的 before/after 生命周期） */
+    middleware?: Middleware[];
+    /** 工具发现模式：'full' 全量加载 schema，'summary' 渐进式摘要发现，默认 'full' */
+    toolDiscovery?: 'full' | 'summary';
+    /** 工具摘要模式下描述最大长度（字符数），默认 100 */
+    toolSummaryMaxDesc?: number;
+    /** LLM 调用重试策略（模型韧性） */
+    retryPolicy?: RetryPolicy;
+    /** 降级 LLM Provider（主 Provider 重试耗尽后切换） */
+    fallbackProvider?: LLMProvider;
+    /** 工具结果存储（超大结果写入文件，按需读取） */
+    toolResultStore?: ToolResultStore;
+    /** 数据获取类工具名列表（用于循环检测，默认 ['web_fetch', 'execute_command', 'write_file', 'append_file', 'run_script', 'read_file', 'read_tool_doc']） */
+    dataFetchTools?: string[];
+    /** 产出型工具名列表（有这些工具调用时不触发数据获取循环检测，默认 ['delegate_task', 'create_presentation', 'create_document', 'create_pdf', 'show_widget', 'save_artifact']） */
+    outputTools?: string[];
+}
+/** AgentEngine.run() 入参 */
+export interface RunOptions {
+    /** 会话 ID（同一会话共享上下文） */
+    sessionId: string;
+    /** 用户输入消息 */
+    message: string;
+    /** 显式指定 Skill ID（跳过路由） */
+    skillId?: string;
+    /** 额外注入的工具名称列表（动态注入） */
+    extraTools?: string[];
+    /** 会话上下文（上层传入） */
+    context?: SessionContext;
+    /** 中断信号（上层取消时使用） */
+    abortSignal?: AbortSignal;
+    /** 本次执行覆盖的 system prompt 片段（追加到 basePrompt 之后） */
+    systemPromptOverride?: string;
+    /** 扩展参数 */
+    options?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/agent/workflow.d.ts

@@ -0,0 +1,74 @@
+export type WorkflowRole = 'researcher' | 'implementer' | 'reviewer' | 'critic' | 'risk_checker' | 'final_approver' | 'bull_researcher' | 'bear_researcher';
+export interface WorkflowStageTemplate {
+    id: string;
+    role: WorkflowRole;
+    title: string;
+    instruction: string;
+    requiredFor: 'complex' | 'high_risk';
+}
+export interface WorkflowTemplate {
+    id: string;
+    name: string;
+    description: string;
+    stages: WorkflowStageTemplate[];
+}
+export interface WorkflowDecisionLog {
+    task: string;
+    agentName: string;
+    role?: WorkflowRole | string;
+    stage: string;
+    recommendation: string;
+    confidence: number;
+    findings: string[];
+    risks: string[];
+    next_actions: string[];
+}
+export interface StructuredAgentOutput {
+    role?: WorkflowRole | string;
+    summary?: string;
+    findings: string[];
+    risks: string[];
+    recommendation: string;
+    confidence: number;
+    next_actions: string[];
+    rawContent?: string;
+}
+export interface WorkflowCheckpoint {
+    id: string;
+    stage: string;
+    agentName?: string;
+    status: 'started' | 'completed' | 'failed';
+    timestamp: number;
+    summary?: string;
+    /** 阶段恢复上下文（用于节点级续跑） */
+    context?: {
+        task: string;
+        priorOutputs: string[];
+        stageIndex: number;
+    };
+}
+/** 辩论输出结构（Bull/Bear Debate） */
+export interface DebateOutput {
+    topic: string;
+    bull_arguments: string[];
+    bear_arguments: string[];
+    synthesis: string;
+    unresolved_points: string[];
+    confidence: number;
+}
+export declare const DEFAULT_COMPLEX_WORKFLOW_TEMPLATE: WorkflowTemplate;
+export declare function getWorkflowTemplate(id?: string): WorkflowTemplate | undefined;
+export declare function getWorkflowRoleStage(role?: WorkflowRole | string): string;
+export declare function formatWorkflowTemplateForPrompt(template?: WorkflowTemplate): string;
+export declare function buildWorkflowDecisionMemory(log: WorkflowDecisionLog): string;
+export declare function buildStructuredOutputInstruction(role?: WorkflowRole | string): string;
+export declare function wrapTaskWithWorkflowInstructions(task: string, role?: WorkflowRole | string): string;
+export declare function parseStructuredAgentOutput(content: string, fallbackRole?: WorkflowRole | string): StructuredAgentOutput;
+export declare function formatStructuredAgentOutput(agentName: string, output: StructuredAgentOutput, iterations?: number, toolSummary?: string[]): string;
+export declare function buildDebateInstructions(topic: string, context?: string): {
+    bull: string;
+    bear: string;
+};
+export declare function formatDebateOutput(debate: DebateOutput): string;
+export declare function parseDebateOutput(bullOutput: StructuredAgentOutput, bearOutput: StructuredAgentOutput, topic: string): DebateOutput;
+//# sourceMappingURL=workflow.d.ts.map

package/dist/agent/workflow.d.ts.map

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

package/dist/context/collector.d.ts

@@ -0,0 +1,12 @@
+import type { EnvInfo, EnvCollector as IEnvCollector } from './types.ts';
+/**
+ * 默认本地环境采集器
+ * 采集当前机器的 OS、CPU、内存、Shell 等信息
+ * 上层可替换为远程采集实现（如 SSH 采集）
+ */
+export declare class LocalEnvCollector implements IEnvCollector {
+    collect(): Promise<EnvInfo>;
+    format(info: EnvInfo): string;
+    private formatBytes;
+}
+//# sourceMappingURL=collector.d.ts.map

package/dist/context/collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../../src/context/collector.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,IAAI,aAAa,EAAE,MAAM,YAAY,CAAC;AAEzE;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IAC/C,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAoBjC,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM;IAmB7B,OAAO,CAAC,WAAW;CAMpB"}

package/dist/context/manager.d.ts

@@ -0,0 +1,16 @@
+import type { Message } from '../types.ts';
+import type { BuildContextOptions } from './types.ts';
+/**
+ * 消息构建器（纯函数式，无状态）
+ *
+ * 仅负责将上层传入的 systemPrompt + history + userMessage 组装为 LLM 请求消息列表。
+ * 不关心 prompt 内容来源（环境、终端、Skill 等），不维护历史。
+ */
+export declare class ContextManager {
+    /**
+     * 构建完整的 LLM 请求消息列表
+     * 组装顺序：system prompt → extra prompt → history → user message
+     */
+    buildMessages(options: BuildContextOptions): Message[];
+}
+//# sourceMappingURL=manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/context/manager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD;;;;;GAKG;AACH,qBAAa,cAAc;IAEzB;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,EAAE;CAoBvD"}