@usejunior/docx-mcp 0.0.1 → 0.1.2

package/dist/tools/session_resolution.d.ts

@@ -0,0 +1,29 @@
+import { type Session, SessionManager } from '../session/manager.js';
+import { type ToolResponse } from './types.js';
+export type SessionResolutionMode = 'opened_new_session' | 'reused_existing_session' | 'explicit_session';
+export type ResolvedSession = {
+    ok: true;
+    session: Session;
+    metadata: Record<string, unknown>;
+};
+export type SessionResolutionOutcome = ResolvedSession | {
+    ok: false;
+    response: ToolResponse;
+};
+export declare function validateAndLoadDocxFromPath(manager: SessionManager, filePath: string): Promise<{
+    ok: true;
+    normalizedPath: string;
+    filename: string;
+    content: Buffer;
+} | {
+    ok: false;
+    response: ToolResponse;
+}>;
+export declare function mergeSessionResolutionMetadata(extra: Record<string, unknown>, metadata: Record<string, unknown>): Record<string, unknown>;
+export declare function resolveSessionForTool(manager: SessionManager, params: {
+    session_id?: unknown;
+    file_path?: unknown;
+}, opts: {
+    toolName: string;
+}): Promise<SessionResolutionOutcome>;
+//# sourceMappingURL=session_resolution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session_resolution.d.ts","sourceRoot":"","sources":["../../src/tools/session_resolution.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAMpD,MAAM,MAAM,qBAAqB,GAC7B,oBAAoB,GACpB,yBAAyB,GACzB,kBAAkB,CAAC;AAEvB,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,IAAI,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAChC,eAAe,GACf;IACE,EAAE,EAAE,KAAK,CAAC;IACV,QAAQ,EAAE,YAAY,CAAC;CACxB,CAAC;AAmBN,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,GACf,OAAO,CACN;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,YAAY,CAAA;CAAE,CACxC,CAkEA;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzB;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,EACrD,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GACzB,OAAO,CAAC,wBAAwB,CAAC,CAwGnC"}

package/dist/tools/session_resolution.js

