@lingxiao-office/sdk 1.0.0

package/dist/tools/implementations/office/ConditionalFormattingBuilder.js

@@ -0,0 +1,259 @@
+/**
+ * ConditionalFormattingBuilder.ts
+ *
+ * Excel Conditional Formatting implementation for XLSX files.
+ * Supports Data Bars, Color Scales, Icon Sets, and formula-based rules.
+ *
+ * Based on OOXML SpreadsheetML specification.
+ */
+/**
+ * Generate CFVO (Conditional Format Value Object) XML
+ */
+function cfvoXml(cfvo) {
+    const valAttr = cfvo.val !== undefined ? ` val="${cfvo.val}"` : '';
+    return `<cfvo type="${cfvo.type}"${valAttr}/>`;
+}
+/**
+ * Generate color XML element
+ */
+function colorXml(rgb) {
+    // Ensure 8-character RGB format (AARRGGBB)
+    const normalized = rgb.length === 6 ? `FF${rgb}` : rgb;
+    return `<color rgb="${normalized}"/>`;
+}
+/**
+ * Generate Data Bar conditional formatting rule XML
+ */
+export function dataBarRuleXml(rule, priority) {
+    const showValueAttr = rule.showValue === false ? ' showValue="0"' : '';
+    return `<cfRule type="dataBar" priority="${priority}">
+  <dataBar${showValueAttr}>
+    ${cfvoXml(rule.minValue)}
+    ${cfvoXml(rule.maxValue)}
+    ${colorXml(rule.color)}
+  </dataBar>
+</cfRule>`;
+}
+/**
+ * Generate Color Scale conditional formatting rule XML
+ */
+export function colorScaleRuleXml(rule, priority) {
+    const isThreeColor = rule.midValue && rule.midColor;
+    if (isThreeColor) {
+        return `<cfRule type="colorScale" priority="${priority}">
+  <colorScale>
+    ${cfvoXml(rule.minValue)}
+    ${cfvoXml(rule.midValue)}
+    ${cfvoXml(rule.maxValue)}
+    ${colorXml(rule.minColor)}
+    ${colorXml(rule.midColor)}
+    ${colorXml(rule.maxColor)}
+  </colorScale>
+</cfRule>`;
+    }
+    else {
+        return `<cfRule type="colorScale" priority="${priority}">
+  <colorScale>
+    ${cfvoXml(rule.minValue)}
+    ${cfvoXml(rule.maxValue)}
+    ${colorXml(rule.minColor)}
+    ${colorXml(rule.maxColor)}
+  </colorScale>
+</cfRule>`;
+    }
+}
+/**
+ * Generate Icon Set conditional formatting rule XML
+ */
+export function iconSetRuleXml(rule, priority) {
+    const reverseAttr = rule.reverse ? ' reverse="1"' : '';
+    const showValueAttr = rule.showValue === false ? ' showValue="0"' : '';
+    const cfvos = rule.values.map(cfvoXml).join('\n    ');
+    return `<cfRule type="iconSet" priority="${priority}">
+  <iconSet iconSet="${rule.iconSet}"${reverseAttr}${showValueAttr}>
+    ${cfvos}
+  </iconSet>
+</cfRule>`;
+}
+/**
+ * Generate Cell Is conditional formatting rule XML
+ */
+export function cellIsRuleXml(rule, priority) {
+    const formulas = Array.isArray(rule.formula) ? rule.formula : [rule.formula];
+    const formulaXml = formulas.map(f => `<formula>${f}</formula>`).join('\n    ');
+    return `<cfRule type="cellIs" dxfId="${rule.dxfId}" priority="${priority}" operator="${rule.operator}">
+  ${formulaXml}
+</cfRule>`;
+}
+/**
+ * Generate Expression conditional formatting rule XML
+ */
+export function expressionRuleXml(rule, priority) {
+    return `<cfRule type="expression" dxfId="${rule.dxfId}" priority="${priority}">
+  <formula>${rule.formula}</formula>
+</cfRule>`;
+}
+/**
+ * Generate Top 10 conditional formatting rule XML
+ */
+export function top10RuleXml(rule, priority) {
+    const bottomAttr = rule.bottom ? ' bottom="1"' : '';
+    const percentAttr = rule.percent ? ' percent="1"' : '';
+    return `<cfRule type="top10" dxfId="${rule.dxfId}" priority="${priority}" rank="${rule.rank}"${bottomAttr}${percentAttr}/>`;
+}
+/**
+ * Generate conditional formatting rule XML based on type
+ */
+export function conditionalFormattingRuleXml(rule, priority) {
+    switch (rule.type) {
+        case 'dataBar':
+            return dataBarRuleXml(rule, priority);
+        case 'colorScale':
+            return colorScaleRuleXml(rule, priority);
+        case 'iconSet':
+            return iconSetRuleXml(rule, priority);
+        case 'cellIs':
+            return cellIsRuleXml(rule, priority);
+        case 'expression':
+            return expressionRuleXml(rule, priority);
+        case 'top10':
+            return top10RuleXml(rule, priority);
+    }
+}
+/**
+ * Generate complete conditional formatting XML for a range
+ */
+export function conditionalFormattingXml(cf, startPriority = 1) {
+    const rulesXml = cf.rules
+        .map((rule, index) => conditionalFormattingRuleXml(rule, startPriority + index))
+        .join('\n  ');
+    return `<conditionalFormatting sqref="${cf.sqref}">
+  ${rulesXml}
+</conditionalFormatting>`;
+}
+/**
+ * Generate multiple conditional formatting blocks
+ */
+export function multipleConditionalFormattingXml(formats) {
+    let priority = 1;
+    const blocks = [];
+    for (const cf of formats) {
+        blocks.push(conditionalFormattingXml(cf, priority));
+        priority += cf.rules.length;
+    }
+    return blocks.join('\n');
+}
+/**
+ * Helper: Create a data bar rule with default settings
+ */
+export function createDataBarRule(color, showValue = true) {
+    return {
+        type: 'dataBar',
+        minValue: { type: 'min' },
+        maxValue: { type: 'max' },
+        color,
+        showValue,
+    };
+}
+/**
+ * Helper: Create a two-color scale rule
+ */
+export function createTwoColorScale(minColor, maxColor) {
+    return {
+        type: 'colorScale',
+        minValue: { type: 'min' },
+        minColor,
+        maxValue: { type: 'max' },
+        maxColor,
+    };
+}
+/**
+ * Helper: Create a three-color scale rule
+ */
+export function createThreeColorScale(minColor, midColor, maxColor) {
+    return {
+        type: 'colorScale',
+        minValue: { type: 'min' },
+        minColor,
+        midValue: { type: 'percentile', val: 50 },
+        midColor,
+        maxValue: { type: 'max' },
+        maxColor,
+    };
+}
+/**
+ * Helper: Create a 3-icon set rule with percentile thresholds
+ */
+export function createIconSetRule(iconSet, reverse = false, showValue = true) {
+    // Default thresholds for 3-icon sets
+    const values = [
+        { type: 'percentile', val: 0 },
+        { type: 'percentile', val: 33 },
+        { type: 'percentile', val: 67 },
+    ];
+    return {
+        type: 'iconSet',
+        iconSet,
+        values,
+        reverse,
+        showValue,
+    };
+}
+/**
+ * Helper: Create a 5-icon set rule with percentile thresholds
+ */
+export function createFiveIconSetRule(iconSet, reverse = false, showValue = true) {
+    const values = [
+        { type: 'percentile', val: 0 },
+        { type: 'percentile', val: 20 },
+        { type: 'percentile', val: 40 },
+        { type: 'percentile', val: 60 },
+        { type: 'percentile', val: 80 },
+    ];
+    return {
+        type: 'iconSet',
+        iconSet,
+        values,
+        reverse,
+        showValue,
+    };
+}
+/**
+ * Predefined color schemes
+ */
+export const ColorSchemes = {
+    // Red-Yellow-Green (traffic light)
+    RedYellowGreen: {
+        min: 'F8696B',
+        mid: 'FFEB84',
+        max: '63BE7B',
+    },
+    // Blue-White-Red (heat map)
+    BlueWhiteRed: {
+        min: '5A8AC6',
+        mid: 'FFFFFF',
+        max: 'F8696B',
+    },
+    // Green-White-Red
+    GreenWhiteRed: {
+        min: '63BE7B',
+        mid: 'FFFFFF',
+        max: 'F8696B',
+    },
+    // Blue gradient
+    BlueGradient: {
+        min: 'FFFFFF',
+        max: '5A8AC6',
+    },
+    // Green gradient
+    GreenGradient: {
+        min: 'FFFFFF',
+        max: '63BE7B',
+    },
+    // Red gradient
+    RedGradient: {
+        min: 'FFFFFF',
+        max: 'F8696B',
+    },
+};
+//# sourceMappingURL=ConditionalFormattingBuilder.js.map

