@yun520-1/heartflow 0.15.2

package/dist/agent/runtime/AgentRuntime.js

@@ -0,0 +1,355 @@
+/**
+ * AgentRuntime — 主导入器 / 运行时编排器
+ * @version v0.1.0
+ *
+ * 整合 TaskGraph + TaskScheduler，提供：
+ *   - 统一的 Agent 任务编排
+ *   - 多图管理 (多个并行工作流)
+ *   - 事件总线 (agent-event)
+ *   - 状态持久化与恢复
+ *   - 心跳监控
+ */
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentRuntime = void 0;
+const TaskGraph_1 = require("./TaskGraph");
+const TaskScheduler_1 = require("./TaskScheduler");
+/**
+ * AgentRuntime — 主导入器
+ *
+ * 使用示例:
+ *   const runtime = new AgentRuntime({
+ *     name: 'DataPipeline',
+ *     checkpointEngine: new CheckpointEngine({ dir: '~/.hermes/heartflow/checkpoints' })
+ *   });
+ *
+ *   // 注册工作流
+ *   runtime.registerWorkflow({
+ *     id: 'etl',
+ *     name: 'ETL Pipeline',
+ *     nodes: [
+ *       { id: 'fetch', label: 'Fetch Data', payload: { url: '...' }, deps: ['transform'] },
+ *       { id: 'transform', label: 'Transform', payload: { format: 'csv' } },
+ *     ]
+ *   });
+ *
+ *   // 监听事件
+ *   runtime.on('task_complete', (e) => console.log('Task done:', e.nodeId));
+ *
+ *   // 执行工作流
+ *   const result = await runtime.execute('etl', async (node) => {
+ *     // 执行任务
+ *     return { result: node.payload };
+ *   });
+ */
+class AgentRuntime {
+    id;
+    name;
+    checkpointEngine;
+    heartbeatInterval;
+    autoCheckpoint;
+    _graphs = new Map();
+    _schedulers = new Map();
+    _listeners = new Map();
+    _status = 'idle';
+    _uptimeStartedAt = Date.now();
+    _lastHeartbeat = Date.now();
+    _heartbeatTimer;
+    _totalTasksProcessed = 0;
+    constructor(options = {}) {
+        this.id = options.id ?? `agent-${Date.now()}`;
+        this.name = options.name ?? 'AgentRuntime';
+        this.checkpointEngine = options.checkpointEngine;
+        this.heartbeatInterval = options.heartbeatInterval ?? 30000;
+        this.autoCheckpoint = options.autoCheckpoint ?? true;
+    }
+    // ─── 事件总线 ─────────────────────────────────────────────
+    /**
+     * 注册事件监听器
+     */
+    on(type, listener) {
+        if (!this._listeners.has(type)) {
+            this._listeners.set(type, new Set());
+        }
+        this._listeners.get(type).add(listener);
+        // 返回取消订阅函数
+        return () => {
+            this._listeners.get(type)?.delete(listener);
+        };
+    }
+    /**
+     * 触发事件
+     */
+    async _emit(event) {
+        const promises = [];
+        const listeners = this._listeners.get(event.type);
+        if (listeners) {
+            for (const listener of listeners) {
+                const result = listener(event);
+                if (result instanceof Promise)
+                    promises.push(result);
+            }
+        }
+        // 同时触发通配符监听器
+        const wildcard = this._listeners.get('*');
+        if (wildcard) {
+            for (const listener of wildcard) {
+                const result = listener(event);
+                if (result instanceof Promise)
+                    promises.push(result);
+            }
+        }
+        await Promise.all(promises);
+    }
+    _newEvent(type, payload, graphId, nodeId) {
+        return { type, timestamp: Date.now(), payload, graphId, nodeId };
+    }
+    // ─── 心跳 ─────────────────────────────────────────────
+    /**
+     * 启动心跳
+     */
+    startHeartbeat() {
+        if (this._heartbeatTimer)
+            return;
+        this._heartbeatTimer = setInterval(() => {
+            this._lastHeartbeat = Date.now();
+            this._emit(this._newEvent('heartbeat', {
+                uptime: this._lastHeartbeat - this._uptimeStartedAt,
+                activeGraphs: this._graphs.size,
+                totalTasks: this._totalTasksProcessed,
+                status: this._status,
+            }));
+        }, this.heartbeatInterval);
+    }
+    /**
+     * 停止心跳
+     */
+    stopHeartbeat() {
+        if (this._heartbeatTimer) {
+            clearInterval(this._heartbeatTimer);
+            this._heartbeatTimer = undefined;
+        }
+    }
+    // ─── 工作流注册 ─────────────────────────────────────────────
+    /**
+     * 注册工作流定义 (但不立即执行)
+     */
+    registerWorkflow(workflow) {
+        const graph = new TaskGraph_1.TaskGraph({
+            id: workflow.id,
+            name: workflow.name,
+            checkpointEngine: this.checkpointEngine,
+        });
+        graph.addNodes(workflow.nodes);
+        this._graphs.set(workflow.id, graph);
+    }
+    /**
+     * 预定义工作流 (快捷方法)
+     */
+    static createSequentialWorkflow(id, name, nodes) {
+        // 顺序执行: 每个节点依赖前一个
+        return {
+            id,
+            name,
+            nodes: nodes.map((n, i) => ({
+                id: n.id,
+                label: n.label,
+                payload: n.payload,
+                deps: i > 0 ? [nodes[i - 1].id] : [],
+            })),
+        };
+    }
+    static createParallelWorkflow(id, name, nodes) {
+        // 完全并行: 所有节点无依赖
+        return {
+            id,
+            name,
+            nodes: nodes.map(n => ({ id: n.id, label: n.label, payload: n.payload, deps: [] })),
+        };
+    }
+    static createDAGWorkflow(id, name, nodes) {
+        return { id, name, nodes };
+    }
+    // ─── 执行 ─────────────────────────────────────────────
+    /**
+     * 执行指定工作流
+     */
+    async execute(workflowId, executor, options) {
+        const graph = this._graphs.get(workflowId);
+        if (!graph) {
+            throw new Error(`Workflow "${workflowId}" not found`);
+        }
+        // 检查循环
+        const cycle = graph.detectCycle();
+        if (cycle.hasCycle) {
+            throw new Error(`Workflow "${workflowId}" has cycle: ${cycle.cycleNodes?.join(' → ')}`);
+        }
+        this._status = 'running';
+        await this._emit(this._newEvent('graph_start', { workflowId }, workflowId));
+        this.startHeartbeat();
+        const schedulerEvents = {
+            onTaskStart: async (node) => {
+                this._emit(this._newEvent('task_start', { nodeId: node.id }, workflowId, node.id));
+            },
+            onTaskComplete: async (node, result) => {
+                this._totalTasksProcessed++;
+                this._emit(this._newEvent('task_complete', { nodeId: node.id, result }, workflowId, node.id));
+            },
+            onTaskFail: async (node, error) => {
+                this._emit(this._newEvent('task_fail', { nodeId: node.id, error: error.message }, workflowId, node.id));
+            },
+            onTaskSkip: async (node, reason) => {
+                this._emit(this._newEvent('task_skip', { nodeId: node.id, reason }, workflowId, node.id));
+            },
+            onGraphComplete: async () => {
+                this._status = 'idle';
+                this._emit(this._newEvent('graph_complete', { workflowId }, workflowId));
+            },
+            onGraphFail: async (_, failedNodeId) => {
+                this._status = 'idle';
+                this._emit(this._newEvent('graph_fail', { workflowId, failedNodeId }, workflowId));
+            },
+            onCheckpoint: async () => {
+                this._emit(this._newEvent('checkpoint_save', { workflowId }, workflowId));
+            },
+        };
+        const scheduler = new TaskScheduler_1.TaskScheduler({
+            graph,
+            executor,
+            events: schedulerEvents,
+            maxConcurrency: options?.maxConcurrency ?? Infinity,
+            checkpointInterval: options?.checkpointInterval ?? 5,
+            autoStart: options?.autoStart ?? true,
+        });
+        this._schedulers.set(workflowId, scheduler);
+        const result = await scheduler.run();
+        return result;
+    }
+    /**
+     * 执行并等待完成
+     */
+    async executeAndWait(workflowId, executor, options) {
+        return this.execute(workflowId, executor, { ...options, autoStart: true });
+    }
+    // ─── 控制 ─────────────────────────────────────────────
+    /**
+     * 暂停工作流
+     */
+    pause(workflowId) {
+        const scheduler = this._schedulers.get(workflowId);
+        if (!scheduler)
+            throw new Error(`Scheduler "${workflowId}" not found`);
+        scheduler.pause();
+        this._status = 'paused';
+        this._emit(this._newEvent('scheduler_pause', { workflowId }, workflowId));
+    }
+    /**
+     * 恢复工作流
+     */
+    async resume(workflowId) {
+        const scheduler = this._schedulers.get(workflowId);
+        if (!scheduler)
+            throw new Error(`Scheduler "${workflowId}" not found`);
+        this._status = 'running';
+        this._emit(this._newEvent('scheduler_resume', { workflowId }, workflowId));
+        await scheduler.resume();
+    }
+    /**
+     * 停止工作流
+     */
+    stop(workflowId) {
+        const scheduler = this._schedulers.get(workflowId);
+        if (!scheduler)
+            throw new Error(`Scheduler "${workflowId}" not found`);
+        scheduler.stop();
+        this._status = 'stopped';
+        this._emit(this._newEvent('scheduler_stop', { workflowId }, workflowId));
+    }
+    /**
+     * 停止所有工作流
+     */
+    stopAll() {
+        for (const [id] of this._schedulers) {
+            this.stop(id);
+        }
+    }
+    // ─── 查询 ─────────────────────────────────────────────
+    /**
+     * 获取工作流图
+     */
+    getGraph(workflowId) {
+        return this._graphs.get(workflowId);
+    }
+    /**
+     * 获取所有工作流
+     */
+    getAllGraphs() {
+        return Array.from(this._graphs.entries()).map(([id, graph]) => ({
+            id,
+            name: graph.name,
+            graph,
+        }));
+    }
+    /**
+     * 获取调度器
+     */
+    getScheduler(workflowId) {
+        return this._schedulers.get(workflowId);
+    }
+    /**
+     * 获取状态
+     */
+    getStatus() {
+        return {
+            id: this.id,
+            name: this.name,
+            status: this._status,
+            activeGraphs: Array.from(this._graphs.values()).map(g => g.id),
+            completedGraphs: Array.from(this._graphs.values())
+                .filter(g => g.getStatus() === 'completed')
+                .map(g => g.id),
+            failedGraphs: Array.from(this._graphs.values())
+                .filter(g => g.getStatus() === 'failed')
+                .map(g => g.id),
+            totalTasksProcessed: this._totalTasksProcessed,
+            uptimeStartedAt: this._uptimeStartedAt,
+            lastHeartbeat: this._lastHeartbeat,
+        };
+    }
+    // ─── 持久化 ─────────────────────────────────────────────
+    /**
+     * 保存完整运行时状态
+     */
+    async saveState() {
+        if (!this.checkpointEngine) {
+            return { success: false, error: 'No checkpoint engine' };
+        }
+        const state = this.getStatus();
+        return this.checkpointEngine.save(state, `agent-runtime-${this.id}`);
+    }
+    /**
+     * 加载运行时状态
+     */
+    static async loadState(engine, runtimeId, options) {
+        const result = engine.load(`agent-runtime-${runtimeId}`);
+        if (!result.success || !result.data)
+            return null;
+        const state = result.data;
+        const runtime = new AgentRuntime({ id: state.id, name: state.name, ...options });
+        runtime._status = state.status;
+        runtime._totalTasksProcessed = state.totalTasksProcessed;
+        runtime._uptimeStartedAt = state.uptimeStartedAt;
+        runtime._lastHeartbeat = state.lastHeartbeat;
+        return runtime;
+    }
+    /**
+     * 关闭运行时 (清理资源)
+     */
+    shutdown() {
+        this.stopAll();
+        this.stopHeartbeat();
+    }
+}
+exports.AgentRuntime = AgentRuntime;
+exports.default = AgentRuntime;
+//# sourceMappingURL=AgentRuntime.js.map