@@ -0,0 +1,158 @@
+import fs from 'node:fs/promises';
+import { errorMessage } from "../error_utils.js";
+import path from 'node:path';
+import { err } from './types.js';
+import { enforceReadPathPolicy } from './path_policy.js';
+import { validateDocxArchiveSafety } from './docx_archive_guard.js';
+const MAX_DOCX_BYTES = 50 * 1024 * 1024;
+function mapSessionLookupError(message, sessionId) {
+    if (message.startsWith('INVALID_SESSION_ID:')) {
+        return err('INVALID_SESSION_ID', message.replace(/^INVALID_SESSION_ID:/, 'Invalid session id: '), 'Session IDs must match format: ses_[12 alphanumeric chars]');
+    }
+    if (message.startsWith('SESSION_NOT_FOUND:')) {
+        return err('SESSION_NOT_FOUND', `Session not found: ${sessionId}`);
+    }
+    if (message.startsWith('SESSION_EXPIRED:')) {
+        return err('SESSION_EXPIRED', `Session expired: ${sessionId}`);
+    }
+    return err('SESSION_RESOLUTION_ERROR', `Failed to resolve session: ${message}`);
+}
+export async function validateAndLoadDocxFromPath(manager, filePath) {
+    const normalizedPath = manager.normalizePath(filePath);
+    const stat = await fs.stat(normalizedPath).catch(() => null);
+    if (!stat || !stat.isFile()) {
+        return {
+            ok: false,
+            response: err('FILE_NOT_FOUND', `File not found: ${filePath}`, 'Copy the file to ~/Downloads/ or ~/Documents/ first, then pass that path.'),
+        };
+    }
+    if (path.extname(normalizedPath).toLowerCase() !== '.docx') {
+        return {
+            ok: false,
+            response: err('INVALID_FILE_TYPE', `Invalid file type: ${path.extname(normalizedPath)}`, 'Only .docx files are supported.'),
+        };
+    }
+    const policy = await enforceReadPathPolicy(filePath);
+    if (!policy.ok) {
+        return {
+            ok: false,
+            response: policy.response,
+        };
+    }
+    const safePath = policy.normalizedPath;
+    const safeStat = await fs.stat(safePath).catch(() => null);
+    if (!safeStat || !safeStat.isFile()) {
+        return {
+            ok: false,
+            response: err('FILE_NOT_FOUND', `File not found: ${filePath}`, 'Copy the file to ~/Downloads/ or ~/Documents/ first, then pass that path.'),
+        };
+    }
+    if (safeStat.size > MAX_DOCX_BYTES) {
+        return {
+            ok: false,
+            response: err('VALIDATION_ERROR', 'File too large', 'Check file type (.docx only) and size (max 50MB).'),
+        };
+    }
+    const content = await fs.readFile(safePath);
+    const archiveGuard = await validateDocxArchiveSafety(content);
+    if (!archiveGuard.ok) {
+        return {
+            ok: false,
+            response: archiveGuard.response,
+        };
+    }
+    return {
+        ok: true,
+        normalizedPath: safePath,
+        filename: path.basename(safePath),
+        content: content,
+    };
+}
+export function mergeSessionResolutionMetadata(extra, metadata) {
+    return { ...extra, ...metadata };
+}
+export async function resolveSessionForTool(manager, params, opts) {
+    const sessionId = typeof params.session_id === 'string' ? params.session_id.trim() : '';
+    const filePath = typeof params.file_path === 'string' ? params.file_path.trim() : '';
+    if (!sessionId && !filePath) {
+        return {
+            ok: false,
+            response: err('MISSING_SESSION_CONTEXT', `Tool '${opts.toolName}' requires session_id or file_path.`, "Provide an existing session_id, or pass file_path to auto-open/reuse an editing session."),
+        };
+    }
+    if (sessionId) {
+        let session;
+        try {
+            session = manager.getSession(sessionId);
+        }
+        catch (e) {
+            return {
+                ok: false,
+                response: mapSessionLookupError(errorMessage(e), sessionId),
+            };
+        }
+        if (filePath) {
+            const requestedPath = manager.normalizePath(filePath);
+            const sessionPath = manager.normalizePath(session.originalPath);
+            if (requestedPath !== sessionPath) {
+                return {
+                    ok: false,
+                    response: err('SESSION_FILE_CONFLICT', `session_id '${sessionId}' is bound to '${sessionPath}', but file_path resolves to '${requestedPath}'.`, 'Use either session_id alone, or provide a file_path that matches the same session document.'),
+                };
+            }
+        }
+        manager.touch(session);
+        return {
+            ok: true,
+            session,
+            metadata: {
+                session_resolution: 'explicit_session',
+                resolved_session_id: session.sessionId,
+                resolved_file_path: manager.normalizePath(session.originalPath),
+            },
+        };
+    }
+    const normalizedPath = manager.normalizePath(filePath);
+    const existing = manager.getMostRecentlyUsedSessionForPath(normalizedPath);
+    if (existing) {
+        const reuseLastUsed = existing.lastAccessedAt.toISOString();
+        manager.touch(existing);
+        return {
+            ok: true,
+            session: existing,
+            metadata: {
+                session_resolution: 'reused_existing_session',
+                reused_existing_session: true,
+                warning: `Using existing editing session ${existing.sessionId} for ${normalizedPath}.`,
+                resolved_session_id: existing.sessionId,
+                resolved_file_path: normalizedPath,
+                reused_session_context: {
+                    edit_revision: existing.editRevision,
+                    edit_count: existing.editCount,
+                    created_at: existing.createdAt.toISOString(),
+                    last_used_at: reuseLastUsed,
+                },
+            },
+        };
+    }
+    const loaded = await validateAndLoadDocxFromPath(manager, filePath);
+    if (!loaded.ok) {
+        return { ok: false, response: loaded.response };
+    }
+    const session = await manager.createSession(loaded.content, loaded.filename, loaded.normalizedPath);
+    // Normalize: merge runs + simplify redlines BEFORE bookmark allocation.
+    session.normalizationStats = session.doc.normalize();
+    // Backfill missing intrinsic paragraph IDs before first read/edit.
+    session.doc.insertParagraphBookmarks(`mcp_${session.sessionId}`);
+    manager.touch(session);
+    return {
+        ok: true,
+        session,
+        metadata: {
+            session_resolution: 'opened_new_session',
+            resolved_session_id: session.sessionId,
+            resolved_file_path: loaded.normalizedPath,
+        },
+    };
+}
+//# sourceMappingURL=session_resolution.js.map

