pptx-viewer-mcp 2.4.1 → 2.5.0

package/dist/mcp/index.mjs

@@ -2,7 +2,7 @@
 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, resolveThemeColorRef, cloneElement as cloneElement$1, isTemplateElementId, makeStoreAwareId, reassignDescendantIds, groupElements as groupElements$1, ungroupElements as ungroupElements$1, TABLE_STYLE_PART_SEQUENCE, normalizeTableStyleGuid, createTableStyleEntry, addTableStyleToMap, deleteTableStyleFromMap, PptxMarkdownConverter, ThemePresets, getThemePreset, setChartType, setChartTitle, setChartGrouping, setChartLegend, setChartDataLabels, setChartAxis, setChartCategories, addChartSeries, removeChartSeries, updateChartSeriesValues, ChartBuilder, setChartDataPointStyle, setChartDataPointExplosion, setChartDataPointMarker, setChartDataPointLabel, setChartSeriesMarker, setChartSeriesTrendline, setChartSeriesErrorBars, setChartHelperLine, setChartColorMapOverride, listChartUserShapes, addChartUserShape, updateChartUserShape, removeChartUserShape, decomposeSmartArt, demoteSmartArtNode, promoteSmartArtNode, reorderSmartArtNode, updateSmartArtNodeText, removeSmartArtNode, addSmartArtNode, findPlaceholders, applyTemplate, getSectionForSlide, moveSlidesToSection, reorderSections, removeSection, addSection, SvgExporter, buildPptxJsonDocument, deserializePptxFromJson, applyImportedPptxData, replaceWithCustomGeometry, replaceShapeGeometry, setElementLocked, findLayoutByName, findLayoutByType, resolveDisplayedChartTypeName } from 'pptx-viewer-core';
+import { validatePptx, repairPptx, PptxHandler, hasTextProperties, resolveThemeColorRef, cloneElement as cloneElement$1, isTemplateElementId, makeStoreAwareId, reassignDescendantIds, groupElements as groupElements$1, ungroupElements as ungroupElements$1, TABLE_STYLE_PART_SEQUENCE, normalizeTableStyleGuid, createTableStyleEntry, addTableStyleToMap, deleteTableStyleFromMap, PptxMarkdownConverter, ThemePresets, getThemePreset, setChartType, setChartTitle, setChartGrouping, setChartLegend, setChartDataLabels, setChartAxis, setChartCategories, addChartSeries, removeChartSeries, updateChartSeriesValues, ChartBuilder, setChartDataPointStyle, setChartDataPointExplosion, setChartDataPointMarker, setChartDataPointLabel, setChartSeriesMarker, setChartSeriesTrendline, setChartSeriesErrorBars, setChartHelperLine, setChartColorMapOverride, listChartUserShapes, addChartUserShape, updateChartUserShape, removeChartUserShape, decomposeSmartArt, demoteSmartArtNode, promoteSmartArtNode, reorderSmartArtNode, updateSmartArtNodeText, removeSmartArtNode, addSmartArtNode, findPlaceholders, applyTemplate, getSectionForSlide, moveSlidesToSection, reorderSections, removeSection, addSection, SvgExporter, buildPptxJsonDocument, deserializePptxFromJson, applyImportedPptxData, replaceWithCustomGeometry, replaceShapeGeometry, setElementLocked, findLayoutByName, findLayoutByType, resolveOleEditorKindFromPayload, getOleNestedDeckDetail, getOleDocumentParagraphs, getOleSheetGrid, applyOleSheetCellEdit, applyOleDocumentParagraphEdit, applyOleNestedDeckElementTextEdit, parseDataUrlToBytes, replaceOleFile, setOleObjectName, resolveDisplayedChartTypeName } from 'pptx-viewer-core';
 import { writeFile, readFile } from 'fs/promises';
 import { resolve, isAbsolute, sep } from 'path';
 
@@ -879,6 +879,49 @@ var ApplyLayoutSchema = z.object({
   layoutName: z.string().optional().describe("Layout name to apply"),
   layoutType: z.string().optional().describe("Layout type to apply (alternative to name)")
 });
