@lingxiao-office/sdk 1.0.0

package/dist/tools/implementations/GenerateSlidevTool.js

@@ -0,0 +1,128 @@
+import { z } from 'zod';
+import { basename } from 'path';
+import { Tool } from '../Tool.js';
+import { tempDownloadRegistry } from '../../core/TempDownloadRegistry.js';
+import { slidevServerManager } from '../../core/SlidevServerManager.js';
+import { buildSlidevProject } from '../slidev/SlidevProjectBuilder.js';
+import { exportSlidevDeck, slidevExportName } from '../slidev/SlidevExporter.js';
+const GenerateSlidevSchema = z.object({
+    output_dir: z.string().optional().describe('Slidev 项目输出目录。省略时写入当前 session scratchpad。'),
+    title: z.string().optional().describe('演示标题，用于项目名和 frontmatter 默认标题。'),
+    markdown: z.string().min(1).describe('完整 Slidev slides.md 内容。应包含 frontmatter、--- 分页、布局指令、代码块或 Mermaid 图表。'),
+    theme: z.string().default('default').describe('Slidev 主题名。内置支持 default、seriph、apple-basic；自定义主题需由项目依赖提供。'),
+    style_css: z.string().optional().describe('可选全局 CSS，写入 style.css。'),
+    start_preview: z.boolean().default(true).describe('是否启动内置 Slidev dev server 并返回 previewUrl。'),
+    export_formats: z.array(z.enum(['pdf', 'pptx', 'png'])).default([]).describe('需要导出的格式。PPTX 为图片拼装，文字不可编辑。'),
+    host: z.string().default('127.0.0.1'),
+    port: z.number().int().min(0).max(65535).optional().describe('预览端口。省略或 0 时自动分配。'),
+    create_project_zip: z.boolean().default(true),
+    create_download_links: z.boolean().default(true),
+    timeout_ms: z.number().int().min(10_000).max(600_000).default(120_000),
+});
+export class GenerateSlidevTool extends Tool {
+    name = 'generate_slidev';
+    description = '生成 Slidev Markdown 演示项目，支持内置运行时预览和 PDF/PPTX/PNG 导出。适用于代码高亮、Mermaid、Markdown-first 的技术分享和商务演示。内置主题：default、seriph、apple-basic。';
+    parameters = GenerateSlidevSchema;
+    async execute(input, context = {}) {
+        const params = GenerateSlidevSchema.parse(input);
+        const warnings = [];
+        try {
+            const project = await buildSlidevProject({
+                workspace: context.workspace,
+                sessionId: context.sessionId,
+                taskWriteScope: context.taskWriteScope,
+                outputDir: params.output_dir,
+                title: params.title,
+                markdown: params.markdown,
+                theme: params.theme,
+                styleCss: params.style_css,
+            });
+            warnings.push(...project.warnings);
+            let projectArtifact;
+            if (params.create_project_zip && params.create_download_links) {
+                projectArtifact = tempDownloadRegistry.create({
+                    path: project.zipPath,
+                    name: basename(project.zipPath),
+                    mimeType: 'application/zip',
+                    expiresInSeconds: undefined,
+                    sessionId: context.sessionId,
+                });
+            }
+            let preview;
+            if (params.start_preview) {
+                preview = await slidevServerManager.start({
+                    projectDir: project.projectDir,
+                    slidesPath: project.slidesPath,
+                    host: params.host,
+                    port: params.port,
+                });
+            }
+            const exported = await exportSlidevDeck({
+                projectDir: project.projectDir,
+                slidesPath: project.slidesPath,
+                formats: params.export_formats,
+                outputBaseName: project.slug,
+                timeoutMs: params.timeout_ms,
+            });
+            const exportArtifacts = params.create_download_links
+                ? exported.map(item => ({
+                    ...tempDownloadRegistry.create({
+                        path: item.path,
+                        name: slidevExportName(item.path),
+                        mimeType: item.mimeType,
+                        expiresInSeconds: undefined,
+                        sessionId: context.sessionId,
+                    }),
+                    format: item.format,
+                    warning: item.warning,
+                }))
+                : exported.map(item => ({
+                    type: 'download_artifact',
+                    token: '',
+                    url: '',
+                    name: slidevExportName(item.path),
+                    path: item.path,
+                    size: 0,
+                    mimeType: item.mimeType,
+                    expiresAt: '',
+                    format: item.format,
+                    warning: item.warning,
+                }));
+            warnings.push(...exported.map(item => item.warning).filter((item) => Boolean(item)));
+            const previewUrl = preview?.id ? `/api/v1/slidev/preview/${preview.id}/` : undefined;
+            const data = projectArtifact ? {
+                ...projectArtifact,
+                kind: 'slidev',
+                previewUrl,
+                rawPreviewUrl: preview?.url,
+                previewId: preview?.id,
+                projectDir: project.projectDir,
+                slidesPath: project.slidesPath,
+                exports: exportArtifacts,
+                warnings,
+                mode: 'slidev',
+            } : {
+                message: `Slidev 项目已生成: ${project.projectDir}`,
+                kind: 'slidev',
+                previewUrl,
+                rawPreviewUrl: preview?.url,
+                previewId: preview?.id,
+                projectDir: project.projectDir,
+                slidesPath: project.slidesPath,
+                zipPath: project.zipPath,
+                exports: exportArtifacts,
+                warnings,
+                mode: 'slidev',
+            };
+            return { success: true, data };
+        }
+        catch (err) {
+            return {
+                success: false,
+                data: { warnings },
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+    }
+}
+//# sourceMappingURL=GenerateSlidevTool.js.map

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

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

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

@@ -0,0 +1,63 @@
+import { z } from 'zod';
+import { Tool, type ToolContext, type ToolResult } from '../Tool.js';
+export declare class GenerateXlsxTool extends Tool {
+    readonly name = "generate_xlsx";
+    readonly description = "\u751F\u6210 Excel XLSX \u5DE5\u4F5C\u7C3F\u3002\u652F\u6301\u591A\u5DE5\u4F5C\u8868\u3001\u81EA\u5B9A\u4E49\u5217\u5BBD\u3001\u516C\u5F0F\uFF08SUM/AVERAGE/COUNTIF \u7B49\uFF09\u3001\u6700\u591A 50 \u5217 \u00D7 10000 \u884C\u3002";
+    readonly parameters: z.ZodObject<{
+        path: z.ZodOptional<z.ZodString>;
+        title: z.ZodString;
+        sheets: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            columns: z.ZodArray<z.ZodObject<{
+                header: z.ZodString;
+                width: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            rows: z.ZodArray<z.ZodArray<z.ZodString>>;
+            formulas: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                cell: z.ZodString;
+                formula: z.ZodString;
+            }, z.core.$strip>>>;
+            conditionalFormatting: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                range: z.ZodString;
+                type: z.ZodEnum<{
+                    dataBar: "dataBar";
+                    colorScale: "colorScale";
+                    iconSet: "iconSet";
+                }>;
+                color: z.ZodOptional<z.ZodString>;
+                showValue: z.ZodOptional<z.ZodBoolean>;
+                minColor: z.ZodOptional<z.ZodString>;
+                midColor: z.ZodOptional<z.ZodString>;
+                maxColor: z.ZodOptional<z.ZodString>;
+                iconSet: z.ZodOptional<z.ZodEnum<{
+                    "3Arrows": "3Arrows";
+                    "3ArrowsGray": "3ArrowsGray";
+                    "3Flags": "3Flags";
+                    "3TrafficLights1": "3TrafficLights1";
+                    "3TrafficLights2": "3TrafficLights2";
+                    "3Signs": "3Signs";
+                    "3Symbols": "3Symbols";
+                    "3Symbols2": "3Symbols2";
+                    "4Arrows": "4Arrows";
+                    "4ArrowsGray": "4ArrowsGray";
+                    "4RedToBlack": "4RedToBlack";
+                    "4Rating": "4Rating";
+                    "4TrafficLights": "4TrafficLights";
+                    "5Arrows": "5Arrows";
+                    "5ArrowsGray": "5ArrowsGray";
+                    "5Rating": "5Rating";
+                    "5Quarters": "5Quarters";
+                }>>;
+                reverse: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>>;
+            styleHeader: z.ZodDefault<z.ZodBoolean>;
+            stripedRows: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        create_download_link: z.ZodDefault<z.ZodBoolean>;
+        expires_in_seconds: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    execute(args: unknown, context?: ToolContext): Promise<ToolResult>;
+    private buildConditionalFormattingRules;
+}
+export default GenerateXlsxTool;
+//# sourceMappingURL=GenerateXlsxTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GenerateXlsxTool.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/GenerateXlsxTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAqDrE,qBAAa,gBAAiB,SAAQ,IAAI;IACxC,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,WAAW,4OAAiF;IACrG,QAAQ,CAAC,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAAsB;IAEnC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAoGxE,OAAO,CAAC,+BAA+B;CA0ExC;AAED,eAAe,gBAAgB,CAAC"}

package/dist/tools/implementations/GenerateXlsxTool.js

@@ -0,0 +1,202 @@
+import { z } from 'zod';
+import { dirname, resolve } from 'path';
+import { mkdirSync } from 'fs';
+import { Tool } from '../Tool.js';
+import { resolveTaskWritePath } from './utils.js';
+import { tempDownloadRegistry } from '../../core/TempDownloadRegistry.js';
+import { ensureExtension, slugFileName } from './OfficeXmlBuilder.js';
+import { applyDefaultHeaderStyle, applyStripedRows } from './office/XlsxStyleBuilder.js';
+import { createWorkbook, setCellValue } from './office/ExcelWorkbook.js';
+const XlsxColumnSchema = z.object({
+    header: z.string().describe('列标题'),
+    width: z.number().min(5).max(100).optional().describe('列宽（字符数），默认 12'),
+});
+const XlsxFormulaSchema = z.object({
+    cell: z.string().describe('单元格引用，如 "E1"、"B10"'),
+    formula: z.string().describe('公式表达式，如 "SUM(B2:B100)"、"AVERAGE(C2:C50)"'),
+});
+const ConditionalFormattingSchema = z.object({
+    range: z.string().describe('应用范围，如 "A2:A100"'),
+    type: z.enum(['dataBar', 'colorScale', 'iconSet']).describe('条件格式类型'),
+    // Data Bar 配置
+    color: z.string().optional().describe('数据条颜色（hex），如 "FF638EC6"'),
+    showValue: z.boolean().optional().describe('是否显示单元格值'),
+    // Color Scale 配置
+    minColor: z.string().optional().describe('最小值颜色（hex）'),
+    midColor: z.string().optional().describe('中间值颜色（hex），三色阶时使用'),
+    maxColor: z.string().optional().describe('最大值颜色（hex）'),
+    // Icon Set 配置
+    iconSet: z.enum(['3Arrows', '3ArrowsGray', '3Flags', '3TrafficLights1', '3TrafficLights2', '3Signs', '3Symbols', '3Symbols2', '4Arrows', '4ArrowsGray', '4RedToBlack', '4Rating', '4TrafficLights', '5Arrows', '5ArrowsGray', '5Rating', '5Quarters']).optional().describe('图标集类型'),
+    reverse: z.boolean().optional().describe('是否反转图标顺序'),
+});
+const XlsxSheetSchema = z.object({
+    name: z.string().min(1).max(31).describe('工作表名称'),
+    columns: z.array(XlsxColumnSchema).min(1).max(50).describe('列定义，第一行自动作为表头'),
+    rows: z.array(z.array(z.string())).max(10000).describe('数据行，每行长度应与 columns 一致'),
+    formulas: z.array(XlsxFormulaSchema).optional().describe('公式定义，会在指定单元格写入 Excel 公式'),
+    conditionalFormatting: z.array(ConditionalFormattingSchema).optional().describe('条件格式定义（当前仅记录在返回摘要中，复杂条件格式建议使用 Office runtime/模板处理）'),
+    styleHeader: z.boolean().default(true).describe('是否尝试为表头应用样式（受底层库限制，效果可能不可见）'),
+    stripedRows: z.boolean().default(false).describe('是否尝试应用条纹行样式（受底层库限制，效果可能不可见）'),
+});
+const GenerateXlsxSchema = z.object({
+    path: z.string().optional().describe('输出 xlsx 路径。可省略，默认写入当前 session scratchpad。'),
+    title: z.string().min(1).max(200).describe('工作簿标题（用于文件名和文档属性）'),
+    sheets: z.array(XlsxSheetSchema).min(1).max(20).describe('工作表数组，至少 1 个，最多 20 个'),
+    create_download_link: z.boolean().default(true),
+    expires_in_seconds: z.number().optional(),
+});
+export class GenerateXlsxTool extends Tool {
+    name = 'generate_xlsx';
+    description = '生成 Excel XLSX 工作簿。支持多工作表、自定义列宽、公式（SUM/AVERAGE/COUNTIF 等）、最多 50 列 × 10000 行。';
+    parameters = GenerateXlsxSchema;
+    async execute(args, context) {
+        const parsed = GenerateXlsxSchema.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 defaultName = `${slugFileName(input.title, 'workbook')}.xlsx`;
+        const requestedPath = input.path || `.lingxiao/sessions/${context?.sessionId || 'default'}/scratchpad/${defaultName}`;
+        let outputPath;
+        try {
+            outputPath = ensureExtension(resolveTaskWritePath(context?.workspace, requestedPath, context?.sessionId, context?.taskWriteScope), '.xlsx');
+        }
+        catch (error) {
+            return { success: false, data: null, error: `ERROR: ${error instanceof Error ? error.message : String(error)}` };
+        }
+        try {
+            const wb = await createWorkbook();
+            wb.title = input.title;
+            wb.creator = 'LingXiao';
+            wb.created = new Date();
+            const sheetSummaries = [];
+            for (const sheet of input.sheets) {
+                const ws = wb.addWorksheet(sheet.name);
+                ws.addRow(sheet.columns.map(c => c.header));
+                for (const row of sheet.rows) {
+                    ws.addRow(row);
+                }
+                // 设置列宽
+                ws.columns = sheet.columns.map(c => ({ header: c.header, width: c.width || 12 }));
+                // 写入公式
+                if (sheet.formulas?.length) {
+                    for (const f of sheet.formulas) {
+                        ws.getCell(f.cell.toUpperCase()).value = { formula: f.formula.replace(/^=/, ''), result: 0 };
+                    }
+                }
+                // Normalize generated values so leading "=" strings become formulas.
+                for (let rowNumber = 2; rowNumber <= sheet.rows.length + 1; rowNumber++) {
+                    const source = sheet.rows[rowNumber - 2] ?? [];
+                    for (let columnNumber = 1; columnNumber <= source.length; columnNumber++) {
+                        setCellValue(ws.getCell(rowNumber, columnNumber), source[columnNumber - 1]);
+                    }
+                }
+                // 应用表头样式
+                if (sheet.styleHeader !== false) {
+                    applyDefaultHeaderStyle(ws, sheet.columns.length);
+                }
+                // 应用条纹行样式
+                if (sheet.stripedRows && sheet.rows.length > 0) {
+                    applyStripedRows(ws, sheet.columns.length, sheet.rows.length + 1, 2);
+                }
+                // 条件格式由 buildConditionalFormattingRules 校验/汇总；复杂 OOXML 注入交给后续 runtime。
+                if (sheet.conditionalFormatting?.length)
+                    this.buildConditionalFormattingRules(sheet.conditionalFormatting);
+                sheetSummaries.push({
+                    name: sheet.name,
+                    rows: sheet.rows.length,
+                    columns: sheet.columns.length,
+                    conditionalFormats: sheet.conditionalFormatting?.length || 0,
+                });
+            }
+            mkdirSync(dirname(outputPath), { recursive: true });
+            await wb.xlsx.writeFile(outputPath);
+            const artifact = input.create_download_link
+                ? tempDownloadRegistry.create({
+                    path: outputPath,
+                    name: defaultName,
+                    mimeType: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+                    expiresInSeconds: input.expires_in_seconds,
+                    sessionId: context?.sessionId,
+                })
+                : undefined;
+            return {
+                success: true,
+                data: artifact ? {
+                    ...artifact,
+                    sheetCount: input.sheets.length,
+                    sheets: sheetSummaries,
+                } : {
+                    path: resolve(outputPath),
+                    sheetCount: input.sheets.length,
+                    sheets: sheetSummaries,
+                },
+            };
+        }
+        catch (error) {
+            return { success: false, data: null, error: `ERROR: ${error instanceof Error ? error.message : String(error)}` };
+        }
+    }
+    buildConditionalFormattingRules(formats) {
+        const rules = [];
+        for (const fmt of formats) {
+            if (fmt.type === 'dataBar') {
+                rules.push({
+                    type: 'dataBar',
+                    minValue: { type: 'min' },
+                    maxValue: { type: 'max' },
+                    color: fmt.color || 'FF638EC6',
+                    showValue: fmt.showValue !== false,
+                });
+            }
+            else if (fmt.type === 'colorScale') {
+                if (fmt.midColor) {
+                    // 三色阶
+                    rules.push({
+                        type: 'colorScale',
+                        minValue: { type: 'min' },
+                        minColor: fmt.minColor || 'F8696B',
+                        midValue: { type: 'percentile', val: 50 },
+                        midColor: fmt.midColor,
+                        maxValue: { type: 'max' },
+                        maxColor: fmt.maxColor || '63BE7B',
+                    });
+                }
+                else {
+                    // 二色阶
+                    rules.push({
+                        type: 'colorScale',
+                        minValue: { type: 'min' },
+                        minColor: fmt.minColor || 'FFFFFF',
+                        maxValue: { type: 'max' },
+                        maxColor: fmt.maxColor || '5A8AC6',
+                    });
+                }
+            }
+            else if (fmt.type === 'iconSet') {
+                const iconSet = fmt.iconSet || '3Arrows';
+                const iconCount = iconSet.startsWith('3') ? 3 : iconSet.startsWith('4') ? 4 : 5;
+                const values = [];
+                if (iconCount === 3) {
+                    values.push({ type: 'percentile', val: 0 }, { type: 'percentile', val: 33 }, { type: 'percentile', val: 67 });
+                }
+                else if (iconCount === 4) {
+                    values.push({ type: 'percentile', val: 0 }, { type: 'percentile', val: 25 }, { type: 'percentile', val: 50 }, { type: 'percentile', val: 75 });
+                }
+                else {
+                    values.push({ type: 'percentile', val: 0 }, { type: 'percentile', val: 20 }, { type: 'percentile', val: 40 }, { type: 'percentile', val: 60 }, { type: 'percentile', val: 80 });
+                }
+                rules.push({
+                    type: 'iconSet',
+                    iconSet: iconSet,
+                    values,
+                    reverse: fmt.reverse || false,
+                    showValue: fmt.showValue !== false,
+                });
+            }
+        }
+        return rules;
+    }
+}
+export default GenerateXlsxTool;
+//# sourceMappingURL=GenerateXlsxTool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GenerateXlsxTool.js","sourceRoot":"","sources":["../../../src/tools/implementations/GenerateXlsxTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,EAAE,IAAI,EAAqC,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACzF,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzE,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;IAClC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;CACvE,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IAC/C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;CACzE,CAAC,CAAC;AAEH,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IAC9C,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;IACrE,cAAc;IACd,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IAChE,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;IACtD,iBAAiB;IACjB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;IACtD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAC7D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;IACtD,cAAc;IACd,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC;IACnR,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;CACrD,CAAC,CAAC;AAEH,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;IACjD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC;IAC3E,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IAC/E,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IACnF,qBAAqB,EAAE,CAAC,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;IACrI,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IAC9E,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,6BAA6B,CAAC;CAChF,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IACjF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAC/D,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IAChF,oBAAoB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAC/C,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC;AAIH,MAAM,OAAO,gBAAiB,SAAQ,IAAI;IAC/B,IAAI,GAAG,eAAe,CAAC;IACvB,WAAW,GAAG,6EAA6E,CAAC;IAC5F,UAAU,GAAG,kBAAkB,CAAC;IAEzC,KAAK,CAAC,OAAO,CAAC,IAAa,EAAE,OAAqB;QAChD,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACzI,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC;QAE1B,MAAM,WAAW,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC;QACpE,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,IAAI,sBAAsB,OAAO,EAAE,SAAS,IAAI,SAAS,eAAe,WAAW,EAAE,CAAC;QACtH,IAAI,UAAkB,CAAC;QACvB,IAAI,CAAC;YACH,UAAU,GAAG,eAAe,CAAC,oBAAoB,CAAC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC;QAC9I,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QACnH,CAAC;QAED,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,cAAc,EAAE,CAAC;YAClC,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;YACvB,EAAE,CAAC,OAAO,GAAG,UAAU,CAAC;YACxB,EAAE,CAAC,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;YAExB,MAAM,cAAc,GAAwF,EAAE,CAAC;YAE/G,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjC,MAAM,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACvC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;gBAC5C,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;oBAC7B,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACjB,CAAC;gBAED,OAAO;gBACP,EAAE,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;gBAElF,OAAO;gBACP,IAAI,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;oBAC3B,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;wBAC/B,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,KAAK,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;oBAC/F,CAAC;gBACH,CAAC;gBAED,qEAAqE;gBACrE,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,SAAS,EAAE,EAAE,CAAC;oBACxE,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;oBAC/C,KAAK,IAAI,YAAY,GAAG,CAAC,EAAE,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,CAAC;wBACzE,YAAY,CAAC,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC;oBAC9E,CAAC;gBACH,CAAC;gBAED,SAAS;gBACT,IAAI,KAAK,CAAC,WAAW,KAAK,KAAK,EAAE,CAAC;oBAChC,uBAAuB,CAAC,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBACpD,CAAC;gBAED,UAAU;gBACV,IAAI,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC/C,gBAAgB,CAAC,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;gBACvE,CAAC;gBAED,uEAAuE;gBACvE,IAAI,KAAK,CAAC,qBAAqB,EAAE,MAAM;oBAAE,IAAI,CAAC,+BAA+B,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;gBAE3G,cAAc,CAAC,IAAI,CAAC;oBAClB,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM;oBACvB,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM;oBAC7B,kBAAkB,EAAE,KAAK,CAAC,qBAAqB,EAAE,MAAM,IAAI,CAAC;iBAC7D,CAAC,CAAC;YACL,CAAC;YAED,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACpD,MAAM,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;YAEpC,MAAM,QAAQ,GAAG,KAAK,CAAC,oBAAoB;gBACzC,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC;oBAC5B,IAAI,EAAE,UAAU;oBAChB,IAAI,EAAE,WAAW;oBACjB,QAAQ,EAAE,mEAAmE;oBAC7E,gBAAgB,EAAE,KAAK,CAAC,kBAAkB;oBAC1C,SAAS,EAAE,OAAO,EAAE,SAAS;iBAC9B,CAAC;gBACF,CAAC,CAAC,SAAS,CAAC;YAEd,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;oBACf,GAAG,QAAQ;oBACX,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;oBAC/B,MAAM,EAAE,cAAc;iBACvB,CAAC,CAAC,CAAC;oBACF,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC;oBACzB,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;oBAC/B,MAAM,EAAE,cAAc;iBACvB;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QACnH,CAAC;IACH,CAAC;IAEO,+BAA+B,CAAC,OAA2D;QACjG,MAAM,KAAK,GAAgC,EAAE,CAAC;QAE9C,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC3B,KAAK,CAAC,IAAI,CAAC;oBACT,IAAI,EAAE,SAAS;oBACf,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE;oBACzB,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE;oBACzB,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,UAAU;oBAC9B,SAAS,EAAE,GAAG,CAAC,SAAS,KAAK,KAAK;iBACnC,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBACrC,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;oBACjB,MAAM;oBACN,KAAK,CAAC,IAAI,CAAC;wBACT,IAAI,EAAE,YAAY;wBAClB,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE;wBACzB,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,QAAQ;wBAClC,QAAQ,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,EAAE,EAAE;wBACzC,QAAQ,EAAE,GAAG,CAAC,QAAQ;wBACtB,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE;wBACzB,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,QAAQ;qBACnC,CAAC,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACN,MAAM;oBACN,KAAK,CAAC,IAAI,CAAC;wBACT,IAAI,EAAE,YAAY;wBAClB,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE;wBACzB,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,QAAQ;wBAClC,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE;wBACzB,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,QAAQ;qBACnC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;iBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAClC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,SAAS,CAAC;gBACzC,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAEhF,MAAM,MAAM,GAAG,EAAE,CAAC;gBAClB,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;oBACpB,MAAM,CAAC,IAAI,CACT,EAAE,IAAI,EAAE,YAAqB,EAAE,GAAG,EAAE,CAAC,EAAE,EACvC,EAAE,IAAI,EAAE,YAAqB,EAAE,GAAG,EAAE,EAAE,EAAE,EACxC,EAAE,IAAI,EAAE,YAAqB,EAAE,GAAG,EAAE,EAAE,EAAE,CACzC,CAAC;gBACJ,CAAC;qBAAM,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;oBAC3B,MAAM,CAAC,IAAI,CACT,EAAE,IAAI,EAAE,YAAqB,EAAE,GAAG,EAAE,CAAC,EAAE,EACvC,EAAE,IAAI,EAAE,YAAqB,EAAE,GAAG,EAAE,EAAE,EAAE,EACxC,EAAE,IAAI,EAAE,YAAqB,EAAE,GAAG,EAAE,EAAE,EAAE,EACxC,EAAE,IAAI,EAAE,YAAqB,EAAE,GAAG,EAAE,EAAE,EAAE,CACzC,CAAC;gBACJ,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,CACT,EAAE,IAAI,EAAE,YAAqB,EAAE,GAAG,EAAE,CAAC,EAAE,EACvC,EAAE,IAAI,EAAE,YAAqB,EAAE,GAAG,EAAE,EAAE,EAAE,EACxC,EAAE,IAAI,EAAE,YAAqB,EAAE,GAAG,EAAE,EAAE,EAAE,EACxC,EAAE,IAAI,EAAE,YAAqB,EAAE,GAAG,EAAE,EAAE,EAAE,EACxC,EAAE,IAAI,EAAE,YAAqB,EAAE,GAAG,EAAE,EAAE,EAAE,CACzC,CAAC;gBACJ,CAAC;gBAED,KAAK,CAAC,IAAI,CAAC;oBACT,IAAI,EAAE,SAAS;oBACf,OAAO,EAAE,OAAsB;oBAC/B,MAAM;oBACN,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,KAAK;oBAC7B,SAAS,EAAE,GAAG,CAAC,SAAS,KAAK,KAAK;iBACnC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED,eAAe,gBAAgB,CAAC"}

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

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import { Tool, type ToolContext, type ToolResult } from '../Tool.js';
+export declare class GetTerminalOutputTool extends Tool {
+    readonly name = "get_terminal_output";
+    readonly description = "\u83B7\u53D6\u540E\u53F0\u7EC8\u7AEF\u4F1A\u8BDD\u7684\u8F93\u51FA\u3002\u7528\u4E8E\u67E5\u770B\u540E\u53F0\u547D\u4EE4\u7684\u8FD0\u884C\u72B6\u6001\u548C\u8F93\u51FA\u5185\u5BB9\u3002";
+    readonly parameters: z.ZodObject<{
+        terminal_id: z.ZodString;
+        wait_seconds: z.ZodOptional<z.ZodNumber>;
+        tail_lines: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    execute(args: unknown, _context?: ToolContext): Promise<ToolResult>;
+    private getStatusLabel;
+}
+export default GetTerminalOutputTool;
+//# sourceMappingURL=GetTerminalOutput.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GetTerminalOutput.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/GetTerminalOutput.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAmB,IAAI,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAWtF,qBAAa,qBAAsB,SAAQ,IAAI;IAC7C,QAAQ,CAAC,IAAI,yBAAyB;IACtC,QAAQ,CAAC,WAAW,gMAAqC;IACzD,QAAQ,CAAC,UAAU;;;;sBAA2B;IAExC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAkFzE,OAAO,CAAC,cAAc;CAUvB;AAED,eAAe,qBAAqB,CAAC"}

package/dist/tools/implementations/GetTerminalOutput.js

@@ -0,0 +1,97 @@
+import { z } from 'zod';
+import { createToolError, Tool } from '../Tool.js';
+import { getTerminalSessionManager } from './TerminalSessionManager.js';
+import { isTerminalSessionActiveStatus } from '../../core/StateSemantics.js';
+import { TERMINAL } from '../../config/defaults.js';
+const GetTerminalOutputSchema = z.object({
+    terminal_id: z.string().describe('终端会话 ID，使用 shell(is_background=true) 返回的 terminal_id。'),
+    wait_seconds: z.number().optional().describe('等待时间 (秒，默认 2)'),
+    tail_lines: z.number().optional().describe('返回最后 N 行 (默认全部)'),
+});
+export class GetTerminalOutputTool extends Tool {
+    name = 'get_terminal_output';
+    description = '获取后台终端会话的输出。用于查看后台命令的运行状态和输出内容。';
+    parameters = GetTerminalOutputSchema;
+    async execute(args, _context) {
+        const params = args;
+        const manager = getTerminalSessionManager();
+        const session = manager.getSession(params.terminal_id);
+        if (!session) {
+            const active = manager.getAllActiveSessions().slice(0, 10).map((s) => ({
+                terminal_id: s.terminalId,
+                command: s.command,
+                status: s.status,
+                pid: s.pid,
+                started_at: s.startedAt,
+            }));
+            return createToolError({
+                code: 'TERMINAL_SESSION_NOT_FOUND',
+                message: `终端会话 ${params.terminal_id} 不存在。`,
+                retryable: true,
+                cause: 'terminal_id 可能已过期、被清理，或不是 shell 后台返回的真实 ID。',
+                fix: active.length > 0 ? '改用 active_sessions 中的 terminal_id；如果没有目标会话，请重新运行 shell 并设置 is_background=true。' : '当前没有活跃后台会话；请重新运行 shell 并设置 is_background=true，再用返回的 terminal_id 查询。',
+                hints: { active_sessions: active },
+                example_args: active[0] ? { terminal_id: active[0].terminal_id } : { terminal_id: '<shell 返回的 terminal_id>' },
+            });
+        }
+        const waitSeconds = params.wait_seconds ?? 2;
+        // 如果会话还在运行，等待一段时间看是否有新输出
+        if (isTerminalSessionActiveStatus(session.status)) {
+            await new Promise(resolve => setTimeout(resolve, waitSeconds * 1000));
+        }
+        // 构建输出
+        let stdoutText = session.stdout || '(无输出)';
+        let stderrText = session.stderr || '';
+        // tail_lines 处理
+        if (params.tail_lines && params.tail_lines > 0) {
+            const stdoutLines = stdoutText.split('\n');
+            if (stdoutLines.length > params.tail_lines) {
+                stdoutText = `... (省略前 ${stdoutLines.length - params.tail_lines} 行)\n` +
+                    stdoutLines.slice(-params.tail_lines).join('\n');
+            }
+        }
+        // 截断保护
+        if (stdoutText.length > TERMINAL.OUTPUT_TRUNCATE_CHARS) {
+            stdoutText = stdoutText.substring(stdoutText.length - TERMINAL.OUTPUT_TRUNCATE_CHARS) + '\n... (截断)';
+        }
+        if (stderrText.length > TERMINAL.OUTPUT_TRUNCATE_CHARS) {
+            stderrText = stderrText.substring(stderrText.length - TERMINAL.OUTPUT_TRUNCATE_CHARS) + '\n... (截断)';
+        }
+        const statusLabel = this.getStatusLabel(session.status);
+        const header = [
+            `[终端 ${session.terminalId.substring(0, 8)} | PID ${session.pid ?? 'N/A'} | 状态: ${statusLabel}]`,
+            `命令: ${session.command}`,
+            `开始时间: ${new Date(session.startedAt).toLocaleString()}`,
+        ];
+        if (session.completedAt) {
+            header.push(`完成时间: ${new Date(session.completedAt).toLocaleString()}`);
+        }
+        if (session.exitCode !== null) {
+            header.push(`退出码: ${session.exitCode}`);
+        }
+        if (session.exitSignal) {
+            header.push(`信号: ${session.exitSignal}`);
+        }
+        header.push(`最后输出: ${new Date(session.outputUpdatedAt).toLocaleString()}`);
+        const parts = [header.join('\n'), '---', stdoutText];
+        if (stderrText) {
+            parts.push(`\n[stderr]\n${stderrText}`);
+        }
+        return {
+            success: true,
+            data: parts.join('\n'),
+        };
+    }
+    getStatusLabel(status) {
+        const labels = {
+            running: '运行中',
+            suspended: '已挂起',
+            completed: '已完成',
+            failed: '失败',
+            killed: '已终止',
+        };
+        return labels[status] || status;
+    }
+}
+export default GetTerminalOutputTool;
+//# sourceMappingURL=GetTerminalOutput.js.map

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

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

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

@@ -0,0 +1,70 @@
+import { z } from 'zod';
+import { Tool, type ToolContext, type ToolResult } from '../Tool.js';
+export declare class GitTool extends Tool {
+    readonly name = "git";
+    readonly description = "Git \u7248\u672C\u63A7\u5236\u64CD\u4F5C\uFF1A\u67E5\u770B\u72B6\u6001\u3001\u6682\u5B58\u6587\u4EF6\u3001\u63D0\u4EA4\u3001\u5207\u6362\u5206\u652F\u3001\u63A8\u9001\u62C9\u53D6\uFF0C\u4EE5\u53CA\u521B\u5EFA/\u5408\u5E76 MR/PR\uFF08GitHub/GitLab/Gitea\uFF09\u3002\u6CE8\u610F\uFF1A\u4E0D\u652F\u6301 force push \u548C\u5F3A\u5236\u5220\u9664\u8FDC\u7AEF\u5206\u652F\u7B49\u5371\u9669\u64CD\u4F5C\u3002";
+    readonly parameters: z.ZodObject<{
+        action: z.ZodEnum<{
+            push: "push";
+            fetch: "fetch";
+            status: "status";
+            log: "log";
+            commit: "commit";
+            pull: "pull";
+            branch_create: "branch_create";
+            branch_switch: "branch_switch";
+            merge_mr: "merge_mr";
+            create_mr: "create_mr";
+            stage: "stage";
+            diff: "diff";
+            unstage: "unstage";
+            branch_list: "branch_list";
+            list_mrs: "list_mrs";
+        }>;
+        message: z.ZodOptional<z.ZodString>;
+        amend: z.ZodOptional<z.ZodBoolean>;
+        files: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        branch: z.ZodOptional<z.ZodString>;
+        from: z.ZodOptional<z.ZodString>;
+        remote: z.ZodOptional<z.ZodString>;
+        set_upstream: z.ZodOptional<z.ZodBoolean>;
+        staged: z.ZodOptional<z.ZodBoolean>;
+        file: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        mr_title: z.ZodOptional<z.ZodString>;
+        mr_description: z.ZodOptional<z.ZodString>;
+        mr_target: z.ZodOptional<z.ZodString>;
+        mr_id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        mr_draft: z.ZodOptional<z.ZodBoolean>;
+        mr_state: z.ZodOptional<z.ZodEnum<{
+            all: "all";
+            open: "open";
+            merged: "merged";
+            closed: "closed";
+        }>>;
+    }, z.core.$strip>;
+    /**
+     * Resolve git author identity from ToolContext.
+     *
+     * Priority: context.gitIdentity (injected by BaseAgentRuntime from AgentRole.gitIdentity).
+     * Returns undefined if no identity is configured for this agent/role.
+     */
+    private resolveGitIdentity;
+    /**
+     * Run pre-commit gate checks. Returns { passed, diagnostics }.
+     *
+     * Gate config from git.pre_commit_gate:
+     *   - enabled: master switch
+     *   - type_check: run `npx tsc --noEmit` before commit
+     *   - command: custom shell command to run before commit
+     */
+    private runPreCommitGate;
+    /**
+     * Emit git:activity event for monitoring/visualization.
+     * Fires after each git action completes (commit, push, pull, branch, merge, create_mr).
+     */
+    private emitGitActivity;
+    execute(args: unknown, context?: ToolContext): Promise<ToolResult>;
+    private buildPlatformApi;
+}
+//# sourceMappingURL=GitTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GitTool.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/GitTool.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;AA0DrE,qBAAa,OAAQ,SAAQ,IAAI;IAC/B,QAAQ,CAAC,IAAI,SAAS;IACtB,QAAQ,CAAC,WAAW,wZAA4G;IAChI,QAAQ,CAAC,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAAiB;IAEpC;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAQ1B;;;;;;;OAOG;YACW,gBAAgB;IAmD9B;;;OAGG;IACH,OAAO,CAAC,eAAe;IAkCjB,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;YAoK1D,gBAAgB;CAiB/B"}