package/dist/tools/session_resolution.js.map

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

package/dist/tools/types.d.ts

@@ -0,0 +1,15 @@
+export type ToolResponse = {
+    success: true;
+    [key: string]: unknown;
+} | {
+    success: false;
+    error: {
+        code: string;
+        message: string;
+        hint?: string;
+    };
+    [key: string]: unknown;
+};
+export declare function ok(extra?: Record<string, unknown>): ToolResponse;
+export declare function err(code: string, message: string, hint?: string): ToolResponse;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GACpB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GACzC;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAExG,wBAAgB,EAAE,CAAC,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,YAAY,CAEpE;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,YAAY,CAE9E"}

package/dist/tools/types.js

@@ -0,0 +1,7 @@
+export function ok(extra = {}) {
+    return { success: true, ...extra };
+}
+export function err(code, message, hint) {
+    return { success: false, error: { code, message, hint } };
+}
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,EAAE,CAAC,QAAiC,EAAE;IACpD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,OAAe,EAAE,IAAa;IAC9D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;AAC5D,CAAC"}

package/dist/tools/update_footnote.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"update_footnote.d.ts","sourceRoot":"","sources":["../../src/tools/update_footnote.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAExD,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE;IACN,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACA,OAAO,CAAC,YAAY,CAAC,CAoCvB"}

package/dist/tools/update_footnote.js

@@ -0,0 +1,39 @@
+import { errorMessage } from "../error_utils.js";
+import { resolveSessionForTool, mergeSessionResolutionMetadata } from './session_resolution.js';
+import { ok, err } from './types.js';
+export async function updateFootnote(manager, params) {
+    const resolved = await resolveSessionForTool(manager, params, { toolName: 'update_footnote' });
+    if (!resolved.ok)
+        return resolved.response;
+    const { session, metadata } = resolved;
+    if (params.note_id == null) {
+        return err('MISSING_PARAMETER', 'note_id is required.', 'Provide the footnote ID to update.');
+    }
+    if (!params.new_text) {
+        return err('MISSING_PARAMETER', 'new_text is required.', 'Provide the new footnote text.');
+    }
+    try {
+        // Verify footnote exists before updating
+        const existing = await session.doc.getFootnote(params.note_id);
+        if (!existing) {
+            return err('NOTE_NOT_FOUND', `Footnote ID ${params.note_id} not found`, 'Use get_footnotes to list available footnotes.');
+        }
+        await session.doc.updateFootnoteText({
+            noteId: params.note_id,
+            newText: params.new_text,
+        });
+        manager.markEdited(session);
+        return ok(mergeSessionResolutionMetadata({
+            note_id: params.note_id,
+            session_id: session.sessionId,
+        }, metadata));
+    }
+    catch (e) {
+        const msg = errorMessage(e);
+        if (msg.includes('not found')) {
+            return err('NOTE_NOT_FOUND', msg, 'Use get_footnotes to list available footnotes.');
+        }
+        return err('FOOTNOTE_ERROR', msg);
+    }
+}
+//# sourceMappingURL=update_footnote.js.map

