@usejunior/docx-mcp 0.9.1 → 0.10.0

package/dist/tools/insert_paragraph.d.ts

@@ -1,3 +1,4 @@
+import { type RevisionContext } from '@usejunior/docx-core';
 import { SessionManager } from '../session/manager.js';
 import { type ToolResponse } from './types.js';
 export declare function insertParagraph(manager: SessionManager, params: {
@@ -8,5 +9,5 @@ export declare function insertParagraph(manager: SessionManager, params: {
     position?: string;
     style_source_id?: string;
     target_style?: string;
-}): Promise<ToolResponse>;
+}, ctx?: RevisionContext): Promise<ToolResponse>;
 //# sourceMappingURL=insert_paragraph.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"insert_paragraph.d.ts","sourceRoot":"","sources":["../../src/tools/insert_paragraph.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,cAAc,EAAoB,MAAM,uBAAuB,CAAC;AAEzE,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAsGxD,wBAAsB,eAAe,CACnC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE;IACN,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;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GACA,OAAO,CAAC,YAAY,CAAC,CA6FvB"}
+{"version":3,"file":"insert_paragraph.d.ts","sourceRoot":"","sources":["../../src/tools/insert_paragraph.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,eAAe,EAIrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAkD,MAAM,uBAAuB,CAAC;AAEvG,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAsGxD,wBAAsB,eAAe,CACnC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE;IACN,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;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,EACD,GAAG,CAAC,EAAE,eAAe,GACpB,OAAO,CAAC,YAAY,CAAC,CA8FvB"}

package/dist/tools/insert_paragraph.js

@@ -1,4 +1,5 @@
 import { getParagraphRuns, hasHyperlinkTags, stripHyperlinkTags, stripAllInlineTags, } from '@usejunior/docx-core';
+import { getRevisionContextForSession } from '../session/manager.js';
 import { errorMessage } from "../error_utils.js";
 import { err, ok } from './types.js';
 import { RESULT_PREVIEW_CHARS, previewText } from './preview.js';
@@ -85,12 +86,13 @@ function buildReplacementPartsForInsert(segments, templateRun, headerAddProps) {
     }
     return parts.some((p) => !!p.addRunProps) ? parts : null;
 }
