@usejunior/docx-mcp 0.0.1 → 0.1.1

package/dist/tool_catalog.js

@@ -0,0 +1,314 @@
+import { z } from 'zod';
+const SESSION_OR_FILE_FIELDS = {
+    session_id: z.string().optional(),
+    file_path: z.string().optional(),
+};
+const PLAN_OBJECT_SCHEMA = z.object({}).catchall(z.unknown());
+export const SAFE_DOCX_TOOL_CATALOG = [
+    {
+        name: 'read_file',
+        description: 'Read document content with paragraph IDs. Accepts session_id or file_path.',
+        input: z.object({
+            ...SESSION_OR_FILE_FIELDS,
+            offset: z.number().optional(),
+            limit: z.number().optional(),
+            node_ids: z.array(z.string()).optional(),
+            format: z.enum(['toon', 'json', 'simple']).optional(),
+            show_formatting: z
+                .boolean()
+                .optional()
+                .describe('When true (default), shows inline formatting tags (<b>, <i>, <u>, <highlighting>, <a>). When false, emits plain text with no inline tags.'),
+        }),
+        annotations: { readOnlyHint: true, destructiveHint: false },
+    },
+    {
+        name: 'grep',
+        description: 'Search paragraphs with regex. Accepts session_id or file_path.',
+        input: z.object({
+            ...SESSION_OR_FILE_FIELDS,
+            patterns: z.array(z.string()),
+            case_sensitive: z.boolean().optional(),
+            whole_word: z.boolean().optional(),
+            max_results: z.number().optional(),
+            context_chars: z.number().optional(),
+            dedupe_by_paragraph: z.boolean().optional(),
+        }),
+        annotations: { readOnlyHint: true, destructiveHint: false },
+    },
+    {
+        name: 'init_plan',
+        description: 'Initialize revision-bound context metadata for coordinated multi-agent planning. Accepts session_id or file_path.',
+        input: z.object({
+            ...SESSION_OR_FILE_FIELDS,
+            plan_name: z.string().optional(),
+            orchestrator_id: z.string().optional(),
+        }),
+        annotations: { readOnlyHint: true, destructiveHint: false },
+    },
+    {
+        name: 'merge_plans',
+        description: 'Deterministically merge multiple sub-agent plans and detect hard conflicts before apply.',
+        input: z.object({
+            plans: z.array(PLAN_OBJECT_SCHEMA),
+            fail_on_conflict: z.boolean().optional(),
+            require_shared_base_revision: z.boolean().optional(),
+        }),
+        annotations: { readOnlyHint: true, destructiveHint: false },
+    },
+    {
+        name: 'apply_plan',
+        description: '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.',
+        input: z.object({
+            ...SESSION_OR_FILE_FIELDS,
+            steps: z
+                .array(z.object({}).catchall(z.unknown()))
+                .optional()
+                .describe('JSON array of edit steps. Each step needs step_id, operation, and operation-specific fields.'),
+            plan_file_path: z
+                .string()
+                .optional()
+                .describe('Path to a .json file containing an array of edit steps. Mutually exclusive with steps.'),
+        }),
+        annotations: { readOnlyHint: false, destructiveHint: true },
+    },
+    {
+        name: 'replace_text',
+        description: 'Replace text in a paragraph by _bk_* id, preserving formatting. Accepts session_id or file_path.',
+        input: z.object({
+            ...SESSION_OR_FILE_FIELDS,
+            target_paragraph_id: z.string(),
+            old_string: z.string(),
+            new_string: z.string(),
+            instruction: z.string(),
+            normalize_first: z
+                .boolean()
+                .optional()
+                .describe('Merge format-identical adjacent runs before searching. Useful when text is fragmented across runs.'),
+        }),
+        annotations: { readOnlyHint: false, destructiveHint: true },
+    },
+    {
+        name: 'insert_paragraph',
+        description: 'Insert a paragraph before/after an anchor paragraph by _bk_* id. Accepts session_id or file_path.',
+        input: z.object({
+            ...SESSION_OR_FILE_FIELDS,
+            positional_anchor_node_id: z.string(),
+            new_string: z.string(),
+            instruction: z.string(),
+            position: z.enum(['BEFORE', 'AFTER']).optional(),
+            style_source_id: z
+                .string()
+                .optional()
+                .describe('Paragraph _bk_* ID to clone formatting (pPr and template run) from instead of the positional anchor. Falls back to anchor with a warning if not found.'),
+        }),
+        annotations: { readOnlyHint: false, destructiveHint: true },
+    },
+    {
+        name: 'download',
+        description: '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.',
+        input: z.object({
+            ...SESSION_OR_FILE_FIELDS,
+            save_to_local_path: z.string(),
+            clean_bookmarks: z.boolean().optional(),
+            download_format: z.enum(['clean', 'tracked', 'both']).optional(),
+            allow_overwrite: z.boolean().optional(),
+            tracked_save_to_local_path: z.string().optional(),
+            tracked_changes_author: z.string().optional(),
+            tracked_changes_engine: z.enum(['auto', 'atomizer', 'diffmatch']).optional(),
+            fail_on_rebuild_fallback: z
+                .boolean()
+                .optional()
+                .describe('When true, return an error instead of a destructive output if the comparison engine falls back to rebuild mode (which destroys table structure). Default: false.'),
+        }),
+        annotations: { readOnlyHint: false, destructiveHint: true },
+    },
+    {
+        name: 'format_layout',
+        description: 'Apply deterministic OOXML layout controls (paragraph spacing, table row height, cell padding). Accepts session_id or file_path.',
+        input: z.object({
+            ...SESSION_OR_FILE_FIELDS,
+            strict: z.boolean().optional(),
+            paragraph_spacing: z
+                .object({
+                paragraph_ids: z.array(z.string()).optional(),
+                before_twips: z.number().optional(),
+                after_twips: z.number().optional(),
+                line_twips: z.number().optional(),
+                line_rule: z.enum(['auto', 'exact', 'atLeast']).optional(),
+            })
+                .optional(),
+            row_height: z
+                .object({
+                table_indexes: z.array(z.number()).optional(),
+                row_indexes: z.array(z.number()).optional(),
+                value_twips: z.number().optional(),
+                rule: z.enum(['auto', 'exact', 'atLeast']).optional(),
+            })
+                .optional(),
+            cell_padding: z
+                .object({
+                table_indexes: z.array(z.number()).optional(),
+                row_indexes: z.array(z.number()).optional(),
+                cell_indexes: z.array(z.number()).optional(),
+                top_dxa: z.number().optional(),
+                bottom_dxa: z.number().optional(),
+                left_dxa: z.number().optional(),
+                right_dxa: z.number().optional(),
+            })
+                .optional(),
+        }),
+        annotations: { readOnlyHint: false, destructiveHint: true },
+    },
+    {
+        name: 'accept_changes',
+        description: 'Accept all tracked changes in the document body, producing a clean document with no revision markup. Returns acceptance stats.',
+        input: z.object({
+            ...SESSION_OR_FILE_FIELDS,
+        }),
+        annotations: { readOnlyHint: false, destructiveHint: true },
+    },
+    {
+        name: 'has_tracked_changes',
+        description: 'Check whether the document body contains tracked-change markers (insertions, deletions, moves, and property-change records). Read-only.',
+        input: z.object({
+            ...SESSION_OR_FILE_FIELDS,
+        }),
+        annotations: { readOnlyHint: true, destructiveHint: false },
+    },
+    {
+        name: 'get_session_status',
+        description: 'Get session metadata. Accepts session_id or file_path.',
+        input: z.object({
+            ...SESSION_OR_FILE_FIELDS,
+        }),
+        annotations: { readOnlyHint: true, destructiveHint: false },
+    },
+    {
+        name: 'clear_session',
+        description: 'Clear one session, all sessions for a file path, or all sessions with explicit confirmation.',
+        input: z.object({
+            session_id: z.string().optional(),
+            file_path: z.string().optional(),
+            clear_all: z.boolean().optional(),
+            confirm: z.boolean().optional(),
+        }),
+        annotations: { readOnlyHint: false, destructiveHint: true },
+    },
+    {
+        name: 'duplicate_document',
+        description: 'Duplicate a source .docx and auto-open a fresh editing session for the duplicate.',
+        input: z.object({
+            source_file_path: z.string(),
+            destination_file_path: z.string().optional(),
+            overwrite: z.boolean().optional(),
+        }),
+        annotations: { readOnlyHint: false, destructiveHint: true },
+    },
+    {
+        name: 'add_comment',
+        description: 'Add a comment or threaded reply to a document. Provide target_paragraph_id + anchor_text for root comments, or parent_comment_id for replies.',
+        input: z.object({
+            ...SESSION_OR_FILE_FIELDS,
+            target_paragraph_id: z.string().optional().describe('Paragraph ID to anchor the comment to (for root comments).'),
+            anchor_text: z.string().optional().describe('Text within the paragraph to anchor the comment to. If omitted, anchors to entire paragraph.'),
+            parent_comment_id: z.number().optional().describe('Parent comment ID for threaded replies.'),
+            author: z.string().describe('Comment author name.'),
+            text: z.string().describe('Comment body text.'),
+            initials: z.string().optional().describe('Author initials (defaults to first letter of author name).'),
+        }),
+        annotations: { readOnlyHint: false, destructiveHint: true },
+    },
+    {
+        name: 'get_comments',
+        description: 'Get all comments from the document with IDs, authors, dates, text, and anchored paragraph IDs. Includes threaded replies. Read-only.',
+        input: z.object({
+            ...SESSION_OR_FILE_FIELDS,
+        }),
+        annotations: { readOnlyHint: true, destructiveHint: false },
+    },
+    {
+        name: 'delete_comment',
+        description: 'Delete a comment and all its threaded replies from the document. Cascade-deletes all descendants.',
+        input: z.object({
+            ...SESSION_OR_FILE_FIELDS,
+            comment_id: z.number().describe('Comment ID to delete.'),
+        }),
+        annotations: { readOnlyHint: false, destructiveHint: true },
+    },
+    {
+        name: 'compare_documents',
+        description: '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.',
+        input: z.object({
+            original_file_path: z.string().optional().describe('Path to the original DOCX file.'),
+            revised_file_path: z.string().optional().describe('Path to the revised DOCX file.'),
+            session_id: z.string().optional(),
+            file_path: z.string().optional(),
+            save_to_local_path: z.string().describe('Path to save the tracked-changes DOCX output.'),
+            author: z.string().optional().describe("Author name for track changes. Default: 'Comparison'."),
+            engine: z.enum(['auto', 'atomizer', 'diffmatch']).optional().describe("Comparison engine. Default: 'auto'."),
+        }),
+        annotations: { readOnlyHint: true, destructiveHint: false },
+    },
+    {
+        name: 'get_footnotes',
+        description: 'Get all footnotes from the document with IDs, display numbers, text, and anchored paragraph IDs. Read-only.',
+        input: z.object({
+            ...SESSION_OR_FILE_FIELDS,
+        }),
+        annotations: { readOnlyHint: true, destructiveHint: false },
+    },
+    {
+        name: 'add_footnote',
+        description: '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.',
+        input: z.object({
+            ...SESSION_OR_FILE_FIELDS,
+            target_paragraph_id: z.string().describe('Paragraph ID to anchor the footnote to.'),
+            after_text: z.string().optional().describe('Text after which to insert the footnote reference. If omitted, appends at end of paragraph.'),
+            text: z.string().describe('Footnote body text.'),
+        }),
+        annotations: { readOnlyHint: false, destructiveHint: true },
+    },
+    {
+        name: 'update_footnote',
+        description: 'Update the text content of an existing footnote.',
+        input: z.object({
+            ...SESSION_OR_FILE_FIELDS,
+            note_id: z.number().describe('Footnote ID to update.'),
+            new_text: z.string().describe('New footnote body text.'),
+        }),
+        annotations: { readOnlyHint: false, destructiveHint: true },
+    },
+    {
+        name: 'delete_footnote',
+        description: 'Delete a footnote and its reference from the document.',
+        input: z.object({
+            ...SESSION_OR_FILE_FIELDS,
+            note_id: z.number().describe('Footnote ID to delete.'),
+        }),
+        annotations: { readOnlyHint: false, destructiveHint: true },
+    },
+    {
+        name: 'extract_revisions',
+        description: '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.',
+        input: z.object({
+            ...SESSION_OR_FILE_FIELDS,
+            offset: z.number().optional().describe('0-based offset for pagination. Default: 0.'),
+            limit: z.number().optional().describe('Max entries per page (1-500). Default: 50.'),
+        }),
+        annotations: { readOnlyHint: true, destructiveHint: false },
+    },
+];
+function toJsonObjectSchema(schema, name) {
+    const jsonSchema = z.toJSONSchema(schema);
+    if (typeof jsonSchema !== 'object' || Array.isArray(jsonSchema) || jsonSchema === null) {
+        throw new Error(`Expected JSON schema object for tool '${name}'.`);
+    }
+    return jsonSchema;
+}
+export const SAFE_DOCX_MCP_TOOLS = SAFE_DOCX_TOOL_CATALOG.map((tool) => ({
+    name: tool.name,
+    description: tool.description,
+    inputSchema: toJsonObjectSchema(tool.input, tool.name),
+    annotations: tool.annotations,
+}));
+//# sourceMappingURL=tool_catalog.js.map

