@lingxiao-office/sdk 1.0.0

package/dist/core/workflow/ExecutionGraph.js

@@ -0,0 +1,275 @@
+/**
+ * ExecutionGraph - 构建和分析 workflow 执行依赖图
+ *
+ * 职责：
+ * - 构建节点依赖图
+ * - 拓扑排序确定执行顺序
+ * - 检测循环依赖
+ * - 查找起始节点
+ */
+export class ExecutionGraph {
+    workflow;
+    adjacencyList; // nodeId -> [依赖的节点ID列表]
+    reverseList; // nodeId -> [依赖它的节点ID列表]
+    nodeIds;
+    constructor(workflow) {
+        this.workflow = workflow;
+        this.adjacencyList = new Map();
+        this.reverseList = new Map();
+        this.nodeIds = new Set();
+        this.buildGraph();
+    }
+    /**
+     * 构建依赖图
+     * adjacencyList: target -> [sources] (节点依赖哪些节点)
+     * reverseList: source -> [targets] (节点被哪些节点依赖)
+     */
+    buildGraph() {
+        // 初始化所有节点
+        for (const node of this.workflow.nodes) {
+            this.nodeIds.add(node.id);
+            this.adjacencyList.set(node.id, []);
+            this.reverseList.set(node.id, []);
+        }
+        // 构建边关系
+        for (const edge of this.workflow.edges) {
+            const { source, target } = edge;
+            // 验证节点存在
+            if (!this.nodeIds.has(source)) {
+                throw new Error(`Edge references non-existent source node: ${source}`);
+            }
+            if (!this.nodeIds.has(target)) {
+                throw new Error(`Edge references non-existent target node: ${target}`);
+            }
+            // target 依赖 source
+            const deps = this.adjacencyList.get(target);
+            if (!deps.includes(source)) {
+                deps.push(source);
+            }
+            // source 被 target 依赖
+            const dependents = this.reverseList.get(source);
+            if (!dependents.includes(target)) {
+                dependents.push(target);
+            }
+        }
+    }
+    /**
+     * 拓扑排序 - 返回执行顺序
+     * 使用 DFS 实现
+     */
+    topologicalSort() {
+        const sorted = [];
+        const visited = new Set();
+        const temp = new Set(); // 用于检测循环
+        const visit = (nodeId) => {
+            if (temp.has(nodeId)) {
+                throw new Error(`Cycle detected in workflow involving node: ${nodeId}`);
+            }
+            if (visited.has(nodeId)) {
+                return;
+            }
+            temp.add(nodeId);
+            // 先访问所有依赖
+            const deps = this.adjacencyList.get(nodeId) || [];
+            for (const dep of deps) {
+                visit(dep);
+            }
+            temp.delete(nodeId);
+            visited.add(nodeId);
+            sorted.push(nodeId);
+        };
+        // 访问所有节点
+        for (const nodeId of this.nodeIds) {
+            if (!visited.has(nodeId)) {
+                visit(nodeId);
+            }
+        }
+        return sorted;
+    }
+    /**
+     * 检测循环依赖
+     */
+    detectCycles() {
+        try {
+            this.topologicalSort();
+            return false;
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('Cycle detected')) {
+                return true;
+            }
+            throw error;
+        }
+    }
+    /**
+     * 获取起始节点（无依赖的节点）
+     */
+    getStartNodes() {
+        const startNodes = [];
+        for (const nodeId of this.nodeIds) {
+            const deps = this.adjacencyList.get(nodeId) || [];
+            if (deps.length === 0) {
+                startNodes.push(nodeId);
+            }
+        }
+        return startNodes;
+    }
+    /**
+     * 获取节点的直接依赖
+     */
+    getDependencies(nodeId) {
+        return this.adjacencyList.get(nodeId) || [];
+    }
+    /**
+     * 获取依赖该节点的节点列表
+     */
+    getDependents(nodeId) {
+        return this.reverseList.get(nodeId) || [];
+    }
+    /**
+     * 获取节点的所有前置节点（递归）
+     */
+    getAllPredecessors(nodeId) {
+        const predecessors = new Set();
+        const visited = new Set();
+        const collect = (id) => {
+            if (visited.has(id))
+                return;
+            visited.add(id);
+            const deps = this.adjacencyList.get(id) || [];
+            for (const dep of deps) {
+                predecessors.add(dep);
+                collect(dep);
+            }
+        };
+        collect(nodeId);
+        return predecessors;
+    }
+    /**
+     * 获取节点的所有后继节点（递归）
+     */
+    getAllSuccessors(nodeId) {
+        const successors = new Set();
+        const visited = new Set();
+        const collect = (id) => {
+            if (visited.has(id))
+                return;
+            visited.add(id);
+            const dependents = this.reverseList.get(id) || [];
+            for (const dependent of dependents) {
+                successors.add(dependent);
+                collect(dependent);
+            }
+        };
+        collect(nodeId);
+        return successors;
+    }
+    /**
+     * 检查是否可以并行执行两个节点
+     */
+    canRunInParallel(nodeId1, nodeId2) {
+        // 如果一个节点依赖另一个，不能并行
+        const predecessors1 = this.getAllPredecessors(nodeId1);
+        const predecessors2 = this.getAllPredecessors(nodeId2);
+        if (predecessors1.has(nodeId2) || predecessors2.has(nodeId1)) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * 获取可以并行执行的节点组
+     * 返回按层级分组的节点
+     */
+    getParallelLayers() {
+        const layers = [];
+        const processed = new Set();
+        const remaining = new Set(this.nodeIds);
+        while (remaining.size > 0) {
+            const currentLayer = [];
+            // 找到所有依赖已满足的节点
+            for (const nodeId of remaining) {
+                const deps = this.adjacencyList.get(nodeId) || [];
+                const allDepsProcessed = deps.every(dep => processed.has(dep));
+                if (allDepsProcessed) {
+                    currentLayer.push(nodeId);
+                }
+            }
+            if (currentLayer.length === 0) {
+                throw new Error('Unable to find next layer - possible cycle or logic error');
+            }
+            layers.push(currentLayer);
+            // 标记为已处理
+            for (const nodeId of currentLayer) {
+                processed.add(nodeId);
+                remaining.delete(nodeId);
+            }
+        }
+        return layers;
+    }
+    /**
+     * 验证图的完整性
+     */
+    validate() {
+        const errors = [];
+        // 检查是否有循环
+        if (this.detectCycles()) {
+            errors.push('Workflow contains cycles');
+        }
+        // 检查是否有孤立节点（既无输入也无输出）
+        for (const nodeId of this.nodeIds) {
+            const deps = this.adjacencyList.get(nodeId) || [];
+            const dependents = this.reverseList.get(nodeId) || [];
+            if (deps.length === 0 && dependents.length === 0 && this.nodeIds.size > 1) {
+                errors.push(`Node ${nodeId} is isolated (no connections)`);
+            }
+        }
+        // 检查是否至少有一个起始节点
+        const startNodes = this.getStartNodes();
+        if (startNodes.length === 0 && this.nodeIds.size > 0) {
+            errors.push('Workflow has no start nodes (all nodes have dependencies)');
+        }
+        return {
+            valid: errors.length === 0,
+            errors
+        };
+    }
+    /**
+     * 获取图的统计信息
+     */
+    getStats() {
+        const layers = this.getParallelLayers();
+        return {
+            nodeCount: this.nodeIds.size,
+            edgeCount: this.workflow.edges.length,
+            startNodeCount: this.getStartNodes().length,
+            maxDepth: this.calculateMaxDepth(),
+            layerCount: layers.length
+        };
+    }
+    /**
+     * 计算图的最大深度
+     */
+    calculateMaxDepth() {
+        const depths = new Map();
+        const calculateDepth = (nodeId) => {
+            if (depths.has(nodeId)) {
+                return depths.get(nodeId);
+            }
+            const deps = this.adjacencyList.get(nodeId) || [];
+            if (deps.length === 0) {
+                depths.set(nodeId, 0);
+                return 0;
+            }
+            const maxDepDep = Math.max(...deps.map(dep => calculateDepth(dep)));
+            const depth = maxDepDep + 1;
+            depths.set(nodeId, depth);
+            return depth;
+        };
+        let maxDepth = 0;
+        for (const nodeId of this.nodeIds) {
+            maxDepth = Math.max(maxDepth, calculateDepth(nodeId));
+        }
+        return maxDepth;
+    }
+}
+//# sourceMappingURL=ExecutionGraph.js.map

