@usejunior/docx-mcp 0.0.1 → 0.1.2

package/dist/tools/grep.js

@@ -0,0 +1,129 @@
+import { errorMessage } from "../error_utils.js";
+import { err, ok } from './types.js';
+import { mergeSessionResolutionMetadata, resolveSessionForTool } from './session_resolution.js';
+export async function grep(manager, params) {
+    try {
+        const resolved = await resolveSessionForTool(manager, params, { toolName: 'grep' });
+        if (!resolved.ok)
+            return resolved.response;
+        const { session, metadata } = resolved;
+        const patterns = params.patterns ?? [];
+        const caseSensitive = params.case_sensitive ?? false;
+        const wholeWord = params.whole_word ?? false;
+        const maxResults = params.max_results ?? 100;
+        const contextChars = params.context_chars ?? 50;
+        const dedupeByParagraph = params.dedupe_by_paragraph ?? true;
+        const patternStr = wholeWord ? `\\b(${patterns.join('|')})\\b` : `(${patterns.join('|')})`;
+        let re;
+        try {
+            re = new RegExp(patternStr, caseSensitive ? 'g' : 'gi');
+        }
+        catch (e) {
+            // Mirror Python behavior: return success but include an error in payload.
+            return ok(mergeSessionResolutionMetadata({
+                session_id: session.sessionId,
+                patterns,
+                dedupe_by_paragraph: dedupeByParagraph,
+                total_matches: 0,
+                paragraphs_with_matches: 0,
+                matches: [],
+                error: `Invalid regex pattern: ${errorMessage(e)}`,
+            }, metadata));
+        }
+        const { paragraphs } = session.doc.readParagraphs();
+        const typed = paragraphs;
+        const { nodes } = session.doc.buildDocumentView({ includeSemanticTags: true });
+        const locatorById = new Map(nodes.map((n) => [n.id, { list_label: n.list_label ?? '', header: n.header ?? '' }]));
+        const matches = [];
+        const paragraphsWithMatches = new Set();
+        let totalMatches = 0;
+        let matchesTruncated = false;
+        for (let paraIndex = 0; paraIndex < typed.length; paraIndex += 1) {
+            const p = typed[paraIndex];
+            re.lastIndex = 0;
+            const text = p.text;
+            let m;
+            let paragraphMatchCount = 0;
+            let firstMatchText = '';
+            let firstMatchIndex = -1;
+            // eslint-disable-next-line no-cond-assign
+            while ((m = re.exec(text)) !== null) {
+                totalMatches += 1;
+                paragraphMatchCount += 1;
+                if (firstMatchIndex === -1) {
+                    firstMatchText = m[0];
+                    firstMatchIndex = m.index;
+                }
+                if (!dedupeByParagraph) {
+                    if (matches.length < maxResults) {
+                        const start = Math.max(0, m.index - contextChars);
+                        const end = Math.min(text.length, m.index + m[0].length + contextChars);
+                        const before = text.slice(start, m.index);
+                        const after = text.slice(m.index + m[0].length, end);
+                        const locator = locatorById.get(p.id) ?? { list_label: '', header: '' };
+                        matches.push({
+                            para_id: p.id,
+                            para_index_1based: paraIndex + 1,
+                            list_label: locator.list_label,
+                            header: locator.header,
+                            match_count_in_paragraph: 1,
+                            match_text: m[0],
+                            context: `...${before}>>>${m[0]}<<<${after}...`,
+                        });
+                    }
+                    else {
+                        matchesTruncated = true;
+                    }
+                }
+                if (m[0].length === 0)
+                    break; // safety for zero-length regex
+            }
+            if (paragraphMatchCount > 0) {
+                paragraphsWithMatches.add(p.id);
+                if (dedupeByParagraph) {
+                    if (matches.length < maxResults) {
+                        const start = Math.max(0, firstMatchIndex - contextChars);
+                        const end = Math.min(text.length, firstMatchIndex + firstMatchText.length + contextChars);
+                        const before = text.slice(start, firstMatchIndex);
+                        const after = text.slice(firstMatchIndex + firstMatchText.length, end);
+                        const locator = locatorById.get(p.id) ?? { list_label: '', header: '' };
+                        matches.push({
+                            para_id: p.id,
+                            para_index_1based: paraIndex + 1,
+                            list_label: locator.list_label,
+                            header: locator.header,
+                            match_count_in_paragraph: paragraphMatchCount,
+                            match_text: firstMatchText,
+                            context: `...${before}>>>${firstMatchText}<<<${after}...`,
+                        });
+                    }
+                    else {
+                        matchesTruncated = true;
+                    }
+                }
+            }
+        }
+        const response = mergeSessionResolutionMetadata({
+            session_id: session.sessionId,
+            patterns,
+            dedupe_by_paragraph: dedupeByParagraph,
+            total_matches: totalMatches,
+            paragraphs_with_matches: paragraphsWithMatches.size,
+            matches,
+            matches_returned: matches.length,
+            max_results_applied: maxResults,
+            matches_truncated: matchesTruncated,
+        }, metadata);
+        if (matchesTruncated) {
+            response.truncation_note = dedupeByParagraph
+                ? 'max_results limits returned rows to matching paragraphs while total_matches counts all regex hits. Increase max_results or set dedupe_by_paragraph=false for per-match rows.'
+                : 'max_results limits returned rows to individual matches while total_matches counts all regex hits. Increase max_results to see more matches.';
+        }
+        return ok(response);
+    }
+    catch (e) {
+        const msg = errorMessage(e);
+        return err('SEARCH_ERROR', `Failed to search document: ${msg}`, 'Check patterns are valid regex and try again.');
+    }
+}
+//# sourceMappingURL=grep.js.map