package/dist/tool_catalog.js.map

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

package/dist/tools/accept_changes.d.ts

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

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

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

package/dist/tools/accept_changes.js

@@ -0,0 +1,21 @@
+import { errorMessage } from "../error_utils.js";
+import { resolveSessionForTool, mergeSessionResolutionMetadata } from './session_resolution.js';
+import { ok, err } from './types.js';
+export async function acceptChanges(manager, params) {
+    const resolved = await resolveSessionForTool(manager, params, { toolName: 'accept_changes' });
+    if (!resolved.ok)
+        return resolved.response;
+    const { session, metadata } = resolved;
+    try {
+        const stats = session.doc.acceptChanges();
+        manager.markEdited(session);
+        return ok(mergeSessionResolutionMetadata({
+            ...stats,
+            session_id: session.sessionId,
+        }, metadata));
+    }
+    catch (e) {
+        return err('ACCEPT_CHANGES_ERROR', errorMessage(e));
+    }
+}
+//# sourceMappingURL=accept_changes.js.map

package/dist/tools/accept_changes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accept_changes.js","sourceRoot":"","sources":["../../src/tools/accept_changes.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,8BAA8B,EAAE,MAAM,yBAAyB,CAAC;AAChG,OAAO,EAAE,EAAE,EAAE,GAAG,EAAqB,MAAM,YAAY,CAAC;AAExD,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAuB,EACvB,MAAmD;IAEnD,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAC9F,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,OAAO,QAAQ,CAAC,QAAQ,CAAC;IAC3C,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC;IAEvC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC;QAC1C,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC5B,OAAO,EAAE,CAAC,8BAA8B,CAAC;YACvC,GAAG,KAAK;YACR,UAAU,EAAE,OAAO,CAAC,SAAS;SAC9B,EAAE,QAAQ,CAAC,CAAC,CAAC;IAChB,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,OAAO,GAAG,CAAC,sBAAsB,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC;AACH,CAAC"}

