@usejunior/docx-mcp 0.0.1 → 0.1.2

package/dist/tools/merge_plans.js

@@ -0,0 +1,408 @@
+import { err, ok } from './types.js';
+import { errorMessage } from "../error_utils.js";
+function asRecord(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return null;
+    return value;
+}
+function asTrimmedString(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function asInteger(value) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return null;
+    if (!Number.isInteger(value) || value < 0)
+        return null;
+    return value;
+}
+function asBoolean(value, fallback) {
+    return typeof value === 'boolean' ? value : fallback;
+}
+function normalizeOperation(value) {
+    const raw = asTrimmedString(value)?.toLowerCase();
+    if (!raw)
+        return null;
+    if (raw === 'replace_text')
+        return 'replace_text';
+    if (raw === 'insert_paragraph')
+        return 'insert_paragraph';
+    return null;
+}
+function extractRange(step) {
+    const rangeRaw = step.range ?? step.span ?? step.match_range;
+    if (rangeRaw == null)
+        return null;
+    const rangeObj = asRecord(rangeRaw);
+    if (!rangeObj)
+        return 'invalid';
+    const start = asInteger(rangeObj.start);
+    const end = asInteger(rangeObj.end);
+    if (start == null || end == null)
+        return 'invalid';
+    if (end <= start)
+        return 'invalid';
+    return { start, end };
+}
+function stepRef(step) {
+    return {
+        plan_id: step.source_plan_id,
+        plan_index: step.source_plan_index,
+        step_index: step.source_step_index,
+        step_id: step.step_id,
+    };
+}
+function buildAutoStepId(planIndex, stepIndex) {
+    return `auto_${planIndex + 1}_${stepIndex + 1}`;
+}
+function cloneArguments(step) {
+    const out = {};
+    for (const [key, value] of Object.entries(step)) {
+        if (key === 'operation' || key === 'op' || key === 'step_id' || key === 'note' || key === 'range' || key === 'span' || key === 'match_range') {
+            continue;
+        }
+        out[key] = value;
+    }
+    return out;
+}
+function normalizePlans(plansRaw) {
+    if (!Array.isArray(plansRaw)) {
+        return {
+            plans: [],
+            plan_count: 0,
+            conflicts: [
+                {
+                    code: 'INVALID_INPUT',
+                    severity: 'hard',
+                    message: "'plans' must be an array.",
+                    step_refs: [],
+                },
+            ],
+        };
+    }
+    const plans = [];
+    const conflicts = [];
+    for (let pIdx = 0; pIdx < plansRaw.length; pIdx += 1) {
+        const planObj = asRecord(plansRaw[pIdx]);
+        const planId = asTrimmedString(planObj?.plan_id) ?? `plan_${pIdx + 1}`;
+        if (!planObj) {
+            conflicts.push({
+                code: 'INVALID_PLAN',
+                severity: 'hard',
+                message: `Plan at index ${pIdx} is not an object.`,
+                step_refs: [],
+            });
+            continue;
+        }
+        const baseRevisionRaw = planObj.base_revision;
+        const baseRevision = baseRevisionRaw == null ? null : asInteger(baseRevisionRaw);
+        if (baseRevisionRaw != null && baseRevision == null) {
+            conflicts.push({
+                code: 'INVALID_BASE_REVISION',
+                severity: 'hard',
+                message: `Plan '${planId}' has invalid base_revision. Expected a non-negative integer.`,
+                step_refs: [],
+            });
+        }
+        const stepsRaw = planObj.steps;
+        if (!Array.isArray(stepsRaw)) {
+            conflicts.push({
+                code: 'INVALID_PLAN_STEPS',
+                severity: 'hard',
+                message: `Plan '${planId}' must include a 'steps' array.`,
+                step_refs: [],
+            });
+            continue;
+        }
+        const normalizedSteps = [];
+        for (let sIdx = 0; sIdx < stepsRaw.length; sIdx += 1) {
+            const stepObj = asRecord(stepsRaw[sIdx]);
+            const generatedStepId = buildAutoStepId(pIdx, sIdx);
+            const providedStepId = asTrimmedString(stepObj?.step_id);
+            const finalStepId = providedStepId ?? generatedStepId;
+            if (!stepObj) {
+                conflicts.push({
+                    code: 'INVALID_STEP',
+                    severity: 'hard',
+                    message: `Step ${sIdx} in plan '${planId}' is not an object.`,
+                    step_refs: [{ plan_id: planId, plan_index: pIdx, step_index: sIdx, step_id: finalStepId }],
+                });
+                continue;
+            }
+            const operation = normalizeOperation(stepObj.operation ?? stepObj.op);
+            if (!operation) {
+                conflicts.push({
+                    code: 'INVALID_STEP_OPERATION',
+                    severity: 'hard',
+                    message: `Step '${finalStepId}' in plan '${planId}' has unsupported operation.`,
+                    step_refs: [{ plan_id: planId, plan_index: pIdx, step_index: sIdx, step_id: finalStepId }],
+                });
+                continue;
+            }
+            const baseStep = {
+                step_id: finalStepId,
+                source_plan_id: planId,
+                source_plan_index: pIdx,
+                source_step_index: sIdx,
+                note: asTrimmedString(stepObj.note),
+                arguments: cloneArguments(stepObj),
+            };
+            if (operation === 'replace_text') {
+                const targetParagraphId = asTrimmedString(stepObj.target_paragraph_id);
+                if (!targetParagraphId) {
+                    conflicts.push({
+                        code: 'INVALID_STEP_TARGET',
+                        severity: 'hard',
+                        message: `replace_text step '${finalStepId}' in plan '${planId}' requires target_paragraph_id.`,
+                        step_refs: [{ plan_id: planId, plan_index: pIdx, step_index: sIdx, step_id: finalStepId }],
+                    });
+                    continue;
+                }
+                const range = extractRange(stepObj);
+                if (range === 'invalid') {
+                    conflicts.push({
+                        code: 'INVALID_STEP_RANGE',
+                        severity: 'hard',
+                        message: `replace_text step '${finalStepId}' in plan '${planId}' has invalid range/span metadata.`,
+                        paragraph_id: targetParagraphId,
+                        step_refs: [{ plan_id: planId, plan_index: pIdx, step_index: sIdx, step_id: finalStepId }],
+                    });
+                    continue;
+                }
+                normalizedSteps.push({
+                    ...baseStep,
+                    operation,
+                    target_paragraph_id: targetParagraphId,
+                    range: range ?? undefined,
+                });
+                continue;
+            }
+            const anchorParagraphId = asTrimmedString(stepObj.positional_anchor_node_id)
+                ?? asTrimmedString(stepObj.anchor_paragraph_id);
+            if (!anchorParagraphId) {
+                conflicts.push({
+                    code: 'INVALID_STEP_TARGET',
+                    severity: 'hard',
+                    message: `insert_paragraph step '${finalStepId}' in plan '${planId}' requires positional_anchor_node_id.`,
+                    step_refs: [{ plan_id: planId, plan_index: pIdx, step_index: sIdx, step_id: finalStepId }],
+                });
+                continue;
+            }
+            const position = (asTrimmedString(stepObj.position) ?? 'AFTER').toUpperCase();
+            if (position !== 'BEFORE' && position !== 'AFTER') {
+                conflicts.push({
+                    code: 'INVALID_STEP_POSITION',
+                    severity: 'hard',
+                    message: `insert_paragraph step '${finalStepId}' in plan '${planId}' has invalid position '${String(stepObj.position)}'.`,
+                    paragraph_id: anchorParagraphId,
+                    step_refs: [{ plan_id: planId, plan_index: pIdx, step_index: sIdx, step_id: finalStepId }],
+                });
+                continue;
+            }
+            normalizedSteps.push({
+                ...baseStep,
+                operation,
+                positional_anchor_node_id: anchorParagraphId,
+                position: position,
+            });
+        }
+        plans.push({
+            plan_id: planId,
+            base_revision: baseRevision,
+            source_plan_index: pIdx,
+            steps: normalizedSteps,
+        });
+    }
+    return {
+        plans,
+        conflicts,
+        plan_count: plansRaw.length,
+    };
+}
+function detectDuplicateStepIdConflicts(steps) {
+    const byStepId = new Map();
+    for (const step of steps) {
+        const arr = byStepId.get(step.step_id) ?? [];
+        arr.push(step);
+        byStepId.set(step.step_id, arr);
+    }
+    const conflicts = [];
+    for (const [stepId, dupeSteps] of byStepId.entries()) {
+        if (dupeSteps.length < 2)
+            continue;
+        conflicts.push({
+            code: 'DUPLICATE_STEP_ID',
+            severity: 'hard',
+            message: `Duplicate step_id '${stepId}' detected across submitted plans.`,
+            step_refs: dupeSteps.map((s) => stepRef(s)),
+            details: { duplicate_step_id: stepId },
+        });
+    }
+    return conflicts;
+}
+function rangesOverlap(a, b) {
+    return a.start < b.end && b.start < a.end;
+}
+function detectReplaceConflicts(steps) {
+    const replaceSteps = steps.filter((s) => s.operation === 'replace_text' && !!s.target_paragraph_id);
+    const byParagraph = new Map();
+    for (const step of replaceSteps) {
+        const paragraphId = step.target_paragraph_id;
+        const arr = byParagraph.get(paragraphId) ?? [];
+        arr.push(step);
+        byParagraph.set(paragraphId, arr);
+    }
+    const conflicts = [];
+    for (const [paragraphId, paragraphSteps] of byParagraph.entries()) {
+        if (paragraphSteps.length < 2)
+            continue;
+        const unknownRangeSteps = paragraphSteps.filter((s) => !s.range);
+        if (unknownRangeSteps.length > 0) {
+            conflicts.push({
+                code: 'UNKNOWN_REPLACE_RANGE',
+                severity: 'hard',
+                message: `replace_text steps targeting paragraph '${paragraphId}' require explicit non-overlapping ranges for deterministic merge.`,
+                paragraph_id: paragraphId,
+                step_refs: paragraphSteps.map((s) => stepRef(s)),
+            });
+            continue;
+        }
+        for (let i = 0; i < paragraphSteps.length; i += 1) {
+            for (let j = i + 1; j < paragraphSteps.length; j += 1) {
+                const a = paragraphSteps[i];
+                const b = paragraphSteps[j];
+                if (!a.range || !b.range)
+                    continue;
+                if (!rangesOverlap(a.range, b.range))
+                    continue;
+                conflicts.push({
+                    code: 'OVERLAPPING_REPLACE_RANGE',
+                    severity: 'hard',
+                    message: `replace_text spans overlap in paragraph '${paragraphId}'.`,
+                    paragraph_id: paragraphId,
+                    step_refs: [stepRef(a), stepRef(b)],
+                    details: {
+                        first_range: a.range,
+                        second_range: b.range,
+                    },
+                });
+            }
+        }
+    }
+    return conflicts;
+}
+function detectInsertSlotCollisions(steps) {
+    const insertSteps = steps.filter((s) => s.operation === 'insert_paragraph' && !!s.positional_anchor_node_id && !!s.position);
+    const bySlot = new Map();
+    for (const step of insertSteps) {
+        const slotKey = `${step.positional_anchor_node_id}::${step.position}`;
+        const arr = bySlot.get(slotKey) ?? [];
+        arr.push(step);
+        bySlot.set(slotKey, arr);
+    }
+    const conflicts = [];
+    for (const [slotKey, slotSteps] of bySlot.entries()) {
+        if (slotSteps.length < 2)
+            continue;
+        const anchorId = slotSteps[0].positional_anchor_node_id;
+        const position = slotSteps[0].position;
+        conflicts.push({
+            code: 'INSERT_SLOT_COLLISION',
+            severity: 'hard',
+            message: `Multiple insert_paragraph steps target the same slot '${slotKey}'.`,
+            paragraph_id: anchorId,
+            step_refs: slotSteps.map((s) => stepRef(s)),
+            details: {
+                anchor_paragraph_id: anchorId,
+                position,
+            },
+        });
+    }
+    return conflicts;
+}
+function detectBaseRevisionConflicts(plans, requireSharedBaseRevision) {
+    const revisions = new Set();
+    for (const plan of plans) {
+        if (plan.base_revision == null)
+            continue;
+        revisions.add(plan.base_revision);
+    }
+    if (revisions.size === 0) {
+        return { conflicts: [], mergedBaseRevision: null };
+    }
+    const mergedBaseRevision = revisions.size === 1 ? [...revisions][0] : null;
+    if (!requireSharedBaseRevision || revisions.size <= 1) {
+        return { conflicts: [], mergedBaseRevision };
+    }
+    return {
+        mergedBaseRevision,
+        conflicts: [
+            {
+                code: 'BASE_REVISION_CONFLICT',
+                severity: 'hard',
+                message: `Submitted plans have mismatched base_revision values: ${[...revisions].sort((a, b) => a - b).join(', ')}.`,
+                step_refs: [],
+                details: {
+                    base_revisions: [...revisions].sort((a, b) => a - b),
+                },
+            },
+        ],
+    };
+}
+export async function mergePlans(params) {
+    try {
+        const failOnConflict = asBoolean(params.fail_on_conflict, true);
+        const requireSharedBaseRevision = asBoolean(params.require_shared_base_revision, true);
+        const normalized = normalizePlans(params.plans);
+        const normalizedPlans = normalized.plans;
+        const flattenedSteps = normalizedPlans.flatMap((plan) => plan.steps);
+        const revisionCheck = detectBaseRevisionConflicts(normalizedPlans, requireSharedBaseRevision);
+        const conflicts = [
+            ...normalized.conflicts,
+            ...revisionCheck.conflicts,
+            ...detectDuplicateStepIdConflicts(flattenedSteps),
+            ...detectReplaceConflicts(flattenedSteps),
+            ...detectInsertSlotCollisions(flattenedSteps),
+        ];
+        const hasConflicts = conflicts.length > 0;
+        const mergedPlan = {
+            format: 'safe_docx_merged_plan_v1',
+            generated_at: new Date().toISOString(),
+            base_revision: revisionCheck.mergedBaseRevision,
+            plan_count: normalized.plan_count,
+            step_count: flattenedSteps.length,
+            steps: flattenedSteps,
+        };
+        if (hasConflicts && failOnConflict) {
+            return {
+                success: false,
+                error: {
+                    code: 'PLAN_CONFLICT',
+                    message: `Detected ${conflicts.length} hard conflict(s) while merging plans.`,
+                    hint: 'Resolve reported conflicts, or set fail_on_conflict=false to inspect diagnostics without hard failure.',
+                },
+                has_conflicts: true,
+                conflict_count: conflicts.length,
+                conflicts,
+                merged_plan: mergedPlan,
+            };
+        }
+        return ok({
+            has_conflicts: hasConflicts,
+            conflict_count: conflicts.length,
+            conflicts,
+            merged_plan: mergedPlan,
+            conflict_policy: {
+                fail_on_conflict: failOnConflict,
+                require_shared_base_revision: requireSharedBaseRevision,
+            },
+        });
+    }
+    catch (e) {
+        const msg = errorMessage(e);
+        return err('MERGE_PLAN_ERROR', `Failed to merge plans: ${msg}`);
+    }
+}
+//# sourceMappingURL=merge_plans.js.map