package/dist/tools/grep.js.map

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

package/dist/tools/has_tracked_changes.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"has_tracked_changes.d.ts","sourceRoot":"","sources":["../../src/tools/has_tracked_changes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AA4ExD,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAClD,OAAO,CAAC,YAAY,CAAC,CAmBvB"}

package/dist/tools/has_tracked_changes.js

@@ -0,0 +1,74 @@
+import { errorMessage } from "../error_utils.js";
+import { mergeSessionResolutionMetadata, resolveSessionForTool } from './session_resolution.js';
+import { err, ok } from './types.js';
+const W_NS = 'http://schemas.openxmlformats.org/wordprocessingml/2006/main';
+const TRACKED_CHANGE_LOCALS = ['ins', 'del', 'moveFrom', 'moveTo'];
+const PROPERTY_CHANGE_LOCALS = [
+    'rPrChange', 'pPrChange', 'sectPrChange',
+    'tblPrChange', 'trPrChange', 'tcPrChange',
+];
+function countMarkers(doc) {
+    const body = doc.getElementsByTagNameNS(W_NS, 'body').item(0);
+    if (!body) {
+        return {
+            total_markers: 0,
+            content_markers: 0,
+            property_markers: 0,
+            insertions: 0,
+            deletions: 0,
+            move_from: 0,
+            move_to: 0,
+            rpr_changes: 0,
+            ppr_changes: 0,
+            sectpr_changes: 0,
+            tblpr_changes: 0,
+            trpr_changes: 0,
+            tcpr_changes: 0,
+        };
+    }
+    const countByLocal = (localName) => body.getElementsByTagNameNS(W_NS, localName).length;
+    const contentCounts = {
+        insertions: countByLocal(TRACKED_CHANGE_LOCALS[0]),
+        deletions: countByLocal(TRACKED_CHANGE_LOCALS[1]),
+        move_from: countByLocal(TRACKED_CHANGE_LOCALS[2]),
+        move_to: countByLocal(TRACKED_CHANGE_LOCALS[3]),
+    };
+    const propertyCounts = {
+        rpr_changes: countByLocal(PROPERTY_CHANGE_LOCALS[0]),
+        ppr_changes: countByLocal(PROPERTY_CHANGE_LOCALS[1]),
+        sectpr_changes: countByLocal(PROPERTY_CHANGE_LOCALS[2]),
+        tblpr_changes: countByLocal(PROPERTY_CHANGE_LOCALS[3]),
+        trpr_changes: countByLocal(PROPERTY_CHANGE_LOCALS[4]),
+        tcpr_changes: countByLocal(PROPERTY_CHANGE_LOCALS[5]),
+    };
+    const content_markers = Object.values(contentCounts).reduce((sum, value) => sum + value, 0);
+    const property_markers = Object.values(propertyCounts).reduce((sum, value) => sum + value, 0);
+    return {
+        total_markers: content_markers + property_markers,
+        content_markers,
+        property_markers,
+        ...contentCounts,
+        ...propertyCounts,
+    };
+}
+export async function hasTrackedChanges_tool(manager, params) {
+    try {
+        const resolved = await resolveSessionForTool(manager, params, { toolName: 'has_tracked_changes' });
+        if (!resolved.ok)
+            return resolved.response;
+        const { session, metadata } = resolved;
+        const docClone = session.doc.getDocumentXmlClone();
+        const marker_stats = countMarkers(docClone);
+        return ok(mergeSessionResolutionMetadata({
+            session_id: session.sessionId,
+            edit_revision: session.editRevision,
+            has_tracked_changes: marker_stats.total_markers > 0,
+            scope: 'document_body',
+            marker_stats,
+        }, metadata));
+    }
+    catch (e) {
+        return err('TRACKED_CHANGES_CHECK_ERROR', errorMessage(e));
+    }
+}
+//# sourceMappingURL=has_tracked_changes.js.map