package/dist/tools/add_comment.d.ts

@@ -0,0 +1,13 @@
+import { SessionManager } from '../session/manager.js';
+import { type ToolResponse } from './types.js';
+export declare function addComment(manager: SessionManager, params: {
+    session_id?: string;
+    file_path?: string;
+    target_paragraph_id?: string;
+    anchor_text?: string;
+    parent_comment_id?: number;
+    author: string;
+    text: string;
+    initials?: string;
+}): Promise<ToolResponse>;
+//# sourceMappingURL=add_comment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"add_comment.d.ts","sourceRoot":"","sources":["../../src/tools/add_comment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAGxD,wBAAsB,UAAU,CAC9B,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE;IACN,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,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,GACA,OAAO,CAAC,YAAY,CAAC,CA6FvB"}

package/dist/tools/add_comment.js

@@ -0,0 +1,77 @@
+import { errorMessage } from "../error_utils.js";
+import { resolveSessionForTool, mergeSessionResolutionMetadata } from './session_resolution.js';
+import { ok, err } from './types.js';
+import { findUniqueSubstringMatch } from '@usejunior/docx-core';
+export async function addComment(manager, params) {
+    const resolved = await resolveSessionForTool(manager, params, { toolName: 'add_comment' });
+    if (!resolved.ok)
+        return resolved.response;
+    const { session, metadata } = resolved;
+    try {
+        // Reply mode: parent_comment_id provided
+        if (params.parent_comment_id != null) {
+            const result = await session.doc.addCommentReply({
+                parentCommentId: params.parent_comment_id,
+                author: params.author,
+                text: params.text,
+                initials: params.initials,
+            });
+            manager.markEdited(session);
+            return ok(mergeSessionResolutionMetadata({
+                comment_id: result.commentId,
+                parent_comment_id: result.parentCommentId,
+                mode: 'reply',
+                session_id: session.sessionId,
+            }, metadata));
+        }
+        // Root comment mode: target_paragraph_id required
+        if (!params.target_paragraph_id) {
+            return err('MISSING_PARAMETER', 'Either target_paragraph_id (for root comments) or parent_comment_id (for replies) is required.', 'Provide target_paragraph_id + optional anchor_text for root comments, or parent_comment_id for threaded replies.');
+        }
+        const pid = params.target_paragraph_id;
+        const pEl = session.doc.getParagraphElementById(pid);
+        if (!pEl) {
+            return err('ANCHOR_NOT_FOUND', `Paragraph ID ${pid} not found in document`, 'Use grep or read_file to find valid paragraph IDs.');
+        }
+        let start = 0;
+        let end;
+        if (params.anchor_text) {
+            // Find anchor_text within the paragraph
+            const paraText = session.doc.getParagraphTextById(pid) ?? '';
+            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.');
+            }
+            start = match.start;
+            end = match.end;
+        }
+        else {
+            // Anchor to entire paragraph
+            const paraText = session.doc.getParagraphTextById(pid) ?? '';
+            end = paraText.length;
+        }
+        const result = await session.doc.addComment({
+            paragraphId: pid,
+            start,
+            end,
+            author: params.author,
+            text: params.text,
+            initials: params.initials,
+        });
+        manager.markEdited(session);
+        return ok(mergeSessionResolutionMetadata({
+            comment_id: result.commentId,
+            anchor_paragraph_id: pid,
+            anchor_text: params.anchor_text ?? null,
+            mode: 'root',
+            session_id: session.sessionId,
+        }, metadata));
+    }
+    catch (e) {
+        return err('COMMENT_ERROR', errorMessage(e));
+    }
+}
+//# sourceMappingURL=add_comment.js.map

