@usejunior/docx-mcp 0.0.1 → 0.1.1

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { runServer } from './server.js';
+export { createProgram, runCli } from './cli/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { runServer } from './server.js';
+export { createProgram, runCli } from './cli/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,80 @@
+import { SessionManager } from './session/manager.js';
+export declare const MCP_TRANSPORT: "stdio";
+export declare const MCP_TOOLS: {
+    name: "read_file" | "grep" | "init_plan" | "merge_plans" | "apply_plan" | "replace_text" | "insert_paragraph" | "download" | "format_layout" | "accept_changes" | "has_tracked_changes" | "get_session_status" | "clear_session" | "duplicate_document" | "add_comment" | "get_comments" | "delete_comment" | "compare_documents" | "get_footnotes" | "add_footnote" | "update_footnote" | "delete_footnote" | "extract_revisions";
+    description: "Read document content with paragraph IDs. Accepts session_id or file_path." | "Search paragraphs with regex. Accepts session_id or file_path." | "Initialize revision-bound context metadata for coordinated multi-agent planning. Accepts session_id or file_path." | "Deterministically merge multiple sub-agent plans and detect hard conflicts before apply." | "Validate and apply a batch of edit steps (replace_text, insert_paragraph) to a session document in one call. Validates all steps first; applies only if all pass. Accepts inline steps or a plan_file_path. Compatible with merge_plans output." | "Replace text in a paragraph by _bk_* id, preserving formatting. Accepts session_id or file_path." | "Insert a paragraph before/after an anchor paragraph by _bk_* id. Accepts session_id or file_path." | "Save clean and/or tracked changes output back to the user filesystem. Defaults to both clean and tracked outputs when no format override is provided. Accepts session_id or file_path." | "Apply deterministic OOXML layout controls (paragraph spacing, table row height, cell padding). Accepts session_id or file_path." | "Accept all tracked changes in the document body, producing a clean document with no revision markup. Returns acceptance stats." | "Check whether the document body contains tracked-change markers (insertions, deletions, moves, and property-change records). Read-only." | "Get session metadata. Accepts session_id or file_path." | "Clear one session, all sessions for a file path, or all sessions with explicit confirmation." | "Duplicate a source .docx and auto-open a fresh editing session for the duplicate." | "Add a comment or threaded reply to a document. Provide target_paragraph_id + anchor_text for root comments, or parent_comment_id for replies." | "Get all comments from the document with IDs, authors, dates, text, and anchored paragraph IDs. Includes threaded replies. Read-only." | "Delete a comment and all its threaded replies from the document. Cascade-deletes all descendants." | "Compare two DOCX documents and produce a tracked-changes output document. Provide original_file_path + revised_file_path for standalone comparison, or session_id/file_path to compare session edits against the original." | "Get all footnotes from the document with IDs, display numbers, text, and anchored paragraph IDs. Read-only." | "Add a footnote anchored to a paragraph. Optionally position the reference after specific text using after_text. Note: [^N] markers in read_file output are display-only and not part of the editable text used by replace_text." | "Update the text content of an existing footnote." | "Delete a footnote and its reference from the document." | "Extract tracked changes as structured JSON with before/after text per paragraph, revision details, and comments. Supports pagination via offset and limit. Read-only - does not modify the document.";
+    inputSchema: Record<string, unknown>;
+    annotations: {
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+    } | {
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+    } | {
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+    } | {
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+    } | {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+    } | {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+    } | {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+    } | {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+    } | {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+    } | {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+    } | {
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+    } | {
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+    } | {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+    } | {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+    } | {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+    } | {
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+    } | {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+    } | {
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+    } | {
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+    } | {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+    } | {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+    } | {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+    } | {
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+    };
+}[];
+export declare function dispatchToolCall(sessions: SessionManager, name: string, args: Record<string, unknown>): Promise<Record<string, unknown>>;
+export declare function runServer(): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AA0BtD,eAAO,MAAM,aAAa,EAAG,OAAgB,CAAC;AAE9C,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAAsB,CAAC;AAE7C,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA0DlC;AAED,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CA6B/C"}

package/dist/server.js