package/dist/tools/implementations/office/ConditionalFormattingBuilder.js.map

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

package/dist/tools/implementations/office/ExcelWorkbook.d.ts

@@ -0,0 +1,21 @@
+import type { Cell, CellValue, Workbook, Worksheet } from 'exceljs';
+type ExcelJsModule = typeof import('exceljs');
+export declare const EXCEL_MAX_PARSE_BYTES: number;
+export interface WorkbookLoadLimits {
+    maxBytes?: number;
+}
+export declare function loadExcelJs(): Promise<ExcelJsModule>;
+export declare function createWorkbook(): Promise<Workbook>;
+export declare function readWorkbook(filePath: string, limits?: WorkbookLoadLimits): Promise<Workbook>;
+export declare function enforceWorkbookSize(filePath: string, maxBytes: number): void;
+export declare function workbookSheetNames(workbook: Workbook): string[];
+export declare function getWorksheetOrThrow(workbook: Workbook, name?: string): Worksheet;
+export declare function cellValueToPrimitive(value: CellValue): string | number | boolean | null;
+export declare function cellDisplayValue(cell: Cell): string;
+export declare function worksheetToRows(worksheet: Worksheet, maxRows?: number): unknown[][];
+export declare function worksheetToCsv(worksheet: Worksheet, maxRows?: number): string;
+export declare function csvEscape(value: unknown): string;
+export declare function columnLetterToNumber(column: string): number;
+export declare function setCellValue(cell: Cell, value: unknown): void;
+export {};
+//# sourceMappingURL=ExcelWorkbook.d.ts.map

