@usejunior/docx-mcp 0.0.1 → 0.1.1

package/dist/tools/apply_plan.js

@@ -0,0 +1,346 @@
+import fs from 'node:fs/promises';
+import { findUniqueSubstringMatch } from '@usejunior/docx-core';
+import { errorMessage } from '../error_utils.js';
+import { err, ok } from './types.js';
+import { enforceReadPathPolicy } from './path_policy.js';
+import { replaceText, stripSearchTags } from './replace_text.js';
+import { insertParagraph } from './insert_paragraph.js';
+import { resolveSessionForTool } from './session_resolution.js';
+// ---------------------------------------------------------------------------
+// Known fields per operation — only these are extracted during normalization.
+// ---------------------------------------------------------------------------
+const REPLACE_TEXT_FIELDS = new Set([
+    'target_paragraph_id',
+    'old_string',
+    'new_string',
+    'instruction',
+    'normalize_first',
+]);
+const INSERT_PARAGRAPH_FIELDS = new Set([
+    'positional_anchor_node_id',
+    'new_string',
+    'instruction',
+    'position',
+    'style_source_id',
+]);
+const SUPPORTED_OPERATIONS = new Set(['replace_text', 'insert_paragraph']);
+const LEGACY_ALIASES = new Set(['smart_edit', 'smart_insert']);
+const MAX_PLAN_FILE_BYTES = 1 * 1024 * 1024; // 1 MB
+// ---------------------------------------------------------------------------
+// Normalization: accept both raw and merge_plans-envelope formats
+// ---------------------------------------------------------------------------
+function normalizeSteps(rawSteps) {
+    const steps = [];
+    const errors = [];
+    for (let i = 0; i < rawSteps.length; i++) {
+        const raw = rawSteps[i];
+        if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+            errors.push(`Step ${i}: not a valid object.`);
+            continue;
+        }
+        const rawObj = raw;
+        // Reject __proto__ pollution
+        if (Object.prototype.hasOwnProperty.call(rawObj, '__proto__')) {
+            errors.push(`Step ${i}: __proto__ key is not allowed.`);
+            continue;
+        }
+        // Detect envelope format (merge_plans output has `arguments` sub-object)
+        const hasEnvelope = typeof rawObj.arguments === 'object' && rawObj.arguments !== null && !Array.isArray(rawObj.arguments);
+        const argsSource = hasEnvelope ? rawObj.arguments : rawObj;
+        // Reject __proto__ in arguments envelope too
+        if (hasEnvelope && Object.prototype.hasOwnProperty.call(argsSource, '__proto__')) {
+            errors.push(`Step ${i}: __proto__ key is not allowed in arguments.`);
+            continue;
+        }
+        // Extract operation — could be top-level or in arguments
+        const operationRaw = String(rawObj.operation ?? rawObj.op ?? '').trim().toLowerCase();
+        if (!operationRaw) {
+            errors.push(`Step ${i}: missing operation field.`);
+            continue;
+        }
+        if (LEGACY_ALIASES.has(operationRaw)) {
+            errors.push(`Step ${i}: legacy operation '${operationRaw}' is not supported. Use 'replace_text' or 'insert_paragraph'.`);
+            continue;
+        }
+        if (!SUPPORTED_OPERATIONS.has(operationRaw)) {
+            errors.push(`Step ${i}: unsupported operation '${operationRaw}'.`);
+            continue;
+        }
+        const operation = operationRaw;
+        // Extract step_id
+        const stepId = typeof rawObj.step_id === 'string' ? rawObj.step_id.trim() : '';
+        if (!stepId) {
+            errors.push(`Step ${i}: missing or empty step_id.`);
+            continue;
+        }
+        // Extract only known fields into a fresh object (prevents __proto__ pollution)
+        const knownFields = operation === 'replace_text' ? REPLACE_TEXT_FIELDS : INSERT_PARAGRAPH_FIELDS;
+        const fields = {};
+        for (const key of knownFields) {
+            if (key in argsSource) {
+                fields[key] = argsSource[key];
+            }
+        }
+        steps.push({ step_id: stepId, operation, fields });
+    }
+    return { steps, errors };
+}
+// ---------------------------------------------------------------------------
+// Validation phase: check ALL steps before applying
+// ---------------------------------------------------------------------------
+function validateSteps(steps, doc) {
+    const results = [];
+    for (let i = 0; i < steps.length; i++) {
+        const step = steps[i];
+        const validation = {
+            step_id: step.step_id,
+            step_index: i,
+            valid: true,
+            errors: [],
+            warnings: [],
+        };
+        if (step.operation === 'replace_text') {
+            const targetId = step.fields.target_paragraph_id;
+            if (typeof targetId !== 'string' || !targetId.trim()) {
+                validation.errors.push('Missing target_paragraph_id.');
+            }
+            else {
+                const text = doc.getParagraphTextById(targetId);
+                if (text === null) {
+                    validation.errors.push(`target_paragraph_id '${targetId}' not found in document.`);
+                }
+                else {
+                    // Check old_string exists and matches in the paragraph.
+                    // Apply the same tag-stripping that replaceText does before matching.
+                    const oldStr = step.fields.old_string;
+                    if (typeof oldStr !== 'string') {
+                        validation.errors.push('Missing old_string.');
+                    }
+                    else {
+                        const stripped = stripSearchTags(oldStr);
+                        const matchResult = findUniqueSubstringMatch(text, stripped);
+                        if (matchResult.status === 'not_found') {
+                            validation.errors.push(`old_string not found in paragraph '${targetId}'. `
+                                + `Paragraph text (first 120 chars): "${text.slice(0, 120)}"`);
+                        }
+                        else if (matchResult.status === 'multiple') {
+                            validation.errors.push(`old_string matched ${matchResult.matchCount} times in paragraph '${targetId}' `
+                                + `(${matchResult.mode} matching). Must be unique.`);
+                        }
+                    }
+                }
+            }
+            if (typeof step.fields.new_string !== 'string') {
+                validation.errors.push('Missing new_string.');
+            }
+            if (typeof step.fields.instruction !== 'string') {
+                validation.errors.push('Missing instruction.');
+            }
+        }
+        else if (step.operation === 'insert_paragraph') {
+            const anchorId = step.fields.positional_anchor_node_id;
+            if (typeof anchorId !== 'string' || !anchorId.trim()) {
+                validation.errors.push('Missing positional_anchor_node_id.');
+            }
+            else {
+                const text = doc.getParagraphTextById(anchorId);
+                if (text === null) {
+                    validation.errors.push(`positional_anchor_node_id '${anchorId}' not found in document.`);
+                }
+            }
+            if (typeof step.fields.new_string !== 'string') {
+                validation.errors.push('Missing new_string.');
+            }
+            if (typeof step.fields.instruction !== 'string') {
+                validation.errors.push('Missing instruction.');
+            }
+            // Validate style_source_id — warning only, not error
+            const styleSourceId = step.fields.style_source_id;
+            if (typeof styleSourceId === 'string' && styleSourceId.trim()) {
+                const text = doc.getParagraphTextById(styleSourceId);
+                if (text === null) {
+                    validation.warnings.push(`style_source_id '${styleSourceId}' not found; will fall back to anchor formatting.`);
+                }
+            }
+            const pos = step.fields.position;
+            if (pos !== undefined && pos !== 'BEFORE' && pos !== 'AFTER') {
+                validation.errors.push(`Invalid position '${String(pos)}'. Must be 'BEFORE' or 'AFTER'.`);
+            }
+        }
+        if (validation.errors.length > 0)
+            validation.valid = false;
+        results.push(validation);
+    }
+    return results;
+}
+// ---------------------------------------------------------------------------
+// Load steps from file path
+// ---------------------------------------------------------------------------
+async function loadStepsFromFile(filePath) {
+    if (!filePath.endsWith('.json')) {
+        return { error: err('INVALID_PLAN_FILE', `plan_file_path must have a .json extension: ${filePath}`) };
+    }
+    const pathCheck = await enforceReadPathPolicy(filePath);
+    if (!pathCheck.ok) {
+        return { error: pathCheck.response };
+    }
+    let stat;
+    try {
+        stat = await fs.stat(pathCheck.resolvedPath);
+    }
+    catch {
+        return { error: err('PLAN_FILE_NOT_FOUND', `Plan file not found: ${filePath}`) };
+    }
+    if (stat.size > MAX_PLAN_FILE_BYTES) {
+        return { error: err('PLAN_FILE_TOO_LARGE', `Plan file exceeds 1MB limit (${stat.size} bytes): ${filePath}`) };
+    }
+    let content;
+    try {
+        content = await fs.readFile(pathCheck.resolvedPath, 'utf-8');
+    }
+    catch (e) {
+        return { error: err('PLAN_FILE_READ_ERROR', `Failed to read plan file: ${errorMessage(e)}`) };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch (e) {
+        return { error: err('PLAN_FILE_PARSE_ERROR', `Failed to parse plan file as JSON: ${errorMessage(e)}`) };
+    }
+    if (!Array.isArray(parsed)) {
+        return { error: err('PLAN_FILE_FORMAT_ERROR', 'Plan file must contain a JSON array of steps.') };
+    }
+    return { steps: parsed };
+}
+// ---------------------------------------------------------------------------
+// Apply phase: execute steps sequentially, stop on first error
+// ---------------------------------------------------------------------------
+async function executeSteps(manager, sessionId, steps) {
+    const completedStepIds = [];
+    const stepResults = [];
+    for (let i = 0; i < steps.length; i++) {
+        const step = steps[i];
+        let result;
+        if (step.operation === 'replace_text') {
+            result = await replaceText(manager, {
+                session_id: sessionId,
+                target_paragraph_id: step.fields.target_paragraph_id,
+                old_string: step.fields.old_string,
+                new_string: step.fields.new_string,
+                instruction: step.fields.instruction,
+                normalize_first: step.fields.normalize_first,
+            });
+        }
+        else {
+            result = await insertParagraph(manager, {
+                session_id: sessionId,
+                positional_anchor_node_id: step.fields.positional_anchor_node_id,
+                new_string: step.fields.new_string,
+                instruction: step.fields.instruction,
+                position: step.fields.position,
+                style_source_id: step.fields.style_source_id,
+            });
+        }
+        if (!result.success) {
+            stepResults.push({ step_id: step.step_id, success: false, result: result });
+            return {
+                completed_step_ids: completedStepIds,
+                failed_step_id: step.step_id,
+                failed_step_index: i,
+                failed_step_error: result.error?.message ?? 'Unknown error',
+                step_results: stepResults,
+            };
+        }
+        completedStepIds.push(step.step_id);
+        stepResults.push({ step_id: step.step_id, success: true, result: result });
+    }
+    return { completed_step_ids: completedStepIds, step_results: stepResults };
+}
+// ---------------------------------------------------------------------------
+// Main tool entry point
+// ---------------------------------------------------------------------------
+export async function applyPlan(manager, params) {
+    try {
+        // Validate mutual exclusivity of steps and plan_file_path
+        if (params.steps && params.plan_file_path) {
+            return err('INVALID_PARAMS', 'Cannot provide both steps and plan_file_path. Use one or the other.');
+        }
+        if (!params.steps && !params.plan_file_path) {
+            return err('INVALID_PARAMS', 'Must provide either steps (JSON array) or plan_file_path.');
+        }
+        // Load steps
+        let rawSteps;
+        if (params.plan_file_path) {
+            const loaded = await loadStepsFromFile(params.plan_file_path);
+            if (loaded.error)
+                return loaded.error;
+            rawSteps = loaded.steps;
+        }
+        else {
+            rawSteps = params.steps;
+        }
+        // Normalize steps
+        const { steps, errors: normErrors } = normalizeSteps(rawSteps);
+        if (normErrors.length > 0) {
+            return err('NORMALIZATION_ERROR', `Step normalization failed with ${normErrors.length} error(s): ${normErrors.join('; ')}`);
+        }
+        if (steps.length === 0) {
+            return err('EMPTY_PLAN', 'Plan contains no valid steps.');
+        }
+        // Resolve session
+        const resolved = await resolveSessionForTool(manager, params, { toolName: 'apply_plan' });
+        if (!resolved.ok)
+            return resolved.response;
+        const { session } = resolved;
+        // Validation phase — check ALL steps before applying
+        const validations = validateSteps(steps, session.doc);
+        const overallValid = validations.every((v) => v.valid);
+        if (!overallValid) {
+            return {
+                success: false,
+                error: {
+                    code: 'VALIDATION_FAILED',
+                    message: `Plan validation failed: ${validations.filter((v) => !v.valid).length} of ${steps.length} step(s) have errors.`,
+                    hint: 'Fix the reported errors and resubmit.',
+                },
+                overall_valid: false,
+                steps: validations,
+            };
+        }
+        // Collect warnings
+        const allWarnings = validations.flatMap((v) => v.warnings.map((w) => ({ step_id: v.step_id, warning: w })));
+        // Apply phase — execute steps sequentially
+        const result = await executeSteps(manager, session.sessionId, steps);
+        if (result.failed_step_id !== undefined) {
+            return {
+                success: false,
+                error: {
+                    code: 'APPLY_PARTIAL_FAILURE',
+                    message: `Plan execution stopped at step '${result.failed_step_id}' (index ${result.failed_step_index}).`,
+                    hint: 'Completed steps have already been applied. Reapply to original DOCX if rollback is needed.',
+                },
+                session_id: session.sessionId,
+                completed_count: result.completed_step_ids.length,
+                completed_step_ids: result.completed_step_ids,
+                failed_step_id: result.failed_step_id,
+                failed_step_index: result.failed_step_index,
+                failed_step_error: result.failed_step_error,
+                step_results: result.step_results,
+                ...(allWarnings.length > 0 ? { warnings: allWarnings } : {}),
+            };
+        }
+        return ok({
+            session_id: session.sessionId,
+            edit_count: session.editCount,
+            completed_count: result.completed_step_ids.length,
+            completed_step_ids: result.completed_step_ids,
+            step_results: result.step_results,
+            ...(allWarnings.length > 0 ? { warnings: allWarnings } : {}),
+        });
+    }
+    catch (e) {
+        return err('APPLY_PLAN_ERROR', `Failed to apply plan: ${errorMessage(e)}`);
+    }
+}
+//# sourceMappingURL=apply_plan.js.map

package/dist/tools/apply_plan.js.map

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

package/dist/tools/clear_session.d.ts

@@ -0,0 +1,9 @@
+import { SessionManager } from '../session/manager.js';
+import { type ToolResponse } from './types.js';
+export declare function clearSession(manager: SessionManager, params: {
+    session_id?: string;
+    file_path?: string;
+    clear_all?: boolean;
+    confirm?: boolean;
+}): Promise<ToolResponse>;
+//# sourceMappingURL=clear_session.d.ts.map

package/dist/tools/clear_session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clear_session.d.ts","sourceRoot":"","sources":["../../src/tools/clear_session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAExD,wBAAsB,YAAY,CAChC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE;IACN,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GACA,OAAO,CAAC,YAAY,CAAC,CAyFvB"}

package/dist/tools/clear_session.js

@@ -0,0 +1,66 @@
+import { errorMessage } from "../error_utils.js";
+import { err, ok } from './types.js';
+export async function clearSession(manager, params) {
+    try {
+        const clearAll = params.clear_all === true;
+        const sessionId = typeof params.session_id === 'string' ? params.session_id.trim() : '';
+        const filePath = typeof params.file_path === 'string' ? params.file_path.trim() : '';
+        const hasSessionId = sessionId.length > 0;
+        const hasFilePath = filePath.length > 0;
+        if (clearAll) {
+            if (params.confirm !== true) {
+                return err('CONFIRMATION_REQUIRED', 'clear_all=true requires confirm=true.', 'Re-run with confirm=true to clear every active session.');
+            }
+            if (hasSessionId || hasFilePath) {
+                return err('INVALID_CLEAR_TARGET', 'clear_all=true cannot be combined with session_id or file_path.', 'Use clear_all=true, confirm=true by itself, or remove clear_all and target a session_id/file_path.');
+            }
+            const clearedIds = await manager.clearAllSessions();
+            return ok({
+                clear_mode: 'all',
+                cleared_session_ids: clearedIds,
+                cleared_count: clearedIds.length,
+            });
+        }
+        if (hasSessionId && hasFilePath) {
+            return err('INVALID_CLEAR_TARGET', 'Provide either session_id or file_path, not both.', 'Use session_id to clear one session, or file_path to clear all sessions for one file.');
+        }
+        if (!hasSessionId && !hasFilePath) {
+            return err('INVALID_CLEAR_TARGET', 'clear_session requires session_id, file_path, or clear_all=true.', 'Provide session_id to clear one session, file_path to clear all sessions for a file, or clear_all=true with confirm=true.');
+        }
+        if (hasSessionId) {
+            try {
+                await manager.clearSessionById(sessionId);
+            }
+            catch (e) {
+                const msg = errorMessage(e);
+                if (msg.startsWith('INVALID_SESSION_ID:')) {
+                    return err('INVALID_SESSION_ID', msg.replace(/^INVALID_SESSION_ID:/, 'Invalid session id: '), 'Session IDs must match format: ses_[12 alphanumeric chars]');
+                }
+                if (msg.startsWith('SESSION_NOT_FOUND:')) {
+                    return err('SESSION_NOT_FOUND', `Session not found: ${sessionId}`);
+                }
+                if (msg.startsWith('SESSION_EXPIRED:')) {
+                    return err('SESSION_EXPIRED', `Session expired: ${sessionId}`);
+                }
+                return err('CLEAR_SESSION_ERROR', `Failed to clear session: ${msg}`);
+            }
+            return ok({
+                clear_mode: 'session_id',
+                cleared_session_ids: [sessionId],
+                cleared_count: 1,
+            });
+        }
+        const normalizedPath = manager.normalizePath(filePath);
+        const clearedIds = await manager.clearSessionsByPath(normalizedPath);
+        return ok({
+            clear_mode: 'file_path',
+            file_path: normalizedPath,
+            cleared_session_ids: clearedIds,
+            cleared_count: clearedIds.length,
+        });
+    }
+    catch (e) {
+        return err('CLEAR_SESSION_ERROR', `Failed to clear session(s): ${errorMessage(e)}`);
+    }
+}
+//# sourceMappingURL=clear_session.js.map

package/dist/tools/clear_session.js.map

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

package/dist/tools/compare_documents.d.ts

@@ -0,0 +1,12 @@
+import { SessionManager } from '../session/manager.js';
+import { type ToolResponse } from './types.js';
+export declare function compareDocuments_tool(manager: SessionManager, params: {
+    original_file_path?: string;
+    revised_file_path?: string;
+    session_id?: string;
+    file_path?: string;
+    save_to_local_path: string;
+    author?: string;
+    engine?: string;
+}): Promise<ToolResponse>;
+//# sourceMappingURL=compare_documents.d.ts.map

package/dist/tools/compare_documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare_documents.d.ts","sourceRoot":"","sources":["../../src/tools/compare_documents.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAyBxD,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE;IACN,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GACA,OAAO,CAAC,YAAY,CAAC,CA8GvB"}

package/dist/tools/compare_documents.js

@@ -0,0 +1,121 @@
+import path from 'node:path';
+import { errorCode, errorMessage } from "../error_utils.js";
+import fs from 'node:fs/promises';
+import { err, ok } from './types.js';
+import { compareDocuments } from '@usejunior/docx-core';
+import { mergeSessionResolutionMetadata, resolveSessionForTool, validateAndLoadDocxFromPath, } from './session_resolution.js';
+import { enforceWritePathPolicy } from './path_policy.js';
+import { DEFAULT_RECONSTRUCTION_MODE } from './comparison_defaults.js';
+function expandPath(inputPath) {
+    return inputPath.startsWith('~') ? path.join(process.env.HOME || '', inputPath.slice(1)) : inputPath;
+}
+async function runWithoutConsoleLog(fn) {
+    if (process.env.SAFE_DOCX_ALLOW_COMPARISON_STDOUT === '1')
+        return fn();
+    const originalLog = console.log;
+    console.log = () => { };
+    try {
+        return await fn();
+    }
+    finally {
+        console.log = originalLog;
+    }
+}
+export async function compareDocuments_tool(manager, params) {
+    try {
+        const hasOriginal = typeof params.original_file_path === 'string' && params.original_file_path.trim().length > 0;
+        const hasRevised = typeof params.revised_file_path === 'string' && params.revised_file_path.trim().length > 0;
+        const hasSession = (typeof params.session_id === 'string' && params.session_id.trim().length > 0) ||
+            (typeof params.file_path === 'string' && params.file_path.trim().length > 0);
+        // Determine mode
+        const twoFileMode = hasOriginal && hasRevised;
+        const sessionMode = !twoFileMode && hasSession;
+        if (!twoFileMode && !sessionMode) {
+            return err('MISSING_PARAMS', 'Provide original_file_path + revised_file_path for two-file comparison, or session_id/file_path for session comparison.', 'Two-file mode compares two DOCX files. Session mode compares the current session state against the original.');
+        }
+        // Validate engine
+        const engine = params.engine ?? 'auto';
+        if (engine !== 'auto' && engine !== 'atomizer' && engine !== 'diffmatch') {
+            if (engine === 'wmlcomparer') {
+                return err('INVALID_ENGINE', "Engine 'wmlcomparer' is not supported.", "Use 'auto', 'atomizer', or 'diffmatch'.");
+            }
+            return err('INVALID_ENGINE', `Invalid engine: ${String(engine)}`, "Use 'auto', 'atomizer', or 'diffmatch'.");
+        }
+        const compareEngine = engine;
+        const author = params.author ?? 'Comparison';
+        let originalBuffer;
+        let revisedBuffer;
+        let sessionMetadata = {};
+        let originalFilePath;
+        let revisedFilePath;
+        if (twoFileMode) {
+            // Mode 1: two file paths
+            const originalLoaded = await validateAndLoadDocxFromPath(manager, params.original_file_path);
+            if (!originalLoaded.ok)
+                return originalLoaded.response;
+            const revisedLoaded = await validateAndLoadDocxFromPath(manager, params.revised_file_path);
+            if (!revisedLoaded.ok)
+                return revisedLoaded.response;
+            originalBuffer = originalLoaded.content;
+            revisedBuffer = revisedLoaded.content;
+            originalFilePath = originalLoaded.normalizedPath;
+            revisedFilePath = revisedLoaded.normalizedPath;
+        }
+        else {
+            // Mode 2: session edits
+            const resolved = await resolveSessionForTool(manager, params, { toolName: 'compare_documents' });
+            if (!resolved.ok)
+                return resolved.response;
+            const { session, metadata } = resolved;
+            sessionMetadata = metadata;
+            // Use comparison baseline (post-normalization with bookmarks) when available
+            // to prevent normalization artifacts from appearing as false tracked changes.
+            originalBuffer = session.comparisonBaselineWithBookmarks ?? session.originalBuffer;
+            const revised = await session.doc.toBuffer({ cleanBookmarks: false });
+            revisedBuffer = revised.buffer;
+            originalFilePath = manager.normalizePath(session.originalPath);
+        }
+        // Run comparison
+        const result = await runWithoutConsoleLog(() => compareDocuments(originalBuffer, revisedBuffer, {
+            author,
+            engine: compareEngine,
+            reconstructionMode: DEFAULT_RECONSTRUCTION_MODE,
+        }));
+        // Validate and write output
+        const savePath = expandPath(params.save_to_local_path);
+        const writePolicy = await enforceWritePathPolicy(savePath);
+        if (!writePolicy.ok)
+            return writePolicy.response;
+        await fs.mkdir(path.dirname(savePath), { recursive: true });
+        await fs.writeFile(savePath, new Uint8Array(result.document));
+        const response = {
+            mode: twoFileMode ? 'two_file' : 'session',
+            original_file_path: originalFilePath,
+            revised_file_path: revisedFilePath,
+            saved_to: savePath,
+            size_bytes: result.document.length,
+            engine_requested: compareEngine,
+            engine_used: result.engine,
+            author,
+            stats: result.stats,
+            reconstruction_mode_requested: result.reconstructionModeRequested,
+            reconstruction_mode_used: result.reconstructionModeUsed,
+            fallback_reason: result.fallbackReason,
+            message: twoFileMode
+                ? `Redline comparing '${path.basename(originalFilePath)}' vs '${path.basename(revisedFilePath)}' saved to ${savePath}`
+                : `Redline of session edits saved to ${savePath}`,
+        };
+        if (sessionMode) {
+            return ok(mergeSessionResolutionMetadata(response, sessionMetadata));
+        }
+        return ok(response);
+    }
+    catch (e) {
+        const msg = errorMessage(e);
+        if (String(errorCode(e) ?? '').toUpperCase() === 'EACCES') {
+            return err('PERMISSION_DENIED', `Cannot write to: ${params.save_to_local_path}`, 'Try saving to ~/Downloads/ or ~/Documents/ instead.');
+        }
+        return err('COMPARE_ERROR', `Comparison failed: ${msg}`);
+    }
+}
+//# sourceMappingURL=compare_documents.js.map

package/dist/tools/compare_documents.js.map

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

package/dist/tools/comparison_defaults.d.ts

@@ -0,0 +1,9 @@
+import type { CompareOptions } from '@usejunior/docx-core';
+/**
+ * Default comparison reconstruction mode for tracked output.
+ *
+ * In-place mode preserves revised document structure when safe to do so.
+ * The atomizer pipeline still falls back to rebuild if round-trip safety checks fail.
+ */
+export declare const DEFAULT_RECONSTRUCTION_MODE: NonNullable<CompareOptions['reconstructionMode']>;
+//# sourceMappingURL=comparison_defaults.d.ts.map

package/dist/tools/comparison_defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparison_defaults.d.ts","sourceRoot":"","sources":["../../src/tools/comparison_defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,EAAE,WAAW,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAa,CAAC"}

package/dist/tools/comparison_defaults.js

@@ -0,0 +1,8 @@
+/**
+ * Default comparison reconstruction mode for tracked output.
+ *
+ * In-place mode preserves revised document structure when safe to do so.
+ * The atomizer pipeline still falls back to rebuild if round-trip safety checks fail.
+ */
+export const DEFAULT_RECONSTRUCTION_MODE = 'inplace';
+//# sourceMappingURL=comparison_defaults.js.map

package/dist/tools/comparison_defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparison_defaults.js","sourceRoot":"","sources":["../../src/tools/comparison_defaults.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAsD,SAAS,CAAC"}

package/dist/tools/delete_comment.d.ts

@@ -0,0 +1,8 @@
+import { SessionManager } from '../session/manager.js';
+import { type ToolResponse } from './types.js';
+export declare function deleteComment(manager: SessionManager, params: {
+    session_id?: string;
+    file_path?: string;
+    comment_id?: number;
+}): Promise<ToolResponse>;
+//# sourceMappingURL=delete_comment.d.ts.map