package/dist/tools/add_comment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add_comment.js","sourceRoot":"","sources":["../../src/tools/add_comment.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,8BAA8B,EAAE,MAAM,yBAAyB,CAAC;AAChG,OAAO,EAAE,EAAE,EAAE,GAAG,EAAqB,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAoB,MAAM,sBAAsB,CAAC;AAElF,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,OAAuB,EACvB,MASC;IAED,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC,CAAC;IAC3F,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,OAAO,QAAQ,CAAC,QAAQ,CAAC;IAC3C,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC;IAEvC,IAAI,CAAC;QACH,yCAAyC;QACzC,IAAI,MAAM,CAAC,iBAAiB,IAAI,IAAI,EAAE,CAAC;YACrC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;gBAC/C,eAAe,EAAE,MAAM,CAAC,iBAAiB;gBACzC,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;aAC1B,CAAC,CAAC;YACH,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YAC5B,OAAO,EAAE,CAAC,8BAA8B,CAAC;gBACvC,UAAU,EAAE,MAAM,CAAC,SAAS;gBAC5B,iBAAiB,EAAE,MAAM,CAAC,eAAe;gBACzC,IAAI,EAAE,OAAO;gBACb,UAAU,EAAE,OAAO,CAAC,SAAS;aAC9B,EAAE,QAAQ,CAAC,CAAC,CAAC;QAChB,CAAC;QAED,kDAAkD;QAClD,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;YAChC,OAAO,GAAG,CACR,mBAAmB,EACnB,gGAAgG,EAChG,kHAAkH,CACnH,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,CAAC,mBAAmB,CAAC;QACvC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC;QACrD,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,GAAG,CACR,kBAAkB,EAClB,gBAAgB,GAAG,wBAAwB,EAC3C,oDAAoD,CACrD,CAAC;QACJ,CAAC;QAED,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,GAAW,CAAC;QAEhB,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,wCAAwC;YACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YAC7D,MAAM,KAAK,GAAG,wBAAwB,CAAC,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;YAErE,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBACjC,OAAO,GAAG,CACR,gBAAgB,EAChB,gBAAgB,MAAM,CAAC,WAAW,4BAA4B,GAAG,EAAE,EACnE,wDAAwD,CACzD,CAAC;YACJ,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;gBAChC,OAAO,GAAG,CACR,kBAAkB,EAClB,SAAS,KAAK,CAAC,UAAU,yCAAyC,GAAG,EAAE,EACvE,uDAAuD,CACxD,CAAC;YACJ,CAAC;YAED,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;YACpB,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,6BAA6B;YAC7B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YAC7D,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC;QACxB,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;YAC1C,WAAW,EAAE,GAAG;YAChB,KAAK;YACL,GAAG;YACH,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC,CAAC;QAEH,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC5B,OAAO,EAAE,CAAC,8BAA8B,CAAC;YACvC,UAAU,EAAE,MAAM,CAAC,SAAS;YAC5B,mBAAmB,EAAE,GAAG;YACxB,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,IAAI;YACvC,IAAI,EAAE,MAAM;YACZ,UAAU,EAAE,OAAO,CAAC,SAAS;SAC9B,EAAE,QAAQ,CAAC,CAAC,CAAC;IAChB,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,OAAO,GAAG,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC"}