package/dist/core/workflow/ExecutionGraph.js.map

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

package/dist/core/workflow/ScheduleTriggerSync.d.ts

@@ -0,0 +1,22 @@
+import type { ScheduledTaskManager } from '../ScheduledTaskManager.js';
+import type { WorkflowDefinition } from './types.js';
+export interface WorkflowScheduleTriggerSyncResult {
+    workflowId: string;
+    synced: Array<{
+        nodeId: string;
+        taskId: string;
+        cron: string;
+        status: 'created' | 'updated';
+        next_run_at: number | null;
+    }>;
+    deleted: Array<{
+        nodeId: string;
+        taskId?: string;
+        reason: 'removed' | 'invalid';
+    }>;
+    warnings: string[];
+    errors: string[];
+}
+export declare function syncWorkflowScheduleTriggers(workflow: WorkflowDefinition, scheduledTaskManager: ScheduledTaskManager): WorkflowScheduleTriggerSyncResult;
+export declare function deleteWorkflowScheduleTriggers(workflowId: string, scheduledTaskManager: ScheduledTaskManager): WorkflowScheduleTriggerSyncResult;
+//# sourceMappingURL=ScheduleTriggerSync.d.ts.map

package/dist/core/workflow/ScheduleTriggerSync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScheduleTriggerSync.d.ts","sourceRoot":"","sources":["../../../src/core/workflow/ScheduleTriggerSync.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAEvE,OAAO,KAAK,EAAkB,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAIrE,MAAM,WAAW,iCAAiC;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,KAAK,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;QAC9B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5B,CAAC,CAAC;IACH,OAAO,EAAE,KAAK,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;KAC/B,CAAC,CAAC;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAkFD,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,kBAAkB,EAC5B,oBAAoB,EAAE,oBAAoB,GACzC,iCAAiC,CA+DnC;AAED,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,MAAM,EAClB,oBAAoB,EAAE,oBAAoB,GACzC,iCAAiC,CAcnC"}

