@cicctencent/agent-server 0.2.40 → 0.2.42

package/dist/cjs/doc-generator/docx-renderer.js

@@ -0,0 +1,354 @@
+"use strict";
+/**
+ * @file DOCX 渲染器
+ * @description 使用 docx 库将结构化文档数据渲染为 .docx 文件
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderDocx = renderDocx;
+const docx_1 = require("docx");
+const fs = __importStar(require("fs"));
+const config_loader_ts_1 = require("./config-loader.js");
+/** 将 hex 颜色转 DOCX 格式（去掉 #） */
+function hex(color) {
+    if (!color)
+        return '000000';
+    return color.replace('#', '');
+}
+/** 页面尺寸映射 (DXA units, 1440 DXA = 1 inch) */
+const PAGE_SIZES = {
+    A4: { width: 11906, height: 16838 },
+    letter: { width: 12240, height: 15840 },
+    legal: { width: 12240, height: 20160 },
+};
+/** 渲染 DOCX */
+async function renderDocx(data, templatesDir) {
+    const theme = (0, config_loader_ts_1.loadTheme)('docx', data.theme, templatesDir);
+    const opts = data.options || {};
+    // 页面配置
+    const pageSizeKey = opts.pageSize || theme.page?.size || 'A4';
+    const pageSize = PAGE_SIZES[pageSizeKey] || PAGE_SIZES.A4;
+    const margins = opts.margins || theme.page?.margin || { top: 1440, right: 1440, bottom: 1440, left: 1440 };
+    // 内容宽度 (DXA)
+    const contentWidth = pageSize.width - margins.left - margins.right;
+    // 构建文档 children
+    const children = [];
+    // 可选目录
+    if (opts.includeToc) {
+        children.push(new docx_1.TableOfContents('Table of Contents', {
+            hyperlink: true,
+            headingStyleRange: '1-3',
+        }));
+        children.push(new docx_1.Paragraph({ children: [new docx_1.PageBreak()] }));
+    }
+    // 渲染每个区块
+    for (const block of data.blocks) {
+        const rendered = renderBlock(block, theme, contentWidth);
+        children.push(...rendered);
+    }
+    // 构建文档
+    const doc = new docx_1.Document({
+        styles: {
+            default: {
+                document: {
+                    run: { font: theme.fonts.body, size: (theme.sizes.body || 12) * 2 },
+                },
+            },
+            paragraphStyles: buildParagraphStyles(theme),
+        },
+        numbering: {
+            config: [
+                {
+                    reference: 'bullets',
+                    levels: [{
+                            level: 0,
+                            format: docx_1.LevelFormat.BULLET,
+                            text: '\u2022',
+                            alignment: docx_1.AlignmentType.LEFT,
+                            style: { paragraph: { indent: { left: 720, hanging: 360 } } },
+                        }],
+                },
+                {
+                    reference: 'numbers',
+                    levels: [{
+                            level: 0,
+                            format: docx_1.LevelFormat.DECIMAL,
+                            text: '%1.',
+                            alignment: docx_1.AlignmentType.LEFT,
+                            style: { paragraph: { indent: { left: 720, hanging: 360 } } },
+                        }],
+                },
+            ],
+        },
+        sections: [{
+                properties: {
+                    page: {
+                        size: { width: pageSize.width, height: pageSize.height },
+                        margin: margins,
+                    },
+                },
+                headers: opts.headerText ? {
+                    default: new docx_1.Header({
+                        children: [new docx_1.Paragraph({
+                                border: { bottom: { style: docx_1.BorderStyle.SINGLE, size: 6, color: hex(theme.colors.primary), space: 1 } },
+                                children: [new docx_1.TextRun({ text: opts.headerText, font: theme.fonts.caption, size: (theme.sizes.caption || 10) * 2, color: hex(theme.colors.caption) })],
+                            })],
+                    }),
+                } : undefined,
+                footers: (opts.showPageNumbers !== false || opts.footerText) ? {
+                    default: new docx_1.Footer({
+                        children: [new docx_1.Paragraph({
+                                alignment: docx_1.AlignmentType.CENTER,
+                                children: [
+                                    ...(opts.footerText ? [new docx_1.TextRun({ text: opts.footerText + '  |  ', font: theme.fonts.caption, size: (theme.sizes.caption || 10) * 2, color: hex(theme.colors.caption) })] : []),
+                                    new docx_1.TextRun({ text: 'Page ', font: theme.fonts.caption, size: (theme.sizes.caption || 10) * 2, color: hex(theme.colors.caption) }),
+                                    new docx_1.TextRun({ children: [docx_1.PageNumber.CURRENT], font: theme.fonts.caption, size: (theme.sizes.caption || 10) * 2, color: hex(theme.colors.caption) }),
+                                ],
+                            })],
+                    }),
+                } : undefined,
+                children,
+            }],
+    });
+    const buffer = await docx_1.Packer.toBuffer(doc);
+    const filename = data.filename || `${sanitizeFilename(data.title)}.docx`;
+    return {
+        buffer,
+        filename,
+        mimeType: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+        size: buffer.length,
+    };
+}
+function buildParagraphStyles(theme) {
+    const sizes = theme.sizes;
+    return [
+        {
+            id: 'Heading1', name: 'Heading 1', basedOn: 'Normal', next: 'Normal', quickFormat: true,
+            run: { size: (sizes.h1 || 24) * 2, bold: true, font: theme.fonts.heading, color: hex(theme.colors.heading || theme.colors.primary) },
+            paragraph: { spacing: { before: theme.spacing.headingBefore || 240, after: theme.spacing.headingAfter || 120 }, outlineLevel: 0 },
+        },
+        {
+            id: 'Heading2', name: 'Heading 2', basedOn: 'Normal', next: 'Normal', quickFormat: true,
+            run: { size: (sizes.h2 || 20) * 2, bold: true, font: theme.fonts.heading, color: hex(theme.colors.heading || theme.colors.primary) },
+            paragraph: { spacing: { before: theme.spacing.headingBefore || 240, after: theme.spacing.headingAfter || 120 }, outlineLevel: 1 },
+        },
+        {
+            id: 'Heading3', name: 'Heading 3', basedOn: 'Normal', next: 'Normal', quickFormat: true,
+            run: { size: (sizes.h3 || 16) * 2, bold: true, font: theme.fonts.heading, color: hex(theme.colors.heading || theme.colors.primary) },
+            paragraph: { spacing: { before: 180, after: 120 }, outlineLevel: 2 },
+        },
+        {
+            id: 'Heading4', name: 'Heading 4', basedOn: 'Normal', next: 'Normal', quickFormat: true,
+            run: { size: (sizes.h4 || 14) * 2, bold: true, font: theme.fonts.heading, color: hex(theme.colors.heading || theme.colors.primary) },
+            paragraph: { spacing: { before: 120, after: 80 }, outlineLevel: 3 },
+        },
+    ];
+}
+function renderBlock(block, theme, contentWidth) {
+    const result = [];
+    const c = theme.colors;
+    const f = theme.fonts;
+    const s = theme.sizes;
+    const sp = theme.spacing;
+    switch (block.type) {
+        case 'heading': {
+            const levelMap = {
+                1: docx_1.HeadingLevel.HEADING_1,
+                2: docx_1.HeadingLevel.HEADING_2,
+                3: docx_1.HeadingLevel.HEADING_3,
+                4: docx_1.HeadingLevel.HEADING_4,
+            };
+            result.push(new docx_1.Paragraph({
+                heading: levelMap[block.level || 1] || docx_1.HeadingLevel.HEADING_1,
+                children: [new docx_1.TextRun({ text: block.text || '' })],
+            }));
+            break;
+        }
+        case 'paragraph': {
+            if (block.runs?.length) {
+                result.push(new docx_1.Paragraph({
+                    spacing: { after: sp.paragraphAfter || 120, line: sp.lineSpacing || 276 },
+                    children: block.runs.map(run => new docx_1.TextRun({
+                        text: run.text,
+                        bold: run.bold,
+                        italics: run.italic,
+                        underline: run.underline ? {} : undefined,
+                        color: run.color ? hex(run.color) : undefined,
+                        size: run.fontSize ? run.fontSize * 2 : undefined,
+                        font: f.body,
+                    })),
+                }));
+            }
+            else {
+                result.push(new docx_1.Paragraph({
+                    spacing: { after: sp.paragraphAfter || 120, line: sp.lineSpacing || 276 },
+                    children: [new docx_1.TextRun({ text: block.text || '', font: f.body, size: (s.body || 12) * 2, color: hex(c.body || c.textPrimary) })],
+                }));
+            }
+            break;
+        }
+        case 'bullets': {
+            if (block.items?.length) {
+                for (const item of block.items) {
+                    result.push(new docx_1.Paragraph({
+                        numbering: { reference: 'bullets', level: 0 },
+                        spacing: { after: 60 },
+                        children: [new docx_1.TextRun({ text: item, font: f.body, size: (s.body || 12) * 2, color: hex(c.body || c.textPrimary) })],
+                    }));
+                }
+            }
+            break;
+        }
+        case 'numbers': {
+            if (block.items?.length) {
+                for (const item of block.items) {
+                    result.push(new docx_1.Paragraph({
+                        numbering: { reference: 'numbers', level: 0 },
+                        spacing: { after: 60 },
+                        children: [new docx_1.TextRun({ text: item, font: f.body, size: (s.body || 12) * 2, color: hex(c.body || c.textPrimary) })],
+                    }));
+                }
+            }
+            break;
+        }
+        case 'table': {
+            if (block.table) {
+                result.push(renderDocxTable(block.table, theme, contentWidth));
+            }
+            break;
+        }
+        case 'image': {
+            if (block.image_url) {
+                try {
+                    const imgData = fs.existsSync(block.image_url)
+                        ? fs.readFileSync(block.image_url)
+                        : Buffer.alloc(0);
+                    if (imgData.length > 0) {
+                        const ext = block.image_url.split('.').pop()?.toLowerCase() || 'png';
+                        result.push(new docx_1.Paragraph({
+                            children: [new docx_1.ImageRun({
+                                    type: ext,
+                                    data: imgData,
+                                    transformation: {
+                                        width: block.image_width || 400,
+                                        height: block.image_height || 300,
+                                    },
+                                    altText: {
+                                        title: block.image_alt || 'Image',
+                                        description: block.image_alt || 'Image',
+                                        name: block.image_alt || 'image',
+                                    },
+                                })],
+                        }));
+                    }
+                }
+                catch {
+                    result.push(new docx_1.Paragraph({
+                        children: [new docx_1.TextRun({ text: `[Image: ${block.image_url}]`, italics: true, color: hex(c.caption) })],
+                    }));
+                }
+            }
+            break;
+        }
+        case 'page_break': {
+            result.push(new docx_1.Paragraph({ children: [new docx_1.PageBreak()] }));
+            break;
+        }
+        case 'toc': {
+            result.push(new docx_1.TableOfContents('Table of Contents', {
+                hyperlink: true,
+                headingStyleRange: '1-3',
+            }));
+            break;
+        }
+        case 'spacer': {
+            result.push(new docx_1.Paragraph({ spacing: { after: block.height || 200 }, children: [] }));
+            break;
+        }
+    }
+    return result;
+}
+function renderDocxTable(table, theme, contentWidth) {
+    const c = theme.colors;
+    const f = theme.fonts;
+    const s = theme.sizes;
+    const border = { style: docx_1.BorderStyle.SINGLE, size: 1, color: hex(c.tableBorder || 'CCCCCC') };
+    const borders = { top: border, bottom: border, left: border, right: border };
+    const colCount = table.headers.length;
+    const colWidth = Math.floor(contentWidth / colCount);
+    const headerRow = new docx_1.TableRow({
+        children: table.headers.map(h => new docx_1.TableCell({
+            borders,
+            width: { size: colWidth, type: docx_1.WidthType.DXA },
+            shading: { fill: hex(c.tableHeader || 'D5E8F0'), type: docx_1.ShadingType.CLEAR },
+            margins: { top: 80, bottom: 80, left: 120, right: 120 },
+            children: [new docx_1.Paragraph({
+                    alignment: docx_1.AlignmentType.CENTER,
+                    children: [new docx_1.TextRun({
+                            text: h,
+                            bold: true,
+                            font: f.body,
+                            size: (s.body || 12) * 2,
+                            color: hex(c.tableHeaderText || c.textPrimary),
+                        })],
+                })],
+        })),
+    });
+    const dataRows = table.rows.map((row, rowIdx) => new docx_1.TableRow({
+        children: row.map(cell => new docx_1.TableCell({
+            borders,
+            width: { size: colWidth, type: docx_1.WidthType.DXA },
+            shading: rowIdx % 2 === 1 ? { fill: hex(c.tableAltRow || 'F5F9FC'), type: docx_1.ShadingType.CLEAR } : undefined,
+            margins: { top: 80, bottom: 80, left: 120, right: 120 },
+            children: [new docx_1.Paragraph({
+                    children: [new docx_1.TextRun({
+                            text: String(cell),
+                            font: f.body,
+                            size: (s.body || 12) * 2,
+                            color: hex(c.body || c.textPrimary),
+                        })],
+                })],
+        })),
+    }));
+    return new docx_1.Table({
+        width: { size: contentWidth, type: docx_1.WidthType.DXA },
+        columnWidths: Array(colCount).fill(colWidth),
+        rows: [headerRow, ...dataRows],
+    });
+}
+function sanitizeFilename(name) {
+    return name.replace(/[^a-zA-Z0-9\u4e00-\u9fff_-]/g, '_').slice(0, 50);
+}
+//# sourceMappingURL=docx-renderer.js.map

