@usejunior/docx-mcp 0.9.0 → 0.10.0

package/dist/tools/odf/grep.js

@@ -0,0 +1,81 @@
+import { errorMessage } from '../../error_utils.js';
+import { err, ok } from '../types.js';
+import { searchParagraphsCore, searchRawXmlCore } from '../grep_core.js';
+/**
+ * ODF (.odt) `grep`. Session-mode only — the dispatcher resolves the ODF session by
+ * `.odt` `file_path` before calling here (multi-file `file_paths` stays on the DOCX
+ * lane). ODF paragraphs carry no list-label / header context, so those fields are
+ * empty. Output shape mirrors the DOCX grep session response.
+ */
+export async function odfGrep(manager, session, params, metadata) {
+    try {
+        let patterns = params.patterns ?? [];
+        if (patterns.length === 0 && typeof params.pattern === 'string') {
+            patterns = [params.pattern];
+        }
+        if (patterns.length === 0) {
+            return err('MISSING_PATTERN', 'No search patterns provided.', 'Pass patterns: ["your search term"] (array of regex strings).');
+        }
+        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 searchXml = params.search_xml ?? false;
+        const patternStr = wholeWord ? `\\b(${patterns.join('|')})\\b` : `(${patterns.join('|')})`;
+        let re;
+        try {
+            re = new RegExp(patternStr, caseSensitive ? 'g' : 'gi');
+        }
+        catch (e) {
+            return ok({
+                file_path: session.originalPath,
+                provider: 'odf',
+                patterns,
+                total_matches: 0,
+                matches: [],
+                error: `Invalid regex pattern: ${errorMessage(e)}`,
+                ...metadata,
+            });
+        }
+        if (searchXml) {
+            const xmlResult = searchRawXmlCore(session.doc.toXml(), re, { maxResults, contextChars });
+            return ok({
+                file_path: session.originalPath,
+                provider: 'odf',
+                patterns,
+                search_xml: true,
+                total_matches: xmlResult.totalMatches,
+                matches: xmlResult.matches,
+                matches_returned: xmlResult.matches.length,
+                matches_truncated: xmlResult.matchesTruncated,
+                ...metadata,
+            });
+        }
+        const paragraphs = session.doc.getParagraphs();
+        const result = searchParagraphsCore(paragraphs, re, { maxResults, contextChars, dedupeByParagraph }, null);
+        const response = {
+            file_path: session.originalPath,
+            provider: 'odf',
+            patterns,
+            dedupe_by_paragraph: dedupeByParagraph,
+            total_matches: result.totalMatches,
+            paragraphs_with_matches: result.paragraphsWithMatches,
+            matches: result.matches,
+            matches_returned: result.matches.length,
+            max_results_applied: maxResults,
+            matches_truncated: result.matchesTruncated,
+            ...metadata,
+        };
+        if (result.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) {
+        return err('SEARCH_ERROR', `Failed to search ODF document: ${errorMessage(e)}`, 'Check patterns are valid regex and try again.');
+    }
+}
+//# sourceMappingURL=grep.js.map

package/dist/tools/odf/grep.js.map

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

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

@@ -0,0 +1,19 @@
+import { type OdfSession, SessionManager } from '../../session/manager.js';
+import { type ToolResponse } from '../types.js';
+/**
+ * ODF (.odt) `insert_paragraph`. Inserts plain-text paragraph(s) BEFORE/AFTER an anchor.
+ * `new_string` is split on blank lines into separate paragraphs; single newlines become
+ * line breaks (parity with the DOCX tool). DOCX run-formatting tags are not yet supported
+ * for ODF and are stripped.
+ *
+ * IMPORTANT: ODF paragraph IDs are positional ordinals, so inserting shifts every ID at or
+ * after the insertion point. The response carries machine-actionable invalidation fields so
+ * the agent re-reads before its next edit.
+ */
+export declare function odfInsertParagraph(manager: SessionManager, session: OdfSession, params: {
+    positional_anchor_node_id: string;
+    new_string: string;
+    instruction: string;
+    position?: string;
+}, metadata: Record<string, unknown>): Promise<ToolResponse>;
+//# sourceMappingURL=insert_paragraph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"insert_paragraph.d.ts","sourceRoot":"","sources":["../../../src/tools/odf/insert_paragraph.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG3E,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEzD;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE;IAAE,yBAAyB,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,EACzG,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,YAAY,CAAC,CAqCvB"}

package/dist/tools/odf/insert_paragraph.js

@@ -0,0 +1,50 @@
+import { stripAllInlineTags } from '@usejunior/docx-core';
+import { errorMessage } from '../../error_utils.js';
+import { RESULT_PREVIEW_CHARS, previewText } from '../preview.js';
+import { err, ok } from '../types.js';
+/**
+ * ODF (.odt) `insert_paragraph`. Inserts plain-text paragraph(s) BEFORE/AFTER an anchor.
+ * `new_string` is split on blank lines into separate paragraphs; single newlines become
+ * line breaks (parity with the DOCX tool). DOCX run-formatting tags are not yet supported
+ * for ODF and are stripped.
+ *
+ * IMPORTANT: ODF paragraph IDs are positional ordinals, so inserting shifts every ID at or
+ * after the insertion point. The response carries machine-actionable invalidation fields so
+ * the agent re-reads before its next edit.
+ */
+export async function odfInsertParagraph(manager, session, params, metadata) {
+    try {
+        const anchorId = params.positional_anchor_node_id;
+        const positionUpper = (params.position ?? 'AFTER').toUpperCase();
+        if (positionUpper !== 'BEFORE' && positionUpper !== 'AFTER') {
+            return err('INVALID_POSITION', `Invalid position: ${params.position}. Must be 'BEFORE' or 'AFTER'.`);
+        }
+        const text = stripAllInlineTags(params.new_string ?? '');
+        const result = session.doc.insertParagraph(anchorId, text, positionUpper);
+        if (!result.ok) {
+            return err(result.code, result.message);
+        }
+        manager.markEdited(session);
+        const newIds = result.newIds;
+        return ok({
+            success: true,
+            file_path: session.originalPath,
+            provider: 'odf',
+            edit_count: session.editCount,
+            anchor_paragraph_id: anchorId,
+            new_paragraph_id: newIds[0] ?? null,
+            new_paragraph_ids: newIds,
+            position: positionUpper,
+            inserted_text: previewText(text, RESULT_PREVIEW_CHARS),
+            // ODF IDs are positional; everything at/after the insertion point has shifted.
+            invalidates_paragraph_ids_after: anchorId,
+            requires_reread_before_next_edit: true,
+            ids_note: 'ODF paragraph IDs are positional and have shifted after this insertion. Call read_file or grep again to get current IDs before your next edit.',
+            ...metadata,
+        });
+    }
+    catch (e) {
+        return err('INSERT_ERROR', `Failed to insert paragraph into ODF document: ${errorMessage(e)}`);
+    }
+}
+//# sourceMappingURL=insert_paragraph.js.map

package/dist/tools/odf/insert_paragraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert_paragraph.js","sourceRoot":"","sources":["../../../src/tools/odf/insert_paragraph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,GAAG,EAAE,EAAE,EAAqB,MAAM,aAAa,CAAC;AAEzD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAuB,EACvB,OAAmB,EACnB,MAAyG,EACzG,QAAiC;IAEjC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,CAAC,yBAAyB,CAAC;QAClD,MAAM,aAAa,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QACjE,IAAI,aAAa,KAAK,QAAQ,IAAI,aAAa,KAAK,OAAO,EAAE,CAAC;YAC5D,OAAO,GAAG,CAAC,kBAAkB,EAAE,qBAAqB,MAAM,CAAC,QAAQ,gCAAgC,CAAC,CAAC;QACvG,CAAC;QAED,MAAM,IAAI,GAAG,kBAAkB,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;QAEzD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,QAAQ,EAAE,IAAI,EAAE,aAAmC,CAAC,CAAC;QAChG,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAE5B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC7B,OAAO,EAAE,CAAC;YACR,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,OAAO,CAAC,YAAY;YAC/B,QAAQ,EAAE,KAAK;YACf,UAAU,EAAE,OAAO,CAAC,SAAS;YAC7B,mBAAmB,EAAE,QAAQ;YAC7B,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI;YACnC,iBAAiB,EAAE,MAAM;YACzB,QAAQ,EAAE,aAAa;YACvB,aAAa,EAAE,WAAW,CAAC,IAAI,EAAE,oBAAoB,CAAC;YACtD,+EAA+E;YAC/E,+BAA+B,EAAE,QAAQ;YACzC,gCAAgC,EAAE,IAAI;YACtC,QAAQ,EACN,gJAAgJ;YAClJ,GAAG,QAAQ;SACZ,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,OAAO,GAAG,CAAC,cAAc,EAAE,iDAAiD,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACjG,CAAC;AACH,CAAC"}

package/dist/tools/odf/read_file.d.ts

@@ -0,0 +1,9 @@
+import { type OdfSession, SessionManager } from '../../session/manager.js';
+import { type ToolResponse } from '../types.js';
+export declare function odfReadFile(_manager: SessionManager, session: OdfSession, params: {
+    offset?: number;
+    limit?: number;
+    node_ids?: string[];
+    format?: string;
+}, metadata: Record<string, unknown>): Promise<ToolResponse>;
+//# sourceMappingURL=read_file.d.ts.map

package/dist/tools/odf/read_file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read_file.d.ts","sourceRoot":"","sources":["../../../src/tools/odf/read_file.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,UAAU,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAuCzD,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EACjF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,YAAY,CAAC,CA6DvB"}

package/dist/tools/odf/read_file.js

@@ -0,0 +1,124 @@
+import { formatToonDataLine, renderToon, } from '@usejunior/docx-core';
+import { err, ok } from '../types.js';
+import { buildPaginationMeta, DEFAULT_CONTENT_TOKEN_BUDGET, estimateTokens } from '../pagination.js';
+import { READ_SIMPLE_PREVIEW_CHARS, previewText } from '../preview.js';
+function odfParagraphsToDocumentViewNodes(session) {
+    return session.doc.getParagraphs().map((paragraph) => ({
+        id: paragraph.id,
+        list_label: '',
+        header: '',
+        style: 'body',
+        text: paragraph.text,
+        clean_text: paragraph.text,
+        tagged_text: paragraph.text,
+        list_metadata: {
+            list_level: -1,
+            label_type: null,
+            label_string: '',
+            header_text: null,
+            header_style: null,
+            header_formatting: null,
+            is_auto_numbered: false,
+        },
+        style_fingerprint: {
+            list_level: -1,
+            left_indent_pt: 0,
+            first_line_indent_pt: 0,
+            style_name: 'body',
+            alignment: 'LEFT',
+        },
+        paragraph_style_id: null,
+        paragraph_style_name: 'body',
+        paragraph_alignment: 'LEFT',
+        paragraph_indents_pt: { left: 0, first_line: 0 },
+        numbering: { num_id: null, ilvl: null, is_auto_numbered: false },
+        header_formatting: null,
+        body_run_formatting: null,
+    }));
+}
+export async function odfReadFile(_manager, session, params, metadata) {
+    try {
+        const format = (params.format ?? 'toon').toLowerCase();
+        if (format !== 'toon' && format !== 'json' && format !== 'simple') {
+            return err('INVALID_FORMAT', `Invalid format: ${params.format}`, "Use 'toon' (default), 'json', or 'simple'.");
+        }
+        const nodes = odfParagraphsToDocumentViewNodes(session);
+        const totalParagraphs = nodes.length;
+        const hasExplicitLimit = typeof params.limit === 'number';
+        const hasExplicitOffset = typeof params.offset === 'number';
+        const hasNodeIds = params.node_ids != null && params.node_ids.length > 0;
+        const budgetActive = !hasExplicitLimit && !hasExplicitOffset && !hasNodeIds;
+        let filtered = nodes;
+        let startIdx = 0;
+        if (hasNodeIds) {
+            const set = new Set(params.node_ids);
+            filtered = nodes.filter((n) => set.has(n.id));
+        }
+        else {
+            if (hasExplicitOffset) {
+                if (params.offset > 0)
+                    startIdx = Math.max(0, params.offset - 1);
+                if (params.offset < 0)
+                    startIdx = Math.max(0, totalParagraphs + params.offset);
+            }
+            const endIdx = hasExplicitLimit ? Math.min(totalParagraphs, startIdx + params.limit) : totalParagraphs;
+            filtered = nodes.slice(startIdx, endIdx);
+        }
+        let content;
+        let paragraphsReturned;
+        if (!budgetActive) {
+            if (format === 'json') {
+                content = JSON.stringify(filtered, null, 2);
+            }
+            else if (format === 'simple') {
+                content = renderSimpleOdf(filtered);
+            }
+            else {
+                content = renderToon(filtered);
+            }
+            paragraphsReturned = filtered.length;
+        }
+        else {
+            const result = renderToonWithBudgetOdf(filtered, DEFAULT_CONTENT_TOKEN_BUDGET);
+            content = result.content;
+            paragraphsReturned = result.count;
+        }
+        const paginationMeta = buildPaginationMeta(totalParagraphs, paragraphsReturned, startIdx);
+        return ok({
+            file_path: session.originalPath,
+            provider: 'odf',
+            content,
+            total_paragraphs: totalParagraphs,
+            paragraphs_returned: paragraphsReturned,
+            ...paginationMeta,
+            ...metadata,
+        });
+    }
+    catch (e) {
+        return err('READ_ERROR', e instanceof Error ? e.message : String(e), 'Check session status and try again.');
+    }
+}
+function renderSimpleOdf(nodes) {
+    const lines = ['#TOON id | text'];
+    for (const n of nodes) {
+        lines.push(`${n.id} | ${previewText(n.clean_text, READ_SIMPLE_PREVIEW_CHARS)}`);
+    }
+    return lines.join('\n');
+}
+// ODF Phase 1 flattens table cells to body paragraphs, so nodes never carry
+// `table_context`. The budget renderer therefore has no table-marker handling
+// (unlike the DOCX/gdocs renderers) — keeping it free of structurally-unreachable
+// branches.
+function renderToonWithBudgetOdf(nodes, budget) {
+    let accumulated = '#SCHEMA id | list_label | header | style | text';
+    let count = 0;
+    for (const node of nodes) {
+        const candidate = accumulated + '\n' + formatToonDataLine(node);
+        if (count > 0 && estimateTokens(candidate) > budget)
+            break;
+        accumulated = candidate;
+        count++;
+    }
+    return { content: accumulated, count };
+}
+//# sourceMappingURL=read_file.js.map

package/dist/tools/odf/read_file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read_file.js","sourceRoot":"","sources":["../../../src/tools/odf/read_file.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,UAAU,GAEX,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,GAAG,EAAE,EAAE,EAAqB,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,4BAA4B,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACrG,OAAO,EAAE,yBAAyB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEvE,SAAS,gCAAgC,CAAC,OAAmB;IAC3D,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,CAAC,SAAuC,EAAE,EAAE,CAAC,CAAC;QACnF,EAAE,EAAE,SAAS,CAAC,EAAE;QAChB,UAAU,EAAE,EAAE;QACd,MAAM,EAAE,EAAE;QACV,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,UAAU,EAAE,SAAS,CAAC,IAAI;QAC1B,WAAW,EAAE,SAAS,CAAC,IAAI;QAC3B,aAAa,EAAE;YACb,UAAU,EAAE,CAAC,CAAC;YACd,UAAU,EAAE,IAAI;YAChB,YAAY,EAAE,EAAE;YAChB,WAAW,EAAE,IAAI;YACjB,YAAY,EAAE,IAAI;YAClB,iBAAiB,EAAE,IAAI;YACvB,gBAAgB,EAAE,KAAK;SACxB;QACD,iBAAiB,EAAE;YACjB,UAAU,EAAE,CAAC,CAAC;YACd,cAAc,EAAE,CAAC;YACjB,oBAAoB,EAAE,CAAC;YACvB,UAAU,EAAE,MAAM;YAClB,SAAS,EAAE,MAAM;SAClB;QACD,kBAAkB,EAAE,IAAI;QACxB,oBAAoB,EAAE,MAAM;QAC5B,mBAAmB,EAAE,MAAM;QAC3B,oBAAoB,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE;QAChD,SAAS,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE;QAChE,iBAAiB,EAAE,IAAI;QACvB,mBAAmB,EAAE,IAAI;KAC1B,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAwB,EACxB,OAAmB,EACnB,MAAiF,EACjF,QAAiC;IAEjC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QACvD,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YAClE,OAAO,GAAG,CAAC,gBAAgB,EAAE,mBAAmB,MAAM,CAAC,MAAM,EAAE,EAAE,4CAA4C,CAAC,CAAC;QACjH,CAAC;QAED,MAAM,KAAK,GAAG,gCAAgC,CAAC,OAAO,CAAC,CAAC;QACxD,MAAM,eAAe,GAAG,KAAK,CAAC,MAAM,CAAC;QAErC,MAAM,gBAAgB,GAAG,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC;QAC1D,MAAM,iBAAiB,GAAG,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC;QAC5D,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,IAAI,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QACzE,MAAM,YAAY,GAAG,CAAC,gBAAgB,IAAI,CAAC,iBAAiB,IAAI,CAAC,UAAU,CAAC;QAE5E,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAS,CAAC,CAAC;YACtC,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAChD,CAAC;aAAM,CAAC;YACN,IAAI,iBAAiB,EAAE,CAAC;gBACtB,IAAI,MAAM,CAAC,MAAO,GAAG,CAAC;oBAAE,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,MAAO,GAAG,CAAC,CAAC,CAAC;gBACnE,IAAI,MAAM,CAAC,MAAO,GAAG,CAAC;oBAAE,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,eAAe,GAAG,MAAM,CAAC,MAAO,CAAC,CAAC;YACnF,CAAC;YACD,MAAM,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,QAAQ,GAAG,MAAM,CAAC,KAAM,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC;YACxG,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,OAAe,CAAC;QACpB,IAAI,kBAA0B,CAAC;QAE/B,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;gBACtB,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAC9C,CAAC;iBAAM,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC/B,OAAO,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;YACtC,CAAC;iBAAM,CAAC;gBACN,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;YACjC,CAAC;YACD,kBAAkB,GAAG,QAAQ,CAAC,MAAM,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,GAAG,uBAAuB,CAAC,QAAQ,EAAE,4BAA4B,CAAC,CAAC;YAC/E,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;YACzB,kBAAkB,GAAG,MAAM,CAAC,KAAK,CAAC;QACpC,CAAC;QAED,MAAM,cAAc,GAAG,mBAAmB,CAAC,eAAe,EAAE,kBAAkB,EAAE,QAAQ,CAAC,CAAC;QAE1F,OAAO,EAAE,CAAC;YACR,SAAS,EAAE,OAAO,CAAC,YAAY;YAC/B,QAAQ,EAAE,KAAK;YACf,OAAO;YACP,gBAAgB,EAAE,eAAe;YACjC,mBAAmB,EAAE,kBAAkB;YACvC,GAAG,cAAc;YACjB,GAAG,QAAQ;SACZ,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,OAAO,GAAG,CAAC,YAAY,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,qCAAqC,CAAC,CAAC;IAC9G,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,KAAkC;IACzD,MAAM,KAAK,GAAa,CAAC,iBAAiB,CAAC,CAAC;IAC5C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,WAAW,CAAC,CAAC,CAAC,UAAU,EAAE,yBAAyB,CAAC,EAAE,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,4EAA4E;AAC5E,8EAA8E;AAC9E,kFAAkF;AAClF,YAAY;AACZ,SAAS,uBAAuB,CAC9B,KAAkC,EAClC,MAAc;IAEd,IAAI,WAAW,GAAG,iDAAiD,CAAC;IACpE,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,WAAW,GAAG,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAChE,IAAI,KAAK,GAAG,CAAC,IAAI,cAAc,CAAC,SAAS,CAAC,GAAG,MAAM;YAAE,MAAM;QAC3D,WAAW,GAAG,SAAS,CAAC;QACxB,KAAK,EAAE,CAAC;IACV,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AACzC,CAAC"}

package/dist/tools/odf/replace_text.d.ts

@@ -0,0 +1,9 @@
+import { type OdfSession, SessionManager } from '../../session/manager.js';
+import { type ToolResponse } from '../types.js';
+export declare function odfReplaceText(manager: SessionManager, session: OdfSession, params: {
+    target_paragraph_id: string;
+    old_string: string;
+    new_string: string;
+    instruction: string;
+}, metadata: Record<string, unknown>): Promise<ToolResponse>;
+//# sourceMappingURL=replace_text.d.ts.map

package/dist/tools/odf/replace_text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace_text.d.ts","sourceRoot":"","sources":["../../../src/tools/odf/replace_text.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE3E,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEzD,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE;IAAE,mBAAmB,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EACpG,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,YAAY,CAAC,CAoCvB"}

package/dist/tools/odf/replace_text.js

@@ -0,0 +1,41 @@
+import { stripAllInlineTags } from '@usejunior/docx-core';
+import { RESULT_PREVIEW_CHARS, previewText } from '../preview.js';
+import { err, ok } from '../types.js';
+export async function odfReplaceText(manager, session, params, metadata) {
+    try {
+        const pid = params.target_paragraph_id;
+        const oldStr = stripAllInlineTags(params.old_string);
+        const newStr = stripAllInlineTags(params.new_string);
+        const beforeText = session.doc.getParagraphTextById(pid);
+        if (beforeText === null) {
+            return err('ANCHOR_NOT_FOUND', `Paragraph ID ${pid} not found in document`);
+        }
+        const result = session.doc.replaceTextById(pid, oldStr, newStr);
+        if (!result.ok) {
+            return err(result.code, result.message);
+        }
+        manager.markEdited(session);
+        const afterText = session.doc.getParagraphTextById(pid) ?? '';
+        return ok({
+            file_path: session.originalPath,
+            provider: 'odf',
+            edit_count: session.editCount,
+            target_paragraph_id: pid,
+            replacements_made: 1,
+            before_text: previewText(beforeText.trim(), RESULT_PREVIEW_CHARS),
+            after_text: previewText(afterText.trim(), RESULT_PREVIEW_CHARS),
+            ...metadata,
+        });
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        if (msg.includes('ANCHOR_NOT_FOUND'))
+            return err('ANCHOR_NOT_FOUND', msg);
+        if (msg.includes('TEXT_NOT_FOUND'))
+            return err('TEXT_NOT_FOUND', msg);
+        if (msg.includes('MATCH_SPANS_MULTIPLE_NODES'))
+            return err('MATCH_SPANS_MULTIPLE_NODES', msg);
+        return err('EDIT_ERROR', `Failed to edit ODF document: ${msg}`);
+    }
+}
+//# sourceMappingURL=replace_text.js.map

package/dist/tools/odf/replace_text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace_text.js","sourceRoot":"","sources":["../../../src/tools/odf/replace_text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,GAAG,EAAE,EAAE,EAAqB,MAAM,aAAa,CAAC;AAEzD,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAuB,EACvB,OAAmB,EACnB,MAAoG,EACpG,QAAiC;IAEjC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,CAAC,mBAAmB,CAAC;QACvC,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAErD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC;QACzD,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACxB,OAAO,GAAG,CAAC,kBAAkB,EAAE,gBAAgB,GAAG,wBAAwB,CAAC,CAAC;QAC9E,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAChE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAE5B,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAE9D,OAAO,EAAE,CAAC;YACR,SAAS,EAAE,OAAO,CAAC,YAAY;YAC/B,QAAQ,EAAE,KAAK;YACf,UAAU,EAAE,OAAO,CAAC,SAAS;YAC7B,mBAAmB,EAAE,GAAG;YACxB,iBAAiB,EAAE,CAAC;YACpB,WAAW,EAAE,WAAW,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,oBAAoB,CAAC;YACjE,UAAU,EAAE,WAAW,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,oBAAoB,CAAC;YAC/D,GAAG,QAAQ;SACZ,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACvD,IAAI,GAAG,CAAC,QAAQ,CAAC,kBAAkB,CAAC;YAAE,OAAO,GAAG,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;QAC1E,IAAI,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YAAE,OAAO,GAAG,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;QACtE,IAAI,GAAG,CAAC,QAAQ,CAAC,4BAA4B,CAAC;YAAE,OAAO,GAAG,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAC;QAC9F,OAAO,GAAG,CAAC,YAAY,EAAE,gCAAgC,GAAG,EAAE,CAAC,CAAC;IAClE,CAAC;AACH,CAAC"}

package/dist/tools/odf/save.d.ts

@@ -0,0 +1,7 @@
+import { type OdfSession, SessionManager } from '../../session/manager.js';
+import { type ToolResponse } from '../types.js';
+export declare function odfSave(manager: SessionManager, session: OdfSession, params: {
+    save_to_local_path?: string;
+    allow_overwrite?: boolean;
+}, metadata: Record<string, unknown>): Promise<ToolResponse>;
+//# sourceMappingURL=save.d.ts.map

package/dist/tools/odf/save.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save.d.ts","sourceRoot":"","sources":["../../../src/tools/odf/save.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,UAAU,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG3E,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAMzD,wBAAsB,OAAO,CAC3B,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE;IAAE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE,EAClE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,YAAY,CAAC,CA4CvB"}

package/dist/tools/odf/save.js

@@ -0,0 +1,48 @@
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { errorCode, errorMessage } from '../../error_utils.js';
+import { enforceWritePathPolicy, resolvesToSamePath } from '../path_policy.js';
+import { err, ok } from '../types.js';
+function expandPath(inputPath) {
+    return inputPath.startsWith('~') ? path.join(process.env.HOME || '', inputPath.slice(1)) : inputPath;
+}
+export async function odfSave(manager, session, params, metadata) {
+    const rawSavePath = typeof params.save_to_local_path === 'string' ? params.save_to_local_path.trim() : '';
+    if (!rawSavePath) {
+        return err('MISSING_SAVE_PATH', 'save requires save_to_local_path for ODF files.', 'Provide a writable .odt output path.');
+    }
+    try {
+        const savePath = expandPath(rawSavePath);
+        const allowOverwrite = params.allow_overwrite ?? false;
+        if (!allowOverwrite && await resolvesToSamePath(savePath, session.originalPath)) {
+            return err('OVERWRITE_BLOCKED', `Refusing to overwrite original file: ${savePath}`, 'Save to a different path, or set allow_overwrite=true if you explicitly want in-place overwrite.');
+        }
+        const writePolicy = await enforceWritePathPolicy(savePath);
+        if (!writePolicy.ok)
+            return writePolicy.response;
+        await fs.mkdir(path.dirname(savePath), { recursive: true });
+        const buffer = await manager.saveOdfTo(session, savePath);
+        manager.touch(session);
+        return ok({
+            file_path: manager.normalizePath(session.originalPath),
+            provider: 'odf',
+            original_filename: session.filename,
+            edit_count: session.editCount,
+            edit_revision: session.editRevision,
+            saved_to: savePath,
+            size_bytes: buffer.length,
+            save_format: 'odt',
+            returned_variants: ['odt'],
+            message: `ODF document saved to ${savePath}`,
+            ...metadata,
+        });
+    }
+    catch (e) {
+        const msg = errorMessage(e);
+        if (String(errorCode(e) ?? '').toUpperCase() === 'EACCES') {
+            return err('PERMISSION_DENIED', `Cannot write to: ${rawSavePath}`, 'Try saving to ~/Downloads/ or ~/Documents/ instead.');
+        }
+        return err('SAVE_ERROR', `Failed to save ODF document: ${msg}`, 'Check the path is valid and writable.');
+    }
+}
+//# sourceMappingURL=save.js.map

package/dist/tools/odf/save.js.map

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

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

@@ -1 +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,CA6DvB"}
+{"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;AAsCxD,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,CAsGvB"}

package/dist/tools/open_document.js

@@ -5,6 +5,7 @@ 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';
+import { loadOdfCore } from '../odf_loader.js';
 function getAvailableToolsSchema() {
     const toolDefaultsByName = {
         grep: { dedupe_by_paragraph: true },
@@ -37,8 +38,12 @@ export async function openDocument(manager, params) {
         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 extension = path.extname(expanded).toLowerCase();
+        if (extension !== '.docx' && extension !== '.odt') {
+            const hint = extension === '.dotx'
+                ? 'Only .docx and .odt files are supported in the local runtime. Convert the .dotx template to .docx before opening it.'
+                : 'Only .docx and .odt files are supported.';
+            return err('INVALID_FILE_TYPE', `Invalid file type: ${extension}`, hint);
         }
         const policy = await enforceReadPathPolicy(filePath);
         if (!policy.ok)
@@ -46,7 +51,38 @@ export async function openDocument(manager, params) {
         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).');
+            return err('VALIDATION_ERROR', 'File too large', 'Check file type (.docx or .odt only) and size (max 50MB).');
+        }
+        if (extension === '.odt') {
+            const odf = await loadOdfCore();
+            if (!odf) {
+                return err('MISSING_DEPENDENCY', 'ODF (.odt) support requires @usejunior/odf-core.', 'Install @usejunior/odf-core to enable ODF editing.');
+            }
+            const archiveGuard = await odf.validateOdfArchiveSafety(content);
+            if (!archiveGuard.ok)
+                return err(archiveGuard.code, archiveGuard.message, archiveGuard.hint);
+            const filename = path.basename(safePath);
+            const archive = await odf.OdfArchive.load(content);
+            const doc = odf.OdfDocument.fromContentXml(await archive.getContentXml());
+            const session = await manager.createOdfSession(content, filename, safePath, archive, doc);
+            const paragraphCount = session.doc.getParagraphs().length;
+            return ok({
+                file_path: manager.normalizePath(session.originalPath),
+                provider: 'odf',
+                expires_at: session.expiresAt.toISOString(),
+                document: {
+                    filename,
+                    paragraphs: paragraphCount,
+                    size_bytes: content.length,
+                },
+                normalization: { runs_merged: 0, redlines_simplified: 0, double_elevations_fixed: 0, normalization_skipped: true },
+                save_defaults: {
+                    default_variants: ['odt'],
+                    default_save_format: 'odt',
+                    supports_variant_override: false,
+                },
+                tools: getAvailableToolsSchema(),
+            });
         }
         const archiveGuard = await validateDocxArchiveSafety(content);
         if (!archiveGuard.ok)

package/dist/tools/open_document.js.map

@@ -1 +1 @@
-{"version":3,"file":"open_document.js","sourceRoot":"","sources":["../../src/tools/open_document.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAa,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,GAAG,EAAE,EAAE,EAAqB,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,SAAS,uBAAuB;IAM9B,MAAM,kBAAkB,GAA4C;QAClE,IAAI,EAAE,EAAE,mBAAmB,EAAE,IAAI,EAAE;QACnC,IAAI,EAAE;YACJ,WAAW,EAAE,MAAM;YACnB,eAAe,EAAE,IAAI;YACrB,iBAAiB,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC;SACxC;KACF,CAAC;IAEF,OAAO,mBAAmB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACtC,MAAM,UAAU,GAAG,wBAAwB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC9D,MAAM,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,OAAO,QAAQ;YACb,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE;YAC1E,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,CAAC;IACrE,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,wBAAwB,CAAC,WAAoC;IACpE,MAAM,aAAa,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;IAChD,IAAI,CAAC,aAAa,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QACxF,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAuB,EACvB,MAA2D;IAE3D,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC;IAClC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAEjD,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YAC5B,OAAO,GAAG,CACR,gBAAgB,EAChB,mBAAmB,QAAQ,EAAE,EAC7B,2EAA2E,CAC5E,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,KAAK,OAAO,EAAE,CAAC;YACrD,OAAO,GAAG,CAAC,mBAAmB,EAAE,sBAAsB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,iCAAiC,CAAC,CAAC;QACrH,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QACrD,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,MAAM,CAAC,QAAQ,CAAC;QACvC,MAAM,QAAQ,GAAG,MAAM,CAAC,cAAc,CAAC;QAEvC,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;YACtC,OAAO,GAAG,CAAC,kBAAkB,EAAE,gBAAgB,EAAE,mDAAmD,CAAC,CAAC;QACxG,CAAC;QACD,MAAM,YAAY,GAAG,MAAM,yBAAyB,CAAC,OAAiB,CAAC,CAAC;QACxE,IAAI,CAAC,YAAY,CAAC,EAAE;YAAE,OAAO,YAAY,CAAC,QAAQ,CAAC;QAEnD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,OAAiB,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAEnF,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,OAAO,CAAC,kBAAkB,CAAC,OAAO,EAAE;YACnE,iBAAiB,EAAE,MAAM,CAAC,kBAAkB;SAC7C,CAAC,CAAC;QAEH,OAAO,EAAE,CAAC;YACR,SAAS,EAAE,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,YAAY,CAAC;YACtD,UAAU,EAAE,OAAO,CAAC,SAAS,CAAC,WAAW,EAAE;YAC3C,QAAQ,EAAE;gBACR,QAAQ;gBACR,UAAU,EAAE,cAAc;gBAC1B,UAAU,EAAE,OAAO,CAAC,MAAM;aAC3B;YACD,aAAa,EAAE,OAAO,CAAC,kBAAkB;gBACvC,CAAC,CAAC;oBACE,WAAW,EAAE,OAAO,CAAC,kBAAkB,CAAC,UAAU;oBAClD,oBAAoB,EAAE,OAAO,CAAC,kBAAkB,CAAC,eAAe;oBAChE,mBAAmB,EAAE,OAAO,CAAC,kBAAkB,CAAC,oBAAoB;oBACpE,uBAAuB,EAAE,OAAO,CAAC,kBAAkB,CAAC,qBAAqB;oBACzE,qBAAqB,EAAE,KAAK;iBAC7B;gBACH,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,mBAAmB,EAAE,CAAC,EAAE,uBAAuB,EAAE,CAAC,EAAE,qBAAqB,EAAE,IAAI,EAAE;YACvG,aAAa,EAAE;gBACb,gBAAgB,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC;gBACtC,mBAAmB,EAAE,MAAM;gBAC3B,yBAAyB,EAAE,IAAI;aAChC;YACD,KAAK,EAAE,uBAAuB,EAAE;SACjC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,OAAO,GAAG,CAAC,iBAAiB,EAAE,wBAAwB,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,yCAAyC,CAAC,CAAC;IACtH,CAAC;AACH,CAAC"}
+{"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

@@ -8,6 +8,15 @@ export type PathPolicyOutcome = {
     ok: false;
     response: ToolResponse;
 };
+export declare function canonicalizePath(inputPath: string): Promise<string>;
+/**
+ * True when two paths resolve to the same filesystem location. Canonicalizes both via realpath (with a
+ * lexical fallback for paths that do not exist yet) so a symlink can't disguise a clobber of an input
+ * document behind a different-looking output path. Shared source-clobber guard for the write tools
+ * (issue #313); folded out of the export-local guard so all write tools enforce it identically.
+ */
+export declare function resolvesToSamePath(a: string, b: string): Promise<boolean>;
+export declare function getPlatformTempDefaults(platform?: NodeJS.Platform): string[];
 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

@@ -1 +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"}
+{"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;AAUN,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOzE;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE/E;AAQD,wBAAgB,uBAAuB,CAAC,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAAG,MAAM,EAAE,CAI9F;AAoGD,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"}