+var GetOleContentSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0).describe("Zero-based slide index"),
+  elementId: z.string().describe("OLE element ID")
+});
+var SetOleSheetCellSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0).describe("Zero-based slide index"),
+  elementId: z.string().describe("OLE element ID (Excel payload: .xlsx or .xls)"),
+  row: z.number().int().min(0).describe("Zero-based row index on the first worksheet"),
+  col: z.number().int().min(0).describe("Zero-based column index on the first worksheet"),
+  value: z.string().describe("New cell value")
+});
+var SetOleDocumentParagraphSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0).describe("Zero-based slide index"),
+  elementId: z.string().describe("OLE element ID (Word payload: .docx)"),
+  paragraphIndex: z.number().int().min(0).describe("Zero-based paragraph index"),
+  text: z.string().describe("New paragraph text")
+});
+var SetOleDeckSlideTitleSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0).describe("Zero-based slide index"),
+  elementId: z.string().describe("OLE element ID (nested-deck payload: .pptx)"),
+  deckSlideIndex: z.number().int().min(0).describe("Zero-based slide index within the nested deck"),
+  deckElementId: z.string().describe(
+    "ID of the text-bearing shape to edit within the nested slide, from ole_get_content's deckSlides[n].elements[i].elementId"
+  ),
+  title: z.string().describe("New text for the chosen shape")
+});
+var ReplaceOleFileSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0).describe("Zero-based slide index"),
+  elementId: z.string().describe("OLE element ID"),
+  fileData: z.string().describe('New payload as a base64 data URL (e.g. "data:application/pdf;base64,...")'),
+  fileName: z.string().optional().describe("Optional new file name (also updates the resolved MIME type)")
+});
+var SetOleObjectNameSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0).describe("Zero-based slide index"),
+  elementId: z.string().describe("OLE element ID"),
+  name: z.string().describe("New Object Name (p:oleObj/@name); blank/whitespace clears it")
+});
 function generateElementId() {
   return `el-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
 }
@@ -2847,6 +2890,129 @@ function updateMetadata(ctx, params) {
     result: { updated }
   };
 }
+function resolveOleElement(ctx, slideIndex, elementId) {
+  const err = validateSlideIndex(slideIndex, ctx.pptxData.slides.length);
+  if (err) {
+    throw new Error(err);
+  }
+  const slide = ctx.pptxData.slides[slideIndex];
+  const index = slide.elements.findIndex((e) => e.id === elementId);
+  if (index === -1) {
+    throw new Error(`Element '${elementId}' not found on slide ${slideIndex}.`);
+  }
+  const element = slide.elements[index];
+  if (element.type !== "ole") {
+    throw new Error(`Element '${elementId}' is not an OLE object.`);
+  }
+  return { slide, element, index };
+}
+function commitOleElement(slide, index, updated) {
+  slide.elements.splice(index, 1, updated);
+  slide.isDirty = true;
+}
+async function getOleContent(ctx, params) {
+  const { element } = resolveOleElement(ctx, params.slideIndex, params.elementId);
+  const kind = await resolveOleEditorKindFromPayload(element);
+  const base = { pptxData: ctx.pptxData, dirty: false };
+  switch (kind) {
+    case "sheet-xlsx":
+    case "sheet-xls": {
+      const sheet = await getOleSheetGrid(element);
+      return { ...base, result: { elementId: element.id, kind, editable: true, sheet } };
+    }
+    case "document-docx":
+    case "document-doc": {
+      const paragraphs = await getOleDocumentParagraphs(element);
+      return { ...base, result: { elementId: element.id, kind, editable: true, paragraphs } };
+    }
+    case "deck-pptx": {
+      const deckSlides = await getOleNestedDeckDetail(element);
+      return { ...base, result: { elementId: element.id, kind, editable: true, deckSlides } };
+    }
+    default:
+      return {
+        ...base,
+        result: {
+          elementId: element.id,
+          kind,
+          editable: false,
+          message: `This OLE object's content (${kind}) is not directly editable; use ole_replace_file to replace it wholesale.`
+        }
+      };
+  }
+}
+async function setOleSheetCell(ctx, params) {
+  const { slide, element, index } = resolveOleElement(ctx, params.slideIndex, params.elementId);
+  const updated = await applyOleSheetCellEdit(element, {
+    row: params.row,
+    col: params.col,
+    value: params.value
+  });
+  const changed = updated !== element;
+  if (changed) {
+    commitOleElement(slide, index, updated);
+  }
+  return {
+    pptxData: ctx.pptxData,
+    dirty: changed,
+    result: { elementId: params.elementId, changed }
+  };
+}
+async function setOleDocumentParagraph(ctx, params) {
+  const { slide, element, index } = resolveOleElement(ctx, params.slideIndex, params.elementId);
+  const updated = await applyOleDocumentParagraphEdit(element, params.paragraphIndex, params.text);
+  const changed = updated !== element;
+  if (changed) {
+    commitOleElement(slide, index, updated);
+  }
+  return {
+    pptxData: ctx.pptxData,
+    dirty: changed,
+    result: { elementId: params.elementId, changed }
+  };
+}
+async function setOleDeckSlideTitle(ctx, params) {
+  const { slide, element, index } = resolveOleElement(ctx, params.slideIndex, params.elementId);
+  const updated = await applyOleNestedDeckElementTextEdit(
+    element,
+    params.deckSlideIndex,
+    params.deckElementId,
+    params.title
+  );
+  const changed = updated !== element;
+  if (changed) {
+    commitOleElement(slide, index, updated);
+  }
+  return {
+    pptxData: ctx.pptxData,
+    dirty: changed,
+    result: { elementId: params.elementId, changed }
+  };
+}
+async function setOleObjectNameT(ctx, params) {
+  const { slide, element, index } = resolveOleElement(ctx, params.slideIndex, params.elementId);
+  const updated = await setOleObjectName(element, params.name);
+  commitOleElement(slide, index, updated);
+  return {
+    pptxData: ctx.pptxData,
+    dirty: true,
+    result: { elementId: params.elementId, changed: true }
+  };
+}
+async function replaceOleFileT(ctx, params) {
+  const { slide, element, index } = resolveOleElement(ctx, params.slideIndex, params.elementId);
+  const parsed = parseDataUrlToBytes(params.fileData);
+  if (!parsed) {
+    throw new Error('fileData must be a base64 data URL, e.g. "data:<mime-type>;base64,<...>".');
+  }
+  const updated = await replaceOleFile(element, parsed.bytes, params.fileName);
+  commitOleElement(slide, index, updated);
+  return {
+    pptxData: ctx.pptxData,
+    dirty: true,
+    result: { elementId: params.elementId, changed: true }
+  };
+}
 
 // src/tools/presentation-tools.ts
 function getPresentationProperties(ctx) {
@@ -4960,6 +5126,90 @@ function createServer() {
       return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
     }
   );