package/dist/tools/add_footnote.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"add_footnote.d.ts","sourceRoot":"","sources":["../../src/tools/add_footnote.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAExD,wBAAsB,WAAW,CAC/B,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE;IACN,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GACA,OAAO,CAAC,YAAY,CAAC,CA0CvB"}

package/dist/tools/add_footnote.js

@@ -0,0 +1,45 @@
+import { errorMessage } from "../error_utils.js";
+import { resolveSessionForTool, mergeSessionResolutionMetadata } from './session_resolution.js';
+import { ok, err } from './types.js';
+export async function addFootnote(manager, params) {
+    const resolved = await resolveSessionForTool(manager, params, { toolName: 'add_footnote' });
+    if (!resolved.ok)
+        return resolved.response;
+    const { session, metadata } = resolved;
+    if (!params.target_paragraph_id) {
+        return err('MISSING_PARAMETER', 'target_paragraph_id is required.', 'Provide the _bk_* ID of the paragraph to anchor the footnote to.');
+    }
+    if (!params.text) {
+        return err('MISSING_PARAMETER', 'text is required.', 'Provide the footnote body text.');
+    }
+    const pid = params.target_paragraph_id;
+    const pEl = session.doc.getParagraphElementById(pid);
+    if (!pEl) {
+        return err('ANCHOR_NOT_FOUND', `Paragraph ID ${pid} not found in document`, 'Use grep or read_file to find valid paragraph IDs.');
+    }
+    try {
+        const result = await session.doc.addFootnote({
+            paragraphId: pid,
+            afterText: params.after_text,
+            text: params.text,
+        });
+        manager.markEdited(session);
+        return ok(mergeSessionResolutionMetadata({
+            note_id: result.noteId,
+            target_paragraph_id: pid,
+            after_text: params.after_text ?? null,
+            session_id: session.sessionId,
+        }, metadata));
+    }
+    catch (e) {
+        const msg = errorMessage(e);
+        if (msg.includes('not found in paragraph')) {
+            return err('TEXT_NOT_FOUND', msg, 'Verify after_text is present in the target paragraph.');
+        }
+        if (msg.includes('found') && msg.includes('times')) {
+            return err('MULTIPLE_MATCHES', msg, 'Provide more specific after_text for a unique match.');
+        }
+        return err('FOOTNOTE_ERROR', msg);
+    }
+}
+//# sourceMappingURL=add_footnote.js.map

