@lingxiao-office/sdk 1.0.0

package/dist/tools/implementations/EditXlsxTool.js

@@ -0,0 +1,210 @@
+import { z } from 'zod';
+import { resolve } from 'path';
+import { existsSync } from 'fs';
+import { Tool } from '../Tool.js';
+import { resolveTaskWritePath } from './utils.js';
+import { columnLetterToNumber, getWorksheetOrThrow, readWorkbook, setCellValue, workbookSheetNames, worksheetToRows, } from './office/ExcelWorkbook.js';
+const EditXlsxOperation = z.discriminatedUnion('op', [
+    z.object({ op: z.literal('inspect') }),
+    z.object({
+        op: z.literal('read_sheet'),
+        sheet: z.string().optional().describe('工作表名称，默认第一个'),
+        max_rows: z.number().min(1).max(5000).default(500).describe('最多读取行数'),
+    }),
+    z.object({
+        op: z.literal('set_cell'),
+        sheet: z.string().optional(),
+        cell: z.string().describe('单元格引用，如 "A1"、"C5"'),
+        value: z.string().describe('单元格值'),
+    }),
+    z.object({
+        op: z.literal('set_cells'),
+        sheet: z.string().optional(),
+        cells: z.array(z.object({
+            cell: z.string(),
+            value: z.string(),
+        })).min(1).max(1000).describe('批量设置单元格'),
+    }),
+    z.object({
+        op: z.literal('append_rows'),
+        sheet: z.string().optional(),
+        rows: z.array(z.array(z.string())).min(1).max(5000).describe('追加的数据行'),
+    }),
+    z.object({
+        op: z.literal('add_sheet'),
+        name: z.string().min(1).max(31).describe('新工作表名称'),
+    }),
+    z.object({
+        op: z.literal('delete_sheet'),
+        name: z.string().describe('要删除的工作表名称'),
+    }),
+    z.object({
+        op: z.literal('rename_sheet'),
+        old_name: z.string().describe('原名称'),
+        new_name: z.string().min(1).max(31).describe('新名称'),
+    }),
+    z.object({
+        op: z.literal('set_column_width'),
+        sheet: z.string().optional(),
+        column: z.string().describe('列标识，如 "A"、"B"、"C"'),
+        width: z.number().min(1).max(200).describe('列宽（字符数）'),
+    }),
+    z.object({
+        op: z.literal('set_formula'),
+        sheet: z.string().optional(),
+        cell: z.string().describe('单元格引用'),
+        formula: z.string().describe('公式，如 "SUM(B2:B100)"'),
+    }),
+]);
+const EditXlsxSchema = z.object({
+    path: z.string().describe('要编辑的 XLSX 文件路径'),
+    output_path: z.string().optional().describe('另存为路径。省略则覆盖原文件。'),
+    operations: z.array(EditXlsxOperation).min(1).max(50).describe('操作列表，按顺序执行'),
+    create_download_link: z.boolean().default(true),
+    expires_in_seconds: z.number().optional(),
+});
+export class EditXlsxTool extends Tool {
+    name = 'edit_xlsx';
+    description = '编辑现有 XLSX 文件。支持操作：inspect（查看结构）、read_sheet（读取数据）、set_cell/set_cells（写入单元格）、append_rows（追加行）、add_sheet/delete_sheet/rename_sheet（管理工作表）、set_column_width（列宽）、set_formula（公式）。';
+    parameters = EditXlsxSchema;
+    async execute(args, context) {
+        const parsed = EditXlsxSchema.safeParse(args);
+        if (!parsed.success) {
+            return { success: false, data: null, error: `ERROR: ${parsed.error.issues.map(i => `${i.path.join('.')}: ${i.message}`).join('; ')}` };
+        }
+        const input = parsed.data;
+        const resolvedPath = resolveTaskWritePath(context?.workspace, input.path, context?.sessionId, context?.taskWriteScope);
+        if (!existsSync(resolvedPath)) {
+            return { success: false, data: null, error: `ERROR: 文件不存在: ${resolvedPath}` };
+        }
+        let outputPath;
+        try {
+            outputPath = input.output_path
+                ? resolveTaskWritePath(context?.workspace, input.output_path, context?.sessionId, context?.taskWriteScope)
+                : resolvedPath;
+        }
+        catch (error) {
+            return { success: false, data: null, error: `ERROR: ${error instanceof Error ? error.message : String(error)}` };
+        }
+        try {
+            const wb = await readWorkbook(resolvedPath);
+            const results = [];
+            for (const op of input.operations) {
+                switch (op.op) {
+                    case 'inspect': {
+                        const sheets = wb.worksheets.map((ws) => {
+                            return {
+                                name: ws.name,
+                                rows: ws.rowCount,
+                                columns: ws.columnCount,
+                            };
+                        });
+                        results.push({ op: 'inspect', sheets, totalSheets: wb.worksheets.length });
+                        break;
+                    }
+                    case 'read_sheet': {
+                        const ws = getWorksheetOrThrow(wb, op.sheet);
+                        const data = worksheetToRows(ws, op.max_rows);
+                        const sliced = data.slice(0, op.max_rows);
+                        results.push({
+                            op: 'read_sheet',
+                            sheet: ws.name,
+                            headers: data[0] || [],
+                            rows: sliced.slice(1),
+                            totalRows: ws.rowCount,
+                            returnedRows: sliced.length - 1,
+                        });
+                        break;
+                    }
+                    case 'set_cell': {
+                        const ws = getWorksheetOrThrow(wb, op.sheet);
+                        setCellValue(ws.getCell(op.cell.toUpperCase()), op.value);
+                        results.push({ op: 'set_cell', cell: op.cell.toUpperCase(), value: op.value });
+                        break;
+                    }
+                    case 'set_cells': {
+                        const ws = getWorksheetOrThrow(wb, op.sheet);
+                        let count = 0;
+                        for (const { cell, value } of op.cells) {
+                            setCellValue(ws.getCell(cell.toUpperCase()), value);
+                            count++;
+                        }
+                        results.push({ op: 'set_cells', count });
+                        break;
+                    }
+                    case 'append_rows': {
+                        const ws = getWorksheetOrThrow(wb, op.sheet);
+                        for (const row of op.rows) {
+                            const appended = ws.addRow([]);
+                            for (let ci = 0; ci < row.length; ci++) {
+                                const val = row[ci];
+                                if (val === null || val === undefined || val === '')
+                                    continue;
+                                setCellValue(appended.getCell(ci + 1), val);
+                            }
+                        }
+                        results.push({ op: 'append_rows', addedRows: op.rows.length, totalRows: ws.rowCount });
+                        break;
+                    }
+                    case 'add_sheet': {
+                        if (wb.getWorksheet(op.name)) {
+                            throw new Error(`Sheet "${op.name}" 已存在`);
+                        }
+                        wb.addWorksheet(op.name);
+                        results.push({ op: 'add_sheet', name: op.name });
+                        break;
+                    }
+                    case 'delete_sheet': {
+                        const ws = wb.getWorksheet(op.name);
+                        if (!ws) {
+                            throw new Error(`Sheet "${op.name}" 不存在`);
+                        }
+                        if (wb.worksheets.length <= 1) {
+                            throw new Error('请至少保留一个工作表。');
+                        }
+                        wb.removeWorksheet(ws.id);
+                        results.push({ op: 'delete_sheet', name: op.name });
+                        break;
+                    }
+                    case 'rename_sheet': {
+                        const ws = wb.getWorksheet(op.old_name);
+                        if (!ws)
+                            throw new Error(`Sheet "${op.old_name}" 不存在`);
+                        if (wb.getWorksheet(op.new_name))
+                            throw new Error(`Sheet "${op.new_name}" 已存在`);
+                        ws.name = op.new_name;
+                        results.push({ op: 'rename_sheet', old_name: op.old_name, new_name: op.new_name });
+                        break;
+                    }
+                    case 'set_column_width': {
+                        const ws = getWorksheetOrThrow(wb, op.sheet);
+                        ws.getColumn(columnLetterToNumber(op.column)).width = op.width;
+                        results.push({ op: 'set_column_width', column: op.column, width: op.width });
+                        break;
+                    }
+                    case 'set_formula': {
+                        const ws = getWorksheetOrThrow(wb, op.sheet);
+                        ws.getCell(op.cell.toUpperCase()).value = { formula: op.formula.replace(/^=/, ''), result: 0 };
+                        results.push({ op: 'set_formula', cell: op.cell.toUpperCase(), formula: op.formula });
+                        break;
+                    }
+                }
+            }
+            await wb.xlsx.writeFile(outputPath);
+            return {
+                success: true,
+                data: {
+                    path: resolve(outputPath),
+                    operations: results,
+                    sheetCount: wb.worksheets.length,
+                    sheets: workbookSheetNames(wb),
+                },
+            };
+        }
+        catch (error) {
+            return { success: false, data: null, error: `ERROR: ${error instanceof Error ? error.message : String(error)}` };
+        }
+    }
+}
+export default EditXlsxTool;
+//# sourceMappingURL=EditXlsxTool.js.map

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

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

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

