@lingxiao-office/sdk 1.0.0

package/dist/tools/implementations/ParallelReadBatchTool.js

@@ -0,0 +1,90 @@
+import { z } from 'zod';
+import { Tool } from '../Tool.js';
+import { getToolMetadata, isParallelSafeTool } from '../ToolMetadata.js';
+const BatchOperationSchema = z.object({
+    id: z.string().optional().describe('调用标识，便于在结果中对应'),
+    tool: z.string().describe('只读且 parallelSafe 的工具名'),
+    args: z.unknown().optional().describe('工具参数'),
+});
+const ParallelReadBatchSchema = z.object({
+    operations: z.array(BatchOperationSchema).min(1).max(20).describe('要并行执行的只读工具调用'),
+    max_concurrency: z.number().int().min(1).max(8).optional().default(4).describe('并发上限，默认 4'),
+    allow_network: z.boolean().optional().default(false).describe('网络工具默认关闭；显式设为 true 后参与批处理'),
+});
+export class ParallelReadBatchTool extends Tool {
+    registry;
+    name = 'parallel_read_batch';
+    description = '显式并行只读批处理：并行执行 file_read/list_dir/glob/code_search 等安全读工具；写入、危险、非 parallelSafe 或预检失败的项会被跳过并在 rejected 中说明。';
+    parameters = ParallelReadBatchSchema;
+    constructor(registry) {
+        super();
+        this.registry = registry;
+    }
+    async execute(args, context) {
+        const params = args;
+        const rejected = [];
+        const accepted = params.operations.map((op, index) => {
+            const preflight = this.registry.preflight(op.tool, op.args ?? {}, context);
+            const meta = getToolMetadata(preflight.tool);
+            const allowed = preflight.ok &&
+                meta.readOnly === true &&
+                meta.modifiesWorkspace !== true &&
+                meta.dangerous !== true &&
+                isParallelSafeTool(preflight.tool) &&
+                (params.allow_network === true || meta.requiresNetwork !== true);
+            if (!allowed) {
+                rejected.push({
+                    index,
+                    id: op.id,
+                    tool: op.tool,
+                    reason: preflight.ok
+                        ? '工具不是安全并行只读工具，或需要网络/权限。'
+                        : preflight.repair?.message || '预检失败。',
+                    preflight,
+                });
+                return null;
+            }
+            return {
+                index,
+                id: op.id ?? String(index),
+                tool: preflight.tool,
+                args: preflight.normalizedArgs ?? op.args ?? {},
+            };
+        }).filter((op) => op !== null);
+        if (accepted.length === 0) {
+            return {
+                success: false,
+                data: { rejected, accepted_count: 0 },
+                error: `parallel_read_batch 没有可执行的安全只读调用；已跳过 ${rejected.length} 个不适合并行读取的调用。`,
+            };
+        }
+        const max = params.max_concurrency ?? 4;
+        const results = new Array(accepted.length);
+        let cursor = 0;
+        const workers = Array.from({ length: Math.min(max, accepted.length) }, async () => {
+            while (cursor < accepted.length) {
+                const current = cursor++;
+                const op = accepted[current];
+                results[current] = {
+                    index: op.index,
+                    id: op.id,
+                    tool: op.tool,
+                    result: await this.registry.execute(op.tool, op.args, context),
+                };
+            }
+        });
+        await Promise.all(workers);
+        return {
+            success: true,
+            data: {
+                count: results.length,
+                accepted_count: accepted.length,
+                rejected_count: rejected.length,
+                rejected,
+                results,
+            },
+        };
+    }
+}
+export default ParallelReadBatchTool;
+//# sourceMappingURL=ParallelReadBatchTool.js.map

package/dist/tools/implementations/ParallelReadBatchTool.js.map

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