package/dist/core/workflow/ScheduleTriggerSync.js

@@ -0,0 +1,141 @@
+import { getNextCronTime } from '../ScheduledTaskManager.js';
+const SOURCE_TYPE = 'workflow_trigger';
+function isRecord(value) {
+    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+function readString(config, key) {
+    const value = config[key];
+    if (typeof value === 'string' && value.trim())
+        return value.trim();
+    return undefined;
+}
+function normalizeSessionId(sessionId) {
+    const trimmed = sessionId?.trim();
+    return trimmed ? trimmed : undefined;
+}
+function readBoolean(config, key, fallback) {
+    const value = config[key];
+    if (typeof value === 'boolean')
+        return value;
+    return fallback;
+}
+function normalizeIntensity(value) {
+    return value === 'gentle' || value === 'normal' || value === 'aggressive' || value === 'critical'
+        ? value
+        : 'normal';
+}
+function normalizeAudience(value) {
+    return value === 'personal' || value === 'team' || value === 'ops' || value === 'customer'
+        ? value
+        : 'personal';
+}
+function extractTriggerConfig(workflow, node) {
+    const rawConfig = isRecord(node.data?.config) ? node.data.config : {};
+    const cron = readString(rawConfig, 'scheduleCron');
+    if (!cron) {
+        return { warning: `schedule_trigger node ${node.id} is missing scheduleCron` };
+    }
+    if (getNextCronTime(cron, Date.now()) === null) {
+        return { warning: `schedule_trigger node ${node.id} has invalid cron: ${cron}` };
+    }
+    const workflowInput = isRecord(rawConfig.scheduleWorkflowInput) ? rawConfig.scheduleWorkflowInput : {};
+    const sessionId = readString(rawConfig, 'scheduleSessionId') ?? normalizeSessionId(workflow.config.sessionId);
+    if (!sessionId) {
+        return { warning: `schedule_trigger node ${node.id} is missing sessionId; set scheduleSessionId or workflow.config.sessionId` };
+    }
+    return {
+        config: {
+            cron,
+            sessionId,
+            prompt: readString(rawConfig, 'schedulePrompt') || node.data?.label || `Workflow trigger ${node.id}`,
+            recurring: readBoolean(rawConfig, 'scheduleRecurring', true),
+            durable: readBoolean(rawConfig, 'scheduleDurable', true),
+            enabled: readBoolean(rawConfig, 'scheduleEnabled', true),
+            intensity: normalizeIntensity(rawConfig.scheduleIntensity),
+            audience: normalizeAudience(rawConfig.scheduleAudience),
+            workflowInput: workflowInput,
+        },
+    };
+}
+function currentTriggerNodeIds(workflow) {
+    return new Set(workflow.nodes.filter(node => node.data?.type === 'schedule_trigger').map(node => node.id));
+}
+export function syncWorkflowScheduleTriggers(workflow, scheduledTaskManager) {
+    const result = {
+        workflowId: workflow.id,
+        synced: [],
+        deleted: [],
+        warnings: [],
+        errors: [],
+    };
+    const triggerNodeIds = currentTriggerNodeIds(workflow);
+    const existingTasks = scheduledTaskManager.getTasksBySource(SOURCE_TYPE, workflow.id);
+    const existingByNode = new Map(existingTasks.map(task => [task.source_node_id, task]));
+    for (const task of existingTasks) {
+        if (!task.source_node_id || !triggerNodeIds.has(task.source_node_id)) {
+            scheduledTaskManager.deleteTask(task.id);
+            result.deleted.push({ nodeId: task.source_node_id || '<unknown>', taskId: task.id, reason: 'removed' });
+        }
+    }
+    for (const node of workflow.nodes) {
+        if (node.data?.type !== 'schedule_trigger')
+            continue;
+        const extracted = extractTriggerConfig(workflow, node);
+        if (!extracted.config) {
+            if (extracted.warning)
+                result.warnings.push(extracted.warning);
+            const existing = existingByNode.get(node.id);
+            if (existing) {
+                scheduledTaskManager.deleteTask(existing.id);
+                result.deleted.push({ nodeId: node.id, taskId: existing.id, reason: 'invalid' });
+            }
+            continue;
+        }
+        const existed = existingByNode.has(node.id);
+        try {
+            const upserted = scheduledTaskManager.upsertTaskBySource({
+                sourceType: SOURCE_TYPE,
+                sourceId: workflow.id,
+                sourceNodeId: node.id,
+                cron: extracted.config.cron,
+                prompt: extracted.config.prompt,
+                recurring: extracted.config.recurring,
+                durable: extracted.config.durable,
+                enabled: extracted.config.enabled,
+                sessionId: extracted.config.sessionId,
+                taskType: 'workflow',
+                workflowId: workflow.id,
+                workflowInput: extracted.config.workflowInput,
+                intensity: extracted.config.intensity,
+                audience: extracted.config.audience,
+            });
+            result.synced.push({
+                nodeId: node.id,
+                taskId: upserted.id,
+                cron: extracted.config.cron,
+                status: existed ? 'updated' : 'created',
+                next_run_at: upserted.next_run_at,
+            });
+        }
+        catch (error) {
+            result.errors.push(`schedule_trigger node ${node.id} sync failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    return result;
+}
+export function deleteWorkflowScheduleTriggers(workflowId, scheduledTaskManager) {
+    const existingTasks = scheduledTaskManager.getTasksBySource(SOURCE_TYPE, workflowId);
+    scheduledTaskManager.deleteTasksBySource(SOURCE_TYPE, workflowId);
+    return {
+        workflowId,
+        synced: [],
+        deleted: existingTasks.map((task) => ({
+            nodeId: task.source_node_id || '<unknown>',
+            taskId: task.id,
+            reason: 'removed',
+        })),
+        warnings: [],
+        errors: [],
+    };
+}
+//# sourceMappingURL=ScheduleTriggerSync.js.map

package/dist/core/workflow/ScheduleTriggerSync.js.map

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

package/dist/core/workflow/VariableResolver.d.ts

@@ -0,0 +1,83 @@
+/**
+ * 变量解析器
+ *
+ * 解析 workflow 中的变量引用语法：
+ * - ${workflow.variables.userName} - 全局变量
+ * - ${node_id.outputs.result} - 节点输出
+ * - ${context.sessionId} - 执行上下文
+ * - ${env.WORKSPACE} - 环境变量
+ * - ${input.userInput} - 输入节点数据
+ * - ${node_id.outputs.data.items[0].name} - JSONPath 深度访问
+ * - ${node_id.outputs.result || 'default'} - 默认值
+ */
+import type { VariableScope } from './types.js';
+export declare class VariableResolver {
+    /**
+     * 解析模板字符串中的变量引用
+     *
+     * @param template - 包含 ${...} 语法的模板字符串
+     * @param scope - 变量作用域
+     * @returns 解析后的字符串
+     */
+    resolve(template: string, scope: VariableScope): unknown;
+    /**
+     * 解析单个表达式
+     *
+     * @param expression - 表达式字符串（不含 ${}）
+     * @param scope - 变量作用域
+     * @returns 解析后的值
+     */
+    private resolveExpression;
+    /**
+     * 解析默认值
+     *
+     * @param defaultExpr - 默认值表达式
+     * @param scope - 变量作用域
+     * @returns 解析后的默认值
+     */
+    private parseDefaultValue;
+    /**
+     * 解析对象中的所有变量引用
+     *
+     * @param obj - 包含变量引用的对象
+     * @param scope - 变量作用域
+     * @returns 解析后的对象
+     */
+    resolveObject<T extends Record<string, unknown>>(obj: T, scope: VariableScope): T;
+    /**
+     * 检查字符串是否包含变量引用
+     *
+     * @param str - 待检查的字符串
+     * @returns 是否包含变量引用
+     */
+    hasVariableReference(str: string): boolean;
+    /**
+     * 提取字符串中的所有变量引用
+     *
+     * @param str - 待提取的字符串
+     * @returns 变量引用列表
+     */
+    extractVariableReferences(str: string): string[];
+    /**
+     * 验证变量引用是否有效
+     *
+     * @param expression - 变量引用表达式
+     * @param scope - 变量作用域
+     * @returns 是否有效
+     */
+    isValidReference(expression: string, scope: VariableScope): boolean;
+    /**
+     * 检测循环引用
+     *
+     * @param template - 模板字符串
+     * @param scope - 变量作用域
+     * @param visited - 已访问的变量集合
+     * @returns 是否存在循环引用
+     */
+    detectCircularReference(template: string, scope: VariableScope, visited?: Set<string>): boolean;
+}
+/**
+ * 创建默认的变量解析器实例
+ */
+export declare function createVariableResolver(): VariableResolver;
+//# sourceMappingURL=VariableResolver.d.ts.map

package/dist/core/workflow/VariableResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VariableResolver.d.ts","sourceRoot":"","sources":["../../../src/core/workflow/VariableResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAchD,qBAAa,gBAAgB;IAC3B;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO;IAyBxD;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IA8EzB;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAsBzB;;;;;;OAMG;IACH,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,aAAa,GAAG,CAAC;IAsBjF;;;;;OAKG;IACH,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAO1C;;;;;OAKG;IACH,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE;IAgBhD;;;;;;OAMG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO;IASnE;;;;;;;OAOG;IACH,uBAAuB,CACrB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,EACpB,OAAO,GAAE,GAAG,CAAC,MAAM,CAAa,GAC/B,OAAO;CA0BX;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAEzD"}