@@ -0,0 +1,112 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { SessionManager } from './session/manager.js';
+import { SAFE_DOCX_MCP_TOOLS } from './tool_catalog.js';
+import { readFile } from './tools/read_file.js';
+import { grep } from './tools/grep.js';
+import { initPlan } from './tools/init_plan.js';
+import { replaceText } from './tools/replace_text.js';
+import { insertParagraph } from './tools/insert_paragraph.js';
+import { mergePlans } from './tools/merge_plans.js';
+import { applyPlan } from './tools/apply_plan.js';
+import { download } from './tools/download.js';
+import { getSessionStatus } from './tools/get_session_status.js';
+import { hasTrackedChanges_tool } from './tools/has_tracked_changes.js';
+import { clearSession } from './tools/clear_session.js';
+import { duplicateDocument } from './tools/duplicate_document.js';
+import { formatLayout } from './tools/format_layout.js';
+import { acceptChanges } from './tools/accept_changes.js';
+import { addComment } from './tools/add_comment.js';
+import { getComments } from './tools/get_comments.js';
+import { deleteComment } from './tools/delete_comment.js';
+import { getFootnotes } from './tools/get_footnotes.js';
+import { addFootnote } from './tools/add_footnote.js';
+import { updateFootnote } from './tools/update_footnote.js';
+import { deleteFootnote } from './tools/delete_footnote.js';
+import { compareDocuments_tool } from './tools/compare_documents.js';
+import { extractRevisions_tool } from './tools/extract_revisions.js';
+export const MCP_TRANSPORT = 'stdio';
+export const MCP_TOOLS = SAFE_DOCX_MCP_TOOLS;
+export async function dispatchToolCall(sessions, name, args) {
+    switch (name) {
+        case 'read_file':
+            return await readFile(sessions, args);
+        case 'grep':
+            return await grep(sessions, args);
+        case 'init_plan':
+            return await initPlan(sessions, args);
+        case 'merge_plans':
+            return await mergePlans(args);
+        case 'apply_plan':
+            return await applyPlan(sessions, args);
+        case 'replace_text':
+            return await replaceText(sessions, args);
+        case 'insert_paragraph':
+            return await insertParagraph(sessions, args);
+        case 'download':
+            return await download(sessions, args);
+        case 'format_layout':
+            return await formatLayout(sessions, args);
+        case 'accept_changes':
+            return await acceptChanges(sessions, args);
+        case 'has_tracked_changes':
+            return await hasTrackedChanges_tool(sessions, args);
+        case 'get_session_status':
+            return await getSessionStatus(sessions, args);
+        case 'clear_session':
+            return await clearSession(sessions, args);
+        case 'duplicate_document':
+            return await duplicateDocument(sessions, args);
+        case 'add_comment':
+            return await addComment(sessions, args);
+        case 'get_comments':
+            return await getComments(sessions, args);
+        case 'delete_comment':
+            return await deleteComment(sessions, args);
+        case 'compare_documents':
+            return await compareDocuments_tool(sessions, args);
+        case 'get_footnotes':
+            return await getFootnotes(sessions, args);
+        case 'add_footnote':
+            return await addFootnote(sessions, args);
+        case 'update_footnote':
+            return await updateFootnote(sessions, args);
+        case 'delete_footnote':
+            return await deleteFootnote(sessions, args);
+        case 'extract_revisions':
+            return await extractRevisions_tool(sessions, args);
+        default:
+            return {
+                success: false,
+                error: {
+                    code: 'UNKNOWN_TOOL',
+                    message: `Unknown tool: ${name}`,
+                    hint: 'Use file-first tools: read_file, grep, replace_text, insert_paragraph, download, get_session_status.',
+                },
+            };
+    }
+}
+export async function runServer() {
+    const server = new Server({ name: 'safe-docx', version: '0.1.0' }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    const sessions = new SessionManager();
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return { tools: MCP_TOOLS };
+    });
+    server.setRequestHandler(CallToolRequestSchema, async (req) => {
+        const { name } = req.params;
+        const args = (req.params.arguments ?? {});
+        const result = await dispatchToolCall(sessions, name, args);
+        // MCP SDK expects tool results as content blocks.
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+        };
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/session/manager.d.ts

@@ -0,0 +1,84 @@
+import { DocxDocument, type NormalizationResult, type ParagraphRevision, type ReconstructionMode, type ReconstructionFallbackReason, type ReconstructionFallbackDiagnostics } from '@usejunior/docx-core';
+export type DownloadFormat = 'clean' | 'tracked' | 'both';
+export type TrackedChangesStats = {
+    insertions: number;
+    deletions: number;
+    modifications: number;
+};
+export type DownloadCacheEntry = {
+    cacheKey: string;
+    revision: number;
+    format: DownloadFormat;
+    cleanBookmarks: boolean;
+    trackedEngine: 'auto' | 'atomizer' | 'diffmatch';
+    trackedAuthor: string;
+    revisedBuffer: Buffer;
+    trackedBuffer: Buffer | null;
+    trackedStats: TrackedChangesStats | null;
+    trackedReconstructionMode?: ReconstructionMode;
+    trackedFallbackReason?: ReconstructionFallbackReason;
+    trackedFallbackDiagnostics?: ReconstructionFallbackDiagnostics;
+    bookmarksRemoved: number;
+    exportedAtUtc: string;
+    cachedAtIso: string;
+};
+export type ExtractionCacheEntry = {
+    revision: number;
+    changes: ParagraphRevision[];
+};
+export type Session = {
+    sessionId: string;
+    filename: string;
+    tmpPath: string;
+    originalPath: string;
+    originalBuffer: Buffer;
+    /**
+     * Post-normalization + bookmark-cleaned buffer used as comparison baseline for tracked output.
+     * Comparing against this instead of originalBuffer prevents normalization artifacts from
+     * appearing as false tracked changes. Set during open_document after normalization.
+     */
+    comparisonBaseline: Buffer | null;
+    /**
+     * Post-normalization buffer WITH bookmarks, used as comparison baseline for
+     * compare_documents tool (which uses cleanBookmarks: false).
+     */
+    comparisonBaselineWithBookmarks: Buffer | null;
+    doc: DocxDocument;
+    editCount: number;
+    editRevision: number;
+    downloadCache: Map<string, DownloadCacheEntry>;
+    extractionCache: ExtractionCacheEntry | null;
+    createdAt: Date;
+    lastAccessedAt: Date;
+    expiresAt: Date;
+    normalizationStats: NormalizationResult | null;
+};
+export declare class SessionManager {
+    private sessions;
+    private ttlMs;
+    private static readonly SESSION_ID_PATTERN;
+    constructor(opts?: {
+        ttlMs?: number;
+    });
+    private expandPath;
+    normalizePath(inputPath: string): string;
+    private newSessionId;
+    createSession(documentContent: Buffer, filename: string, originalPath: string): Promise<Session>;
+    getSession(sessionId: string): Session;
+    private listActiveSessionsForPath;
+    getMostRecentlyUsedSessionForPath(normalizedPath: string): Session | null;
+    private cleanupSessionArtifacts;
+    clearSessionById(sessionId: string): Promise<Session>;
+    clearSessionsByPath(normalizedPath: string): Promise<string[]>;
+    clearAllSessions(): Promise<string[]>;
+    touch(session: Session): void;
+    markEdited(session: Session): void;
+    getDownloadCache(session: Session, cacheKey: string): DownloadCacheEntry | null;
+    setDownloadCache(session: Session, entry: DownloadCacheEntry): void;
+    getExtractionCache(session: Session): ExtractionCacheEntry | null;
+    setExtractionCache(session: Session, changes: ParagraphRevision[]): void;
+    saveTo(session: Session, savePath: string, opts?: {
+        cleanBookmarks?: boolean;
+    }): Promise<void>;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/session/manager.d.ts.map

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

package/dist/session/manager.js

@@ -0,0 +1,155 @@
+import { randomBytes } from 'node:crypto';
+import path from 'node:path';
+import os from 'node:os';
+import fs from 'node:fs/promises';
+import { DocxDocument, } from '@usejunior/docx-core';
+export class SessionManager {
+    sessions = new Map();
+    ttlMs;
+    static SESSION_ID_PATTERN = /^ses_[A-Za-z0-9]{12}$/;
+    constructor(opts) {
+        this.ttlMs = opts?.ttlMs ?? 60 * 60 * 1000;
+    }
+    expandPath(inputPath) {
+        return inputPath.startsWith('~')
+            ? path.join(process.env.HOME || '', inputPath.slice(1))
+            : inputPath;
+    }
+    normalizePath(inputPath) {
+        return path.resolve(this.expandPath(inputPath));
+    }
+    newSessionId() {
+        // Format: ses_[12 alphanumeric] (close enough: base64url chars).
+        const alphabet = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';
+        const bytes = randomBytes(12);
+        let out = '';
+        for (let i = 0; i < 12; i++) {
+            out += alphabet[bytes[i] % alphabet.length];
+        }
+        return `ses_${out}`;
+    }
+    async createSession(documentContent, filename, originalPath) {
+        const sessionId = this.newSessionId();
+        const dir = await fs.mkdtemp(path.join(os.tmpdir(), 'safe-docx-'));
+        const tmpPath = path.join(dir, filename);
+        // Ensure we pass an ArrayBufferView to satisfy Node's type signature across TS lib setups.
+        await fs.writeFile(tmpPath, new Uint8Array(documentContent));
+        const doc = await DocxDocument.load(documentContent);
+        const now = new Date();
+        const expiresAt = new Date(now.getTime() + this.ttlMs);
+        const session = {
+            sessionId,
+            filename,
+            tmpPath,
+            originalPath,
+            originalBuffer: Buffer.from(documentContent),
+            comparisonBaseline: null,
+            comparisonBaselineWithBookmarks: null,
+            doc,
+            editCount: 0,
+            editRevision: 0,
+            downloadCache: new Map(),
+            extractionCache: null,
+            createdAt: now,
+            lastAccessedAt: now,
+            expiresAt,
+            normalizationStats: null,
+        };
+        this.sessions.set(sessionId, session);
+        return session;
+    }
+    getSession(sessionId) {
+        if (!SessionManager.SESSION_ID_PATTERN.test(sessionId)) {
+            throw new Error(`INVALID_SESSION_ID:${sessionId}`);
+        }
+        const ses = this.sessions.get(sessionId);
+        if (!ses)
+            throw new Error(`SESSION_NOT_FOUND:${sessionId}`);
+        const now = Date.now();
+        if (ses.expiresAt.getTime() < now) {
+            this.sessions.delete(sessionId);
+            throw new Error(`SESSION_EXPIRED:${sessionId}`);
+        }
+        return ses;
+    }
+    listActiveSessionsForPath(normalizedPath) {
+        const now = Date.now();
+        const out = [];
+        for (const [sessionId, session] of this.sessions.entries()) {
+            if (session.expiresAt.getTime() < now) {
+                this.sessions.delete(sessionId);
+                continue;
+            }
+            if (this.normalizePath(session.originalPath) !== normalizedPath)
+                continue;
+            out.push(session);
+        }
+        out.sort((a, b) => b.lastAccessedAt.getTime() - a.lastAccessedAt.getTime());
+        return out;
+    }
+    getMostRecentlyUsedSessionForPath(normalizedPath) {
+        const sessionsForPath = this.listActiveSessionsForPath(normalizedPath);
+        return sessionsForPath[0] ?? null;
+    }
+    async cleanupSessionArtifacts(session) {
+        const tmpDir = path.dirname(session.tmpPath);
+        await fs.rm(tmpDir, { recursive: true, force: true }).catch(() => undefined);
+    }
+    async clearSessionById(sessionId) {
+        const session = this.getSession(sessionId);
+        this.sessions.delete(sessionId);
+        await this.cleanupSessionArtifacts(session);
+        return session;
+    }
+    async clearSessionsByPath(normalizedPath) {
+        const sessionsForPath = this.listActiveSessionsForPath(normalizedPath);
+        for (const session of sessionsForPath) {
+            this.sessions.delete(session.sessionId);
+        }
+        await Promise.all(sessionsForPath.map((session) => this.cleanupSessionArtifacts(session)));
+        return sessionsForPath.map((session) => session.sessionId);
+    }
+    async clearAllSessions() {
+        const allSessions = [...this.sessions.values()];
+        const clearedIds = allSessions.map((session) => session.sessionId);
+        this.sessions.clear();
+        await Promise.all(allSessions.map((session) => this.cleanupSessionArtifacts(session)));
+        return clearedIds;
+    }
+    touch(session) {
+        const now = new Date();
+        session.lastAccessedAt = now;
+        session.expiresAt = new Date(now.getTime() + this.ttlMs);
+    }
+    markEdited(session) {
+        session.editCount += 1;
+        session.editRevision += 1;
+        // Any edit creates a new canonical revision; previously generated artifacts
+        // are no longer current and should not be reused by default.
+        session.downloadCache.clear();
+        session.extractionCache = null;
+    }
+    getDownloadCache(session, cacheKey) {
+        return session.downloadCache.get(cacheKey) ?? null;
+    }
+    setDownloadCache(session, entry) {
+        session.downloadCache.set(entry.cacheKey, entry);
+    }
+    getExtractionCache(session) {
+        if (!session.extractionCache)
+            return null;
+        if (session.extractionCache.revision !== session.editRevision) {
+            session.extractionCache = null;
+            return null;
+        }
+        return session.extractionCache;
+    }
+    setExtractionCache(session, changes) {
+        session.extractionCache = { revision: session.editRevision, changes };
+    }
+    async saveTo(session, savePath, opts) {
+        const { buffer } = await session.doc.toBuffer({ cleanBookmarks: opts?.cleanBookmarks ?? true });
+        await fs.writeFile(savePath, new Uint8Array(buffer));
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/session/manager.js.map

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