-export async function insertParagraph(manager, params) {
+export async function insertParagraph(manager, params, ctx) {
     try {
         const resolved = await resolveSessionForTool(manager, params, { toolName: 'insert_paragraph' });
         if (!resolved.ok)
             return resolved.response;
         const { session, metadata } = resolved;
+        const revisionCtx = ctx ?? await getRevisionContextForSession(session);
         const positionUpper = (params.position ?? 'AFTER').toUpperCase();
         if (positionUpper !== 'BEFORE' && positionUpper !== 'AFTER') {
             return err('INVALID_POSITION', `Invalid position: ${params.position}. Must be 'BEFORE' or 'AFTER'.`);
@@ -136,7 +138,7 @@ export async function insertParagraph(manager, params) {
             relativePosition: positionUpper,
             newText: plainParagraphs.join('\n\n'),
             styleSourceId: styleSourceId,
-        });
+        }, revisionCtx);
         const needsHeaderRoleModel = parsedParagraphs.some((segs) => segs.some((s) => s.header));
         const headerAddProps = needsHeaderRoleModel
             ? findHeaderRoleModelAddRunProps(session, params.positional_anchor_node_id)

package/dist/tools/insert_paragraph.js.map

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

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

@@ -0,0 +1,21 @@
+import { type OdfSession, SessionManager } from '../../session/manager.js';
+import { type ToolResponse } from '../types.js';
+/**
+ * ODF (.odt) `add_comment`. Inserts an `office:annotation` either over the whole anchor paragraph
+ * (no `anchor_text`) or bracketing a substring (`anchor_text`). Mirrors the DOCX tool's param and
+ * response shapes.
+ *
+ * Replies (`parent_comment_id`) are NOT supported for ODF — ODF has no first-class reply graph, so a
+ * reply request returns `UNSUPPORTED_FOR_ODF` (a documented Phase-2b limitation). Annotations are
+ * inline children, so positional paragraph IDs do not shift; no ID-invalidation fields are emitted.
+ */
+export declare function odfAddComment(manager: SessionManager, session: OdfSession, params: {
+    file_path?: string;
+    target_paragraph_id?: string;
+    anchor_text?: string;
+    parent_comment_id?: number;
+    author: string;
+    text: string;
+    initials?: string;
+}, metadata: Record<string, unknown>): Promise<ToolResponse>;
+//# sourceMappingURL=add_comment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"add_comment.d.ts","sourceRoot":"","sources":["../../../src/tools/odf/add_comment.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE3E,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEzD;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE;IACN,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,EACD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,YAAY,CAAC,CA0EvB"}

package/dist/tools/odf/add_comment.js

@@ -0,0 +1,64 @@
+import { findUniqueSubstringMatch } from '@usejunior/docx-core';
+import { errorMessage } from '../../error_utils.js';
+import { err, ok } from '../types.js';
+/**
+ * ODF (.odt) `add_comment`. Inserts an `office:annotation` either over the whole anchor paragraph
+ * (no `anchor_text`) or bracketing a substring (`anchor_text`). Mirrors the DOCX tool's param and
+ * response shapes.
+ *
+ * Replies (`parent_comment_id`) are NOT supported for ODF — ODF has no first-class reply graph, so a
+ * reply request returns `UNSUPPORTED_FOR_ODF` (a documented Phase-2b limitation). Annotations are
+ * inline children, so positional paragraph IDs do not shift; no ID-invalidation fields are emitted.
+ */
+export async function odfAddComment(manager, session, params, metadata) {
+    try {
+        if (params.parent_comment_id != null) {
+            return err('UNSUPPORTED_FOR_ODF', 'Comment replies are not supported for ODF (.odt) files.', 'ODF has no first-class reply graph; add a new root comment with target_paragraph_id instead.');
+        }
+        if (!params.target_paragraph_id) {
+            return err('MISSING_PARAMETER', 'target_paragraph_id is required for ODF comments.', 'Provide target_paragraph_id (and optional anchor_text) to anchor the comment.');
+        }
+        const pid = params.target_paragraph_id;
+        const paraText = session.doc.getParagraphTextById(pid);
+        if (paraText == null) {
+            return err('ANCHOR_NOT_FOUND', `Paragraph ID ${pid} not found in document`, 'Use grep or read_file to find valid paragraph IDs.');
+        }
+        let range = {};
+        if (params.anchor_text) {
+            const match = findUniqueSubstringMatch(paraText, params.anchor_text);
+            if (match.status === 'not_found') {
+                return err('TEXT_NOT_FOUND', `anchor_text '${params.anchor_text}' not found in paragraph ${pid}`, 'Verify anchor_text is present in the target paragraph.');
+            }
+            if (match.status === 'multiple') {
+                return err('MULTIPLE_MATCHES', `Found ${match.matchCount} matches for anchor_text in paragraph ${pid}`, 'Provide more specific anchor_text for a unique match.');
+            }
+            range = { start: match.start, end: match.end };
+        }
+        const result = session.doc.addComment({
+            paragraphId: pid,
+            ...range,
+            author: params.author,
+            text: params.text,
+            initials: params.initials,
+        });
+        if (!result.ok) {
+            return err(result.code, result.message);
+        }
+        manager.markEdited(session);
+        return ok({
+            success: true,
+            comment_id: result.commentId,
+            anchor_paragraph_id: pid,
+            anchor_text: params.anchor_text ?? null,
+            mode: 'root',
+            provider: 'odf',
+            file_path: session.originalPath,
+            edit_count: session.editCount,
+            ...metadata,
+        });
+    }
+    catch (e) {
+        return err('COMMENT_ERROR', `Failed to add comment to ODF document: ${errorMessage(e)}`);
+    }
+}
+//# sourceMappingURL=add_comment.js.map

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

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

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

@@ -0,0 +1,4 @@
+import { type OdfSession, SessionManager } from '../../session/manager.js';
+import { type ToolResponse } from '../types.js';
+export declare function odfCloseFile(manager: SessionManager, session: OdfSession, _params: Record<string, unknown>, _metadata: Record<string, unknown>): Promise<ToolResponse>;
+//# sourceMappingURL=close_file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"close_file.d.ts","sourceRoot":"","sources":["../../../src/tools/odf/close_file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEzD,wBAAsB,YAAY,CAChC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,YAAY,CAAC,CAYvB"}

package/dist/tools/odf/close_file.js

@@ -0,0 +1,16 @@
+import { err, ok } from '../types.js';
+export async function odfCloseFile(manager, session, _params, _metadata) {
+    try {
+        const cleared = await manager.clearSessionByPath(session.originalPath);
+        return ok({
+            clear_mode: 'file_path',
+            file_path: cleared ?? session.originalPath,
+            cleared_file_paths: cleared ? [cleared] : [],
+            cleared_count: cleared ? 1 : 0,
+        });
+    }
+    catch (e) {
+        return err('CLOSE_FILE_ERROR', `Failed to close ODF session: ${e instanceof Error ? e.message : String(e)}`);
+    }
+}
+//# sourceMappingURL=close_file.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"close_file.js","sourceRoot":"","sources":["../../../src/tools/odf/close_file.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,EAAE,EAAqB,MAAM,aAAa,CAAC;AAEzD,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAuB,EACvB,OAAmB,EACnB,OAAgC,EAChC,SAAkC;IAElC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACvE,OAAO,EAAE,CAAC;YACR,UAAU,EAAE,WAAW;YACvB,SAAS,EAAE,OAAO,IAAI,OAAO,CAAC,YAAY;YAC1C,kBAAkB,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE;YAC5C,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SAC/B,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,OAAO,GAAG,CAAC,kBAAkB,EAAE,gCAAgC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/G,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,39 @@
+import { type OdfSession, SessionManager } from '../../session/manager.js';
+import { type ToolResponse } from '../types.js';
+/**
+ * ODF `compare_documents` — inline granularity (issue #356), TWO-FILE mode.
+ *
+ * Stateless (mirrors the DOCX `compareDocuments_tool`): it does its own loading and takes no
+ * resolved session, because two-file compare carries no `file_path` and so cannot route through
+ * `resolveOdfSessionForTool` (which requires one). Session-mode `.odt` compare routes through
+ * `dispatchOdf` to `odfCompareDocumentsSession` below.
+ */
+export declare function odfCompareDocuments(manager: SessionManager, params: {
+    original_file_path?: string;
+    revised_file_path?: string;
+    file_path?: string;
+    save_to_local_path?: string;
+    author?: string;
+}): Promise<ToolResponse>;
+/**
+ * ODF `compare_documents` — SESSION mode: redline the live session's edits against the original
+ * the session was opened from.
+ *
+ * Both the baseline and the redline package come from a FRESH archive loaded off
+ * `session.originalBuffer`, never from `session.archive`: `SessionManager.saveOdfTo` stamps the
+ * live archive's `content.xml` with the edited state on every save (so it is not a valid baseline
+ * source), and writing redline markup into it would poison the session. The raw original
+ * `content.xml` needs no normalization as a baseline because `compareOdf` diffs per-block visible
+ * text, which a parse→serialize round-trip does not alter.
+ *
+ * Packaging the redline on the original package is valid under a CURRENT invariant: ODF session
+ * edit tools mutate `content.xml` only (the same premise `saveOdfTo` rests on). If a future ODF
+ * tool mutates non-content parts (styles.xml, manifest, …), session compare must switch to a
+ * revised-session package baseline or copy those modified parts.
+ */
+export declare function odfCompareDocumentsSession(manager: SessionManager, session: OdfSession, params: {
+    file_path?: string;
+    save_to_local_path?: string;
+    author?: string;
+}, metadata: Record<string, unknown>): Promise<ToolResponse>;
+//# sourceMappingURL=compare_documents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compare_documents.d.ts","sourceRoot":"","sources":["../../../src/tools/odf/compare_documents.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,UAAU,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAK3E,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAczD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE;IACN,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GACA,OAAO,CAAC,YAAY,CAAC,CA+EvB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE;IACN,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,EACD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,YAAY,CAAC,CAgEvB"}

package/dist/tools/odf/compare_documents.js

@@ -0,0 +1,156 @@
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { errorCode, errorMessage } from '../../error_utils.js';
+import { loadOdfCore } from '../../odf_loader.js';
+import { enforceWritePathPolicy, resolvesToSamePath } from '../path_policy.js';
+import { validateAndLoadOdfFromPath } from '../session_resolution.js';
+import { err, ok } from '../types.js';
+function expandPath(inputPath) {
+    return inputPath.startsWith('~') ? path.join(process.env.HOME || '', inputPath.slice(1)) : inputPath;
+}
+/** Default change author for ODF comparison: the env-configured AI author, else `SafeDocX`. */
+function resolveAuthor(explicit) {
+    const trimmed = typeof explicit === 'string' ? explicit.trim() : '';
+    if (trimmed)
+        return trimmed;
+    const env = process.env.SAFE_DOCX_AI_AUTHOR;
+    return env && env.trim() ? env.trim() : 'SafeDocX';
+}
+/**
+ * ODF `compare_documents` — inline granularity (issue #356), TWO-FILE mode.
+ *
+ * Stateless (mirrors the DOCX `compareDocuments_tool`): it does its own loading and takes no
+ * resolved session, because two-file compare carries no `file_path` and so cannot route through
+ * `resolveOdfSessionForTool` (which requires one). Session-mode `.odt` compare routes through
+ * `dispatchOdf` to `odfCompareDocumentsSession` below.
+ */
+export async function odfCompareDocuments(manager, params) {
+    try {
+        const hasOriginal = typeof params.original_file_path === 'string' && params.original_file_path.trim().length > 0;
+        const hasRevised = typeof params.revised_file_path === 'string' && params.revised_file_path.trim().length > 0;
+        if (!hasOriginal || !hasRevised) {
+            return err('MISSING_PARAMS', 'ODF comparison requires both original_file_path and revised_file_path.', 'Provide two .odt files, or pass file_path alone to compare a session against its original.');
+        }
+        const rawSavePath = typeof params.save_to_local_path === 'string' ? params.save_to_local_path.trim() : '';
+        if (!rawSavePath) {
+            return err('MISSING_SAVE_PATH', 'compare_documents requires save_to_local_path.', 'Provide a writable .odt output path.');
+        }
+        const originalLoaded = await validateAndLoadOdfFromPath(manager, params.original_file_path);
+        if (!originalLoaded.ok)
+            return originalLoaded.response;
+        const revisedLoaded = await validateAndLoadOdfFromPath(manager, params.revised_file_path);
+        if (!revisedLoaded.ok)
+            return revisedLoaded.response;
+        // Refuse to clobber either source via the output path (parity with the DOCX tool, issue #313).
+        const savePath = expandPath(rawSavePath);
+        for (const source of [originalLoaded.normalizedPath, revisedLoaded.normalizedPath]) {
+            if (await resolvesToSamePath(savePath, source)) {
+                return err('OVERWRITE_BLOCKED', `Refusing to overwrite a source document: ${source}`, 'Choose a different save_to_local_path.');
+            }
+        }
+        const odf = await loadOdfCore();
+        if (!odf) {
+            return err('MISSING_DEPENDENCY', 'ODF (.odt) support requires @usejunior/odf-core.', 'Install @usejunior/odf-core to enable ODF comparison.');
+        }
+        const author = resolveAuthor(params.author);
+        const originalXml = await originalLoaded.archive.getContentXml();
+        const revisedXml = await revisedLoaded.archive.getContentXml();
+        const result = odf.compareOdf(originalXml, revisedXml, { author });
+        // Build the redline on the revised package (its styles/manifest/untouched parts are preserved).
+        const writePolicy = await enforceWritePathPolicy(savePath);
+        if (!writePolicy.ok)
+            return writePolicy.response;
+        revisedLoaded.archive.setContentXml(result.contentXml);
+        const buffer = await revisedLoaded.archive.save();
+        await fs.mkdir(path.dirname(savePath), { recursive: true });
+        await fs.writeFile(savePath, new Uint8Array(buffer));
+        return ok({
+            mode: 'two_file',
+            provider: 'odf',
+            original_file_path: originalLoaded.normalizedPath,
+            revised_file_path: revisedLoaded.normalizedPath,
+            saved_to: savePath,
+            size_bytes: buffer.length,
+            author,
+            granularity: 'inline',
+            stats: result.stats,
+            message: `Redline comparing '${originalLoaded.filename}' vs '${revisedLoaded.filename}' saved to ${savePath}. ` +
+                'Stats count changed-regions: a modified paragraph counts once in modifications with each ' +
+                'changed span inside it counted in insertions/deletions; added or removed paragraphs count one each.',
+        });
+    }
+    catch (e) {
+        if (String(errorCode(e) ?? '').toUpperCase() === 'EACCES') {
+            return err('PERMISSION_DENIED', `Cannot write to: ${params.save_to_local_path}`, 'Try saving to ~/Downloads/ or ~/Documents/ instead.');
+        }
+        return err('COMPARE_ERROR', `ODF comparison failed: ${errorMessage(e)}`);
+    }
+}
+/**
+ * ODF `compare_documents` — SESSION mode: redline the live session's edits against the original
+ * the session was opened from.
+ *
+ * Both the baseline and the redline package come from a FRESH archive loaded off
+ * `session.originalBuffer`, never from `session.archive`: `SessionManager.saveOdfTo` stamps the
+ * live archive's `content.xml` with the edited state on every save (so it is not a valid baseline
+ * source), and writing redline markup into it would poison the session. The raw original
+ * `content.xml` needs no normalization as a baseline because `compareOdf` diffs per-block visible
+ * text, which a parse→serialize round-trip does not alter.
+ *
+ * Packaging the redline on the original package is valid under a CURRENT invariant: ODF session
+ * edit tools mutate `content.xml` only (the same premise `saveOdfTo` rests on). If a future ODF
+ * tool mutates non-content parts (styles.xml, manifest, …), session compare must switch to a
+ * revised-session package baseline or copy those modified parts.
+ */
+export async function odfCompareDocumentsSession(manager, session, params, metadata) {
+    try {
+        const rawSavePath = typeof params.save_to_local_path === 'string' ? params.save_to_local_path.trim() : '';
+        if (!rawSavePath) {
+            return err('MISSING_SAVE_PATH', 'compare_documents requires save_to_local_path.', 'Provide a writable .odt output path.');
+        }
+        // Refuse to clobber the comparison input via the output path (parity with two-file mode and
+        // the DOCX tool, issue #313). No allow_overwrite escape: the original is an input here.
+        const savePath = expandPath(rawSavePath);
+        if (await resolvesToSamePath(savePath, session.originalPath)) {
+            return err('OVERWRITE_BLOCKED', `Refusing to overwrite a source document: ${manager.normalizePath(session.originalPath)}`, 'Choose a different save_to_local_path.');
+        }
+        const odf = await loadOdfCore();
+        if (!odf) {
+            return err('MISSING_DEPENDENCY', 'ODF (.odt) support requires @usejunior/odf-core.', 'Install @usejunior/odf-core to enable ODF comparison.');
+        }
+        const author = resolveAuthor(params.author);
+        const originalArchive = await odf.OdfArchive.load(session.originalBuffer);
+        const originalXml = await originalArchive.getContentXml();
+        const revisedXml = session.doc.toXml();
+        const result = odf.compareOdf(originalXml, revisedXml, { author });
+        const writePolicy = await enforceWritePathPolicy(savePath);
+        if (!writePolicy.ok)
+            return writePolicy.response;
+        originalArchive.setContentXml(result.contentXml);
+        const buffer = await originalArchive.save();
+        await fs.mkdir(path.dirname(savePath), { recursive: true });
+        await fs.writeFile(savePath, new Uint8Array(buffer));
+        manager.touch(session);
+        return ok({
+            mode: 'session',
+            provider: 'odf',
+            original_file_path: manager.normalizePath(session.originalPath),
+            saved_to: savePath,
+            size_bytes: buffer.length,
+            author,
+            granularity: 'inline',
+            stats: result.stats,
+            message: `Redline of session edits to '${session.filename}' saved to ${savePath}. ` +
+                'Stats count changed-regions: a modified paragraph counts once in modifications with each ' +
+                'changed span inside it counted in insertions/deletions; added or removed paragraphs count one each.',
+            ...metadata,
+        });
+    }
+    catch (e) {
+        if (String(errorCode(e) ?? '').toUpperCase() === 'EACCES') {
+            return err('PERMISSION_DENIED', `Cannot write to: ${params.save_to_local_path}`, 'Try saving to ~/Downloads/ or ~/Documents/ instead.');
+        }
+        return err('COMPARE_ERROR', `ODF comparison failed: ${errorMessage(e)}`);
+    }
+}
+//# sourceMappingURL=compare_documents.js.map

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

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

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

@@ -0,0 +1,11 @@
+import { type OdfSession, SessionManager } from '../../session/manager.js';
+import { type ToolResponse } from '../types.js';
+/**
+ * ODF (.odt) `get_comments`. Walks `content.xml` for `office:annotation` elements and returns them
+ * in document order in the same shape as the DOCX tool. ODF has no reply graph, so `replies` is
+ * always empty.
+ */
+export declare function odfGetComments(_manager: SessionManager, session: OdfSession, _params: {
+    file_path?: string;
+}, metadata: Record<string, unknown>): Promise<ToolResponse>;
+//# sourceMappingURL=get_comments.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get_comments.d.ts","sourceRoot":"","sources":["../../../src/tools/odf/get_comments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE3E,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAYzD;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,EAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,YAAY,CAAC,CA6BvB"}

package/dist/tools/odf/get_comments.js

@@ -0,0 +1,32 @@
+import { errorMessage } from '../../error_utils.js';
+import { err, ok } from '../types.js';
+/**
+ * ODF (.odt) `get_comments`. Walks `content.xml` for `office:annotation` elements and returns them
+ * in document order in the same shape as the DOCX tool. ODF has no reply graph, so `replies` is
+ * always empty.
+ */
+export async function odfGetComments(_manager, session, _params, metadata) {
+    try {
+        const comments = session.doc.getComments();
+        const mapped = comments.map((c) => ({
+            id: c.id,
+            author: c.author,
+            date: c.date || null,
+            initials: c.initials,
+            text: c.text,
+            anchored_paragraph_id: c.anchoredParagraphId,
+            replies: [],
+        }));
+        return ok({
+            success: true,
+            comments: mapped,
+            provider: 'odf',
+            file_path: session.originalPath,
+            ...metadata,
+        });
+    }
+    catch (e) {
+        return err('COMMENT_ERROR', `Failed to read comments from ODF document: ${errorMessage(e)}`);
+    }
+}
+//# sourceMappingURL=get_comments.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get_comments.js","sourceRoot":"","sources":["../../../src/tools/odf/get_comments.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,GAAG,EAAE,EAAE,EAAqB,MAAM,aAAa,CAAC;AAYzD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAAwB,EACxB,OAAmB,EACnB,OAA+B,EAC/B,QAAiC;IAEjC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,EAOtC,CAAC;QACH,MAAM,MAAM,GAAiB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAChD,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,IAAI;YACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,qBAAqB,EAAE,CAAC,CAAC,mBAAmB;YAC5C,OAAO,EAAE,EAAE;SACZ,CAAC,CAAC,CAAC;QACJ,OAAO,EAAE,CAAC;YACR,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,MAAM;YAChB,QAAQ,EAAE,KAAK;YACf,SAAS,EAAE,OAAO,CAAC,YAAY;YAC/B,GAAG,QAAQ;SACZ,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,OAAO,GAAG,CAAC,eAAe,EAAE,8CAA8C,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/F,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,4 @@
+import { type OdfSession, SessionManager } from '../../session/manager.js';
+import { type ToolResponse } from '../types.js';
+export declare function odfGetFileStatus(_manager: SessionManager, session: OdfSession, _params: Record<string, unknown>, metadata: Record<string, unknown>): Promise<ToolResponse>;
+//# sourceMappingURL=get_file_status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get_file_status.d.ts","sourceRoot":"","sources":["../../../src/tools/odf/get_file_status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEzD,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,YAAY,CAAC,CAwBvB"}

package/dist/tools/odf/get_file_status.js

@@ -0,0 +1,28 @@
+import { err, ok } from '../types.js';
+export async function odfGetFileStatus(_manager, session, _params, metadata) {
+    try {
+        return ok({
+            file_path: session.originalPath,
+            provider: 'odf',
+            created_at: session.createdAt.toISOString(),
+            expires_at: session.expiresAt.toISOString(),
+            last_activity: session.lastAccessedAt.toISOString(),
+            edit_count: session.editCount,
+            edit_revision: session.editRevision,
+            document: {
+                filename: session.filename,
+                paragraphs: session.doc.getParagraphs().length,
+            },
+            save_defaults: {
+                default_save_format: 'odt',
+                returned_variants: ['odt'],
+                supports_variant_override: false,
+            },
+            ...metadata,
+        });
+    }
+    catch (e) {
+        return err('STATUS_ERROR', e instanceof Error ? e.message : String(e));
+    }
+}
+//# sourceMappingURL=get_file_status.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get_file_status.js","sourceRoot":"","sources":["../../../src/tools/odf/get_file_status.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,EAAE,EAAqB,MAAM,aAAa,CAAC;AAEzD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,QAAwB,EACxB,OAAmB,EACnB,OAAgC,EAChC,QAAiC;IAEjC,IAAI,CAAC;QACH,OAAO,EAAE,CAAC;YACR,SAAS,EAAE,OAAO,CAAC,YAAY;YAC/B,QAAQ,EAAE,KAAK;YACf,UAAU,EAAE,OAAO,CAAC,SAAS,CAAC,WAAW,EAAE;YAC3C,UAAU,EAAE,OAAO,CAAC,SAAS,CAAC,WAAW,EAAE;YAC3C,aAAa,EAAE,OAAO,CAAC,cAAc,CAAC,WAAW,EAAE;YACnD,UAAU,EAAE,OAAO,CAAC,SAAS;YAC7B,aAAa,EAAE,OAAO,CAAC,YAAY;YACnC,QAAQ,EAAE;gBACR,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,MAAM;aAC/C;YACD,aAAa,EAAE;gBACb,mBAAmB,EAAE,KAAK;gBAC1B,iBAAiB,EAAE,CAAC,KAAK,CAAC;gBAC1B,yBAAyB,EAAE,KAAK;aACjC;YACD,GAAG,QAAQ;SACZ,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,OAAO,GAAG,CAAC,cAAc,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACzE,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,19 @@
+import { type OdfSession, SessionManager } from '../../session/manager.js';
+import { type ToolResponse } from '../types.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 declare function odfGrep(manager: SessionManager, session: OdfSession, params: {
+    patterns?: string[];
+    pattern?: string;
+    case_sensitive?: boolean;
+    whole_word?: boolean;
+    max_results?: number;
+    context_chars?: number;
+    dedupe_by_paragraph?: boolean;
+    search_xml?: boolean;
+}, metadata: Record<string, unknown>): Promise<ToolResponse>;
+//# sourceMappingURL=grep.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"grep.d.ts","sourceRoot":"","sources":["../../../src/tools/odf/grep.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE3E,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAGzD;;;;;GAKG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE;IACN,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,EACD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,YAAY,CAAC,CAkFvB"}