@@ -0,0 +1,51 @@
+export type SandboxNetworkMode = 'inherit' | 'disabled' | 'allowlisted';
+export type SandboxBackend = 'app-guard' | 'bubblewrap';
+export interface ExecutionSandboxPolicy {
+    workspace: string;
+    sessionId?: string;
+    cwd?: string;
+    command: string;
+    networkMode: SandboxNetworkMode;
+    allowedHosts: string[];
+    backend?: SandboxBackend;
+    taskId?: string;
+    taskWorkingDirectory?: string;
+    taskWriteScope?: string[];
+}
+export interface SandboxCapabilities {
+    bubblewrapAvailable: boolean;
+    bubblewrapPath?: string;
+    bubblewrapSupportsNetworkIsolation: boolean;
+}
+export interface ExecutionPlan {
+    mode: 'shell' | 'execFile';
+    command: string;
+    args?: string[];
+}
+export interface ExecutionSandboxResult {
+    ok: boolean;
+    error?: string;
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    plan?: ExecutionPlan;
+    metadata?: {
+        mode: SandboxBackend;
+        networkMode: SandboxNetworkMode;
+        visibleRoots: string[];
+        sessionDir?: string;
+        networkRequested?: SandboxNetworkMode;
+        networkEnforced?: boolean;
+        networkIsolation?: 'enforced' | 'not_enforced' | 'not_requested';
+        networkIsolationReason?: string;
+        allowedHostsEnforced?: boolean;
+        /**
+         * 加固模式下 allowlisted 网络因无 host 级出网控制而 fail-closed（整体禁网）时为 true。
+         * 用于让上层/前端知晓"请求了 allowlisted 但实际被降级为 disabled"。
+         */
+        allowedHostsFailClosed?: boolean;
+    };
+}
+export declare function validateDangerousCommand(command: string): string | null;
+export declare function detectSandboxCapabilities(): SandboxCapabilities;
+export declare function prepareExecutionSandbox(policy: ExecutionSandboxPolicy): ExecutionSandboxResult;
+//# sourceMappingURL=ExecutionSandbox.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ExecutionSandbox.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/ExecutionSandbox.ts"],"names":[],"mappings":"AAkBA,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,UAAU,GAAG,aAAa,CAAC;AACxE,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,YAAY,CAAC;AAExD,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,kBAAkB,CAAC;IAChC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kCAAkC,EAAE,OAAO,CAAC;CAC7C;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,GAAG,UAAU,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,QAAQ,CAAC,EAAE;QACT,IAAI,EAAE,cAAc,CAAC;QACrB,WAAW,EAAE,kBAAkB,CAAC;QAChC,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,gBAAgB,CAAC,EAAE,kBAAkB,CAAC;QACtC,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,gBAAgB,CAAC,EAAE,UAAU,GAAG,cAAc,GAAG,eAAe,CAAC;QACjE,sBAAsB,CAAC,EAAE,MAAM,CAAC;QAChC,oBAAoB,CAAC,EAAE,OAAO,CAAC;QAC/B;;;WAGG;QACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;KAClC,CAAC;CACH;AA0BD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoHvE;AAQD,wBAAgB,yBAAyB,IAAI,mBAAmB,CAqB/D;AA2ID,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,sBAAsB,GAAG,sBAAsB,CAsJ9F"}