package/dist/tools/implementations/ParseFileTool.d.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import { Tool, type ToolContext, type ToolResult } from '../Tool.js';
+export declare class ParseFileTool extends Tool {
+    readonly name = "parse_file";
+    readonly description = "\u89E3\u6790\u6587\u4EF6\u5185\u5BB9\uFF0C\u652F\u6301 PDF/Word/Excel/CSV/PowerPoint/ZIP \u7B49\u683C\u5F0F\u3002\u53EF\u5206\u9875/\u5206 sheet \u63D0\u53D6\u3002";
+    readonly parameters: z.ZodObject<{
+        path: z.ZodString;
+        mode: z.ZodOptional<z.ZodEnum<{
+            full: "full";
+            preview: "preview";
+            page: "page";
+            sheet: "sheet";
+        }>>;
+        page: z.ZodOptional<z.ZodNumber>;
+        sheet: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    execute(args: unknown, _context?: ToolContext): Promise<ToolResult>;
+}
+export default ParseFileTool;
+//# sourceMappingURL=ParseFileTool.d.ts.map

package/dist/tools/implementations/ParseFileTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParseFileTool.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/ParseFileTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAWrE,qBAAa,aAAc,SAAQ,IAAI;IACrC,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,WAAW,yKAAqE;IACzF,QAAQ,CAAC,UAAU;;;;;;;;;;sBAAmB;IAEhC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CA4C1E;AAED,eAAe,aAAa,CAAC"}

package/dist/tools/implementations/ParseFileTool.js

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+import { Tool } from '../Tool.js';
+import { parseFile } from './FileParser.js';
+import { existsSync } from 'fs';
+const ParseFileSchema = z.object({
+    path: z.string().describe('文件路径（必须是已上传的文件路径）'),
+    mode: z.enum(['preview', 'full', 'page', 'sheet']).optional().describe('解析模式：preview=快速预览(默认), full=完整内容, page=指定页码(PDF), sheet=指定工作表(Excel)'),
+    page: z.number().optional().describe('mode=page 时指定页码（1-based）'),
+    sheet: z.string().optional().describe('mode=sheet 时指定工作表名称'),
+});
+export class ParseFileTool extends Tool {
+    name = 'parse_file';
+    description = '解析文件内容，支持 PDF/Word/Excel/CSV/PowerPoint/ZIP 等格式。可分页/分 sheet 提取。';
+    parameters = ParseFileSchema;
+    async execute(args, _context) {
+        const params = args;
+        try {
+            if (!existsSync(params.path)) {
+                return {
+                    success: false,
+                    data: null,
+                    error: `文件不存在: ${params.path}`,
+                };
+            }
+            const result = await parseFile(params.path, params.mode || 'preview', { page: params.page, sheet: params.sheet });
+            const lines = [
+                `[格式: ${result.format}]`,
+            ];
+            if (result.metadata?.pages)
+                lines.push(`[页数: ${result.metadata.pages}]`);
+            if (typeof result.metadata?.hasTextLayer === 'boolean') {
+                lines.push(`[PDF 文本层: ${result.metadata.hasTextLayer ? '有' : '无 / 疑似扫描件'}]`);
+            }
+            if (result.metadata?.sheets)
+                lines.push(`[工作表: ${result.metadata.sheets.join(', ')}]`);
+            if (result.metadata?.slides)
+                lines.push(`[幻灯片: ${result.metadata.slides.length}]`);
+            if (result.metadata?.entries)
+                lines.push(`[条目数: ${result.metadata.entries.length}]`);
+            if (result.truncated)
+                lines.push('[⚠ 内容已截断，如需完整内容请使用 mode=full]');
+            lines.push('---');
+            lines.push(result.metadata?.plainText || result.content);
+            return {
+                success: true,
+                data: lines.join('\n'),
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                data: null,
+                error: `解析失败: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    }
+}
+export default ParseFileTool;
+//# sourceMappingURL=ParseFileTool.js.map

package/dist/tools/implementations/ParseFileTool.js.map

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

package/dist/tools/implementations/PythonExec.d.ts

@@ -0,0 +1,38 @@
+import { type ToolPermissionContext } from '../../core/PermissionSystem.js';
+/**
+ * PythonExec - Python 代码执行工具
+ *
+ * 在子进程中执行 Python 代码片段
+ * 参考 Python 版本的 python_exec 实现
+ */
+/** 流式输出回调：Python 子进程每收到一段 stdout/stderr 就推送（用于 agent/leader 卡片逐行流式）。 */
+export type PythonOutputSink = (chunk: string, stream: 'stdout' | 'stderr') => void;
+export interface PythonExecParams {
+    code: string;
+    timeout?: number;
+    max_output?: number;
+    permissionContext?: ToolPermissionContext;
+    workspace?: string;
+    sessionId?: string;
+    cwd?: string;
+    taskId?: string;
+    taskWorkingDirectory?: string;
+    taskWriteScope?: string[];
+    /** 流式输出回调。undefined 时静默（向后兼容单测）。由调用方注入 emitToolOutput 闭包。 */
+    onOutput?: PythonOutputSink;
+}
+export declare class PythonExec {
+    /**
+     * 执行 Python 代码
+     *
+     * @param params 执行参数
+     * @returns 执行结果
+     */
+    static execute(params: PythonExecParams): Promise<{
+        success: boolean;
+        data: string;
+        error?: string;
+    }>;
+}
+export default PythonExec;
+//# sourceMappingURL=PythonExec.d.ts.map

package/dist/tools/implementations/PythonExec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PythonExec.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/PythonExec.ts"],"names":[],"mappings":"AAMA,OAAO,EAAmC,KAAK,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAK7G;;;;;GAKG;AAEH,wEAAwE;AACxE,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,KAAK,IAAI,CAAC;AAEpF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,qBAAqB,CAAC;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B;AASD,qBAAa,UAAU;IACrB;;;;;OAKG;WACU,OAAO,CAClB,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAwL/D;AAED,eAAe,UAAU,CAAC"}

package/dist/tools/implementations/PythonExec.js

@@ -0,0 +1,204 @@
+import { spawn } from 'child_process';
+import { mkdirSync, writeFileSync, unlinkSync, existsSync } from 'fs';
+import { join } from 'path';
+import { tmpdir } from 'os';
+import { refreshRuntimeConfig } from '../../config.js';
+import { getPythonExecutable, getShellCommand } from '../../utils/platform.js';
+import { getDefaultToolPermissionContext } from '../../core/PermissionSystem.js';
+import { prepareExecutionSandbox } from './ExecutionSandbox.js';
+import { Workspace } from '../../core/Workspace.js';
+import { coreLogger } from '../../core/Log.js';
+function shellQuote(value) {
+    if (process.platform === 'win32') {
+        return `"${value.replace(/"/g, '""').replace(/%/g, '%%')}"`;
+    }
+    return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+export class PythonExec {
+    /**
+     * 执行 Python 代码
+     *
+     * @param params 执行参数
+     * @returns 执行结果
+     */
+    static async execute(params) {
+        const { code, timeout = 30, max_output = 20000 } = params;
+        refreshRuntimeConfig();
+        const permissionContext = params.permissionContext || getDefaultToolPermissionContext();
+        const workspace = params.workspace || process.cwd();
+        const networkMode = (permissionContext.mode === 'yolo' ? 'inherit' : permissionContext.mode === 'networked' ? 'allowlisted' : 'disabled');
+        // 限制代码大小
+        if (code.length > 100000) {
+            return {
+                success: false,
+                data: '',
+                error: '代码大小超过 100KB 限制',
+            };
+        }
+        let tmpPath = null;
+        try {
+            // 创建临时文件
+            const { randomUUID } = await import('crypto');
+            const tmpDir = params.sessionId
+                ? join(Workspace.getSessionArtifactPaths(params.sessionId, workspace).sessionDir, 'sandbox-tmp')
+                : tmpdir();
+            const tmpFileName = `python_exec_${randomUUID()}.py`;
+            tmpPath = join(tmpDir, tmpFileName);
+            const command = `${shellQuote(getPythonExecutable())} ${shellQuote(tmpPath)}`;
+            const sandbox = prepareExecutionSandbox({
+                workspace,
+                sessionId: params.sessionId,
+                cwd: params.cwd || params.taskWorkingDirectory,
+                command,
+                networkMode,
+                allowedHosts: permissionContext.allowedHosts,
+                backend: permissionContext.sandboxBackend,
+                taskId: params.taskId,
+                taskWorkingDirectory: params.taskWorkingDirectory,
+                taskWriteScope: params.taskWriteScope,
+            });
+            if (!sandbox.ok || !sandbox.cwd || !sandbox.env || !sandbox.plan) {
+                return {
+                    success: false,
+                    data: '',
+                    error: sandbox.error || 'ERROR: sandbox policy 拒绝执行 Python 代码',
+                };
+            }
+            mkdirSync(tmpDir, { recursive: true });
+            writeFileSync(tmpPath, code, 'utf-8');
+            // 执行 Python 代码（spawn 逐 chunk 流式：等价 execFile 的超时/沙箱/截断语义，
+            // 但能实时把 stdout/stderr 推到 agent/leader 工具卡片——治本流式输出）
+            const plan = sandbox.plan.mode === 'execFile' && sandbox.plan.args
+                ? { command: sandbox.plan.command, args: sandbox.plan.args }
+                : (() => {
+                    const shell = getShellCommand(sandbox.plan.command);
+                    return { command: shell.executable, args: shell.args };
+                })();
+            const child = spawn(plan.command, plan.args, {
+                cwd: sandbox.cwd,
+                env: sandbox.env,
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            // 累积上限（用于最终结果）：stdout 2MB（等价 execFile maxBuffer，但超限改截断而非报错——见有意改善）、
+            // stderr 2000（等价原逻辑）。onOutput 推流的是原始 chunk（前端自行滚动窗口）。
+            const STDOUT_ACCUM_CAP = 2 * 1024 * 1024;
+            const STDERR_ACCUM_CAP = 2000;
+            const stdoutChunks = [];
+            const stderrChunks = [];
+            let stdoutLen = 0;
+            let stderrLen = 0;
+            let stdoutTruncated = false;
+            let timedOut = false;
+            child.stdout?.on('data', (data) => {
+                const text = data.toString('utf-8');
+                if (stdoutLen < STDOUT_ACCUM_CAP) {
+                    const room = STDOUT_ACCUM_CAP - stdoutLen;
+                    stdoutChunks.push(text.slice(0, room));
+                    stdoutLen += Math.min(text.length, room);
+                    if (stdoutLen >= STDOUT_ACCUM_CAP)
+                        stdoutTruncated = true;
+                }
+                try {
+                    params.onOutput?.(text, 'stdout');
+                }
+                catch { /* 推流故障不影响执行 */ }
+            });
+            child.stderr?.on('data', (data) => {
+                const text = data.toString('utf-8');
+                if (stderrLen < STDERR_ACCUM_CAP) {
+                    const room = STDERR_ACCUM_CAP - stderrLen;
+                    stderrChunks.push(text.slice(0, room));
+                    stderrLen += Math.min(text.length, room);
+                }
+                try {
+                    params.onOutput?.(text, 'stderr');
+                }
+                catch { /* 推流故障不影响执行 */ }
+            });
+            const timer = setTimeout(() => {
+                timedOut = true;
+                child.kill('SIGTERM');
+                // SIGTERM 后 200ms 仍未退出则 SIGKILL 兜底
+                setTimeout(() => { try {
+                    child.kill('SIGKILL');
+                }
+                catch { /* 已退出 */ } }, 200).unref?.();
+            }, timeout * 1000);
+            const exitCode = await new Promise((resolve) => {
+                child.on('error', () => resolve(-1));
+                child.on('close', (code) => resolve(typeof code === 'number' ? code : -1));
+            });
+            clearTimeout(timer);
+            if (timedOut) {
+                return {
+                    success: false,
+                    data: '',
+                    error: `执行超时 (${timeout}秒)！警告：这可能是由于代码进入了死循环，或者是某些 IO 操作被永久挂起。请检查代码逻辑并修正后重试！`,
+                };
+            }
+            const stdoutRaw = stdoutChunks.join('');
+            const stderrRaw = stderrChunks.join('');
+            // 处理输出（复用原 max_output 截断逻辑）
+            const resultParts = [];
+            if (stdoutRaw || stdoutTruncated) {
+                let stdoutText = stdoutRaw;
+                if (stdoutTruncated)
+                    stdoutText += '\n... (stdout 累计超过 2MB)';
+                if (stdoutText.length > max_output) {
+                    stdoutText = stdoutText.slice(0, max_output) + '\n... (stdout 截断)';
+                }
+                resultParts.push(stdoutText);
+            }
+            if (stderrRaw) {
+                let stderrText = stderrRaw;
+                if (stderrText.length > 2000) {
+                    stderrText = stderrText.slice(0, 2000) + '\n... (stderr 截断)';
+                }
+                resultParts.push(`[stderr]\n${stderrText}`);
+            }
+            let output = resultParts.join('\n') || '(无输出)';
+            // 最终输出限制
+            if (output.length > max_output) {
+                output = output.slice(0, max_output) + '\n... (截断)';
+            }
+            // 非零退出码：失败但保留输出（等价 execFile 非零退出语义，错误信息改用 stderr/退出码更精确——见有意改善）
+            if (exitCode !== 0) {
+                return {
+                    success: false,
+                    data: output,
+                    error: stderrRaw || `Python 进程退出码 ${exitCode}`,
+                };
+            }
+            return {
+                success: true,
+                data: output,
+            };
+        }
+        catch (error) {
+            const execError = error;
+            const errorDetails = [
+                `错误类型: ${execError.name || '未知'}`,
+                `错误消息: ${execError.message || '无'}`,
+                execError.stack ? `堆栈跟踪:\n${execError.stack}` : null,
+            ].filter(Boolean).join('\n');
+            return {
+                success: false,
+                data: '',
+                error: `Python 执行失败\n${errorDetails}`,
+            };
+        }
+        finally {
+            // 清理临时文件
+            if (tmpPath && existsSync(tmpPath)) {
+                try {
+                    unlinkSync(tmpPath);
+                }
+                catch (cleanupError) {
+                    coreLogger.warn('[PythonExec] 清理临时文件失败:', cleanupError);
+                }
+            }
+        }
+    }
+}
+export default PythonExec;
+//# sourceMappingURL=PythonExec.js.map

package/dist/tools/implementations/PythonExec.js.map

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

package/dist/tools/implementations/PythonExecTool.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import { Tool, type ToolContext, type ToolResult } from '../Tool.js';
+export declare class PythonExecTool extends Tool {
+    readonly name = "python_exec";
+    readonly description = "\u6267\u884C Python \u4EE3\u7801\u7247\u6BB5\uFF0C\u8FD4\u56DE stdout";
+    readonly parameters: z.ZodObject<{
+        code: z.ZodString;
+        timeout: z.ZodOptional<z.ZodNumber>;
+        max_output: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    getExecutionTimeoutMs(args: unknown): number;
+    execute(args: unknown, context?: ToolContext): Promise<ToolResult>;
+}
+export default PythonExecTool;
+//# sourceMappingURL=PythonExecTool.d.ts.map

package/dist/tools/implementations/PythonExecTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PythonExecTool.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/PythonExecTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAkB,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAUrF,qBAAa,cAAe,SAAQ,IAAI;IACtC,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,WAAW,2EAA8B;IAClD,QAAQ,CAAC,UAAU;;;;sBAAoB;IAEvC,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM;IAQtC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAgCzE;AAED,eAAe,cAAc,CAAC"}

package/dist/tools/implementations/PythonExecTool.js

@@ -0,0 +1,54 @@
+import { z } from 'zod';
+import { Tool, emitToolOutput } from '../Tool.js';
+import { PythonExec } from './PythonExec.js';
+import { getToolPermissionContextFromToolContext } from '../../core/PermissionSystem.js';
+const PythonExecSchema = z.object({
+    code: z.string().describe('Python 代码'),
+    timeout: z.number().int().optional().describe('超时秒数 (默认 30)'),
+    max_output: z.number().int().optional().describe('最大输出字符数 (默认 20000)'),
+});
+export class PythonExecTool extends Tool {
+    name = 'python_exec';
+    description = '执行 Python 代码片段，返回 stdout';
+    parameters = PythonExecSchema;
+    getExecutionTimeoutMs(args) {
+        const params = args;
+        const timeoutSeconds = typeof params?.timeout === 'number' && Number.isFinite(params.timeout) && params.timeout > 0
+            ? params.timeout
+            : 30;
+        return Math.ceil(timeoutSeconds * 1000) + 5_000;
+    }
+    async execute(args, context) {
+        const params = args;
+        const permissionContext = getToolPermissionContextFromToolContext(context);
+        // 流式输出闭包：把 Python 子进程逐 chunk stdout/stderr 推到 agent/leader 工具卡片（治本流式）
+        const onOutput = context?.emitter
+            ? (chunk, stream) => emitToolOutput(context, this.name, { chunk, stream })
+            : undefined;
+        const result = await PythonExec.execute({
+            ...params,
+            permissionContext,
+            workspace: typeof context?.workspace === 'string' ? context.workspace : undefined,
+            sessionId: typeof context?.sessionId === 'string' ? context.sessionId : undefined,
+            taskId: typeof context?.taskId === 'string' ? context.taskId : undefined,
+            taskWorkingDirectory: typeof context?.taskWorkingDirectory === 'string' ? context.taskWorkingDirectory : undefined,
+            taskWriteScope: Array.isArray(context?.taskWriteScope) ? context.taskWriteScope : undefined,
+            onOutput,
+        });
+        if (result.success) {
+            return {
+                success: true,
+                data: result.data,
+            };
+        }
+        else {
+            return {
+                success: false,
+                data: null,
+                error: result.error,
+            };
+        }
+    }
+}
+export default PythonExecTool;
+//# sourceMappingURL=PythonExecTool.js.map

package/dist/tools/implementations/PythonExecTool.js.map

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

package/dist/tools/implementations/ReadGraphTool.d.ts

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import { Tool, type ToolContext, type ToolResult } from '../Tool.js';
+export declare class ReadGraphTool extends Tool {
+    readonly name = "read_graph";
+    readonly description: string;
+    readonly parameters: z.ZodObject<{
+        query_type: z.ZodEnum<{
+            summary: "summary";
+            node_by_id: "node_by_id";
+            nodes_by_kind: "nodes_by_kind";
+            nodes_by_tag: "nodes_by_tag";
+            edges_from: "edges_from";
+            edges_to: "edges_to";
+            subgraph: "subgraph";
+        }>;
+        node_id: z.ZodOptional<z.ZodString>;
+        kind: z.ZodOptional<z.ZodEnum<{
+            contract: "contract";
+            origin: "origin";
+            goal: "goal";
+            fact: "fact";
+            intent: "intent";
+            hint: "hint";
+            design_doc: "design_doc";
+        }>>;
+        tag: z.ZodOptional<z.ZodString>;
+        max_depth: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    execute(args: unknown, context?: ToolContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=ReadGraphTool.d.ts.map

package/dist/tools/implementations/ReadGraphTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadGraphTool.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/ReadGraphTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAgJrE,qBAAa,aAAc,SAAQ,IAAI;IACrC,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,WAAW,SAEsB;IAC1C,QAAQ,CAAC,UAAU;;;;;;;;;;;;;;;;;;;;;;sBAAmB;IAEhC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAqIzE"}