package/dist/tools/implementations/office/ExcelWorkbook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExcelWorkbook.d.ts","sourceRoot":"","sources":["../../../../src/tools/implementations/office/ExcelWorkbook.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpE,KAAK,aAAa,GAAG,cAAc,SAAS,CAAC,CAAC;AAG9C,eAAO,MAAM,qBAAqB,QAA8B,CAAC;AAEjE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,aAAa,CAAC,CAG1D;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,QAAQ,CAAC,CAGxD;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,kBAAuB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAKvG;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAK5E;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,EAAE,CAE/D;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAOhF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAcvF;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAGnD;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,SAA0B,GAAG,OAAO,EAAE,EAAE,CAapG;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,SAA0B,GAAG,MAAM,CAI9F;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAIhD;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAU3D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAY7D"}

package/dist/tools/implementations/office/ExcelWorkbook.js

@@ -0,0 +1,114 @@
+import { statSync } from 'fs';
+import { basename } from 'path';
+import { FILE_PARSER } from '../../../config/defaults.js';
+export const EXCEL_MAX_PARSE_BYTES = FILE_PARSER.MAX_PARSE_BYTES;
+export async function loadExcelJs() {
+    const mod = await import('exceljs');
+    return mod.default ?? mod;
+}
+export async function createWorkbook() {
+    const ExcelJS = await loadExcelJs();
+    return new ExcelJS.Workbook();
+}
+export async function readWorkbook(filePath, limits = {}) {
+    enforceWorkbookSize(filePath, limits.maxBytes ?? EXCEL_MAX_PARSE_BYTES);
+    const workbook = await createWorkbook();
+    await workbook.xlsx.readFile(filePath);
+    return workbook;
+}
+export function enforceWorkbookSize(filePath, maxBytes) {
+    const size = statSync(filePath).size;
+    if (size > maxBytes) {
+        throw new Error(`XLSX 文件过大，已拒绝解析: ${basename(filePath)} (${(size / 1024 / 1024).toFixed(1)} MB，限制 ${(maxBytes / 1024 / 1024).toFixed(0)} MB)`);
+    }
+}
+export function workbookSheetNames(workbook) {
+    return workbook.worksheets.map((worksheet) => worksheet.name);
+}
+export function getWorksheetOrThrow(workbook, name) {
+    const worksheet = name ? workbook.getWorksheet(name) : workbook.worksheets[0];
+    if (!worksheet) {
+        const names = workbookSheetNames(workbook);
+        throw new Error(`Sheet "${name || '(first)'}" 不存在。可用 sheets: ${names.join(', ')}`);
+    }
+    return worksheet;
+}
+export function cellValueToPrimitive(value) {
+    if (value == null)
+        return null;
+    if (value instanceof Date)
+        return value.toISOString();
+    if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean')
+        return value;
+    if (typeof value === 'object') {
+        if ('formula' in value)
+            return value.result == null ? `=${value.formula}` : cellValueToPrimitive(value.result);
+        if ('richText' in value && Array.isArray(value.richText)) {
+            return value.richText.map((part) => String(part.text ?? '')).join('');
+        }
+        if ('text' in value)
+            return String(value.text ?? '');
+        if ('hyperlink' in value && 'text' in value)
+            return String(value.text ?? value.hyperlink ?? '');
+        if ('error' in value)
+            return String(value.error ?? '');
+    }
+    return String(value);
+}
+export function cellDisplayValue(cell) {
+    const primitive = cellValueToPrimitive(cell.value);
+    return primitive == null ? '' : String(primitive);
+}
+export function worksheetToRows(worksheet, maxRows = Number.MAX_SAFE_INTEGER) {
+    const rows = [];
+    const rowLimit = Math.min(worksheet.rowCount || 0, maxRows);
+    for (let rowNumber = 1; rowNumber <= rowLimit; rowNumber++) {
+        const row = worksheet.getRow(rowNumber);
+        const rowValues = [];
+        for (let colNumber = 1; colNumber <= (worksheet.columnCount || row.cellCount || 0); colNumber++) {
+            rowValues.push(cellValueToPrimitive(row.getCell(colNumber).value));
+        }
+        while (rowValues.length > 0 && rowValues[rowValues.length - 1] == null)
+            rowValues.pop();
+        rows.push(rowValues);
+    }
+    return rows;
+}
+export function worksheetToCsv(worksheet, maxRows = Number.MAX_SAFE_INTEGER) {
+    return worksheetToRows(worksheet, maxRows)
+        .map((row) => row.map(csvEscape).join(','))
+        .join('\n');
+}
+export function csvEscape(value) {
+    if (value == null)
+        return '';
+    const text = String(value);
+    return /[",\r\n]/.test(text) ? `"${text.replace(/"/g, '""')}"` : text;
+}
+export function columnLetterToNumber(column) {
+    const normalized = column.trim().toUpperCase();
+    let value = 0;
+    for (const char of normalized) {
+        const code = char.charCodeAt(0);
+        if (code < 65 || code > 90)
+            throw new Error(`无效列标识: ${column}`);
+        value = value * 26 + (code - 64);
+    }
+    if (value <= 0)
+        throw new Error(`无效列标识: ${column}`);
+    return value;
+}
+export function setCellValue(cell, value) {
+    if (typeof value === 'string' && value.startsWith('=')) {
+        cell.value = { formula: value.slice(1), result: 0 };
+        return;
+    }
+    if (typeof value === 'number' || typeof value === 'boolean' || value == null) {
+        cell.value = value;
+        return;
+    }
+    const text = String(value);
+    const num = Number(text);
+    cell.value = text.trim() !== '' && Number.isFinite(num) ? num : text;
+}
+//# sourceMappingURL=ExcelWorkbook.js.map

package/dist/tools/implementations/office/ExcelWorkbook.js.map

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

package/dist/tools/implementations/office/OfficeAuditLog.d.ts

@@ -0,0 +1,28 @@
+import type { ToolContext, ToolResult } from '../../Tool.js';
+export interface OfficeAuditRecord {
+    schema_version: 'office_audit.v1';
+    timestamp: string;
+    session_id: string | null;
+    agent_id: string | null;
+    agent_name: string | null;
+    tool_call_id: string | null;
+    tool: string;
+    success: boolean;
+    args_summary: unknown;
+    input_path: string | null;
+    output_path: string | null;
+    output_hash_algorithm: 'sha256';
+    output_hash: string | null;
+    warnings: string[];
+}
+export interface OfficeAuditInput {
+    tool: string;
+    args: unknown;
+    result: ToolResult;
+    context?: ToolContext;
+}
+export declare function resolveOfficeAuditLogPath(context?: ToolContext): string;
+export declare function summarizeOfficeArgs(args: unknown): unknown;
+export declare function writeOfficeAuditRecord(input: OfficeAuditInput): Promise<OfficeAuditRecord>;
+export declare function auditOfficeToolExecution(input: OfficeAuditInput): Promise<void>;
+//# sourceMappingURL=OfficeAuditLog.d.ts.map

package/dist/tools/implementations/office/OfficeAuditLog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OfficeAuditLog.d.ts","sourceRoot":"","sources":["../../../../src/tools/implementations/office/OfficeAuditLog.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAW7D,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,iBAAiB,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,qBAAqB,EAAE,QAAQ,CAAC;IAChC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,wBAAgB,yBAAyB,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,CAevE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAE1D;AAED,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA2BhG;AAED,wBAAsB,wBAAwB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAMrF"}

package/dist/tools/implementations/office/OfficeAuditLog.js

@@ -0,0 +1,221 @@
+import { createHash } from 'crypto';
+import { createReadStream } from 'fs';
+import { appendFile, mkdir, stat } from 'fs/promises';
+import { tmpdir } from 'os';
+import { dirname, isAbsolute, join, resolve } from 'path';
+import { getSessionScopePaths } from '../utils.js';
+const MAX_STRING_LENGTH = 160;
+const MAX_ARRAY_ITEMS = 8;
+const MAX_OBJECT_KEYS = 24;
+const MAX_DEPTH = 4;
+const REDACT_KEY_RE = /(password|passwd|secret|token|api[_-]?key|authorization|cookie|credential)/i;
+const PATH_KEY_RE = /(^|_)(path|file|filename)$/i;
+export function resolveOfficeAuditLogPath(context) {
+    if (typeof context?.officeAuditLogPath === 'string' && context.officeAuditLogPath.trim()) {
+        return resolve(context.officeAuditLogPath);
+    }
+    const scope = getSessionScopePaths(typeof context?.workspace === 'string' ? context.workspace : undefined, typeof context?.sessionId === 'string' ? context.sessionId : undefined);
+    if (scope.sessionDir) {
+        return join(scope.sessionDir, 'logs', 'office-audit.jsonl');
+    }
+    return join(tmpdir(), 'office-audit', 'office-audit.jsonl');
+}
+export function summarizeOfficeArgs(args) {
+    return summarizeValue(args, 0);
+}
+export async function writeOfficeAuditRecord(input) {
+    const warnings = [];
+    const inputPath = inferInputPath(input.tool, input.args, input.context);
+    const outputPath = inferOutputPath(input.tool, input.args, input.result, input.context);
+    const outputHash = outputPath ? await sha256File(outputPath, warnings) : null;
+    const record = {
+        schema_version: 'office_audit.v1',
+        timestamp: new Date().toISOString(),
+        session_id: stringOrNull(input.context?.sessionId),
+        agent_id: stringOrNull(input.context?.agentId),
+        agent_name: stringOrNull(input.context?.agentName),
+        tool_call_id: stringOrNull(input.context?.toolCallId),
+        tool: input.tool,
+        success: input.result.success,
+        args_summary: summarizeOfficeArgs(input.args),
+        input_path: inputPath,
+        output_path: outputPath,
+        output_hash_algorithm: 'sha256',
+        output_hash: outputHash,
+        warnings,
+    };
+    const logPath = resolveOfficeAuditLogPath(input.context);
+    await mkdir(dirname(logPath), { recursive: true });
+    await appendFile(logPath, `${JSON.stringify(record)}\n`, 'utf-8');
+    return record;
+}
+export async function auditOfficeToolExecution(input) {
+    try {
+        await writeOfficeAuditRecord(input);
+    }
+    catch {
+        // Audit failures must never change the tool's user-visible result.
+    }
+}
+function summarizeValue(value, depth) {
+    if (value === null || value === undefined)
+        return value;
+    if (typeof value === 'string')
+        return truncateString(value);
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return value;
+    if (typeof value === 'bigint')
+        return value.toString();
+    if (value instanceof Date)
+        return value.toISOString();
+    if (Buffer.isBuffer(value))
+        return `[buffer:${value.length}]`;
+    if (depth >= MAX_DEPTH) {
+        if (Array.isArray(value))
+            return `[array:${value.length}]`;
+        if (typeof value === 'object')
+            return '[object]';
+        return String(value);
+    }
+    if (Array.isArray(value)) {
+        const summary = value.slice(0, MAX_ARRAY_ITEMS).map((item) => summarizeValue(item, depth + 1));
+        if (value.length > MAX_ARRAY_ITEMS)
+            summary.push(`[truncated:${value.length - MAX_ARRAY_ITEMS}]`);
+        return summary;
+    }
+    if (typeof value === 'object') {
+        const out = {};
+        const entries = Object.entries(value).slice(0, MAX_OBJECT_KEYS);
+        for (const [key, child] of entries) {
+            if (REDACT_KEY_RE.test(key) && !PATH_KEY_RE.test(key)) {
+                out[key] = '[redacted]';
+            }
+            else {
+                out[key] = summarizeValue(child, depth + 1);
+            }
+        }
+        const totalKeys = Object.keys(value).length;
+        if (totalKeys > MAX_OBJECT_KEYS)
+            out.__truncated_keys = totalKeys - MAX_OBJECT_KEYS;
+        return out;
+    }
+    return String(value);
+}
+function truncateString(value) {
+    if (value.length <= MAX_STRING_LENGTH)
+        return value;
+    return `${value.slice(0, MAX_STRING_LENGTH)}...[truncated:${value.length - MAX_STRING_LENGTH}]`;
+}
+function stringOrNull(value) {
+    return typeof value === 'string' && value.length > 0 ? value : null;
+}
+function toolNameHasPrefix(tool, prefix) {
+    return tool.slice(0, prefix.length) === prefix;
+}
+function isEditOfficeTool(tool) {
+    return toolNameHasPrefix(tool, 'edit_');
+}
+function isGenerateOfficeTool(tool) {
+    return toolNameHasPrefix(tool, 'generate_');
+}
+function inferInputPath(tool, args, context) {
+    const argObj = objectOrNull(args);
+    const explicit = firstString(argObj, ['input_path', 'inputPath', 'source_path', 'sourcePath', 'file_path', 'filePath']);
+    if (explicit)
+        return resolveAuditPath(explicit, context);
+    const path = firstString(argObj, ['path']);
+    if (!path)
+        return null;
+    if (isEditOfficeTool(tool) || tool === 'parse_file' || tool === 'office_ops') {
+        return resolveAuditPath(path, context);
+    }
+    return null;
+}
+function inferOutputPath(tool, args, result, context) {
+    const resultPath = findPathInResult(result.data);
+    if (resultPath)
+        return resolveAuditPath(resultPath, context);
+    const argObj = objectOrNull(args);
+    const explicit = firstString(argObj, ['output_path', 'outputPath', 'out_path', 'outPath']);
+    if (explicit)
+        return resolveAuditPath(explicit, context);
+    const path = firstString(argObj, ['path']);
+    if (!path)
+        return null;
+    if (isGenerateOfficeTool(tool))
+        return resolveAuditPath(path, context);
+    if (isEditOfficeTool(tool) && booleanValue(argObj?.overwrite))
+        return resolveAuditPath(path, context);
+    return null;
+}
+function objectOrNull(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : null;
+}
+function firstString(obj, keys) {
+    if (!obj)
+        return null;
+    for (const key of keys) {
+        const value = obj[key];
+        if (typeof value === 'string' && value.trim())
+            return value;
+    }
+    return null;
+}
+function booleanValue(value) {
+    return value === true || value === 'true';
+}
+function resolveAuditPath(filePath, context) {
+    if (isAbsolute(filePath))
+        return resolve(filePath);
+    return resolve(typeof context?.workspace === 'string' ? context.workspace : process.cwd(), filePath);
+}
+function findPathInResult(value, depth = 0) {
+    if (!value || depth > 4)
+        return null;
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            const found = findPathInResult(item, depth + 1);
+            if (found)
+                return found;
+        }
+        return null;
+    }
+    if (typeof value !== 'object')
+        return null;
+    const obj = value;
+    for (const key of ['path', 'output_path', 'outputPath', 'filePath', 'artifact_path']) {
+        const candidate = obj[key];
+        if (typeof candidate === 'string' && candidate.trim())
+            return candidate;
+    }
+    for (const child of Object.values(obj)) {
+        const found = findPathInResult(child, depth + 1);
+        if (found)
+            return found;
+    }
+    return null;
+}
+async function sha256File(filePath, warnings) {
+    try {
+        const info = await stat(filePath);
+        if (!info.isFile()) {
+            warnings.push(`output_path is not a file: ${filePath}`);
+            return null;
+        }
+    }
+    catch { /* swallowed: unhandled error */
+        warnings.push(`output_path does not exist: ${filePath}`);
+        return null;
+    }
+    return new Promise((resolveHash) => {
+        const hash = createHash('sha256');
+        const stream = createReadStream(filePath);
+        stream.on('data', (chunk) => hash.update(chunk));
+        stream.on('error', (error) => {
+            warnings.push(`failed to hash output_path: ${error instanceof Error ? error.message : String(error)}`);
+            resolveHash(null);
+        });
+        stream.on('end', () => resolveHash(hash.digest('hex')));
+    });
+}
+//# sourceMappingURL=OfficeAuditLog.js.map