package/dist/tools/merge_plans.js.map

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

package/dist/tools/open_document.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"open_document.d.ts","sourceRoot":"","sources":["../../src/tools/open_document.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAqCxD,wBAAsB,YAAY,CAChC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1D,OAAO,CAAC,YAAY,CAAC,CA6EvB"}

package/dist/tools/open_document.js

@@ -0,0 +1,102 @@
+import fs from 'node:fs/promises';
+import { errorMessage } from "../error_utils.js";
+import path from 'node:path';
+import { err, ok } from './types.js';
+import { enforceReadPathPolicy } from './path_policy.js';
+import { validateDocxArchiveSafety } from './docx_archive_guard.js';
+import { SAFE_DOCX_MCP_TOOLS } from '../tool_catalog.js';
+function getAvailableToolsSchema() {
+    const toolDefaultsByName = {
+        grep: { dedupe_by_paragraph: true },
+        download: {
+            download_format: 'both',
+            clean_bookmarks: true,
+            returned_variants: ['clean', 'tracked'],
+        },
+    };
+    return SAFE_DOCX_MCP_TOOLS.map((tool) => {
+        const parameters = getTopLevelPropertyNames(tool.inputSchema);
+        const defaults = toolDefaultsByName[tool.name];
+        return defaults
+            ? { name: tool.name, description: tool.description, parameters, defaults }
+            : { name: tool.name, description: tool.description, parameters };
+    });
+}
+function getTopLevelPropertyNames(inputSchema) {
+    const rawProperties = inputSchema['properties'];
+    if (!rawProperties || typeof rawProperties !== 'object' || Array.isArray(rawProperties)) {
+        return [];
+    }
+    return Object.keys(rawProperties);
+}
+export async function openDocument(manager, params) {
+    const filePath = params.file_path;
+    try {
+        const expanded = manager.normalizePath(filePath);
+        const stat = await fs.stat(expanded).catch(() => null);
+        if (!stat || !stat.isFile()) {
+            return err('FILE_NOT_FOUND', `File not found: ${filePath}`, 'Copy the file to ~/Downloads/ or ~/Documents/ first, then pass that path.');
+        }
+        if (path.extname(expanded).toLowerCase() !== '.docx') {
+            return err('INVALID_FILE_TYPE', `Invalid file type: ${path.extname(expanded)}`, 'Only .docx files are supported.');
+        }
+        const policy = await enforceReadPathPolicy(filePath);
+        if (!policy.ok)
+            return policy.response;
+        const safePath = policy.normalizedPath;
+        const content = await fs.readFile(safePath);
+        if (content.length > 50 * 1024 * 1024) {
+            return err('VALIDATION_ERROR', 'File too large', 'Check file type (.docx only) and size (max 50MB).');
+        }
+        const archiveGuard = await validateDocxArchiveSafety(content);
+        if (!archiveGuard.ok)
+            return archiveGuard.response;
+        const filename = path.basename(safePath);
+        const session = await manager.createSession(content, filename, safePath);
+        // Normalize: merge runs + simplify redlines BEFORE bookmark allocation.
+        if (!params.skip_normalization) {
+            session.normalizationStats = session.doc.normalize();
+        }
+        // Insert paragraph bookmarks for stable paragraph ids.
+        const info = session.doc.insertParagraphBookmarks(`mcp_${session.sessionId}`);
+        // Compute comparison baselines AFTER normalization + bookmark insertion.
+        // These baselines are used for tracked-changes comparison instead of originalBuffer,
+        // preventing normalization artifacts from appearing as false tracked changes.
+        const [cleanBaseline, bookmarkedBaseline] = await Promise.all([
+            session.doc.toBuffer({ cleanBookmarks: true }),
+            session.doc.toBuffer({ cleanBookmarks: false }),
+        ]);
+        session.comparisonBaseline = cleanBaseline.buffer;
+        session.comparisonBaselineWithBookmarks = bookmarkedBaseline.buffer;
+        manager.touch(session);
+        return ok({
+            session_id: session.sessionId,
+            expires_at: session.expiresAt.toISOString(),
+            document: {
+                filename,
+                paragraphs: info.paragraphCount,
+                size_bytes: content.length,
+            },
+            normalization: session.normalizationStats
+                ? {
+                    runs_merged: session.normalizationStats.runsMerged,
+                    proof_errors_removed: session.normalizationStats.proofErrRemoved,
+                    redlines_simplified: session.normalizationStats.wrappersConsolidated,
+                    double_elevations_fixed: session.normalizationStats.doubleElevationsFixed,
+                    normalization_skipped: false,
+                }
+                : { runs_merged: 0, redlines_simplified: 0, double_elevations_fixed: 0, normalization_skipped: true },
+            download_defaults: {
+                default_variants: ['clean', 'redline'],
+                default_download_format: 'both',
+                supports_variant_override: true,
+                redownload_by_session_id: true,
+            },
+            tools: getAvailableToolsSchema(),
+        });
+    }
+    catch (e) {
+        return err('FILE_READ_ERROR', `Failed to read file: ${errorMessage(e)}`, 'Ensure the file exists and is readable.');
+    }
+}
+//# sourceMappingURL=open_document.js.map

package/dist/tools/open_document.js.map

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

package/dist/tools/path_policy.d.ts

@@ -0,0 +1,13 @@
+import { type ToolResponse } from './types.js';
+export type PathPolicyOutcome = {
+    ok: true;
+    normalizedPath: string;
+    resolvedPath: string;
+    allowedRoots: string[];
+} | {
+    ok: false;
+    response: ToolResponse;
+};
+export declare function enforceReadPathPolicy(inputPath: string): Promise<PathPolicyOutcome>;
+export declare function enforceWritePathPolicy(inputPath: string): Promise<PathPolicyOutcome>;
+//# sourceMappingURL=path_policy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"path_policy.d.ts","sourceRoot":"","sources":["../../src/tools/path_policy.ts"],"names":[],"mappings":"AAIA,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,MAAM,iBAAiB,GACzB;IACE,EAAE,EAAE,IAAI,CAAC;IACT,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,GACD;IACE,EAAE,EAAE,KAAK,CAAC;IACV,QAAQ,EAAE,YAAY,CAAC;CACxB,CAAC;AA8EN,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAoBzF;AAED,wBAAsB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAoB1F"}