package/dist/tools/has_tracked_changes.js.map

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

package/dist/tools/init_plan.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"init_plan.d.ts","sourceRoot":"","sources":["../../src/tools/init_plan.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAmBxD,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE;IACN,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GACA,OAAO,CAAC,YAAY,CAAC,CAsBvB"}

package/dist/tools/init_plan.js

@@ -0,0 +1,44 @@
+import { randomBytes } from 'node:crypto';
+import { errorMessage } from "../error_utils.js";
+import { err, ok } from './types.js';
+import { mergeSessionResolutionMetadata, resolveSessionForTool } from './session_resolution.js';
+function createPlanContextId() {
+    const alphabet = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';
+    const bytes = randomBytes(12);
+    let suffix = '';
+    for (let i = 0; i < 12; i += 1) {
+        suffix += alphabet[bytes[i] % alphabet.length];
+    }
+    return `plctx_${suffix}`;
+}
+function optionalString(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+export async function initPlan(manager, params) {
+    try {
+        const resolved = await resolveSessionForTool(manager, params, { toolName: 'init_plan' });
+        if (!resolved.ok)
+            return resolved.response;
+        const { session, metadata } = resolved;
+        return ok(mergeSessionResolutionMetadata({
+            plan_context_id: createPlanContextId(),
+            session_id: session.sessionId,
+            base_revision: session.editRevision,
+            edit_count: session.editCount,
+            created_at: new Date().toISOString(),
+            plan_context: {
+                plan_name: optionalString(params.plan_name) ?? null,
+                orchestrator_id: optionalString(params.orchestrator_id) ?? null,
+                document_filename: session.filename,
+            },
+        }, metadata));
+    }
+    catch (e) {
+        const msg = errorMessage(e);
+        return err('PLAN_INIT_ERROR', `Failed to initialize plan context: ${msg}`);
+    }
+}
+//# sourceMappingURL=init_plan.js.map

package/dist/tools/init_plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init_plan.js","sourceRoot":"","sources":["../../src/tools/init_plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAa,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,EAAE,GAAG,EAAE,EAAE,EAAqB,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,8BAA8B,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhG,SAAS,mBAAmB;IAC1B,MAAM,QAAQ,GAAG,gEAAgE,CAAC;IAClF,MAAM,KAAK,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;IAC9B,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,SAAS,MAAM,EAAE,CAAC;AAC3B,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,OAAuB,EACvB,MAKC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;QACzF,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,OAAO,QAAQ,CAAC,QAAQ,CAAC;QAC3C,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC;QAEvC,OAAO,EAAE,CAAC,8BAA8B,CAAC;YACvC,eAAe,EAAE,mBAAmB,EAAE;YACtC,UAAU,EAAE,OAAO,CAAC,SAAS;YAC7B,aAAa,EAAE,OAAO,CAAC,YAAY;YACnC,UAAU,EAAE,OAAO,CAAC,SAAS;YAC7B,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,YAAY,EAAE;gBACZ,SAAS,EAAE,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,IAAI;gBACnD,eAAe,EAAE,cAAc,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,IAAI;gBAC/D,iBAAiB,EAAE,OAAO,CAAC,QAAQ;aACpC;SACF,EAAE,QAAQ,CAAC,CAAC,CAAC;IAChB,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;QAC5B,OAAO,GAAG,CAAC,iBAAiB,EAAE,sCAAsC,GAAG,EAAE,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC"}

package/dist/tools/insert_paragraph.d.ts

@@ -0,0 +1,12 @@
+import { SessionManager } from '../session/manager.js';
+import { type ToolResponse } from './types.js';
+export declare function insertParagraph(manager: SessionManager, params: {
+    session_id?: string;
+    file_path?: string;
+    positional_anchor_node_id: string;
+    new_string: string;
+    instruction: string;
+    position?: string;
+    style_source_id?: string;
+}): Promise<ToolResponse>;
+//# sourceMappingURL=insert_paragraph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"insert_paragraph.d.ts","sourceRoot":"","sources":["../../src/tools/insert_paragraph.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,cAAc,EAAgB,MAAM,uBAAuB,CAAC;AAErE,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAidxD,wBAAsB,eAAe,CACnC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE;IACN,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yBAAyB,EAAE,MAAM,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GACA,OAAO,CAAC,YAAY,CAAC,CAoGvB"}