+  server2.registerTool(
+    "ole_get_content",
+    {
+      description: "Inspect an embedded OLE object's editable content: resolved kind, plus the sheet grid, paragraph list, or nested-deck slide summaries, whichever applies",
+      inputSchema: GetOleContentSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool(
+        params.filePath,
+        (ctx) => getOleContent(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server2.registerTool(
+    "ole_set_sheet_cell",
+    {
+      description: "Edit one cell of an embedded Excel OLE object's first worksheet",
+      inputSchema: SetOleSheetCellSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool(
+        params.filePath,
+        (ctx) => setOleSheetCell(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server2.registerTool(
+    "ole_set_document_paragraph",
+    {
+      description: "Replace one paragraph's text in an embedded Word (.docx or legacy .doc) OLE object",
+      inputSchema: SetOleDocumentParagraphSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool(
+        params.filePath,
+        (ctx) => setOleDocumentParagraph(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server2.registerTool(
+    "ole_set_deck_slide_title",
+    {
+      description: "Edit one text-bearing shape on one slide of an embedded nested-deck (PowerPoint) OLE object, via a full load/save round-trip through the nested deck (call ole_get_content first to discover each slide's elementIds)",
+      inputSchema: SetOleDeckSlideTitleSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool(
+        params.filePath,
+        (ctx) => setOleDeckSlideTitle(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server2.registerTool(
+    "ole_replace_file",
+    {
+      description: `Replace an embedded OLE object's payload wholesale with an arbitrary file; works for any OLE kind, including a generic "Package" object or an unsupported format`,
+      inputSchema: ReplaceOleFileSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool(
+        params.filePath,
+        (ctx) => replaceOleFileT(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server2.registerTool(
+    "ole_set_object_name",
+    {
+      description: "Rename an OLE object's Object Name (p:oleObj/@name); regenerates the baked-in icon caption too when the object is displayed as an icon",
+      inputSchema: SetOleObjectNameSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool(
+        params.filePath,
+        (ctx) => setOleObjectNameT(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
   return server2;
 }