package/dist/cjs/doc-generator/docx-renderer.js.map

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

package/dist/cjs/doc-generator/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @file 文档生成模块 - 统一入口
+ * @description 为 Agent 工具提供结构化文档生成能力（PPTX / DOCX / PDF / HTML Report）
+ */
+import type { ToolContext } from '@cicctencent/agent-core';
+import { renderReport } from './report-renderer.js';
+import { listThemes } from './config-loader.js';
+import type { PresentationData, DocumentData, RenderResult } from './types.js';
+import type { ReportData } from './report-renderer.js';
+export type { PresentationData, DocumentData, RenderResult, ReportData };
+export { listThemes, renderReport };
+/**
+ * 生成文档并保存为 Artifact
+ * @param jsonFilePath 可选：沙箱内的 JSON 数据文件路径（用于大型文档，LLM 先 write_file 再调用）
+ * @returns Artifact 保存结果描述字符串
+ */
+export declare function generateAndSave(type: 'pptx' | 'docx' | 'pdf', data: PresentationData | DocumentData, ctx: ToolContext, jsonFilePath?: string, templatesDir?: string): Promise<string>;
+/**
+ * 生成 HTML Report 并保存为 Artifact + 推送 Widget 事件
+ * 专为 create_report 工具设计：一步完成渲染、保存、内联展示
+ */
+export declare function generateReportAndDisplay(data: ReportData, ctx: ToolContext, jsonFilePath?: string): Promise<string>;
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/doc-generator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/doc-generator/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAW,WAAW,EAAgB,MAAM,yBAAyB,CAAC;AAKlF,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGvD,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC;AAiBpC;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,EAC7B,IAAI,EAAE,gBAAgB,GAAG,YAAY,EACrC,GAAG,EAAE,WAAW,EAChB,YAAY,CAAC,EAAE,MAAM,EACrB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,CAgHjB;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,WAAW,EAChB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,CAgEjB"}