package/dist/tools/update_footnote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update_footnote.js","sourceRoot":"","sources":["../../src/tools/update_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,cAAc,CAClC,OAAuB,EACvB,MAKC;IAED,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAC/F,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,OAAO,QAAQ,CAAC,QAAQ,CAAC;IAC3C,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC;IAEvC,IAAI,MAAM,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;QAC3B,OAAO,GAAG,CAAC,mBAAmB,EAAE,sBAAsB,EAAE,oCAAoC,CAAC,CAAC;IAChG,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,OAAO,GAAG,CAAC,mBAAmB,EAAE,uBAAuB,EAAE,gCAAgC,CAAC,CAAC;IAC7F,CAAC;IAED,IAAI,CAAC;QACH,yCAAyC;QACzC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/D,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,GAAG,CAAC,gBAAgB,EAAE,eAAe,MAAM,CAAC,OAAO,YAAY,EAAE,gDAAgD,CAAC,CAAC;QAC5H,CAAC;QAED,MAAM,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;YACnC,MAAM,EAAE,MAAM,CAAC,OAAO;YACtB,OAAO,EAAE,MAAM,CAAC,QAAQ;SACzB,CAAC,CAAC;QAEH,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC5B,OAAO,EAAE,CAAC,8BAA8B,CAAC;YACvC,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,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,WAAW,CAAC,EAAE,CAAC;YAC9B,OAAO,GAAG,CAAC,gBAAgB,EAAE,GAAG,EAAE,gDAAgD,CAAC,CAAC;QACtF,CAAC;QACD,OAAO,GAAG,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;IACpC,CAAC;AACH,CAAC"}

package/package.json

@@ -1,10 +1,78 @@
 {
   "name": "@usejunior/docx-mcp",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for @usejunior/docx-mcp",
+  "version": "0.1.2",
+  "description": "Safe Docx MCP server (TypeScript)",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "safedocx": "dist/cli.js",
+    "safe-docx": "dist/cli.js"
+  },
+  "scripts": {
+    "clean:dist": "node -e \"const { rmSync } = require('node:fs'); rmSync('dist', { recursive: true, force: true });\"",
+    "build": "npm run build -w @usejunior/docx-core &&npm run clean:dist && tsc -p tsconfig.build.json",
+    "dev": "tsx watch src/cli.ts",
+    "check:spec-coverage": "node scripts/validate_openspec_coverage.mjs",
+    "conformance:discover": "tsx scripts/discover_docx_fixtures.ts --out conformance/discovery.report.json",
+    "conformance:run": "tsx scripts/run_conformance_harness.ts --manifest conformance/fixtures.manifest.json --report conformance/last-report.json",
+    "conformance:smoke": "tsx scripts/run_conformance_harness.ts --manifest conformance/fixtures.manifest.json --mode smoke --report conformance/smoke-report.json",
+    "docs:generate:tools": "node --import tsx scripts/generate_tool_reference.ts",
+    "test:conformance": "vitest run src/conformance/harness.test.ts",
+    "test": "npm run build -w @usejunior/docx-core &&npm run check:spec-coverage && node ../../node_modules/vitest/vitest.mjs",
+    "test:run": "npm run build -w @usejunior/docx-core &&npm run check:spec-coverage && node ../../node_modules/vitest/vitest.mjs run",
+    "test:coverage": "npm run build -w @usejunior/docx-core &&npm run check:spec-coverage && node ../../node_modules/vitest/vitest.mjs run --coverage --coverage.reporter=text-summary --coverage.reporter=json-summary --coverage.reporter=lcov",
+    "prepack": "npm run build",
+    "lint": "tsc -b --pretty false"
+  },
+  "dependencies": {
+    "@usejunior/docx-core": "^0.1.2",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^3.2.4",
+    "@vitest/runner": "^3.2.4",
+    "allure-vitest": "^3.4.5",
+    "@types/node": "^22.10.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "vitest": "^3.2.4"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/UseJunior/safe-docx"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
   "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "docx",
+    "word",
+    "document-editing",
+    "tracked-changes",
+    "document-comparison",
+    "ai",
+    "llm",
+    "formatting-preservation",
+    "ooxml",
+    "serverless",
+    "cloudflare-workers",
+    "edge",
+    "vercel"
+  ],
+  "homepage": "https://github.com/UseJunior/safe-docx/tree/main/packages/docx-mcp",
+  "bugs": {
+    "url": "https://github.com/UseJunior/safe-docx/issues"
+  }
 }