package/dist/agent/runtime/AgentRuntime.js.map

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

package/dist/agent/runtime/PlanExecutor.d.ts

@@ -0,0 +1,132 @@
+/**
+ * PlanExecutor — 自然语言计划解析为任务图
+ * @version v0.1.0
+ *
+ * 功能：
+ *   - 将自然语言计划解析为 TaskGraph（TaskGraph.ts）
+ *   - 集成 CognitionEngine（HeartFlow.think）进行计划分析
+ *   - 支持 DAG 拓扑调度（TaskScheduler.ts）
+ *   - 自动检查点保存
+ *
+ * 使用示例:
+ *   const executor = new PlanExecutor({ cognition });
+ *   const graph = await executor.parse('帮我搜索论文然后总结重点');
+ *   const result = await executor.execute(graph);
+ */
+import { TaskGraph } from './TaskGraph';
+import { TaskScheduler, TaskExecutor, SchedulerEvents } from './TaskScheduler';
+/** 计划步骤解析结果 */
+export interface ParsedStep {
+    id: string;
+    label: string;
+    action: string;
+    intent: string;
+    payload: unknown;
+    deps: string[];
+    tags?: string[];
+}
+/** 解析结果 */
+export interface ParseResult {
+    success: boolean;
+    steps: ParsedStep[];
+    graph: TaskGraph;
+    reasoning?: string;
+    error?: string;
+}
+/** 执行结果 */
+export interface ExecuteResult {
+    success: boolean;
+    graph: TaskGraph;
+    scheduler: TaskScheduler | null;
+    parseMs: number;
+    executeMs: number;
+    totalMs: number;
+    error?: string;
+}
+/** PlanExecutor 配置 */
+export interface PlanExecutorOptions {
+    /** Cognition 函数签名同 HeartFlow.think() */
+    cognition: (input: string, context?: object) => Promise<CognitionResult>;
+    /** 可选：自定义检查点引擎（默认用 CheckpointEngine） */
+    checkpointEngine?: import('../../storage/checkpoint/CheckpointEngine').CheckpointEngine;
+    /** 可选：最大并发任务数 */
+    maxConcurrency?: number;
+    /** 可选：检查点间隔（每 N 个任务） */
+    checkpointInterval?: number;
+    /** 可选：每个任务最大重试次数 */
+    maxRetries?: number;
+}
+/** CognitionEngine 返回类型（兼容 HeartFlow.think） */
+export interface CognitionResult {
+    blocked?: boolean;
+    reason?: string;
+    psychology?: {
+        intention?: string;
+        emotion?: string;
+        needs?: string;
+        defense?: string[];
+    };
+    truthCheck?: {
+        pass?: boolean;
+        issues?: string[];
+    };
+    skills?: Array<{
+        name: string;
+        result?: unknown;
+    }>;
+    memories?: unknown[];
+    latency?: number;
+    [key: string]: unknown;
+}
+/**
+ * PlanExecutor
+ *
+ * 将自然语言计划转换为可执行的 DAG 任务图，并使用 TaskScheduler 驱动执行。
+ */
+export declare class PlanExecutor {
+    private cognition;
+    private checkpointEngine?;
+    private maxConcurrency;
+    private checkpointInterval;
+    private maxRetries;
+    constructor(options: PlanExecutorOptions);
+    /**
+     * parse — 将自然语言计划解析为 TaskGraph
+     *
+     * @param planText  自然语言计划描述
+     * @param context   可选上下文（用于 Cognition 分析）
+     * @returns ParseResult
+     */
+    parse(planText: string, context?: object): Promise<ParseResult>;
+    /**
+     * execute — 执行已解析的 TaskGraph
+     *
+     * @param graph   parse() 返回的 TaskGraph
+     * @param events  可选调度器事件回调
+     * @returns ExecuteResult
+     */
+    execute(graph: TaskGraph, events?: SchedulerEvents): Promise<ExecuteResult>;
+    /**
+     * parseAndExecute — 解析并执行（原子操作）
+     */
+    parseAndExecute(planText: string, context?: object, events?: SchedulerEvents): Promise<ExecuteResult>;
+    /**
+     * 从 Cognition 结果中提取分析文本
+     */
+    private _extractReasoning;
+    /**
+     * 从自然语言计划 + Cognition 结果推断任务步骤
+     */
+    private _inferSteps;
+    /**
+     * 构建 TaskGraph
+     */
+    private _buildGraph;
+}
+/**
+ * 创建 PlanExecutor（使用内置 Mock Cognition）
+ */
+export declare function createPlanExecutor(options?: Partial<PlanExecutorOptions>): PlanExecutor;
+export default PlanExecutor;
+export type { TaskExecutor, SchedulerEvents };
+//# sourceMappingURL=PlanExecutor.d.ts.map

package/dist/agent/runtime/PlanExecutor.d.ts.map

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