package/dist/cjs/doc-generator/index.js

@@ -0,0 +1,251 @@
+"use strict";
+/**
+ * @file 文档生成模块 - 统一入口
+ * @description 为 Agent 工具提供结构化文档生成能力（PPTX / DOCX / PDF / HTML Report）
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderReport = exports.listThemes = void 0;
+exports.generateAndSave = generateAndSave;
+exports.generateReportAndDisplay = generateReportAndDisplay;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const artifact_service_ts_1 = require("../service/artifact.service.js");
+const pptx_renderer_ts_1 = require("./pptx-renderer.js");
+const docx_renderer_ts_1 = require("./docx-renderer.js");
+const pdf_renderer_ts_1 = require("./pdf-renderer.js");
+const report_renderer_ts_1 = require("./report-renderer.js");
+Object.defineProperty(exports, "renderReport", { enumerable: true, get: function () { return report_renderer_ts_1.renderReport; } });
+const config_loader_ts_1 = require("./config-loader.js");
+Object.defineProperty(exports, "listThemes", { enumerable: true, get: function () { return config_loader_ts_1.listThemes; } });
+/** 各类型对应的文件扩展名 */
+const EXT_MAP = { pptx: '.pptx', docx: '.docx', pdf: '.pdf', html: '.html' };
+/** 确保文件名带有正确的扩展名 */
+function ensureExtension(filename, type) {
+    const ext = EXT_MAP[type];
+    if (!ext)
+        return filename;
+    // 如果没有扩展名，补上
+    if (!filename.includes('.'))
+        return filename + ext;
+    // 如果扩展名不对（比如 LLM 传了 .ppt 而不是 .pptx），替换
+    const currentExt = path.extname(filename).toLowerCase();
+    if (currentExt !== ext)
+        return filename.replace(new RegExp(`\\${currentExt}$`, 'i'), ext);
+    return filename;
+}
+/**
+ * 生成文档并保存为 Artifact
+ * @param jsonFilePath 可选：沙箱内的 JSON 数据文件路径（用于大型文档，LLM 先 write_file 再调用）
+ * @returns Artifact 保存结果描述字符串
+ */
+async function generateAndSave(type, data, ctx, jsonFilePath, templatesDir) {
+    // 如果提供了 json_file，从沙箱读取 JSON 并合并到 data
+    if (jsonFilePath) {
+        const sandbox = ctx.custom?.sandbox;
+        if (!sandbox)
+            return 'Error: Sandbox not available. Cannot read json_file.';
+        const resolvedPath = path.isAbsolute(jsonFilePath)
+            ? jsonFilePath
+            : path.join(sandbox.rootDir, jsonFilePath);
+        // 安全检查：确保路径在沙箱内
+        if (!resolvedPath.startsWith(sandbox.rootDir)) {
+            return `Error: json_file path must be within sandbox directory.`;
+        }
+        try {
+            const raw = fs.readFileSync(resolvedPath, 'utf-8');
+            const jsonData = JSON.parse(raw);
+            // 合并：JSON 文件中的字段优先（slides/blocks 等大字段），内联参数作为 fallback
+            if (type === 'pptx') {
+                const d = data;
+                data = {
+                    ...jsonData,
+                    title: d.title || jsonData.title,
+                    theme: d.theme || jsonData.theme,
+                    filename: d.filename || jsonData.filename,
+                };
+            }
+            else {
+                const d = data;
+                data = {
+                    ...jsonData,
+                    title: d.title || jsonData.title,
+                    theme: d.theme || jsonData.theme,
+                    options: d.options || jsonData.options,
+                    filename: d.filename || jsonData.filename,
+                };
+            }
+        }
+        catch (err) {
+            return `Error: Failed to read or parse json_file "${jsonFilePath}": ${err?.message || err}`;
+        }
+    }
+    // 1. 渲染文档
+    let result;
+    switch (type) {
+        case 'pptx':
+            result = await (0, pptx_renderer_ts_1.renderPptx)(data, templatesDir);
+            break;
+        case 'docx':
+            result = await (0, docx_renderer_ts_1.renderDocx)(data, templatesDir);
+            break;
+        case 'pdf':
+            result = await (0, pdf_renderer_ts_1.renderPdf)(data, templatesDir);
+            break;
+        default:
+            return `Error: Unsupported document type: ${type}`;
+    }
+    // 确保文件名带正确扩展名（LLM 可能传入无后缀的文件名）
+    result.filename = ensureExtension(result.filename, type);
+    // 2. 保存到沙箱
+    const sandbox = ctx.custom?.sandbox;
+    if (!sandbox) {
+        return 'Error: Sandbox not available. Cannot save document artifact.';
+    }
+    const fsExec = sandbox.getFileSystemExecutor();
+    if (!fsExec) {
+        return 'Error: FileSystem executor not available in sandbox.';
+    }
+    // 写入临时文件到 Artifact 临时目录，避免污染沙箱根目录
+    const tempDir = '_artifacts/.tmp';
+    const tempPath = `${tempDir}/${result.filename}`;
+    try {
+        if (fsExec.writeFile) {
+            // 对于二进制文件，需要通过 shell 写入
+            const shell = sandbox.getShellExecutor();
+            const base64 = result.buffer.toString('base64');
+            // 分段写入 base64 以避免命令过长
+            const chunkSize = 50000;
+            await shell.exec(`mkdir -p "${tempDir}" && echo -n "" > "${tempPath}.b64"`, 5000);
+            for (let i = 0; i < base64.length; i += chunkSize) {
+                const chunk = base64.slice(i, i + chunkSize);
+                await shell.exec(`echo -n "${chunk}" >> "${tempPath}.b64"`, 5000);
+            }
+            await shell.exec(`base64 -d "${tempPath}.b64" > "${tempPath}" && rm "${tempPath}.b64"`, 10000);
+        }
+    }
+    catch (err) {
+        return `Error: Failed to write document file to sandbox: ${err?.message || err}`;
+    }
+    // 3. 保存为 Artifact
+    try {
+        const sessionId = ctx.sessionId || 'default';
+        const artifactResult = (0, artifact_service_ts_1.saveArtifact)(sandbox.rootDir, sessionId, result.filename, result.buffer);
+        // 通过 SSE 推送到前端（去重命中时跳过）
+        const emitArtifact = ctx.emitArtifact;
+        if (emitArtifact && !artifactResult.dedup) {
+            emitArtifact({
+                artifactId: artifactResult.artifactId,
+                filename: artifactResult.filename,
+                mimeType: artifactResult.mimeType,
+                size: artifactResult.size,
+                url: artifactResult.url,
+                description: `${type.toUpperCase()} document: ${data.title}`,
+            });
+        }
+        return `Document created: ${artifactResult.filename} (${artifactResult.size} bytes). It has been added to the artifact panel for preview and download.`;
+    }
+    catch (err) {
+        return `Error: Failed to save artifact: ${err?.message || err}`;
+    }
+}
+/**
+ * 生成 HTML Report 并保存为 Artifact + 推送 Widget 事件
+ * 专为 create_report 工具设计：一步完成渲染、保存、内联展示
+ */
+async function generateReportAndDisplay(data, ctx, jsonFilePath) {
+    // 如果提供了 json_file，从沙箱读取 JSON 并合并
+    if (jsonFilePath) {
+        const sandbox = ctx.custom?.sandbox;
+        if (!sandbox)
+            return 'Error: Sandbox not available. Cannot read json_file.';
+        const resolvedPath = path.isAbsolute(jsonFilePath)
+            ? jsonFilePath
+            : path.join(sandbox.rootDir, jsonFilePath);
+        if (!resolvedPath.startsWith(sandbox.rootDir)) {
+            return `Error: json_file path must be within sandbox directory.`;
+        }
+        try {
+            const raw = fs.readFileSync(resolvedPath, 'utf-8');
+            const jsonData = JSON.parse(raw);
+            data = {
+                ...jsonData,
+                title: data.title || jsonData.title,
+                theme: data.theme || jsonData.theme,
+                subtitle: data.subtitle || jsonData.subtitle,
+                date: data.date || jsonData.date,
+            };
+        }
+        catch (err) {
+            return `Error: Failed to read or parse json_file "${jsonFilePath}": ${err?.message || err}`;
+        }
+    }
+    if (!data.title)
+        return 'Error: title is required for report generation.';
+    // 1. 渲染 HTML
+    const html = (0, report_renderer_ts_1.renderReport)(data);
+    const buffer = Buffer.from(html, 'utf-8');
+    const filename = data.filename
+        ? ensureExtension(data.filename, 'html')
+        : `${data.title.replace(/[^\w\u4e00-\u9fff]+/g, '_').slice(0, 50)}.html`;
+    // 2. 保存到沙箱 + Artifact
+    const sandbox = ctx.custom?.sandbox;
+    if (!sandbox)
+        return 'Error: Sandbox not available.';
+    let artifactSize = buffer.length;
+    try {
+        const sessionId = ctx.sessionId || 'default';
+        const artifactResult = (0, artifact_service_ts_1.saveArtifact)(sandbox.rootDir, sessionId, filename, buffer);
+        artifactSize = artifactResult.size;
+        // 推送 artifact 事件
+        const emitArtifact = ctx.emitArtifact;
+        if (emitArtifact && !artifactResult.dedup) {
+            emitArtifact({
+                artifactId: artifactResult.artifactId,
+                filename: artifactResult.filename,
+                mimeType: 'text/html',
+                size: artifactResult.size,
+                url: artifactResult.url,
+                description: `HTML Report: ${data.title}`,
+            });
+        }
+    }
+    catch (err) {
+        return `Error: Failed to save report artifact: ${err?.message || err}`;
+    }
+    // 3. 不再推送 Widget 事件 — artifact 卡片自带预览入口，避免与 ArtifactCard 重复展示相同内容
+    return `Report created: ${filename} (${artifactSize} bytes). It has been added to the artifact panel for preview and download.`;
+}
+//# sourceMappingURL=index.js.map