package/dist/tools/add_footnote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add_footnote.js","sourceRoot":"","sources":["../../src/tools/add_footnote.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,8BAA8B,EAAE,MAAM,yBAAyB,CAAC;AAChG,OAAO,EAAE,EAAE,EAAE,GAAG,EAAqB,MAAM,YAAY,CAAC;AAExD,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAuB,EACvB,MAMC;IAED,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC,CAAC;IAC5F,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,OAAO,QAAQ,CAAC,QAAQ,CAAC;IAC3C,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC;IAEvC,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;QAChC,OAAO,GAAG,CAAC,mBAAmB,EAAE,kCAAkC,EAAE,kEAAkE,CAAC,CAAC;IAC1I,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACjB,OAAO,GAAG,CAAC,mBAAmB,EAAE,mBAAmB,EAAE,iCAAiC,CAAC,CAAC;IAC1F,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,CAAC,mBAAmB,CAAC;IACvC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC;IACrD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,GAAG,CAAC,kBAAkB,EAAE,gBAAgB,GAAG,wBAAwB,EAAE,oDAAoD,CAAC,CAAC;IACpI,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;YAC3C,WAAW,EAAE,GAAG;YAChB,SAAS,EAAE,MAAM,CAAC,UAAU;YAC5B,IAAI,EAAE,MAAM,CAAC,IAAI;SAClB,CAAC,CAAC;QAEH,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC5B,OAAO,EAAE,CAAC,8BAA8B,CAAC;YACvC,OAAO,EAAE,MAAM,CAAC,MAAM;YACtB,mBAAmB,EAAE,GAAG;YACxB,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,IAAI;YACrC,UAAU,EAAE,OAAO,CAAC,SAAS;SAC9B,EAAE,QAAQ,CAAC,CAAC,CAAC;IAChB,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,GAAG,CAAC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,CAAC;YAC3C,OAAO,GAAG,CAAC,gBAAgB,EAAE,GAAG,EAAE,uDAAuD,CAAC,CAAC;QAC7F,CAAC;QACD,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACnD,OAAO,GAAG,CAAC,kBAAkB,EAAE,GAAG,EAAE,sDAAsD,CAAC,CAAC;QAC9F,CAAC;QACD,OAAO,GAAG,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;IACpC,CAAC;AACH,CAAC"}

package/dist/tools/apply_plan.d.ts

@@ -0,0 +1,9 @@
+import { SessionManager } from '../session/manager.js';
+import { type ToolResponse } from './types.js';
+export declare function applyPlan(manager: SessionManager, params: {
+    session_id?: string;
+    file_path?: string;
+    steps?: unknown[];
+    plan_file_path?: string;
+}): Promise<ToolResponse>;
+//# sourceMappingURL=apply_plan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apply_plan.d.ts","sourceRoot":"","sources":["../../src/tools/apply_plan.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AA2UxD,wBAAsB,SAAS,CAC7B,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE;IACN,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GACA,OAAO,CAAC,YAAY,CAAC,CAkGvB"}