@lingxiao-office/sdk 1.0.0

package/dist/tools/implementations/workflow/WorkflowCreateTool.d.ts

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+import { Tool, type ToolContext, type ToolResult } from '../../Tool.js';
+export declare class WorkflowCreateTool extends Tool {
+    readonly name = "__workflow_delegate_create";
+    readonly description = "\u521B\u5EFA\u65B0\u7684 workflow\u3002\n\nWorkflow \u662F\u4E00\u4E2A\u53EF\u89C6\u5316\u4EFB\u52A1\u6D41\u7A0B\u56FE\uFF0C\u5305\u542B\u8282\u70B9\u3001\u63A7\u5236\u8FB9\u548C\u6570\u636E\u8FB9\u3002\u521B\u5EFA\u540E\u8FD4\u56DE workflowId\uFF0C\u53EF\u7EE7\u7EED\u6DFB\u52A0\u8282\u70B9\u3001\u8FDE\u8FB9\u3001\u6267\u884C\u3002\n\n\u9002\u7528\u573A\u666F\uFF1A\n- \u591A\u6B65\u9AA4\u590D\u6742\u4EFB\u52A1\n- \u9700\u8981 condition / loop / parallel \u63A7\u5236\u6D41\n- \u9700\u8981 tool + agent \u6DF7\u5408\u6267\u884C\n- \u9700\u8981\u53EF\u89C6\u5316\u5C55\u793A\u4E0E\u53EF\u8BCA\u65AD\u6267\u884C\u72B6\u6001\n\n\u8FD4\u56DE\uFF1A\n- workflowId: \u751F\u6210\u7684 workflow ID\n- status: 'created'\n- name: workflow \u540D\u79F0\n- message: \u4E0B\u4E00\u6B65\u5EFA\u8BAE\n\n\t\u5EFA\u8BAE\u7EED\u63A5\uFF1A\n\t1. \u7528 workflow(action=\"add_node\") \u6DFB\u52A0\u7A33\u5B9A node_id \u7684\u8282\u70B9\n\t2. \u7528 workflow(action=\"connect\") \u5EFA\u7ACB\u63A7\u5236\u6D41\u548C data mapping\n\t3. \u7528 workflow(action=\"execute\") \u8FD0\u884C\uFF0C\u518D\u7528 workflow(action=\"get_status\") \u67E5\u770B\u72B6\u6001";
+    readonly parameters: z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodObject<{
+            tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            author: z.ZodOptional<z.ZodString>;
+            version: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    execute(args: unknown, context?: ToolContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=WorkflowCreateTool.d.ts.map

package/dist/tools/implementations/workflow/WorkflowCreateTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowCreateTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/implementations/workflow/WorkflowCreateTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAYxE,qBAAa,kBAAmB,SAAQ,IAAI;IAC1C,QAAQ,CAAC,IAAI,gCAAgC;IAC7C,QAAQ,CAAC,WAAW,0nCAmBqD;IAEzE,QAAQ,CAAC,UAAU;;;;;;;;uBAAwB;IAErC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CA4CzE"}

package/dist/tools/implementations/workflow/WorkflowCreateTool.js

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+import { Tool } from '../../Tool.js';
+const WorkflowCreateSchema = z.object({
+    name: z.string().describe('Workflow 名称'),
+    description: z.string().optional().describe('Workflow 描述'),
+    metadata: z.object({
+        tags: z.array(z.string()).optional().describe('标签'),
+        author: z.string().optional().describe('作者'),
+        version: z.string().optional().describe('版本')
+    }).strict().optional().describe('元数据')
+}).strict();
+export class WorkflowCreateTool extends Tool {
+    name = '__workflow_delegate_create';
+    description = `创建新的 workflow。
+
+Workflow 是一个可视化任务流程图，包含节点、控制边和数据边。创建后返回 workflowId，可继续添加节点、连边、执行。
+
+适用场景：
+- 多步骤复杂任务
+- 需要 condition / loop / parallel 控制流
+- 需要 tool + agent 混合执行
+- 需要可视化展示与可诊断执行状态
+
+返回：
+- workflowId: 生成的 workflow ID
+- status: 'created'
+- name: workflow 名称
+- message: 下一步建议
+
+	建议续接：
+	1. 用 workflow(action="add_node") 添加稳定 node_id 的节点
+	2. 用 workflow(action="connect") 建立控制流和 data mapping
+	3. 用 workflow(action="execute") 运行，再用 workflow(action="get_status") 查看状态`;
+    parameters = WorkflowCreateSchema;
+    async execute(args, context) {
+        const params = WorkflowCreateSchema.parse(args);
+        // 获取 WorkflowManager
+        const workflowManager = context?.workflowManager;
+        if (!workflowManager) {
+            return {
+                success: false,
+                data: null,
+                error: 'WorkflowManager not available in context'
+            };
+        }
+        try {
+            const workflowId = await workflowManager.create({
+                name: params.name,
+                description: params.description,
+                tags: params.metadata?.tags,
+                createdBy: params.metadata?.author,
+                config: {
+                    variables: {},
+                    workspace: context?.workspace,
+                    sessionId: context?.sessionId,
+                }
+            });
+            return {
+                success: true,
+                data: {
+                    workflowId,
+                    status: 'created',
+                    name: params.name,
+                    nextSuggestedTools: ['workflow(action="add_node")', 'workflow(action="connect")', 'workflow(action="execute")'],
+                    message: 'Workflow created successfully. Add stable node IDs with workflow(action="add_node"), then connect nodes and execute.'
+                }
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                data: null,
+                error: error instanceof Error ? error.message : 'Failed to create workflow'
+            };
+        }
+    }
+}
+//# sourceMappingURL=WorkflowCreateTool.js.map

package/dist/tools/implementations/workflow/WorkflowCreateTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowCreateTool.js","sourceRoot":"","sources":["../../../../src/tools/implementations/workflow/WorkflowCreateTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAqC,MAAM,eAAe,CAAC;AAExE,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;IACxC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;IAC1D,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC;QACjB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;QACnD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;QAC5C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;KAC9C,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;CACvC,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,OAAO,kBAAmB,SAAQ,IAAI;IACjC,IAAI,GAAG,4BAA4B,CAAC;IACpC,WAAW,GAAG;;;;;;;;;;;;;;;;;;;0EAmBiD,CAAC;IAEhE,UAAU,GAAG,oBAAoB,CAAC;IAE3C,KAAK,CAAC,OAAO,CAAC,IAAa,EAAE,OAAqB;QAChD,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEhD,qBAAqB;QACrB,MAAM,eAAe,GAAG,OAAO,EAAE,eAAmH,CAAC;QACrJ,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,IAAI;gBACV,KAAK,EAAE,0CAA0C;aAClD,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC;gBAC9C,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI;gBAC3B,SAAS,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM;gBAClC,MAAM,EAAE;oBACN,SAAS,EAAE,EAAE;oBACb,SAAS,EAAE,OAAO,EAAE,SAAS;oBAC7B,SAAS,EAAE,OAAO,EAAE,SAAS;iBAC9B;aACF,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE;oBACJ,UAAU;oBACV,MAAM,EAAE,SAAS;oBACjB,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,kBAAkB,EAAE,CAAC,6BAA6B,EAAE,4BAA4B,EAAE,4BAA4B,CAAC;oBAC/G,OAAO,EAAE,sHAAsH;iBAChI;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,IAAI;gBACV,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B;aAC5E,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/tools/implementations/workflow/WorkflowExecuteTool.d.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import { Tool, type ToolContext, type ToolResult } from '../../Tool.js';
+export declare class WorkflowExecuteTool extends Tool {
+    readonly name = "__workflow_delegate_execute";
+    readonly description = "\u6267\u884C workflow\u3002\n\n\u6267\u884C\u6A21\u5F0F\uFF1A\n- sync: \u540C\u6B65\u6267\u884C\uFF0C\u7B49\u5F85 workflow \u5B8C\u6210\u540E\u8FD4\u56DE\u7ED3\u679C\n- async: \u5F02\u6B65\u6267\u884C\uFF0C\u7ACB\u5373\u8FD4\u56DE execution_id\uFF0C\u53EF\u7528 workflow(action=\"get_status\") \u67E5\u8BE2\u72B6\u6001";
+    readonly parameters: z.ZodObject<{
+        workflow_id: z.ZodString;
+        input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        options: z.ZodOptional<z.ZodObject<{
+            mode: z.ZodDefault<z.ZodEnum<{
+                async: "async";
+                sync: "sync";
+            }>>;
+            timeout: z.ZodOptional<z.ZodNumber>;
+            onProgress: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    execute(args: unknown, context?: ToolContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=WorkflowExecuteTool.d.ts.map

package/dist/tools/implementations/workflow/WorkflowExecuteTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowExecuteTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/implementations/workflow/WorkflowExecuteTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AA+BxE,qBAAa,mBAAoB,SAAQ,IAAI;IAC3C,QAAQ,CAAC,IAAI,iCAAiC;IAC9C,QAAQ,CAAC,WAAW,oUAIiD;IAErE,QAAQ,CAAC,UAAU;;;;;;;;;;;uBAAyB;IAEtC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CA4IzE"}

package/dist/tools/implementations/workflow/WorkflowExecuteTool.js

@@ -0,0 +1,178 @@
+import { z } from 'zod';
+import { Tool } from '../../Tool.js';
+import { normalizeWorkflowExecutionStatus, normalizeWorkflowNodeStatus, } from '../../../core/StateSemantics.js';
+const WorkflowExecuteOptionsSchema = z
+    .object({
+    mode: z.enum(['sync', 'async']).default('async').describe('执行模式'),
+    timeout: z.number().optional().describe('超时时间（毫秒）'),
+    onProgress: z.boolean().default(false).describe('是否返回进度事件')
+})
+    .strict();
+const WorkflowExecuteSchema = z.object({
+    workflow_id: z.string().describe('Workflow ID'),
+    input: z.record(z.string(), z.unknown()).optional().describe('输入数据'),
+    options: WorkflowExecuteOptionsSchema.optional().describe('执行选项')
+}).strict();
+function summarizeStatus(status) {
+    if (!status)
+        return undefined;
+    const entries = Array.from(status.nodeExecutions.values());
+    return {
+        nodeExecutions: entries,
+        runningNodes: entries.filter((e) => normalizeWorkflowNodeStatus(e.status) === 'running').map((e) => e.nodeId),
+        failedNode: entries.find((e) => normalizeWorkflowNodeStatus(e.status) === 'failed'),
+    };
+}
+export class WorkflowExecuteTool extends Tool {
+    name = '__workflow_delegate_execute';
+    description = `执行 workflow。
+
+执行模式：
+- sync: 同步执行，等待 workflow 完成后返回结果
+- async: 异步执行，立即返回 execution_id，可用 workflow(action="get_status") 查询状态`;
+    parameters = WorkflowExecuteSchema;
+    async execute(args, context) {
+        const params = WorkflowExecuteSchema.parse(args);
+        const workflowEngine = context?.workflowEngine;
+        if (!workflowEngine) {
+            return {
+                success: false,
+                data: null,
+                error: 'WorkflowEngine not available in context'
+            };
+        }
+        try {
+            const mode = params.options?.mode || 'async';
+            const sessionId = context?.sessionId;
+            const commonOpts = {
+                timeout: params.options?.timeout,
+                sessionId,
+            };
+            if (mode === 'async') {
+                const executionId = await workflowEngine.execute(params.workflow_id, params.input, commonOpts);
+                return {
+                    success: true,
+                    data: {
+                        executionId,
+                        status: 'running',
+                        nextSuggestedTool: 'workflow(action="get_status")',
+                        message: 'Workflow execution started. Use workflow(action="get_status") to check progress.'
+                    }
+                };
+            }
+            // sync: 事件驱动等待；无 emitter 时轮询执行状态。
+            const executionId = await workflowEngine.execute(params.workflow_id, params.input, commonOpts);
+            const emitter = context?.emitter;
+            const timeoutMs = params.options?.timeout ?? 600_000;
+            const waitedResult = await new Promise((resolve) => {
+                let done = false;
+                const finish = (payload) => {
+                    if (done)
+                        return;
+                    done = true;
+                    clearTimeout(timer);
+                    unsubOk?.();
+                    unsubFail?.();
+                    unsubCancel?.();
+                    resolve(payload);
+                };
+                const timer = setTimeout(() => finish({ kind: 'timeout' }), timeoutMs);
+                let unsubOk;
+                let unsubFail;
+                let unsubCancel;
+                if (emitter && typeof emitter.subscribe === 'function') {
+                    unsubOk = emitter.subscribe('workflow:execution_completed', (data) => {
+                        if (data?.executionId === executionId)
+                            finish({ kind: 'completed' });
+                    });
+                    unsubFail = emitter.subscribe('workflow:execution_failed', (data) => {
+                        if (data?.executionId !== executionId)
+                            return;
+                        const isTimeout = data?.reason === 'timeout' || typeof data?.timeoutMs === 'number';
+                        finish({ kind: isTimeout ? 'timeout' : 'failed' });
+                    });
+                    unsubCancel = emitter.subscribe('workflow:execution_cancelled', (data) => {
+                        if (data?.executionId === executionId)
+                            finish({ kind: 'cancelled' });
+                    });
+                }
+                else {
+                    const poll = async () => {
+                        while (!done) {
+                            const status = workflowEngine.getStatus(executionId);
+                            if (!status) {
+                                finish({ kind: 'failed' });
+                                return;
+                            }
+                            const normalized = normalizeWorkflowExecutionStatus(status.status);
+                            if (normalized === 'completed') {
+                                finish({ kind: 'completed' });
+                                return;
+                            }
+                            if (normalized === 'failed') {
+                                finish({ kind: 'failed' });
+                                return;
+                            }
+                            // 轮询路径也必须识别 cancelled，否则同步工具会一直等到 timeout。
+                            if (normalized === 'cancelled') {
+                                finish({ kind: 'cancelled' });
+                                return;
+                            }
+                            await new Promise((r) => setTimeout(r, 250));
+                        }
+                    };
+                    void poll();
+                }
+            });
+            const status = workflowEngine.getStatus(executionId);
+            if (waitedResult.kind === 'timeout') {
+                const latestStatus = status ? normalizeWorkflowExecutionStatus(status.status) : 'running';
+                return {
+                    success: false,
+                    data: { executionId, status: latestStatus, debug: summarizeStatus(status) },
+                    error: `Workflow execution timed out after ${timeoutMs}ms (still ${latestStatus}). Use workflow(action="get_status") to keep polling.`,
+                };
+            }
+            if (!status) {
+                return { success: false, data: null, error: 'Execution not found' };
+            }
+            const debug = summarizeStatus(status);
+            const normalizedStatus = normalizeWorkflowExecutionStatus(status.status);
+            if (normalizedStatus === 'completed') {
+                return {
+                    success: true,
+                    data: {
+                        executionId,
+                        status: normalizedStatus,
+                        output: status.variables.get('__output__'),
+                        metrics: {
+                            duration: status.endTime ? status.endTime - status.startTime : 0,
+                            nodesExecuted: status.nodeExecutions.size,
+                        },
+                        debug,
+                    },
+                };
+            }
+            if (normalizedStatus === 'cancelled') {
+                return {
+                    success: false,
+                    data: { executionId, status: normalizedStatus, error: status.error, debug },
+                    error: status.error || 'Workflow execution cancelled',
+                };
+            }
+            return {
+                success: false,
+                data: { executionId, status: normalizedStatus, error: status.error, debug },
+                error: status.error || debug?.failedNode?.error || 'Workflow execution failed',
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                data: null,
+                error: error instanceof Error ? error.message : 'Failed to execute workflow'
+            };
+        }
+    }
+}
+//# sourceMappingURL=WorkflowExecuteTool.js.map

package/dist/tools/implementations/workflow/WorkflowExecuteTool.js.map

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

package/dist/tools/implementations/workflow/WorkflowGetStatusTool.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+import { Tool, type ToolContext, type ToolResult } from '../../Tool.js';
+export declare class WorkflowGetStatusTool extends Tool {
+    readonly name = "__workflow_delegate_get_status";
+    readonly description = "\u67E5\u8BE2 workflow \u6267\u884C\u72B6\u6001\u3002\n\n\u8FD4\u56DE\u4FE1\u606F\uFF1A\n- executionId: \u6267\u884C ID\n- workflowId: Workflow ID\n- status: running | completed | failed | paused\n- progress: \u5F53\u524D\u5DF2\u8BB0\u5F55\u7684\u8282\u70B9\u6267\u884C\u72B6\u6001\u7EDF\u8BA1\uFF08completed / total / percentage\uFF09\n- startTime: \u5F00\u59CB\u65F6\u95F4\n- endTime: \u7ED3\u675F\u65F6\u95F4\uFF08\u5982\u679C\u5DF2\u5B8C\u6210\uFF09\n- output: \u6267\u884C\u7ED3\u679C\uFF08\u5982\u679C\u5DF2\u5B8C\u6210\uFF09\n- error: \u9519\u8BEF\u4FE1\u606F\uFF08\u5982\u679C\u5931\u8D25\uFF09\n- logs: \u6267\u884C\u65E5\u5FD7\uFF08\u5982\u679C include_logs=true\uFF09\n- nodeExecutions: \u6BCF\u4E2A\u8282\u70B9\u7684\u6267\u884C\u72B6\u6001\n\n\u6CE8\u610F\uFF1Aprogress \u57FA\u4E8E\u5F53\u524D executionContext \u4E2D\u5DF2\u8BB0\u5F55\u7684\u8282\u70B9\u6267\u884C\u6761\u76EE\uFF0C\u4E0D\u662F workflow \u9759\u6001\u603B\u8282\u70B9\u6570\u3002";
+    readonly parameters: z.ZodObject<{
+        execution_id: z.ZodString;
+        include_logs: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>;
+    execute(args: unknown, context?: ToolContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=WorkflowGetStatusTool.d.ts.map

package/dist/tools/implementations/workflow/WorkflowGetStatusTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowGetStatusTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/implementations/workflow/WorkflowGetStatusTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AA+BxE,qBAAa,qBAAsB,SAAQ,IAAI;IAC7C,QAAQ,CAAC,IAAI,oCAAoC;IACjD,QAAQ,CAAC,WAAW,s8BAc6C;IAEjE,QAAQ,CAAC,UAAU;;;uBAA2B;IAExC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAoEzE"}

package/dist/tools/implementations/workflow/WorkflowGetStatusTool.js

@@ -0,0 +1,87 @@
+import { z } from 'zod';
+import { Tool } from '../../Tool.js';
+import { normalizeWorkflowExecutionStatus, normalizeWorkflowNodeStatus, } from '../../../core/StateSemantics.js';
+const WorkflowGetStatusSchema = z.object({
+    execution_id: z.string().describe('执行 ID'),
+    include_logs: z.boolean().default(false).describe('是否包含详细日志')
+}).strict();
+export class WorkflowGetStatusTool extends Tool {
+    name = '__workflow_delegate_get_status';
+    description = `查询 workflow 执行状态。
+
+返回信息：
+- executionId: 执行 ID
+- workflowId: Workflow ID
+- status: running | completed | failed | paused
+- progress: 当前已记录的节点执行状态统计（completed / total / percentage）
+- startTime: 开始时间
+- endTime: 结束时间（如果已完成）
+- output: 执行结果（如果已完成）
+- error: 错误信息（如果失败）
+- logs: 执行日志（如果 include_logs=true）
+- nodeExecutions: 每个节点的执行状态
+
+注意：progress 基于当前 executionContext 中已记录的节点执行条目，不是 workflow 静态总节点数。`;
+    parameters = WorkflowGetStatusSchema;
+    async execute(args, context) {
+        const params = WorkflowGetStatusSchema.parse(args);
+        const workflowEngine = context?.workflowEngine;
+        if (!workflowEngine) {
+            return {
+                success: false,
+                data: null,
+                error: 'WorkflowEngine not available in context'
+            };
+        }
+        try {
+            const executionContext = workflowEngine.getStatus(params.execution_id);
+            if (!executionContext) {
+                return {
+                    success: false,
+                    data: null,
+                    error: 'Execution not found'
+                };
+            }
+            const nodeEntries = Array.from(executionContext.nodeExecutions.values());
+            const totalNodes = nodeEntries.length;
+            const completedNodes = nodeEntries.filter((e) => normalizeWorkflowNodeStatus(e.status) === 'completed').length;
+            const executionStatus = normalizeWorkflowExecutionStatus(executionContext.status);
+            const result = {
+                executionId: params.execution_id,
+                workflowId: executionContext.workflowId,
+                status: executionStatus,
+                progress: {
+                    completedNodes,
+                    totalNodes,
+                    percentage: totalNodes > 0 ? Math.round((completedNodes / totalNodes) * 100) : 0
+                },
+                startTime: executionContext.startTime,
+                endTime: executionContext.endTime,
+                nodeExecutions: nodeEntries,
+                runningNodes: nodeEntries.filter((e) => normalizeWorkflowNodeStatus(e.status) === 'running').map((e) => e.nodeId),
+                failedNode: nodeEntries.find((e) => normalizeWorkflowNodeStatus(e.status) === 'failed')?.nodeId,
+            };
+            if (executionStatus === 'completed') {
+                result.output = executionContext.variables.get('__output__');
+            }
+            if (executionStatus === 'failed') {
+                result.error = executionContext.error;
+            }
+            if (params.include_logs) {
+                result.logs = executionContext.logs;
+            }
+            return {
+                success: true,
+                data: result
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                data: null,
+                error: error instanceof Error ? error.message : 'Failed to get status'
+            };
+        }
+    }
+}
+//# sourceMappingURL=WorkflowGetStatusTool.js.map

package/dist/tools/implementations/workflow/WorkflowGetStatusTool.js.map

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

package/dist/tools/implementations/workflow/WorkflowInspectTool.d.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+import { Tool, type ToolContext, type ToolResult } from '../../Tool.js';
+export declare class WorkflowInspectTool extends Tool {
+    readonly name = "__workflow_delegate_inspect";
+    readonly description = "\u67E5\u770B workflow \u5F53\u524D\u56FE\u7ED3\u6784\uFF0C\u8FD4\u56DE LLM \u53EF\u7EED\u63A5\u7684\u8282\u70B9\u3001\u8FB9\u3001\u6309\u8282\u70B9\u805A\u5408\u89C6\u56FE\u548C\u4E0B\u4E00\u6B65\u5EFA\u8BAE\u3002\n\n\u7528\u9014\uFF1A\n- \u8FDE\u63A5\u8282\u70B9\u524D\u786E\u8BA4\u5F53\u524D node_id\n- \u5931\u8D25\u540E\u68C0\u67E5\u5DF2\u6709\u8282\u70B9/\u8FB9\n- \u6267\u884C\u524D\u786E\u8BA4 condition / loop / parallel \u7ED3\u6784\u662F\u5426\u5B8C\u6574\n\n\u8FD4\u56DE\uFF1A\n- workflowId / name / version\n- nodes: \u5F53\u524D\u8282\u70B9\u5217\u8868\uFF08id / label / type / config\uFF09\n- edges: \u5F53\u524D\u8FB9\u5217\u8868\uFF08id / source / target / type / conditionValue / dataMapping\uFF09\n- graph: \u6309\u8282\u70B9\u805A\u5408\u7684 incoming/outgoing/body/branch/exit \u8FB9\uFF0C\u9002\u5408 LLM \u8BFB\u56FE\n- llmSummary: \u53EF\u76F4\u63A5\u9605\u8BFB\u7684\u6587\u672C\u6458\u8981\n- diagnostics.nextSuggestedActions: \u53EF\u6267\u884C\u7684\u4E0B\u4E00\u6B65\u5DE5\u5177\u5EFA\u8BAE";
+    readonly parameters: z.ZodObject<{
+        workflow_id: z.ZodString;
+    }, z.core.$strict>;
+    execute(args: unknown, context?: ToolContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=WorkflowInspectTool.d.ts.map

package/dist/tools/implementations/workflow/WorkflowInspectTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowInspectTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/implementations/workflow/WorkflowInspectTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AA4DxE,qBAAa,mBAAoB,SAAQ,IAAI;IAC3C,QAAQ,CAAC,IAAI,iCAAiC;IAC9C,QAAQ,CAAC,WAAW,ggCAa2B;IAE/C,QAAQ,CAAC,UAAU;;uBAAyB;IAEtC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAiDzE"}

package/dist/tools/implementations/workflow/WorkflowInspectTool.js

@@ -0,0 +1,186 @@
+import { z } from 'zod';
+import { Tool } from '../../Tool.js';
+const WorkflowInspectSchema = z.object({
+    workflow_id: z.string().describe('Workflow ID')
+}).strict();
+export class WorkflowInspectTool extends Tool {
+    name = '__workflow_delegate_inspect';
+    description = `查看 workflow 当前图结构，返回 LLM 可续接的节点、边、按节点聚合视图和下一步建议。
+
+用途：
+- 连接节点前确认当前 node_id
+- 失败后检查已有节点/边
+- 执行前确认 condition / loop / parallel 结构是否完整
+
+返回：
+- workflowId / name / version
+- nodes: 当前节点列表（id / label / type / config）
+- edges: 当前边列表（id / source / target / type / conditionValue / dataMapping）
+- graph: 按节点聚合的 incoming/outgoing/body/branch/exit 边，适合 LLM 读图
+- llmSummary: 可直接阅读的文本摘要
+- diagnostics.nextSuggestedActions: 可执行的下一步工具建议`;
+    parameters = WorkflowInspectSchema;
+    async execute(args, context) {
+        const params = WorkflowInspectSchema.parse(args);
+        const workflowManager = context?.workflowManager;
+        if (!workflowManager) {
+            return { success: false, data: null, error: 'WorkflowManager not available in context' };
+        }
+        try {
+            const workflow = await workflowManager.get(params.workflow_id);
+            if (!workflow) {
+                return { success: false, data: null, error: `Workflow not found: ${params.workflow_id}` };
+            }
+            const nodes = workflow.nodes.map((node) => ({
+                id: node.id,
+                label: node.data?.label,
+                type: node.data?.type,
+                config: node.data?.config ?? {},
+                inputs: node.data?.inputs ?? {},
+                outputs: node.data?.outputs ?? {}
+            }));
+            const edges = workflow.edges.map((edge) => ({
+                id: edge.id,
+                source: edge.source,
+                target: edge.target,
+                type: edge.data?.type ?? 'sequence',
+                conditionValue: edge.data?.conditionValue,
+                dataMapping: edge.data?.dataMapping ?? null
+            }));
+            const graph = buildGraph(nodes, edges);
+            const diagnostics = buildDiagnostics(nodes, edges, graph);
+            return {
+                success: true,
+                data: {
+                    workflowId: workflow.id,
+                    name: workflow.name,
+                    version: workflow.version,
+                    nodes,
+                    edges,
+                    graph,
+                    llmSummary: buildLlmSummary(nodes, edges, graph, diagnostics.nextSuggestedActions),
+                    diagnostics
+                }
+            };
+        }
+        catch (error) {
+            return { success: false, data: null, error: error instanceof Error ? error.message : 'Failed to inspect workflow' };
+        }
+    }
+}
+function edgeRef(edge) {
+    return {
+        edgeId: edge.id,
+        source: edge.source,
+        target: edge.target,
+        type: edge.type,
+        conditionValue: edge.conditionValue,
+        dataMapping: edge.dataMapping
+    };
+}
+function buildGraph(nodes, edges) {
+    return nodes.map(node => {
+        const incoming = edges.filter(edge => edge.target === node.id).map(edgeRef);
+        const outgoing = edges.filter(edge => edge.source === node.id).map(edgeRef);
+        const outgoingControl = outgoing.filter(edge => edge.type !== 'data');
+        const outgoingData = outgoing.filter(edge => edge.type === 'data');
+        const summary = {};
+        if (node.type === 'condition') {
+            const trueBranch = outgoing.find(edge => edge.type === 'condition' && edge.conditionValue === true) ?? null;
+            const falseBranch = outgoing.find(edge => edge.type === 'condition' && edge.conditionValue === false) ?? null;
+            summary.trueBranch = trueBranch;
+            summary.falseBranch = falseBranch;
+        }
+        if (node.type === 'loop') {
+            const bodyEdges = outgoing.filter(edge => edge.type === 'loop');
+            const exitEdges = outgoing.filter(edge => edge.type !== 'loop' && edge.type !== 'data');
+            summary.bodyEdges = bodyEdges;
+            summary.exitEdges = exitEdges;
+        }
+        if (node.type === 'parallel') {
+            const branchEdges = outgoing.filter(edge => edge.type === 'sequence');
+            const exitEdges = outgoing.filter(edge => edge.type !== 'sequence' && edge.type !== 'data');
+            summary.branchEdges = branchEdges;
+            summary.exitEdges = exitEdges;
+        }
+        return {
+            id: node.id,
+            label: node.label,
+            type: node.type,
+            config: node.config,
+            incoming,
+            outgoing,
+            outgoingControl,
+            outgoingData,
+            ...summary
+        };
+    });
+}
+function buildDiagnostics(nodes, edges, graph) {
+    const nextSuggestedActions = [];
+    const nodeIds = new Set(nodes.map(node => node.id));
+    const danglingEdges = edges.filter(edge => !nodeIds.has(edge.source) || !nodeIds.has(edge.target));
+    const unconnectedNodes = nodes.filter(node => !edges.some(edge => edge.source === node.id || edge.target === node.id));
+    const conditionNodes = graph.filter(node => node.type === 'condition');
+    const loopNodes = graph.filter(node => node.type === 'loop');
+    const parallelNodes = graph.filter(node => node.type === 'parallel');
+    for (const node of conditionNodes) {
+        if (!node.trueBranch)
+            nextSuggestedActions.push(`workflow(action="connect", workflow_id="<workflow_id>", source_node_id="${node.id}", target_node_id="<true_node>", edge_type="condition", condition_value=true)`);
+        if (!node.falseBranch)
+            nextSuggestedActions.push(`workflow(action="connect", workflow_id="<workflow_id>", source_node_id="${node.id}", target_node_id="<false_node>", edge_type="condition", condition_value=false)`);
+    }
+    for (const node of loopNodes) {
+        if (!node.bodyEdges || node.bodyEdges.length === 0) {
+            nextSuggestedActions.push(`workflow(action="connect", workflow_id="<workflow_id>", source_node_id="${node.id}", target_node_id="<body_entry>", edge_type="loop")`);
+        }
+    }
+    for (const node of parallelNodes) {
+        const branchCount = node.branchEdges?.length ?? 0;
+        if (branchCount < 2)
+            nextSuggestedActions.push(`workflow(action="connect", workflow_id="<workflow_id>", source_node_id="${node.id}", target_node_id="<branch_entry>", edge_type="sequence") — add ${2 - branchCount} more branch edge(s)`);
+    }
+    if (danglingEdges.length > 0)
+        nextSuggestedActions.push('Recreate the workflow without dangling edges');
+    if (nodes.length === 0)
+        nextSuggestedActions.push('workflow(action="add_node", workflow_id="<workflow_id>", node_id="start", node_type="input", label="Input")');
+    if (nodes.length > 0 && edges.length === 0)
+        nextSuggestedActions.push('Connect nodes with workflow(action="connect").');
+    if (nextSuggestedActions.length === 0)
+        nextSuggestedActions.push('workflow(action="validate", workflow_id="<workflow_id>") then workflow(action="execute", workflow_id="<workflow_id>", options={mode:"sync"})');
+    return {
+        nodeCount: nodes.length,
+        edgeCount: edges.length,
+        danglingEdges,
+        unconnectedNodes,
+        nextSuggestedActions
+    };
+}
+function buildLlmSummary(nodes, edges, graph, actions) {
+    const lines = [];
+    lines.push(`Workflow graph: ${nodes.length} node(s), ${edges.length} edge(s).`);
+    for (const node of graph) {
+        lines.push(`- ${node.id} [${node.type}] ${node.label ?? ''}`.trim());
+        if (node.type === 'condition') {
+            lines.push(`  condition: true -> ${node.trueBranch?.target ?? 'MISSING'}, false -> ${node.falseBranch?.target ?? 'MISSING'}`);
+        }
+        else if (node.type === 'loop') {
+            const body = (node.bodyEdges ?? []).map((edge) => edge.target).join(', ') || 'MISSING';
+            const exits = (node.exitEdges ?? []).map((edge) => edge.target).join(', ') || 'none';
+            lines.push(`  loop body -> ${body}; exits -> ${exits}`);
+        }
+        else if (node.type === 'parallel') {
+            const branches = (node.branchEdges ?? []).map((edge) => edge.target).join(', ') || 'MISSING';
+            const exits = (node.exitEdges ?? []).map((edge) => edge.target).join(', ') || 'none';
+            lines.push(`  parallel branches -> ${branches}; exits -> ${exits}`);
+        }
+        else if (node.outgoing.length > 0) {
+            lines.push(`  outgoing -> ${node.outgoing.map((edge) => `${edge.target}(${edge.type})`).join(', ')}`);
+        }
+    }
+    lines.push('Next suggested actions:');
+    for (const action of actions.slice(0, 5))
+        lines.push(`- ${action}`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=WorkflowInspectTool.js.map