pptx-viewer-mcp 1.3.2 → 2.0.1

package/CHANGELOG.md

@@ -4,6 +4,28 @@ All notable changes to this project are documented here.
 This file is generated from [Conventional Commits](https://www.conventionalcommits.org)
 by [git-cliff](https://git-cliff.org); do not edit it by hand.
 
+## [2.0.0](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-viewer-mcp@2.0.0) - 2026-07-23
+
+### Documentation
+
+- Friendly 2.0.0 changelog for root and packages (by @ChristopherVR) ([f56564d](https://github.com/ChristopherVR/pptx-viewer/commit/f56564de0dea3f3aa6f0bdf5ad5ed1bf6e9d4823))
+
+## 2.0.0
+
+V2 tidies the MCP server's public API. (The exact version and date are set
+when the release is tagged.)
+
+### Breaking changes and migration
+
+- The deprecated `runMutatingTool` re-export is removed. Call `runMcpTool`
+  instead; it is a pure rename with no behavioural difference.
+
+## [1.3.2](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-viewer-mcp@1.3.2) - 2026-07-18
+
+### Documentation
+
+- Correct and expand the per-package npm readmes (by @ChristopherVR) ([46f7c57](https://github.com/ChristopherVR/pptx-viewer/commit/46f7c573701a19e91c507d41ebdc956c64699c38))
+
 ## [1.3.1](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-viewer-mcp@1.3.1) - 2026-07-17
 
 ### Dependencies

package/dist/index.d.ts

@@ -476,10 +476,25 @@ interface ConvertToMarkdownParams {
   semanticMode?: boolean;
   sourceName?: string;
   /**
-   * Root directory under which `outputDir` must resolve. Defaults to
+   * Root directory under which `outputDir` must resolve. Only meaningful when
+   * {@link ConvertToMarkdownParams.scopeOutputDir} is supplied. Defaults to
    * `process.env.PPTX_TOOLS_ROOT` if set, else `process.cwd()`.
    */
   rootDir?: string;
+  /**
+   * Optional host-supplied guard that resolves `outputDir` under `rootDir` and
+   * rejects traversal escapes.
+   *
+   * Confining an output directory is a filesystem concern that only exists on
+   * the server, and it needs `node:path` to do correctly. This module is also
+   * reached from the browser (the in-viewer AI assistant calls this tool for
+   * the markdown string, with no filesystem, so `outputDir` is just a prefix
+   * for image links), and a `node:path` import here (even a lazy one behind a
+   * runtime check) puts a Node builtin into every bundler's module graph and
+   * makes browser builds warn. So the MCP server injects
+   * {@link resolveScopedDir} instead and browsers simply omit it.
+   */
+  scopeOutputDir?: (outputDir: string, rootDir?: string) => string;
 }
 interface ConvertToMarkdownResult {
   markdown: string;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/execution.ts","../src/tools/slide-tools.ts","../src/tools/helpers.ts","../src/tools/element-tools.ts","../src/tools/table-tools.ts","../src/tools/style-tools.ts","../src/tools/content-tools.ts","../src/tools/conversion-tools.ts","../src/tools/theme-tools.ts","../src/tools/chart-tools.ts","../src/tools/smartart-tools.ts","../src/tools/merge-tools.ts","../src/tools/template-tools.ts","../src/tools/metadata-tools.ts","../src/tools/section-tools.ts","../src/tools/export-tools.ts","../src/tools/hyperlink-tools.ts","../src/tools/geometry-tools.ts","../src/tools/lock-tools.ts","../src/tools/validation-tools.ts","../src/tools/presentation-tools.ts","../src/tools/layout-tools.ts"],"mappings":";;;;;;;UAOiB;;EAEhB,UAAU;;EAEV,gBAAgB,iBAAiB,QAAQ;;EAEzC,gBAAgB,iBAAiB,QAAQ;;;;;;UAOzB,WAAW;;EAE3B,UAAU;;EAEV,QAAQ;;EAER;;;;;;UAWgB;;EAEhB,QAAQ;IAAqB,MAAM;;;EAEnC,SAAS;IACR,QAAQ,MAAM,KAAM,OAAO,YAAY,kBAAkB;IACzD,UAAU,MAAM,MAAO,QAAQ;;;EAGhC,YAAY;;;;;;;UAQI;EAChB,SAAS,eAAe,QAAQ;EAChC,UAAU,cAAc,MAAM,aAAa;;;;;;UAO3B;EAChB,eACC,kBACA,OAAO,YACP;IAAW;IAAoB;;EAEhC,SAAS,mBAAmB;;;;;UAMZ;;EAEhB,YAAY;;EAEZ,gBAAgB;;EAEhB,SAAS;;EAET;;;;;;;;;iBCvEqB,iBACrB,kBACA,SAAS,mBACP;EAAU,UAAU;EAAU,UAAU;;;;;iBA0BrB,iBACrB,kBACA,UAAU,YACV,UAAU,YACV,SAAS,mBACP;EAAU;EAAsB;;;;;;iBAgDb,uBAAuB,GAC5C,kBACA,SAAS,kBACT,SAAS,KAAK,gBAAgB,WAAW,KAAK,QAAQ,WAAW,MAC/D,QAAQ;EAAM;EAAuB;;;;UCxFvB;EAChB;EACA;EACA;EACA;EACA;EACA;EACA;EACA,UAAU;;iBAGK,SACf,KAAK,aACL;EAAU;IACR,WAAW;UAuBG;EAChB;EACA;;UAGgB;EAChB;EACA;;iBAGe,SAAS,KAAK,aAAa,QAAQ,iBAAiB,WAAW;UA2B9D;EAChB;;UAGgB;EAChB;EACA;;iBAGe,aACf,KAAK,aACL,QAAQ,qBACN,WAAW;UA4BG;EAChB;;iBAGe,cACf,KAAK,aACL,QAAQ,sBACN;EAAa;;UA2BC;EAChB;EACA;;iBAGe,eACf,KAAK,aACL,QAAQ,uBACN;EAAa;EAAuB;;UA4BtB;EAChB;EACA;EACA;EACA;EACA;EACA;;iBAGe,sBACf,KAAK,aACL,QAAQ,8BACN;EAAa;;UA8BC;EAChB;EACA;EACA;EACA;EACA;EACA;;iBAGe,mBACf,KAAK,aACL,QAAQ,2BACN;EAAa;EAAoB;;UAmCnB;EAChB;EACA;;iBAGe,cACf,KAAK,aACL,QAAQ,sBACN;EAAa;EAAqB;;;;iBChSrB;iBAIA;;iBAKA,gBAAgB,IAAI,gBAAc;;iBAwGlC,iBAAiB,OAAO;;iBA0BxB,mBAAmB,oBAAoB;;;UC9HtC;EAChB;EACA;EACA;EACA;EACA;EACA;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EAEA;EACA;EACA;EACA;EAEA;EACA;EAEA;EACA;EACA;EACA;EAEA;EACA;EACA;EACA;;UAGgB;EAChB;EACA;;iBAGe,WACf,KAAK,aACL,QAAQ,mBACN,WAAW;UAmKG;EAChB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;iBAGe,cACf,KAAK,aACL,QAAQ,sBACN;EAAa;;UA8GC;EAChB;EACA;;iBAGe,eACf,KAAK,aACL,QAAQ,uBACN;EAAa;;UA0BC;EAChB;EACA;EAEA;EACA;EAEA;EACA;;iBAGe,gBACf,KAAK,aACL,QAAQ,wBACN;EAAa;;UA6GC;EAChB;EACA;EACA;EACA;EACA;;UAGgB;EAChB;;iBAGe,aACf,KAAK,aACL,QAAQ,qBACN,WAAW;UAuCG;EAChB;EACA;EACA;EACA;EACA;EACA;EACA;;iBAGe,oBACf,KAAK,aACL,QAAQ,4BACN;EAAa;;UAsDC;EAChB;EACA;;UAGgB;EAChB;;iBAGe,cACf,KAAK,aACL,QAAQ,sBACN,WAAW;UAyDG;EAChB;EACA;;UAGgB;EAChB;;iBAGe,gBACf,KAAK,aACL,QAAQ,wBACN,WAAW;UAqCG;EAChB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;iBAGe,oBACf,KAAK,aACL,QAAQ,4BACN;EAAa;;;;UC7vBC;EAChB;EACA;EACA,OAAO;IAAQ;IAAa;IAAa;;;iBAG1B,iBACf,KAAK,aACL,QAAQ,yBACN;EAAa;;UA6CC;EAChB;EACA;EACA;EACA;EACA;EACA;;iBAGe,qBACf,KAAK,aACL,QAAQ,6BACN;EAAa;EAAkB;;;;UCjEjB;EAChB;EACA;EAEA;EACA,WAAW;EACX,oBAAoB;IAAQ;IAAe;IAAkB;;EAC7D;EACA;EACA;EAEA;EACA;EACA,aAAa;EACb;EAEA;EACA;EACA;EACA;EACA;EAEA;EACA;EACA;EACA;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;iBAGe,mBACf,KAAK,aACL,QAAQ,2BACN;EAAa;;UA6HC;EAChB;EACA;EACA;EACA;;UAGgB;EAChB;EACA;EACA;EACA;EACA;EACA,QAAQ;;iBAGO,sBAAsB,KAAK,cAAc,WAAW;;;UCnJnD;EAChB;EACA;EACA;EACA;;UAGgB;EAChB;EACA;EACA;EACA;EACA;;UAGgB;EAChB;EACA;EACA,SAAS;;iBAGM,SAAS,KAAK,aAAa,QAAQ,iBAAiB,WAAW;UA2G9D;EAChB;EACA;EACA;EACA;EACA;;UAGgB;EAChB;EACA;EACA;;iBAGe,YACf,KAAK,aACL,QAAQ,oBACN,WAAW;UAiGG;EAChB;EACA;EACA;EACA;EACA;EACA;EACA;;UAGgB;EAChB;EACA;EACA;EACA;EACA;EACA;;UAGgB;EAChB;EACA,WAAW;EACX;EACA;;iBAGe,eACf,KAAK,aACL,QAAQ,uBACN,WAAW;;;UClTG;EAChB;EACA;EACA;EACA;IAAe;IAAgB;;EAC/B;EACA;EACA;;;;;EAKA;;UAgBgB;EAChB;EACA;EACA;EACA;;iBAGqB,kBACrB,KAAK,aACL,QAAQ,0BACN,QAAQ,WAAW;;;UCjCL;EAChB;EACA,cAAc;EACd,aAAa;EACb;;iBAGe,aAAa,KAAK,cAAc,WAAW;UAgB1C;EAChB;;UAGgB;EAChB;EACA,aAAa;;iBAGE,iBACf,KAAK,aACL,QAAQ,yBACN,WAAW;UA8BG;EAChB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;iBAGe,kBACf,KAAK,aACL,QAAQ,0BACN;EAAa,aAAa;;UAsCZ;EAChB;EACA;;iBAGe,iBACf,KAAK,aACL,QAAQ,yBACN;EAAa,YAAY;;;;UCpHX;EAChB;EACA;EACA;EACA;EACA;EACA;IAAW;IAAgB;;EAC3B;IACC;IACA;IACA;I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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/execution.ts","../src/tools/slide-tools.ts","../src/tools/helpers.ts","../src/tools/element-tools.ts","../src/tools/table-tools.ts","../src/tools/style-tools.ts","../src/tools/content-tools.ts","../src/tools/conversion-tools.ts","../src/tools/theme-tools.ts","../src/tools/chart-tools.ts","../src/tools/smartart-tools.ts","../src/tools/merge-tools.ts","../src/tools/template-tools.ts","../src/tools/metadata-tools.ts","../src/tools/section-tools.ts","../src/tools/export-tools.ts","../src/tools/hyperlink-tools.ts","../src/tools/geometry-tools.ts","../src/tools/lock-tools.ts","../src/tools/validation-tools.ts","../src/tools/presentation-tools.ts","../src/tools/layout-tools.ts"],"mappings":";;;;;;;UAOiB;;EAEhB,UAAU;;EAEV,gBAAgB,iBAAiB,QAAQ;;EAEzC,gBAAgB,iBAAiB,QAAQ;;;;;;UAOzB,WAAW;;EAE3B,UAAU;;EAEV,QAAQ;;EAER;;;;;;UAWgB;;EAEhB,QAAQ;IAAqB,MAAM;;;EAEnC,SAAS;IACR,QAAQ,MAAM,KAAM,OAAO,YAAY,kBAAkB;IACzD,UAAU,MAAM,MAAO,QAAQ;;;EAGhC,YAAY;;;;;;;UAQI;EAChB,SAAS,eAAe,QAAQ;EAChC,UAAU,cAAc,MAAM,aAAa;;;;;;UAO3B;EAChB,eACC,kBACA,OAAO,YACP;IAAW;IAAoB;;EAEhC,SAAS,mBAAmB;;;;;UAMZ;;EAEhB,YAAY;;EAEZ,gBAAgB;;EAEhB,SAAS;;EAET;;;;;;;;;iBCvEqB,iBACrB,kBACA,SAAS,mBACP;EAAU,UAAU;EAAU,UAAU;;;;;iBA0BrB,iBACrB,kBACA,UAAU,YACV,UAAU,YACV,SAAS,mBACP;EAAU;EAAsB;;;;;;iBAgDb,uBAAuB,GAC5C,kBACA,SAAS,kBACT,SAAS,KAAK,gBAAgB,WAAW,KAAK,QAAQ,WAAW,MAC/D,QAAQ;EAAM;EAAuB;;;;UCxFvB;EAChB;EACA;EACA;EACA;EACA;EACA;EACA;EACA,UAAU;;iBAGK,SACf,KAAK,aACL;EAAU;IACR,WAAW;UAuBG;EAChB;EACA;;UAGgB;EAChB;EACA;;iBAGe,SAAS,KAAK,aAAa,QAAQ,iBAAiB,WAAW;UA2B9D;EAChB;;UAGgB;EAChB;EACA;;iBAGe,aACf,KAAK,aACL,QAAQ,qBACN,WAAW;UA4BG;EAChB;;iBAGe,cACf,KAAK,aACL,QAAQ,sBACN;EAAa;;UA2BC;EAChB;EACA;;iBAGe,eACf,KAAK,aACL,QAAQ,uBACN;EAAa;EAAuB;;UA4BtB;EAChB;EACA;EACA;EACA;EACA;EACA;;iBAGe,sBACf,KAAK,aACL,QAAQ,8BACN;EAAa;;UA8BC;EAChB;EACA;EACA;EACA;EACA;EACA;;iBAGe,mBACf,KAAK,aACL,QAAQ,2BACN;EAAa;EAAoB;;UAmCnB;EAChB;EACA;;iBAGe,cACf,KAAK,aACL,QAAQ,sBACN;EAAa;EAAqB;;;;iBChSrB;iBAIA;;iBAKA,gBAAgB,IAAI,gBAAc;;iBAwGlC,iBAAiB,OAAO;;iBA0BxB,mBAAmB,oBAAoB;;;UC9HtC;EAChB;EACA;EACA;EACA;EACA;EACA;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EAEA;EACA;EACA;EACA;EAEA;EACA;EAEA;EACA;EACA;EACA;EAEA;EACA;EACA;EACA;;UAGgB;EAChB;EACA;;iBAGe,WACf,KAAK,aACL,QAAQ,mBACN,WAAW;UAmKG;EAChB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;iBAGe,cACf,KAAK,aACL,QAAQ,sBACN;EAAa;;UA8GC;EAChB;EACA;;iBAGe,eACf,KAAK,aACL,QAAQ,uBACN;EAAa;;UA0BC;EAChB;EACA;EAEA;EACA;EAEA;EACA;;iBAGe,gBACf,KAAK,aACL,QAAQ,wBACN;EAAa;;UA6GC;EAChB;EACA;EACA;EACA;EACA;;UAGgB;EAChB;;iBAGe,aACf,KAAK,aACL,QAAQ,qBACN,WAAW;UAuCG;EAChB;EACA;EACA;EACA;EACA;EACA;EACA;;iBAGe,oBACf,KAAK,aACL,QAAQ,4BACN;EAAa;;UAsDC;EAChB;EACA;;UAGgB;EAChB;;iBAGe,cACf,KAAK,aACL,QAAQ,sBACN,WAAW;UAyDG;EAChB;EACA;;UAGgB;EAChB;;iBAGe,gBACf,KAAK,aACL,QAAQ,wBACN,WAAW;UAqCG;EAChB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;iBAGe,oBACf,KAAK,aACL,QAAQ,4BACN;EAAa;;;;UC7vBC;EAChB;EACA;EACA,OAAO;IAAQ;IAAa;IAAa;;;iBAG1B,iBACf,KAAK,aACL,QAAQ,yBACN;EAAa;;UA6CC;EAChB;EACA;EACA;EACA;EACA;EACA;;iBAGe,qBACf,KAAK,aACL,QAAQ,6BACN;EAAa;EAAkB;;;;UCjEjB;EAChB;EACA;EAEA;EACA,WAAW;EACX,oBAAoB;IAAQ;IAAe;IAAkB;;EAC7D;EACA;EACA;EAEA;EACA;EACA,aAAa;EACb;EAEA;EACA;EACA;EACA;EACA;EAEA;EACA;EACA;EACA;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;iBAGe,mBACf,KAAK,aACL,QAAQ,2BACN;EAAa;;UA6HC;EAChB;EACA;EACA;EACA;;UAGgB;EAChB;EACA;EACA;EACA;EACA;EACA,QAAQ;;iBAGO,sBAAsB,KAAK,cAAc,WAAW;;;UCnJnD;EAChB;EACA;EACA;EACA;;UAGgB;EAChB;EACA;EACA;EACA;EACA;;UAGgB;EAChB;EACA;EACA,SAAS;;iBAGM,SAAS,KAAK,aAAa,QAAQ,iBAAiB,WAAW;UA2G9D;EAChB;EACA;EACA;EACA;EACA;;UAGgB;EAChB;EACA;EACA;;iBAGe,YACf,KAAK,aACL,QAAQ,oBACN,WAAW;UAiGG;EAChB;EACA;EACA;EACA;EACA;EACA;EACA;;UAGgB;EAChB;EACA;EACA;EACA;EACA;EACA;;UAGgB;EAChB;EACA,WAAW;EACX;EACA;;iBAGe,eACf,KAAK,aACL,QAAQ,uBACN,WAAW;;;UCpTG;EAChB;EACA;EACA;EACA;IAAe;IAAgB;;EAC/B;EACA;EACA;;;;;;EAMA;;;;;;;;;;;;;;EAcA,kBAAkB,mBAAmB;;UAGrB;EAChB;EACA;EACA;EACA;;iBAGqB,kBACrB,KAAK,aACL,QAAQ,0BACN,QAAQ,WAAW;;;UCjCL;EAChB;EACA,cAAc;EACd,aAAa;EACb;;iBAGe,aAAa,KAAK,cAAc,WAAW;UAgB1C;EAChB;;UAGgB;EAChB;EACA,aAAa;;iBAGE,iBACf,KAAK,aACL,QAAQ,yBACN,WAAW;UA8BG;EAChB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;iBAGe,kBACf,KAAK,aACL,QAAQ,0BACN;EAAa,aAAa;;UAsCZ;EAChB;EACA;;iBAGe,iBACf,KAAK,aACL,QAAQ,yBACN;EAAa,YAAY;;;;UCpHX;EAChB;EACA;EACA;EACA;EACA;EACA;IA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"}

package/dist/index.js

@@ -1,7 +1,6 @@
 'use strict';
 
 var pptxViewerCore = require('pptx-viewer-core');
-var path = require('path');
 
 // src/execution.ts
 var PPTX_MIME_TYPE = "application/vnd.openxmlformats-officedocument.presentationml.presentation";
@@ -1557,17 +1556,6 @@ function manageComments(ctx, params) {
     }
   }
 }
-function scopeOutputDir(outputDir, rootDir) {
-  const root = path.resolve(rootDir ?? process.env["PPTX_TOOLS_ROOT"] ?? process.cwd());
-  const resolved = path.isAbsolute(outputDir) ? path.resolve(outputDir) : path.resolve(root, outputDir);
-  const rootWithSep = root.endsWith(path.sep) ? root : root + path.sep;
-  if (resolved !== root && !resolved.startsWith(rootWithSep)) {
-    throw new Error(
-      `convertToMarkdown: outputDir "${outputDir}" resolves outside the allowed root "${root}"`
-    );
-  }
-  return resolved;
-}
 async function convertToMarkdown(ctx, params) {
   const options = {
     mediaFolderName: params.mediaFolderName ?? "media",
@@ -1577,7 +1565,8 @@ async function convertToMarkdown(ctx, params) {
     semanticMode: params.semanticMode === true,
     sourceName: params.sourceName ?? "unknown"
   };
-  const safeOutputDir = scopeOutputDir(params.outputDir ?? ".", params.rootDir);
+  const outputDir = params.outputDir ?? ".";
+  const safeOutputDir = params.scopeOutputDir ? params.scopeOutputDir(outputDir, params.rootDir) : outputDir;
   const converter = new pptxViewerCore.PptxMarkdownConverter(safeOutputDir, options);
   const markdown = await converter.convert(ctx.pptxData);
   return {

package/dist/index.mjs

@@ -1,6 +1,5 @@
 import { PptxHandler, hasTextProperties, PptxMarkdownConverter, ThemePresets, getThemePreset, setChartType, setChartTitle, setChartGrouping, setChartLegend, setChartDataLabels, setChartAxis, setChartCategories, addChartSeries, removeChartSeries, updateChartSeriesValues, ChartBuilder, decomposeSmartArt, demoteSmartArtNode, promoteSmartArtNode, reorderSmartArtNode, updateSmartArtNodeText, removeSmartArtNode, addSmartArtNode, mergePresentation, diffPresentations, findPlaceholders, applyTemplate, getSectionForSlide, moveSlidesToSection, reorderSections, removeSection, addSection, SvgExporter, replaceWithCustomGeometry, replaceShapeGeometry, setElementLocked, validatePptx, repairPptx, findLayoutByName, findLayoutByType } from 'pptx-viewer-core';
 export { PptxHandler } from 'pptx-viewer-core';
-import { resolve, isAbsolute, sep } from 'path';
 
 // src/execution.ts
 var PPTX_MIME_TYPE = "application/vnd.openxmlformats-officedocument.presentationml.presentation";
@@ -1556,17 +1555,6 @@ function manageComments(ctx, params) {
     }
   }
 }
-function scopeOutputDir(outputDir, rootDir) {
-  const root = resolve(rootDir ?? process.env["PPTX_TOOLS_ROOT"] ?? process.cwd());
-  const resolved = isAbsolute(outputDir) ? resolve(outputDir) : resolve(root, outputDir);
-  const rootWithSep = root.endsWith(sep) ? root : root + sep;
-  if (resolved !== root && !resolved.startsWith(rootWithSep)) {
-    throw new Error(
-      `convertToMarkdown: outputDir "${outputDir}" resolves outside the allowed root "${root}"`
-    );
-  }
-  return resolved;
-}
 async function convertToMarkdown(ctx, params) {
   const options = {
     mediaFolderName: params.mediaFolderName ?? "media",
@@ -1576,7 +1564,8 @@ async function convertToMarkdown(ctx, params) {
     semanticMode: params.semanticMode === true,
     sourceName: params.sourceName ?? "unknown"
   };
-  const safeOutputDir = scopeOutputDir(params.outputDir ?? ".", params.rootDir);
+  const outputDir = params.outputDir ?? ".";
+  const safeOutputDir = params.scopeOutputDir ? params.scopeOutputDir(outputDir, params.rootDir) : outputDir;
   const converter = new PptxMarkdownConverter(safeOutputDir, options);
   const markdown = await converter.convert(ctx.pptxData);
   return {

package/dist/mcp/index.js

@@ -5,8 +5,8 @@ var stdio_js = require('@modelcontextprotocol/sdk/server/stdio.js');
 var mcp_js = require('@modelcontextprotocol/sdk/server/mcp.js');
 var zod = require('zod');
 var pptxViewerCore = require('pptx-viewer-core');
-var path = require('path');
 var promises = require('fs/promises');
+var path = require('path');
 
 var GetSlideSchema = zod.z.object({
   filePath: zod.z.string().describe("Path to the PPTX file"),
@@ -1044,17 +1044,6 @@ function manageComments(ctx, params) {
     }
   }
 }
-function scopeOutputDir(outputDir, rootDir) {
-  const root = path.resolve(rootDir ?? process.env["PPTX_TOOLS_ROOT"] ?? process.cwd());
-  const resolved = path.isAbsolute(outputDir) ? path.resolve(outputDir) : path.resolve(root, outputDir);
-  const rootWithSep = root.endsWith(path.sep) ? root : root + path.sep;
-  if (resolved !== root && !resolved.startsWith(rootWithSep)) {
-    throw new Error(
-      `convertToMarkdown: outputDir "${outputDir}" resolves outside the allowed root "${root}"`
-    );
-  }
-  return resolved;
-}
 async function convertToMarkdown(ctx, params) {
   const options = {
     mediaFolderName: params.mediaFolderName ?? "media",
@@ -1064,7 +1053,8 @@ async function convertToMarkdown(ctx, params) {
     semanticMode: params.semanticMode === true,
     sourceName: params.sourceName ?? "unknown"
   };
-  const safeOutputDir = scopeOutputDir(params.outputDir ?? ".", params.rootDir);
+  const outputDir = params.outputDir ?? ".";
+  const safeOutputDir = params.scopeOutputDir ? params.scopeOutputDir(outputDir, params.rootDir) : outputDir;
   const converter = new pptxViewerCore.PptxMarkdownConverter(safeOutputDir, options);
   const markdown = await converter.convert(ctx.pptxData);
   return {
@@ -2979,16 +2969,23 @@ async function executeToolWithContext(filePath, execCtx, toolFn) {
 
 // src/mcp/handlers.ts
 var ALLOWED_EXTENSIONS = /* @__PURE__ */ new Set([".pptx", ".ppt"]);
-function resolveScopedFilePath(filePath, rootDir) {
-  if (typeof filePath !== "string" || filePath.length === 0) {
-    throw new Error("MCP tool: filePath must be a non-empty string");
+function resolveScopedDir(dir, rootDir) {
+  if (typeof dir !== "string" || dir.length === 0) {
+    throw new Error("MCP tool: path must be a non-empty string");
   }
-  const root = path.resolve(process.env["PPTX_TOOLS_ROOT"] ?? process.cwd());
-  const resolved = path.isAbsolute(filePath) ? path.resolve(filePath) : path.resolve(root, filePath);
+  const root = path.resolve(rootDir ?? process.env["PPTX_TOOLS_ROOT"] ?? process.cwd());
+  const resolved = path.isAbsolute(dir) ? path.resolve(dir) : path.resolve(root, dir);
   const rootWithSep = root.endsWith(path.sep) ? root : root + path.sep;
   if (resolved !== root && !resolved.startsWith(rootWithSep)) {
-    throw new Error(`MCP tool: filePath "${filePath}" resolves outside the allowed root "${root}"`);
+    throw new Error(`MCP tool: path "${dir}" resolves outside the allowed root "${root}"`);
   }
+  return resolved;
+}
+function resolveScopedFilePath(filePath, rootDir) {
+  if (typeof filePath !== "string" || filePath.length === 0) {
+    throw new Error("MCP tool: filePath must be a non-empty string");
+  }
+  const resolved = resolveScopedDir(filePath, rootDir);
   const lower = resolved.toLowerCase();
   let isAllowed = false;
   for (const ext of ALLOWED_EXTENSIONS) {
@@ -3014,7 +3011,7 @@ function createMcpContext(_options) {
   return { filesystem: nodeFs };
 }
 async function runMcpTool(filePath, fn, options) {
-  const safePath = resolveScopedFilePath(filePath);
+  const safePath = resolveScopedFilePath(filePath, options?.rootDir);
   const ctx = createMcpContext();
   return executeToolWithContext(safePath, ctx, fn);
 }
@@ -3053,10 +3050,7 @@ function createServer() {
       inputSchema: AddSlideSchema.shape
     },
     async (params) => {
-      const result = await runMcpTool(
-        params.filePath,
-        (ctx) => addSlide(ctx, params)
-      );
+      const result = await runMcpTool(params.filePath, (ctx) => addSlide(ctx, params));
       return {
         content: [
           {
@@ -3475,10 +3469,7 @@ function createServer() {
       inputSchema: FindTextSchema.shape
     },
     async (params) => {
-      const result = await runMcpTool(
-        params.filePath,
-        (ctx) => findText(ctx, params)
-      );
+      const result = await runMcpTool(params.filePath, (ctx) => findText(ctx, params));
       return {
         content: [
           {
@@ -3540,7 +3531,7 @@ function createServer() {
     async (params) => {
       const result = await runMcpTool(
         params.filePath,
-        (ctx) => convertToMarkdown(ctx, params)
+        (ctx) => convertToMarkdown(ctx, { ...params, scopeOutputDir: resolveScopedDir })
       );
       return {
         content: [
@@ -3724,10 +3715,7 @@ function createServer() {
       inputSchema: GetMetadataSchema.shape
     },
     async (params) => {
-      const result = await runMcpTool(
-        params.filePath,
-        (ctx) => getMetadata(ctx)
-      );
+      const result = await runMcpTool(params.filePath, (ctx) => getMetadata(ctx));
       return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
     }
   );

package/dist/mcp/index.mjs

@@ -3,8 +3,8 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
 import { validatePptx, repairPptx, PptxHandler, hasTextProperties, PptxMarkdownConverter, ThemePresets, getThemePreset, setChartType, setChartTitle, setChartGrouping, setChartLegend, setChartDataLabels, setChartAxis, setChartCategories, addChartSeries, removeChartSeries, updateChartSeriesValues, ChartBuilder, decomposeSmartArt, demoteSmartArtNode, promoteSmartArtNode, reorderSmartArtNode, updateSmartArtNodeText, removeSmartArtNode, addSmartArtNode, findPlaceholders, applyTemplate, getSectionForSlide, moveSlidesToSection, reorderSections, removeSection, addSection, SvgExporter, replaceWithCustomGeometry, replaceShapeGeometry, setElementLocked, findLayoutByName, findLayoutByType } from 'pptx-viewer-core';
-import { resolve, isAbsolute, sep } from 'path';
 import { writeFile, readFile } from 'fs/promises';
+import { resolve, isAbsolute, sep } from 'path';
 
 var GetSlideSchema = z.object({
   filePath: z.string().describe("Path to the PPTX file"),
@@ -1042,17 +1042,6 @@ function manageComments(ctx, params) {
     }
   }
 }
-function scopeOutputDir(outputDir, rootDir) {
-  const root = resolve(rootDir ?? process.env["PPTX_TOOLS_ROOT"] ?? process.cwd());
-  const resolved = isAbsolute(outputDir) ? resolve(outputDir) : resolve(root, outputDir);
-  const rootWithSep = root.endsWith(sep) ? root : root + sep;
-  if (resolved !== root && !resolved.startsWith(rootWithSep)) {
-    throw new Error(
-      `convertToMarkdown: outputDir "${outputDir}" resolves outside the allowed root "${root}"`
-    );
-  }
-  return resolved;
-}
 async function convertToMarkdown(ctx, params) {
   const options = {
     mediaFolderName: params.mediaFolderName ?? "media",
@@ -1062,7 +1051,8 @@ async function convertToMarkdown(ctx, params) {
     semanticMode: params.semanticMode === true,
     sourceName: params.sourceName ?? "unknown"
   };
-  const safeOutputDir = scopeOutputDir(params.outputDir ?? ".", params.rootDir);
+  const outputDir = params.outputDir ?? ".";
+  const safeOutputDir = params.scopeOutputDir ? params.scopeOutputDir(outputDir, params.rootDir) : outputDir;
   const converter = new PptxMarkdownConverter(safeOutputDir, options);
   const markdown = await converter.convert(ctx.pptxData);
   return {
@@ -2977,16 +2967,23 @@ async function executeToolWithContext(filePath, execCtx, toolFn) {
 
 // src/mcp/handlers.ts
 var ALLOWED_EXTENSIONS = /* @__PURE__ */ new Set([".pptx", ".ppt"]);
-function resolveScopedFilePath(filePath, rootDir) {
-  if (typeof filePath !== "string" || filePath.length === 0) {
-    throw new Error("MCP tool: filePath must be a non-empty string");
+function resolveScopedDir(dir, rootDir) {
+  if (typeof dir !== "string" || dir.length === 0) {
+    throw new Error("MCP tool: path must be a non-empty string");
   }
-  const root = resolve(process.env["PPTX_TOOLS_ROOT"] ?? process.cwd());
-  const resolved = isAbsolute(filePath) ? resolve(filePath) : resolve(root, filePath);
+  const root = resolve(rootDir ?? process.env["PPTX_TOOLS_ROOT"] ?? process.cwd());
+  const resolved = isAbsolute(dir) ? resolve(dir) : resolve(root, dir);
   const rootWithSep = root.endsWith(sep) ? root : root + sep;
   if (resolved !== root && !resolved.startsWith(rootWithSep)) {
-    throw new Error(`MCP tool: filePath "${filePath}" resolves outside the allowed root "${root}"`);
+    throw new Error(`MCP tool: path "${dir}" resolves outside the allowed root "${root}"`);
   }
+  return resolved;
+}
+function resolveScopedFilePath(filePath, rootDir) {
+  if (typeof filePath !== "string" || filePath.length === 0) {
+    throw new Error("MCP tool: filePath must be a non-empty string");
+  }
+  const resolved = resolveScopedDir(filePath, rootDir);
   const lower = resolved.toLowerCase();
   let isAllowed = false;
   for (const ext of ALLOWED_EXTENSIONS) {
@@ -3012,7 +3009,7 @@ function createMcpContext(_options) {
   return { filesystem: nodeFs };
 }
 async function runMcpTool(filePath, fn, options) {
-  const safePath = resolveScopedFilePath(filePath);
+  const safePath = resolveScopedFilePath(filePath, options?.rootDir);
   const ctx = createMcpContext();
   return executeToolWithContext(safePath, ctx, fn);
 }
@@ -3051,10 +3048,7 @@ function createServer() {
       inputSchema: AddSlideSchema.shape
     },
     async (params) => {
-      const result = await runMcpTool(
-        params.filePath,
-        (ctx) => addSlide(ctx, params)
-      );
+      const result = await runMcpTool(params.filePath, (ctx) => addSlide(ctx, params));
       return {
         content: [
           {
@@ -3473,10 +3467,7 @@ function createServer() {
       inputSchema: FindTextSchema.shape
     },
     async (params) => {
-      const result = await runMcpTool(
-        params.filePath,
-        (ctx) => findText(ctx, params)
-      );
+      const result = await runMcpTool(params.filePath, (ctx) => findText(ctx, params));
       return {
         content: [
           {
@@ -3538,7 +3529,7 @@ function createServer() {
     async (params) => {
       const result = await runMcpTool(
         params.filePath,
-        (ctx) => convertToMarkdown(ctx, params)
+        (ctx) => convertToMarkdown(ctx, { ...params, scopeOutputDir: resolveScopedDir })
       );
       return {
         content: [
@@ -3722,10 +3713,7 @@ function createServer() {
       inputSchema: GetMetadataSchema.shape
     },
     async (params) => {
-      const result = await runMcpTool(
-        params.filePath,
-        (ctx) => getMetadata(ctx)
-      );
+      const result = await runMcpTool(params.filePath, (ctx) => getMetadata(ctx));
       return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
     }
   );

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pptx-viewer-mcp",
-	"version": "1.3.2",
+	"version": "2.0.1",
 	"description": "PowerPoint PPTX tools and MCP server: manipulate, convert, and collaborate on .pptx files from AI agents.",
 	"keywords": [
 		"ai",
@@ -72,11 +72,11 @@
 		"@modelcontextprotocol/sdk": "^1.29.0",
 		"fast-xml-parser": "^5.10.1",
 		"jszip": "^3.10.1",
-		"pptx-viewer-core": "^1.1.0",
+		"pptx-viewer-core": "^2.0.0",
 		"zod": "^4.4.3"
 	},
 	"devDependencies": {
-		"tsdown": "^0.22.9",
+		"tsdown": "^0.22.14",
 		"tsup": "^8.5.1",
 		"typescript": "^7.0.2",
 		"vitest": "^4.1.10",