pptx-viewer-mcp 2.5.8 → 2.6.0

package/dist/mcp/cli.mjs

@@ -0,0 +1,2286 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { apiToolsChartFormattingTools, apiToolsChartTools, apiToolsChartUserShapeTools, apiToolsContentTools, apiToolsConversionTools, apiToolsElementTools, apiToolsExportTools, apiToolsGeometryTools, apiToolsHyperlinkTools, apiToolsJsonTools, apiToolsLayoutTools, apiToolsLockTools, apiToolsMetadataTools, apiToolsOleTools, apiToolsPresentationTools, apiToolsSectionTools, apiToolsSlideTools, apiToolsSmartartTools, apiToolsStyleTools, apiToolsTableStyleTools, apiToolsTableTools, apiToolsTemplateTools, apiToolsThemeTools, apiToolsValidationTools, apiExecution } from 'ooxml-core/pptx/automation';
+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"),
+  slideIndex: z.number().int().min(0).describe("Zero-based slide index")
+});
+var AddSlideSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  insertAfterIndex: z.number().int().min(0).optional().describe("Insert after this slide index"),
+  backgroundColor: z.string().optional().describe("Background color (hex)")
+});
+var DeleteSlidesSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndexes: z.array(z.number().int().min(0)).min(1).describe("Slide indexes to delete")
+});
+var ReorderSlidesSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  newOrder: z.array(z.number().int().min(0)).min(1).describe("New slide order as array of indexes")
+});
+var DuplicateSlideSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0).describe("Slide to duplicate"),
+  targetIndex: z.number().int().min(0).optional().describe("Where to insert the duplicate")
+});
+var UpdateSlidePropertiesSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0).describe("Zero-based slide index"),
+  backgroundColor: z.string().optional().describe("Background color (hex)"),
+  backgroundGradient: z.string().optional().describe("Background gradient CSS"),
+  backgroundImage: z.string().optional().describe("Background image data URL"),
+  notes: z.string().optional().describe("Speaker notes text"),
+  hidden: z.boolean().optional().describe("Whether slide is hidden")
+});
+var SetSlideTransitionSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0).describe("Zero-based slide index"),
+  type: z.string().describe('Transition type (e.g. "fade", "wipe", "none")'),
+  durationMs: z.number().int().min(0).optional().describe("Duration in ms"),
+  direction: z.string().optional().describe('Direction (e.g. "left", "right")'),
+  advanceOnClick: z.boolean().optional().describe("Advance on mouse click"),
+  advanceAfterMs: z.number().int().min(0).optional().describe("Auto-advance after ms")
+});
+var SetCanvasSizeSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  width: z.number().positive().describe("Canvas width in points"),
+  height: z.number().positive().describe("Canvas height in points")
+});
+var ConvertToMarkdownSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  outputDir: z.string().optional().describe("Output directory for markdown and media"),
+  mediaFolderName: z.string().optional().describe("Name for extracted media folder"),
+  includeMetadata: z.boolean().optional().describe("Include presentation metadata"),
+  slideRange: z.object({
+    start: z.number().int().min(0).optional(),
+    end: z.number().int().min(0).optional()
+  }).optional().describe("Slide range to convert"),
+  includeSpeakerNotes: z.boolean().optional().describe("Include speaker notes"),
+  semanticMode: z.boolean().optional().describe("Use semantic (clean) markdown mode")
+});
+var AccessibilityCheckSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file")
+});
+var ThemeColorRefSchema = z.object({
+  scheme: z.enum([
+    "dk1",
+    "lt1",
+    "dk2",
+    "lt2",
+    "accent1",
+    "accent2",
+    "accent3",
+    "accent4",
+    "accent5",
+    "accent6",
+    "hlink",
+    "folHlink",
+    "bg1",
+    "tx1",
+    "bg2",
+    "tx2",
+    "phClr"
+  ]),
+  lumMod: z.number().optional().describe("Multiply HSL luminance (0..1)"),
+  lumOff: z.number().optional().describe("Add to HSL luminance after lumMod (0..1)"),
+  tint: z.number().optional().describe("Blend towards white (0..1)"),
+  shade: z.number().optional().describe("Blend towards black (0..1)"),
+  alpha: z.number().optional().describe("Opacity fraction, 1 = opaque")
+});
+var AddElementSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0).describe("Zero-based slide index"),
+  type: z.enum(["text", "shape", "image", "table", "connector"]).describe("Element type to add"),
+  x: z.number().optional().describe("X position in points"),
+  y: z.number().optional().describe("Y position in points"),
+  width: z.number().optional().describe("Width in points"),
+  height: z.number().optional().describe("Height in points"),
+  text: z.string().optional().describe("Text content"),
+  fontSize: z.number().optional().describe("Font size in points"),
+  fontFamily: z.string().optional().describe("Font family name"),
+  fontColor: z.string().optional().describe("Font color (hex)"),
+  bold: z.boolean().optional().describe("Bold text"),
+  italic: z.boolean().optional().describe("Italic text"),
+  underline: z.boolean().optional().describe("Underline text"),
+  alignment: z.enum(["left", "center", "right", "justify"]).optional().describe("Text alignment"),
+  shapeType: z.string().optional().describe('Shape type (e.g. "rect", "ellipse")'),
+  fillColor: z.string().optional().describe("Fill color (hex)"),
+  strokeColor: z.string().optional().describe("Stroke color (hex)"),
+  strokeWidth: z.number().optional().describe("Stroke width in points"),
+  imageData: z.string().optional().describe("Image as base64 data URL"),
+  altText: z.string().optional().describe("Alt text for accessibility"),
+  rows: z.number().int().min(1).optional().describe("Number of table rows"),
+  columns: z.number().int().min(1).optional().describe("Number of table columns"),
+  cellData: z.array(z.array(z.string())).optional().describe("Table cell data as 2D array"),
+  headerRow: z.boolean().optional().describe("Style first row as header"),
+  startArrow: z.string().optional().describe("Start arrow type"),
+  endArrow: z.string().optional().describe("End arrow type"),
+  startShapeId: z.string().optional().describe("Connect start to shape ID"),
+  endShapeId: z.string().optional().describe("Connect end to shape ID")
+});
+var UpdateElementSchema = 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("Element ID to update"),
+  x: z.number().optional(),
+  y: z.number().optional(),
+  width: z.number().optional(),
+  height: z.number().optional(),
+  rotation: z.number().optional(),
+  text: z.string().optional(),
+  textSegments: z.array(
+    z.object({
+      text: z.string(),
+      style: z.record(z.string(), z.any())
+    }).passthrough()
+  ).optional().describe(
+    "Rich text segments, including paragraph and bullet metadata. Takes precedence over text."
+  ),
+  fontSize: z.number().optional(),
+  fontFamily: z.string().optional(),
+  fontColor: z.string().optional(),
+  /**
+   * A theme colour for the run text. Wins on save; resolves `fontColor`
+   * immediately when `fontColor` was not also given. Passing `fontColor`
+   * alone clears a previously-set text theme colour.
+   */
+  fontThemeColor: ThemeColorRefSchema.optional(),
+  bold: z.boolean().optional(),
+  italic: z.boolean().optional(),
+  underline: z.boolean().optional(),
+  alignment: z.enum(["left", "center", "right", "justify"]).optional(),
+  fillColor: z.string().optional(),
+  strokeColor: z.string().optional(),
+  strokeWidth: z.number().optional(),
+  opacity: z.number().min(0).max(1).optional(),
+  hidden: z.boolean().optional(),
+  flipH: z.boolean().optional(),
+  flipV: z.boolean().optional(),
+  altText: z.string().optional().describe(
+    "Accessibility description (p:cNvPr/@descr) for image, picture, table, chart, smartArt, ole, media, text, shape and connector elements"
+  ),
+  title: z.string().optional().describe(
+    "Accessibility title (p:cNvPr/@title) for table, chart, smartArt, ole, media, text, shape and connector elements (not pictures)"
+  )
+});
+var RenameElementSchema = 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("Element ID to rename"),
+  name: z.string().describe("New element name (empty string clears the name)")
+});
+var DeleteElementsSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0),
+  elementIds: z.array(z.string()).min(1).describe("Element IDs to delete")
+});
+var ArrangeElementsSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0),
+  action: z.enum(["align", "reorderLayer"]),
+  elementIds: z.array(z.string()).optional().describe("Element IDs (for align)"),
+  alignment: z.enum(["left", "right", "top", "bottom", "centerH", "centerV"]).optional(),
+  elementId: z.string().optional().describe("Element ID (for reorderLayer)"),
+  layerAction: z.enum(["bringForward", "sendBackward", "bringToFront", "sendToBack"]).optional()
+});
+var CloneElementSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0),
+  elementId: z.string(),
+  targetSlideIndexes: z.array(z.number().int().min(0)).optional(),
+  offsetX: z.number().optional(),
+  offsetY: z.number().optional()
+});
+var SetElementAnimationSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0),
+  elementId: z.string(),
+  entrance: z.string().optional(),
+  exit: z.string().optional(),
+  durationMs: z.number().optional(),
+  delayMs: z.number().optional(),
+  order: z.number().optional()
+});
+var GroupElementsSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0),
+  elementIds: z.array(z.string()).min(2).describe("At least 2 element IDs to group")
+});
+var UngroupElementsSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0),
+  groupElementId: z.string().describe("Group element ID to ungroup")
+});
+var BatchUpdateElementsSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0),
+  elementIds: z.array(z.string()).min(1),
+  x: z.number().optional(),
+  y: z.number().optional(),
+  width: z.number().optional(),
+  height: z.number().optional(),
+  rotation: z.number().optional(),
+  opacity: z.number().min(0).max(1).optional(),
+  hidden: z.boolean().optional()
+});
+var ThemeColorRefSchema2 = z.object({
+  scheme: z.enum([
+    "dk1",
+    "lt1",
+    "dk2",
+    "lt2",
+    "accent1",
+    "accent2",
+    "accent3",
+    "accent4",
+    "accent5",
+    "accent6",
+    "hlink",
+    "folHlink",
+    "bg1",
+    "tx1",
+    "bg2",
+    "tx2",
+    "phClr"
+  ]),
+  lumMod: z.number().optional().describe("Multiply HSL luminance (0..1)"),
+  lumOff: z.number().optional().describe("Add to HSL luminance after lumMod (0..1)"),
+  tint: z.number().optional().describe("Blend towards white (0..1)"),
+  shade: z.number().optional().describe("Blend towards black (0..1)"),
+  alpha: z.number().optional().describe("Opacity fraction, 1 = opaque")
+});
+var UpdateTableCellsSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0),
+  elementId: z.string().describe("Table element ID"),
+  cells: z.array(
+    z.object({
+      row: z.number().int().min(0),
+      col: z.number().int().min(0),
+      text: z.string()
+    })
+  ).min(1).describe("Cells to update")
+});
+var ManageTableStructureSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0),
+  elementId: z.string().describe("Table element ID"),
+  action: z.enum(["insertRow", "deleteRow", "insertColumn", "deleteColumn"]),
+  position: z.number().int().min(0).optional().describe("Insertion position index"),
+  referenceIndex: z.number().int().min(0).optional(),
+  cellTexts: z.array(z.string()).optional()
+});
+var UpdateElementStyleSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0),
+  elementId: z.string(),
+  fillColor: z.string().optional(),
+  /**
+   * A theme colour for the fill (e.g. `{ scheme: 'accent1', lumMod: 0.8 }`
+   * for "Accent 1, Lighter 80%"). When set, the shape saves as
+   * `<a:schemeClr>` and keeps following the theme after a later theme
+   * change, instead of freezing today's resolved hex. Setting `fillColor`
+   * without this clears any previously-set fill theme colour.
+   */
+  fillThemeColor: ThemeColorRefSchema2.optional(),
+  fillMode: z.string().optional(),
+  fillGradientStops: z.array(
+    z.object({
+      color: z.string(),
+      position: z.number(),
+      opacity: z.number().optional()
+    })
+  ).optional(),
+  fillGradientAngle: z.number().optional(),
+  fillGradientType: z.string().optional(),
+  fillOpacity: z.number().optional(),
+  strokeColor: z.string().optional(),
+  /** A theme colour for the outline; see `fillThemeColor` above. */
+  strokeThemeColor: ThemeColorRefSchema2.optional(),
+  strokeWidth: z.number().optional(),
+  strokeDash: z.string().optional(),
+  strokeOpacity: z.number().optional(),
+  shadowColor: z.string().optional(),
+  shadowBlur: z.number().optional(),
+  shadowOffsetX: z.number().optional(),
+  shadowOffsetY: z.number().optional(),
+  shadowOpacity: z.number().optional(),
+  glowColor: z.string().optional(),
+  glowRadius: z.number().optional(),
+  glowOpacity: z.number().optional(),
+  softEdgeRadius: z.number().optional(),
+  cropLeft: z.number().optional(),
+  cropTop: z.number().optional(),
+  cropRight: z.number().optional(),
+  cropBottom: z.number().optional(),
+  brightness: z.number().optional(),
+  contrast: z.number().optional(),
+  grayscale: z.boolean().optional(),
+  altText: z.string().optional().describe(
+    "Accessibility description (p:cNvPr/@descr) for image, picture, table, chart, smartArt, ole, media, text, shape and connector elements"
+  ),
+  title: z.string().optional().describe(
+    "Accessibility title (p:cNvPr/@title) for table, chart, smartArt, ole, media, text, shape and connector elements (not pictures)"
+  )
+});
+var FindTextSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  query: z.string().describe("Text to search for"),
+  useRegex: z.boolean().optional().describe("Treat query as regex"),
+  caseSensitive: z.boolean().optional().describe("Case-sensitive search"),
+  slideIndexes: z.array(z.number().int().min(0)).optional().describe("Limit search to specific slides")
+});
+var ReplaceTextSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  query: z.string().describe("Text to find"),
+  replacement: z.string().describe("Replacement text"),
+  useRegex: z.boolean().optional(),
+  caseSensitive: z.boolean().optional(),
+  slideIndexes: z.array(z.number().int().min(0)).optional()
+});
+var ManageCommentsSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  action: z.enum(["list", "add", "delete", "resolve"]),
+  slideIndex: z.number().int().min(0).optional(),
+  text: z.string().optional(),
+  author: z.string().optional(),
+  commentId: z.string().optional(),
+  resolved: z.boolean().optional(),
+  includeResolved: z.boolean().optional()
+});
+var TABLE_STYLE_SECTIONS = [
+  "wholeTbl",
+  "band1H",
+  "band2H",
+  "band1V",
+  "band2V",
+  "lastCol",
+  "firstCol",
+  "lastRow",
+  "seCell",
+  "swCell",
+  "firstRow",
+  "neCell",
+  "nwCell"
+];
+var TableStyleSimpleColorSchema = z.object({
+  schemeColor: z.string().describe('Theme colour key (e.g. "accent1"), or "" for a non-scheme fill'),
+  tint: z.number().optional().describe("0-100000"),
+  shade: z.number().optional().describe("0-100000"),
+  color: z.string().optional().describe('Explicit hex colour, e.g. "#FF8800"')
+});
+var TableStyleFillSchema = z.object({
+  schemeColor: z.string(),
+  tint: z.number().optional(),
+  shade: z.number().optional(),
+  color: z.string().optional(),
+  noFill: z.boolean().optional(),
+  gradient: z.object({
+    type: z.enum(["linear", "radial"]),
+    angle: z.number().optional(),
+    stops: z.array(z.object({ position: z.number(), fill: TableStyleSimpleColorSchema }))
+  }).optional(),
+  pattern: z.object({
+    preset: z.string(),
+    foreground: TableStyleSimpleColorSchema.optional(),
+    background: TableStyleSimpleColorSchema.optional()
+  }).optional(),
+  image: z.object({ path: z.string().optional(), data: z.string().optional() }).optional()
+});
+var TableStyleTextSchema = z.object({
+  bold: z.boolean().optional(),
+  italic: z.boolean().optional(),
+  underline: z.boolean().optional(),
+  fontSchemeColor: z.string().optional(),
+  fontTint: z.number().optional(),
+  fontShade: z.number().optional(),
+  fontColor: z.string().optional(),
+  fontFace: z.string().optional(),
+  fontRefIdx: z.string().optional()
+});
+var TableStyleBorderSideSchema = z.object({
+  width: z.number().optional(),
+  dash: z.string().optional(),
+  fill: TableStyleSimpleColorSchema.optional(),
+  color: z.string().optional(),
+  noFill: z.boolean().optional()
+});
+var TableStyleBordersSchema = z.object({
+  left: TableStyleBorderSideSchema.optional(),
+  right: TableStyleBorderSideSchema.optional(),
+  top: TableStyleBorderSideSchema.optional(),
+  bottom: TableStyleBorderSideSchema.optional(),
+  insideH: TableStyleBorderSideSchema.optional(),
+  insideV: TableStyleBorderSideSchema.optional(),
+  tl2br: TableStyleBorderSideSchema.optional(),
+  tr2bl: TableStyleBorderSideSchema.optional()
+});
+var TableStyleCell3DSchema = z.object({
+  bevelWidth: z.number().optional(),
+  bevelHeight: z.number().optional(),
+  bevelPreset: z.string().optional(),
+  material: z.string().optional(),
+  lightRig: z.string().optional(),
+  lightRigDirection: z.string().optional()
+});
+var SetTableStyleSectionSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  styleId: z.string().describe('Table style GUID, e.g. "{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}"'),
+  section: z.enum(TABLE_STYLE_SECTIONS).describe("Which of the 13 CT_TableStyle parts to patch"),
+  styleName: z.string().optional().describe("Rename the style"),
+  fill: TableStyleFillSchema.optional(),
+  text: TableStyleTextSchema.optional(),
+  borders: TableStyleBordersSchema.optional(),
+  cell3D: TableStyleCell3DSchema.optional()
+});
+var CreateTableStyleSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  styleName: z.string().describe("Display name for the new style"),
+  basedOnStyleId: z.string().optional().describe("Deep-clone every section from this existing style GUID as the starting point"),
+  setAsDefault: z.boolean().optional().describe("Repoint ppt/tableStyles.xml's default style at the new one")
+});
+var DeleteTableStyleSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  styleId: z.string().describe("Table style GUID to remove"),
+  force: z.boolean().optional().describe("Delete even though a table on this deck still references the style")
+});
+var AssignTableStyleSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0),
+  elementId: z.string().describe("Table element ID"),
+  styleId: z.string().optional().describe(
+    "Table style GUID to assign. Defaults to the presentation's current default table style when omitted."
+  ),
+  bandedRows: z.boolean().optional(),
+  bandedColumns: z.boolean().optional(),
+  firstRowHeader: z.boolean().optional(),
+  lastRow: z.boolean().optional(),
+  firstCol: z.boolean().optional(),
+  lastCol: z.boolean().optional()
+});
+var GetThemeInfoSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file")
+});
+var ApplyThemePresetSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  presetName: z.string().describe(
+    'Theme preset name (e.g. "OFFICE", "MODERN_BLUE", "EARTH", "MONOCHROME", "VIBRANT", "CORPORATE", "MINIMAL", "DARK")'
+  )
+});
+var UpdateThemeColorsSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  dk1: z.string().optional().describe("Dark 1 color (hex)"),
+  lt1: z.string().optional().describe("Light 1 color (hex)"),
+  dk2: z.string().optional().describe("Dark 2 color (hex)"),
+  lt2: z.string().optional().describe("Light 2 color (hex)"),
+  accent1: z.string().optional().describe("Accent 1 color (hex)"),
+  accent2: z.string().optional().describe("Accent 2 color (hex)"),
+  accent3: z.string().optional().describe("Accent 3 color (hex)"),
+  accent4: z.string().optional().describe("Accent 4 color (hex)"),
+  accent5: z.string().optional().describe("Accent 5 color (hex)"),
+  accent6: z.string().optional().describe("Accent 6 color (hex)"),
+  hlink: z.string().optional().describe("Hyperlink color (hex)"),
+  folHlink: z.string().optional().describe("Followed hyperlink color (hex)")
+});
+var UpdateThemeFontsSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  majorFont: z.string().optional().describe("Heading (major) font family"),
+  minorFont: z.string().optional().describe("Body (minor) font family")
+});
+var MarkerSymbolSchema = z.enum([
+  "circle",
+  "dash",
+  "diamond",
+  "dot",
+  "none",
+  "picture",
+  "plus",
+  "square",
+  "star",
+  "triangle",
+  "x",
+  "auto"
+]);
+var DataLabelPositionSchema = z.enum([
+  "bestFit",
+  "b",
+  "ctr",
+  "inBase",
+  "inEnd",
+  "l",
+  "outEnd",
+  "r",
+  "t"
+]);
+var FormatChartDataPointSchema = 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("Chart element ID"),
+  seriesIndex: z.number().int().min(0).describe("Zero-based series index"),
+  pointIndex: z.number().int().min(0).describe("Zero-based data point (category) index"),
+  fillColor: z.string().optional().describe("Fill colour (hex) for this point only"),
+  strokeColor: z.string().optional().describe("Outline colour (hex) for this point only"),
+  strokeWidth: z.number().optional().describe("Outline width in points"),
+  strokeDashStyle: z.string().optional().describe("Outline dash style, e.g. solid, dash, dashDot, sysDot"),
+  clearStyle: z.boolean().optional().describe("Remove all per-point shape formatting"),
+  explosion: z.number().nullable().optional().describe("Pie/doughnut slice pull-out distance 0-100; null clears it"),
+  marker: z.object({
+    symbol: MarkerSymbolSchema.optional(),
+    size: z.number().optional(),
+    fillColor: z.string().optional()
+  }).nullable().optional().describe("Per-point marker override (line/scatter/bubble); null clears it")
+});
+var FormatChartDataLabelSchema = 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("Chart element ID"),
+  seriesIndex: z.number().int().min(0).describe("Zero-based series index"),
+  pointIndex: z.number().int().min(0).describe("Zero-based data point (category) index"),
+  remove: z.boolean().optional().describe("Remove the per-point label override entirely"),
+  showValue: z.boolean().optional(),
+  showCategory: z.boolean().optional(),
+  showSeriesName: z.boolean().optional(),
+  showPercent: z.boolean().optional(),
+  showLegendKey: z.boolean().optional(),
+  position: DataLabelPositionSchema.optional(),
+  text: z.string().optional().describe("Custom label text override; '' clears it"),
+  spPr: z.object({
+    fillColor: z.string().optional(),
+    strokeColor: z.string().optional(),
+    strokeWidth: z.number().optional(),
+    strokeDashStyle: z.string().optional()
+  }).nullable().optional().describe("This label's own fill/line formatting; null removes it"),
+  txPr: z.object({
+    fontFamily: z.string().optional(),
+    fontSize: z.number().optional(),
+    bold: z.boolean().optional(),
+    italic: z.boolean().optional(),
+    color: z.string().optional()
+  }).nullable().optional().describe("This label's own font; null removes it")
+});
+var FormatChartSeriesSchema = 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("Chart element ID"),
+  seriesIndex: z.number().int().min(0).describe("Zero-based series index"),
+  marker: z.object({
+    symbol: MarkerSymbolSchema.optional(),
+    size: z.number().optional(),
+    fillColor: z.string().optional(),
+    strokeColor: z.string().optional(),
+    strokeWidth: z.number().optional(),
+    strokeDashStyle: z.string().optional()
+  }).nullable().optional().describe("Series marker (line/scatter/bubble/radar); null removes it"),
+  trendline: z.object({
+    trendlineType: z.enum([
+      "linear",
+      "exponential",
+      "logarithmic",
+      "polynomial",
+      "power",
+      "movingAvg"
+    ]),
+    color: z.string().optional(),
+    lineWidth: z.number().optional().describe("Trendline width in points"),
+    lineDashStyle: z.string().optional(),
+    order: z.number().optional().describe("Polynomial order, 2-6"),
+    period: z.number().optional().describe("Moving-average period"),
+    displayEq: z.boolean().optional(),
+    displayRSq: z.boolean().optional()
+  }).nullable().optional().describe("Series trendline; null removes it"),
+  errorBars: z.object({
+    direction: z.enum(["x", "y"]),
+    barType: z.enum(["both", "minus", "plus"]),
+    valType: z.enum(["cust", "fixedVal", "percentage", "stdDev", "stdErr"]),
+    val: z.number().optional(),
+    customPlus: z.array(z.number()).optional(),
+    customMinus: z.array(z.number()).optional(),
+    noEndCap: z.boolean().optional(),
+    color: z.string().optional(),
+    width: z.number().optional().describe("Error-bar line width in points"),
+    dashStyle: z.string().optional()
+  }).nullable().optional().describe("Series error bars; null removes them")
+});
+var SetChartHelperLineSchema = 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("Chart element ID"),
+  line: z.enum(["dropLines", "hiLowLines"]).describe("Which helper line to set"),
+  style: z.object({
+    color: z.string().optional(),
+    width: z.number().optional(),
+    dashStyle: z.string().optional()
+  }).nullable().describe("Line colour/width/dash; {} shows the line with defaults, null removes it")
+});
+var SetChartColorMapOverrideSchema = 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("Chart element ID"),
+  overrides: z.record(z.string(), z.string()).nullable().describe(
+    'Theme colour role remap (bg1/tx1/bg2/tx2/accent1-6/hlink/folHlink -> role), e.g. { "accent1": "accent2" }; null removes the override'
+  )
+});
+var UpdateChartSchema = 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("Chart element ID"),
+  chartType: z.string().optional().describe(
+    'New chart type (bar, line, pie, scatter, area, doughnut, radar, histogram, waterfall, funnel, treemap, sunburst, boxWhisker, regionMap). "pareto" is also accepted: it is authored as a histogram chart with an added cumulative-percentage line series.'
+  ),
+  title: z.string().optional().describe("Chart title"),
+  grouping: z.enum(["clustered", "stacked", "percentStacked"]).optional().describe("Bar/column grouping"),
+  legend: z.object({
+    show: z.boolean().optional(),
+    position: z.string().optional().describe("Legend position: b, t, l, r, tr")
+  }).optional().describe("Legend configuration"),
+  dataLabels: z.object({
+    show: z.boolean().optional(),
+    showValue: z.boolean().optional(),
+    showCategory: z.boolean().optional(),
+    showSeriesName: z.boolean().optional(),
+    showPercent: z.boolean().optional()
+  }).optional().describe("Data label configuration"),
+  axis: z.object({
+    type: z.string().describe("Axis type: valAx, catAx, dateAx, serAx"),
+    edit: z.object({
+      min: z.number().nullable().optional(),
+      max: z.number().nullable().optional(),
+      majorUnit: z.number().nullable().optional(),
+      title: z.string().nullable().optional(),
+      numberFormat: z.string().optional(),
+      majorGridlines: z.boolean().optional(),
+      minorGridlines: z.boolean().optional()
+    })
+  }).optional().describe("Axis configuration"),
+  categories: z.array(z.string()).optional().describe("Category axis labels")
+});
+var AddChartSeriesSchema = 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("Chart element ID"),
+  name: z.string().describe("Series name"),
+  values: z.array(z.number()).describe("Data values"),
+  color: z.string().optional().describe("Series color (hex)")
+});
+var RemoveChartSeriesSchema = 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("Chart element ID"),
+  seriesIndex: z.number().int().min(0).describe("Zero-based series index to remove")
+});
+var UpdateChartSeriesDataSchema = 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("Chart element ID"),
+  seriesIndex: z.number().int().min(0).describe("Zero-based series index"),
+  values: z.array(z.number()).describe("New data values")
+});
+var CreateChartSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0).describe("Zero-based slide index"),
+  chartType: z.string().describe(
+    'Chart type (bar, line, pie, scatter, area, doughnut, radar, histogram, waterfall, funnel, treemap, sunburst, boxWhisker, regionMap). "pareto" is also accepted: it is authored as a histogram chart with an added cumulative-percentage line series.'
+  ),
+  x: z.number().optional().describe("X position in points"),
+  y: z.number().optional().describe("Y position in points"),
+  width: z.number().optional().describe("Width in points"),
+  height: z.number().optional().describe("Height in points"),
+  title: z.string().optional().describe("Chart title"),
+  categories: z.array(z.string()).optional().describe("Category labels"),
+  series: z.array(
+    z.object({
+      name: z.string(),
+      values: z.array(z.number()),
+      color: z.string().optional()
+    })
+  ).optional().describe("Data series"),
+  legend: z.object({
+    show: z.boolean(),
+    position: z.string().optional()
+  }).optional().describe("Legend configuration")
+});
+var PointSchema = z.object({ x: z.number(), y: z.number() });
+var ExtentSchema = z.object({ cx: z.number(), cy: z.number() });
+var ChartUserShapeInputSchema = z.object({
+  kind: z.enum(["sp", "cxnSp"]).optional().describe('Overlay shape kind: "sp" (text/preset shape, default) or "cxnSp" (connector).'),
+  anchor: z.enum(["rel", "abs"]).optional().describe(
+    'Anchor kind: "rel" (default, resizes with the chart; needs `to`) or "abs" (fixed EMU size; needs `ext`).'
+  ),
+  from: PointSchema.describe("Top-left corner as chart-relative fractions (0-1 each)."),
+  to: PointSchema.optional().describe(
+    "Bottom-right corner as chart-relative fractions; rel anchors only."
+  ),
+  ext: ExtentSchema.optional().describe("Width/height in EMU; abs anchors only."),
+  prst: z.string().optional().describe('Preset geometry name (e.g. "rect", "roundRect"); default "rect".'),
+  fill: z.string().optional().describe('Solid fill colour, hex (e.g. "#FFFF00").'),
+  stroke: z.string().optional().describe("Line colour, hex."),
+  strokeWidth: z.number().optional().describe("Line width in points."),
+  text: z.string().optional().describe("Plain text content, centred in the shape.")
+});
+var ListChartUserShapesSchema = 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("Chart element ID")
+});
+var AddChartUserShapeSchema = 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("Chart element ID"),
+  shape: ChartUserShapeInputSchema.describe("The overlay shape to add.")
+});
+var UpdateChartUserShapeSchema = 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("Chart element ID"),
+  index: z.number().int().min(0).describe("Zero-based overlay-shape index (from chart_user_shape_list)"),
+  patch: ChartUserShapeInputSchema.partial().describe(
+    "Fields to overwrite; anything omitted is left as-is."
+  )
+});
+var RemoveChartUserShapeSchema = 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("Chart element ID"),
+  index: z.number().int().min(0).describe("Zero-based overlay-shape index to remove")
+});
+var ManageSmartArtSchema = 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("SmartArt element ID"),
+  action: z.enum([
+    "getNodes",
+    "addNode",
+    "removeNode",
+    "updateNodeText",
+    "reorderNode",
+    "promoteNode",
+    "demoteNode",
+    "decompose"
+  ]).describe("SmartArt action"),
+  nodeId: z.string().optional().describe("Node ID (required for most actions)"),
+  text: z.string().optional().describe("Text for addNode or updateNodeText"),
+  afterNodeId: z.string().optional().describe("Insert after this node ID"),
+  direction: z.number().optional().describe("Reorder direction: 1 (forward) or -1 (backward)")
+});
+var FindPlaceholdersSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file")
+});
+var ApplyTemplateSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  data: z.record(z.string(), z.unknown()).describe("Template data: keys are placeholder names, values are replacement values")
+});
+var GetMetadataSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file")
+});
+var UpdateMetadataSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  title: z.string().optional().describe("Presentation title"),
+  subject: z.string().optional().describe("Subject"),
+  creator: z.string().optional().describe("Creator/author name"),
+  keywords: z.string().optional().describe("Keywords (comma-separated)"),
+  description: z.string().optional().describe("Description/comments"),
+  lastModifiedBy: z.string().optional().describe("Last modified by"),
+  category: z.string().optional().describe("Category"),
+  company: z.string().optional().describe("Company name"),
+  manager: z.string().optional().describe("Manager name"),
+  customProperties: z.array(
+    z.object({
+      name: z.string(),
+      value: z.union([z.string(), z.number(), z.boolean()])
+    })
+  ).optional().describe("Custom properties to set")
+});
+var ManageSectionsSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  action: z.enum(["list", "add", "remove", "reorder", "moveSlides", "getForSlide"]).describe("Section action"),
+  name: z.string().optional().describe("Section name (for add)"),
+  slideIndices: z.array(z.number().int().min(0)).optional().describe("Slide indices (for add, moveSlides)"),
+  sectionId: z.string().optional().describe("Section ID (for remove, moveSlides)"),
+  sectionIds: z.array(z.string()).optional().describe("Ordered section IDs (for reorder)"),
+  slideIndex: z.number().int().min(0).optional().describe("Slide index (for getForSlide)")
+});
+var ExportToSvgSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndices: z.array(z.number().int().min(0)).optional().describe("Specific slides to export (all if omitted)"),
+  includeHidden: z.boolean().optional().describe("Include hidden slides"),
+  defaultFontFamily: z.string().optional().describe("Default font family for SVG"),
+  defaultFontSize: z.number().optional().describe("Default font size")
+});
+var ExportSlideSvgSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0).describe("Zero-based slide index to export"),
+  defaultFontFamily: z.string().optional().describe("Default font family for SVG"),
+  defaultFontSize: z.number().optional().describe("Default font size")
+});
+var ExportToJsonSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  pretty: z.boolean().optional().describe("Pretty-print the JSON document with 2-space indentation (default true)")
+});
+var ImportFromJsonSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  json: z.string().describe("The pptx-viewer-json document text to import (replaces the deck content)")
+});
+var ManageHyperlinksSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0).describe("Zero-based slide index"),
+  action: z.enum(["list", "set", "remove"]).describe("Hyperlink action"),
+  elementId: z.string().optional().describe("Element ID (for set/remove)"),
+  trigger: z.enum(["click", "hover"]).optional().describe("Action trigger (default: click)"),
+  url: z.string().optional().describe("URL for the hyperlink"),
+  tooltip: z.string().optional().describe("Tooltip text"),
+  targetSlideIndex: z.number().int().min(0).optional().describe("Target slide index for internal links"),
+  actionType: z.enum(["url", "slide", "nextSlide", "prevSlide", "firstSlide", "lastSlide", "endShow"]).optional().describe("Link action type")
+});
+var ReplaceGeometrySchema = 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("Shape element ID"),
+  shapeType: z.string().optional().describe('Preset shape type (e.g. "roundRect", "star5", "ellipse", "diamond")'),
+  svgPath: z.string().optional().describe("Custom SVG path data (mutually exclusive with shapeType)"),
+  pathWidth: z.number().optional().describe("Width of SVG path coordinate space"),
+  pathHeight: z.number().optional().describe("Height of SVG path coordinate space"),
+  adjustments: z.record(z.string(), z.number()).optional().describe("Shape adjustment values")
+});
+var SetElementLockSchema = 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("Element ID to lock/unlock"),
+  locked: z.boolean().describe("Whether the element should be locked"),
+  noMove: z.boolean().optional().describe("Prevent moving"),
+  noResize: z.boolean().optional().describe("Prevent resizing"),
+  noRotation: z.boolean().optional().describe("Prevent rotation"),
+  noSelect: z.boolean().optional().describe("Prevent selection"),
+  noTextEdit: z.boolean().optional().describe("Prevent text editing")
+});
+var ValidatePresentationSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file")
+});
+var RepairPresentationSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file")
+});
+var GetPresentationPropertiesSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file")
+});
+var UpdatePresentationPropertiesSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  showType: z.enum(["presented", "browsed", "kiosk"]).optional().describe("Slideshow mode"),
+  loopContinuously: z.boolean().optional().describe("Loop the slideshow"),
+  showWithNarration: z.boolean().optional().describe("Play narration"),
+  showWithAnimation: z.boolean().optional().describe("Play animations"),
+  advanceMode: z.enum(["manual", "useTimings"]).optional().describe("Slide advance mode"),
+  showSlidesMode: z.enum(["all", "customShow", "range"]).optional().describe("Which slides to show"),
+  showSlidesFrom: z.number().int().min(1).optional().describe("Range start (1-based)"),
+  showSlidesTo: z.number().int().min(1).optional().describe("Range end (1-based)"),
+  penColor: z.string().optional().describe("Annotation pen color (hex)")
+});
+var GetLayoutsSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file")
+});
+var ApplyLayoutSchema = z.object({
+  filePath: z.string().describe("Path to the PPTX file"),
+  slideIndex: z.number().int().min(0).describe("Zero-based slide index"),
+  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")
+});
+var formatChartDataPoint = apiToolsChartFormattingTools.formatChartDataPoint;
+var formatChartDataLabel = apiToolsChartFormattingTools.formatChartDataLabel;
+var formatChartSeries = apiToolsChartFormattingTools.formatChartSeries;
+var setChartHelperLineT = apiToolsChartFormattingTools.setChartHelperLineT;
+var setChartColorMapOverrideT = apiToolsChartFormattingTools.setChartColorMapOverrideT;
+var updateChart = apiToolsChartTools.updateChart;
+var addChartSeriesT = apiToolsChartTools.addChartSeriesT;
+var removeChartSeriesT = apiToolsChartTools.removeChartSeriesT;
+var updateChartSeriesData = apiToolsChartTools.updateChartSeriesData;
+var createChart = apiToolsChartTools.createChart;
+var listChartUserShapesT = apiToolsChartUserShapeTools.listChartUserShapesT;
+var addChartUserShapeT = apiToolsChartUserShapeTools.addChartUserShapeT;
+var updateChartUserShapeT = apiToolsChartUserShapeTools.updateChartUserShapeT;
+var removeChartUserShapeT = apiToolsChartUserShapeTools.removeChartUserShapeT;
+var findText = apiToolsContentTools.findText;
+var replaceText = apiToolsContentTools.replaceText;
+var manageComments = apiToolsContentTools.manageComments;
+var convertToMarkdown = apiToolsConversionTools.convertToMarkdown;
+var addElement = apiToolsElementTools.addElement;
+var updateElement = apiToolsElementTools.updateElement;
+var renameElement = apiToolsElementTools.renameElement;
+var deleteElements = apiToolsElementTools.deleteElements;
+var arrangeElements = apiToolsElementTools.arrangeElements;
+var cloneElement = apiToolsElementTools.cloneElement;
+var setElementAnimation = apiToolsElementTools.setElementAnimation;
+var groupElements = apiToolsElementTools.groupElements;
+var ungroupElements = apiToolsElementTools.ungroupElements;
+var batchUpdateElements = apiToolsElementTools.batchUpdateElements;
+var exportToSvg = apiToolsExportTools.exportToSvg;
+var exportSlideSvg = apiToolsExportTools.exportSlideSvg;
+var replaceGeometry = apiToolsGeometryTools.replaceGeometry;
+var manageHyperlinks = apiToolsHyperlinkTools.manageHyperlinks;
+var exportToJson = apiToolsJsonTools.exportToJson;
+var importFromJson = apiToolsJsonTools.importFromJson;
+var getLayouts = apiToolsLayoutTools.getLayouts;
+var applyLayout = apiToolsLayoutTools.applyLayout;
+var setElementLockT = apiToolsLockTools.setElementLockT;
+var getMetadata = apiToolsMetadataTools.getMetadata;
+var updateMetadata = apiToolsMetadataTools.updateMetadata;
+var getOleContent = apiToolsOleTools.getOleContent;
+var setOleSheetCell = apiToolsOleTools.setOleSheetCell;
+var setOleDocumentParagraph = apiToolsOleTools.setOleDocumentParagraph;
+var setOleDeckSlideTitle = apiToolsOleTools.setOleDeckSlideTitle;
+var setOleObjectNameT = apiToolsOleTools.setOleObjectNameT;
+var replaceOleFileT = apiToolsOleTools.replaceOleFileT;
+var getPresentationProperties = apiToolsPresentationTools.getPresentationProperties;
+var updatePresentationProperties = apiToolsPresentationTools.updatePresentationProperties;
+var manageSections = apiToolsSectionTools.manageSections;
+var getSlide = apiToolsSlideTools.getSlide;
+var addSlide = apiToolsSlideTools.addSlide;
+var deleteSlides = apiToolsSlideTools.deleteSlides;
+var reorderSlides = apiToolsSlideTools.reorderSlides;
+var duplicateSlide = apiToolsSlideTools.duplicateSlide;
+var updateSlideProperties = apiToolsSlideTools.updateSlideProperties;
+var setSlideTransition = apiToolsSlideTools.setSlideTransition;
+var setCanvasSize = apiToolsSlideTools.setCanvasSize;
+var manageSmartArt = apiToolsSmartartTools.manageSmartArt;
+apiToolsStyleTools.ALT_TEXT_ELEMENT_TYPES;
+apiToolsStyleTools.TITLE_ELEMENT_TYPES;
+apiToolsStyleTools.applyElementAltText;
+apiToolsStyleTools.applyElementTitle;
+var updateElementStyle = apiToolsStyleTools.updateElementStyle;
+var runAccessibilityCheck = apiToolsStyleTools.runAccessibilityCheck;
+var setTableStyleSection = apiToolsTableStyleTools.setTableStyleSection;
+var createTableStyle = apiToolsTableStyleTools.createTableStyle;
+var deleteTableStyle = apiToolsTableStyleTools.deleteTableStyle;
+var assignTableStyle = apiToolsTableStyleTools.assignTableStyle;
+var updateTableCells = apiToolsTableTools.updateTableCells;
+var manageTableStructure = apiToolsTableTools.manageTableStructure;
+var findPlaceholdersT = apiToolsTemplateTools.findPlaceholdersT;
+var applyTemplateT = apiToolsTemplateTools.applyTemplateT;
+var getThemeInfo = apiToolsThemeTools.getThemeInfo;
+var applyThemePreset = apiToolsThemeTools.applyThemePreset;
+var updateThemeColors = apiToolsThemeTools.updateThemeColors;
+var updateThemeFonts = apiToolsThemeTools.updateThemeFonts;
+var validatePresentation = apiToolsValidationTools.validatePresentation;
+var repairPresentation = apiToolsValidationTools.repairPresentation;
+apiExecution.loadPresentation;
+apiExecution.savePresentation;
+var executeToolWithContext = apiExecution.executeToolWithContext;
+
+// src/mcp/handlers.ts
+var ALLOWED_EXTENSIONS = /* @__PURE__ */ new Set([".pptx", ".ppt"]);
+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(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: 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);
+  const lower = resolved.toLowerCase();
+  let isAllowed = false;
+  for (const ext of ALLOWED_EXTENSIONS) {
+    if (lower.endsWith(ext)) {
+      isAllowed = true;
+      break;
+    }
+  }
+  if (!isAllowed) {
+    throw new Error(
+      `MCP tool: filePath "${filePath}" must end with one of: ${Array.from(ALLOWED_EXTENSIONS).join(", ")}`
+    );
+  }
+  return resolved;
+}
+var nodeFs = {
+  readFile: async (path) => new Uint8Array(await readFile(path)),
+  writeFile: async (path, data) => {
+    await writeFile(path, data);
+  }
+};
+function createMcpContext(_options) {
+  return { filesystem: nodeFs };
+}
+async function runMcpTool(filePath, fn, options) {
+  const safePath = resolveScopedFilePath(filePath);
+  const ctx = createMcpContext();
+  return executeToolWithContext(safePath, ctx, fn);
+}
+
+// src/mcp/server.ts
+function createServer(options) {
+  const server = new McpServer({
+    name: "pptx-viewer-tools",
+    version: "1.0.0"
+  });
+  registerTools(server);
+  return server;
+}
+function registerTools(server, options) {
+  const runMcpTool2 = (filePath, fn) => runMcpTool(filePath, fn);
+  const resolveScopedDir2 = (dir) => resolveScopedDir(dir);
+  const resolveScopedFilePath2 = (filePath) => resolveScopedFilePath(filePath);
+  server.registerTool(
+    "get_slide",
+    {
+      description: "Inspect a single slide: returns layout, notes, elements",
+      inputSchema: GetSlideSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => getSlide(ctx, { slideIndex: params.slideIndex })
+      );
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerTool(
+    "add_slide",
+    {
+      description: "Add a new blank slide to the presentation",
+      inputSchema: AddSlideSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(params.filePath, (ctx) => addSlide(ctx, params));
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerTool(
+    "delete_slides",
+    {
+      description: "Delete one or more slides by index",
+      inputSchema: DeleteSlidesSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => deleteSlides(ctx, {
+          slideIndexes: params.slideIndexes
+        })
+      );
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerTool(
+    "reorder_slides",
+    {
+      description: "Reorder slides by providing a new index array",
+      inputSchema: ReorderSlidesSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => reorderSlides(ctx, { newOrder: params.newOrder })
+      );
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerTool(
+    "duplicate_slide",
+    {
+      description: "Duplicate a slide with new element IDs",
+      inputSchema: DuplicateSlideSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => duplicateSlide(ctx, params)
+      );
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerTool(
+    "update_slide_properties",
+    {
+      description: "Update slide background, notes, or visibility",
+      inputSchema: UpdateSlidePropertiesSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => updateSlideProperties(ctx, params)
+      );
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerTool(
+    "set_slide_transition",
+    {
+      description: "Set or remove a slide transition effect",
+      inputSchema: SetSlideTransitionSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => setSlideTransition(ctx, params)
+      );
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerTool(
+    "set_canvas_size",
+    {
+      description: "Change the presentation canvas dimensions",
+      inputSchema: SetCanvasSizeSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => setCanvasSize(ctx, params)
+      );
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerTool(
+    "add_element",
+    {
+      description: "Add a text, shape, image, table, or connector element",
+      inputSchema: AddElementSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => addElement(ctx, params)
+      );
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerTool(
+    "update_element",
+    {
+      description: "Update element position, size, text, or style",
+      inputSchema: UpdateElementSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => updateElement(ctx, params)
+      );
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerTool(
+    "rename_element",
+    {
+      description: "Rename an element (the selection pane's display name; cNvPr/@name)",
+      inputSchema: RenameElementSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => renameElement(ctx, params)
+      );
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerTool(
+    "delete_elements",
+    {
+      description: "Delete one or more elements by ID",
+      inputSchema: DeleteElementsSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => deleteElements(ctx, params)
+      );
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerTool(
+    "arrange_elements",
+    {
+      description: "Align elements or change z-order (layer)",
+      inputSchema: ArrangeElementsSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => arrangeElements(ctx, params)
+      );
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerTool(
+    "clone_element",
+    {
+      description: "Clone an element within or across slides",
+      inputSchema: CloneElementSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => cloneElement(ctx, params)
+      );
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerTool(
+    "set_element_animation",
+    {
+      description: "Set entrance/exit animation on an element",
+      inputSchema: SetElementAnimationSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => setElementAnimation(ctx, params)
+      );
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerTool(
+    "group_elements",
+    {
+      description: "Group multiple elements into a group",
+      inputSchema: GroupElementsSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => groupElements(ctx, params)
+      );
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerTool(
+    "ungroup_elements",
+    {
+      description: "Ungroup a group element back to individual elements",
+      inputSchema: UngroupElementsSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => ungroupElements(ctx, params)
+      );
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerTool(
+    "batch_update_elements",
+    {
+      description: "Apply the same properties to multiple elements",
+      inputSchema: BatchUpdateElementsSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => batchUpdateElements(ctx, params)
+      );
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerTool(
+    "update_table_cells",
+    {
+      description: "Update text content of table cells",
+      inputSchema: UpdateTableCellsSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => updateTableCells(ctx, params)
+      );
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerTool(
+    "manage_table_structure",
+    {
+      description: "Insert or delete table rows and columns",
+      inputSchema: ManageTableStructureSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => manageTableStructure(ctx, params)
+      );
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerTool(
+    "set_table_style_section",
+    {
+      description: "Patch the fill, text, borders, or cell3D of one section (wholeTbl, banding, first/last row/col, or a corner cell) of an existing loaded table style",
+      inputSchema: SetTableStyleSectionSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => setTableStyleSection(ctx, params)
+      );
+      return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+      };
+    }
+  );
+  server.registerTool(
+    "create_table_style",
+    {
+      description: "Create a new table style (optionally cloned from an existing one) and optionally set it as the default",
+      inputSchema: CreateTableStyleSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => createTableStyle(ctx, params)
+      );
+      return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+      };
+    }
+  );
+  server.registerTool(
+    "delete_table_style",
+    {
+      description: "Remove a table style from the presentation",
+      inputSchema: DeleteTableStyleSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => deleteTableStyle(ctx, params)
+      );
+      return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+      };
+    }
+  );
+  server.registerTool(
+    "assign_table_style",
+    {
+      description: "Assign a table style (and row/column emphasis flags) to an existing table",
+      inputSchema: AssignTableStyleSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => assignTableStyle(ctx, params)
+      );
+      return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+      };
+    }
+  );
+  server.registerTool(
+    "update_element_style",
+    {
+      description: "Update fill, stroke, shadow, glow, or image effects",
+      inputSchema: UpdateElementStyleSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => updateElementStyle(ctx, params)
+      );
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerTool(
+    "run_accessibility_check",
+    {
+      description: "Audit the presentation for accessibility issues",
+      inputSchema: AccessibilityCheckSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => runAccessibilityCheck(ctx)
+      );
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerTool(
+    "find_text",
+    {
+      description: "Search for text across all slides",
+      inputSchema: FindTextSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(params.filePath, (ctx) => findText(ctx, params));
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerTool(
+    "replace_text",
+    {
+      description: "Find and replace text across slides",
+      inputSchema: ReplaceTextSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => replaceText(ctx, params)
+      );
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerTool(
+    "manage_comments",
+    {
+      description: "List, add, delete, or resolve slide comments",
+      inputSchema: ManageCommentsSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => manageComments(ctx, params)
+      );
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerTool(
+    "convert_to_markdown",
+    {
+      description: "Convert the presentation to Markdown format",
+      inputSchema: ConvertToMarkdownSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => convertToMarkdown(ctx, { ...params, scopeOutputDir: resolveScopedDir2 })
+      );
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result, null, 2)
+          }
+        ]
+      };
+    }
+  );
+  server.registerTool(
+    "get_theme_info",
+    {
+      description: "Get current theme information (colors, fonts, available presets)",
+      inputSchema: GetThemeInfoSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(params.filePath, (ctx) => getThemeInfo(ctx));
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "apply_theme_preset",
+    {
+      description: "Apply a built-in theme preset to the presentation",
+      inputSchema: ApplyThemePresetSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => applyThemePreset(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "update_theme_colors",
+    {
+      description: "Update individual theme colors (accent1-6, dk1/2, lt1/2, hlink, folHlink)",
+      inputSchema: UpdateThemeColorsSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => updateThemeColors(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "update_theme_fonts",
+    {
+      description: "Update theme heading (major) and body (minor) fonts",
+      inputSchema: UpdateThemeFontsSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => updateThemeFonts(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "update_chart",
+    {
+      description: "Update chart type, title, legend, data labels, axis, or categories",
+      inputSchema: UpdateChartSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => updateChart(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "add_chart_series",
+    {
+      description: "Add a data series to an existing chart",
+      inputSchema: AddChartSeriesSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => addChartSeriesT(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "remove_chart_series",
+    {
+      description: "Remove a data series from a chart by index",
+      inputSchema: RemoveChartSeriesSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => removeChartSeriesT(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "update_chart_series_data",
+    {
+      description: "Update data values for a chart series",
+      inputSchema: UpdateChartSeriesDataSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => updateChartSeriesData(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "create_chart",
+    {
+      description: "Create a new chart element on a slide",
+      inputSchema: CreateChartSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => createChart(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "format_chart_data_point",
+    {
+      description: "Set per-data-point chart formatting: fill/stroke colour, stroke width, dash style (c:dPt/c:spPr), explosion, and marker override",
+      inputSchema: FormatChartDataPointSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => formatChartDataPoint(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "format_chart_data_label",
+    {
+      description: "Set a per-data-point data-label override (c:dLbl): show flags, position, custom text, and the label's own fill/line formatting (c:spPr) and font (c:txPr)",
+      inputSchema: FormatChartDataLabelSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => formatChartDataLabel(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "format_chart_series",
+    {
+      description: "Set a chart series marker (c:marker), trendline (c:trendline, incl. line width/dash), or error bars (c:errBars, incl. line width/dash)",
+      inputSchema: FormatChartSeriesSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => formatChartSeries(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "set_chart_helper_line",
+    {
+      description: "Set or remove a chart-level helper line on a line/stock/combo chart: c:dropLines or c:hiLowLines",
+      inputSchema: SetChartHelperLineSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => setChartHelperLineT(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "set_chart_color_map_override",
+    {
+      description: "Set or remove a chart's theme colour-map override (c:clrMapOvr), remapping theme colour roles for this chart only",
+      inputSchema: SetChartColorMapOverrideSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => setChartColorMapOverrideT(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "chart_user_shape_list",
+    {
+      description: "List a chart's drawing-overlay shapes (c:userShapes)",
+      inputSchema: ListChartUserShapesSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => listChartUserShapesT(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "chart_user_shape_add",
+    {
+      description: "Add a drawing-overlay shape (text box or connector) to a chart's c:userShapes",
+      inputSchema: AddChartUserShapeSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => addChartUserShapeT(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "chart_user_shape_update",
+    {
+      description: "Move, resize, or restyle one of a chart's drawing-overlay shapes by index",
+      inputSchema: UpdateChartUserShapeSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => updateChartUserShapeT(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "chart_user_shape_remove",
+    {
+      description: "Remove one of a chart's drawing-overlay shapes by index",
+      inputSchema: RemoveChartUserShapeSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => removeChartUserShapeT(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "manage_smart_art",
+    {
+      description: "Manage SmartArt: get nodes, add/remove/reorder/promote/demote nodes, or decompose to shapes",
+      inputSchema: ManageSmartArtSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => manageSmartArt(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "find_placeholders",
+    {
+      description: "Discover all {{placeholder}} tokens in the presentation",
+      inputSchema: FindPlaceholdersSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => findPlaceholdersT(ctx)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "apply_template",
+    {
+      description: "Replace {{placeholder}} tokens with provided values (mail merge)",
+      inputSchema: ApplyTemplateSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => applyTemplateT(ctx, { data: params.data })
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "get_metadata",
+    {
+      description: "Get presentation metadata (title, author, keywords, custom properties)",
+      inputSchema: GetMetadataSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(params.filePath, (ctx) => getMetadata(ctx));
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "update_metadata",
+    {
+      description: "Update presentation metadata (title, author, company, custom properties)",
+      inputSchema: UpdateMetadataSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => updateMetadata(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "manage_sections",
+    {
+      description: "List, add, remove, reorder sections or move slides between sections",
+      inputSchema: ManageSectionsSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => manageSections(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "export_to_svg",
+    {
+      description: "Export all or specific slides to SVG strings",
+      inputSchema: ExportToSvgSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => exportToSvg(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "export_slide_svg",
+    {
+      description: "Export a single slide to SVG",
+      inputSchema: ExportSlideSvgSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => exportSlideSvg(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "export_to_json",
+    {
+      description: "Export the presentation to the portable pptx-viewer-json document format (self-contained, binary assets embedded as base64)",
+      inputSchema: ExportToJsonSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => exportToJson(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "import_from_json",
+    {
+      description: "Replace the presentation content with a deck imported from a pptx-viewer-json document",
+      inputSchema: ImportFromJsonSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => importFromJson(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "manage_hyperlinks",
+    {
+      description: "List, set, or remove hyperlinks/actions on elements",
+      inputSchema: ManageHyperlinksSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => manageHyperlinks(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "replace_geometry",
+    {
+      description: "Replace a shape element geometry with a preset or custom SVG path",
+      inputSchema: ReplaceGeometrySchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => replaceGeometry(ctx, {
+          ...params,
+          adjustments: params.adjustments
+        })
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "set_element_lock",
+    {
+      description: "Lock or unlock an element (prevent move, resize, rotation, selection, text edit)",
+      inputSchema: SetElementLockSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => setElementLockT(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "validate_presentation",
+    {
+      description: "Validate PPTX structural integrity (content types, relationships, XML)",
+      inputSchema: ValidatePresentationSchema.shape
+    },
+    async (params) => {
+      const { readFile: readFile2 } = await import('fs/promises');
+      const safePath = resolveScopedFilePath2(params.filePath);
+      const bytes = await readFile2(safePath);
+      const result = await validatePresentation(bytes.buffer);
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "repair_presentation",
+    {
+      description: "Auto-repair common PPTX structural issues",
+      inputSchema: RepairPresentationSchema.shape
+    },
+    async (params) => {
+      const { readFile: readFile2, writeFile: writeFile2 } = await import('fs/promises');
+      const safePath = resolveScopedFilePath2(params.filePath);
+      const bytes = await readFile2(safePath);
+      const { result, repairedBytes } = await repairPresentation(
+        bytes.buffer
+      );
+      if (result.repairCount > 0) {
+        await writeFile2(safePath, new Uint8Array(repairedBytes));
+      }
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "get_presentation_properties",
+    {
+      description: "Get slideshow properties (show type, loop, advance mode, slide range)",
+      inputSchema: GetPresentationPropertiesSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => getPresentationProperties(ctx)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "update_presentation_properties",
+    {
+      description: "Update slideshow properties (show type, loop, advance mode, pen color)",
+      inputSchema: UpdatePresentationPropertiesSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => updatePresentationProperties(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "get_layouts",
+    {
+      description: "List available slide layouts from the presentation masters",
+      inputSchema: GetLayoutsSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(params.filePath, (ctx) => getLayouts(ctx));
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.registerTool(
+    "apply_layout",
+    {
+      description: "Apply a slide layout to a specific slide",
+      inputSchema: ApplyLayoutSchema.shape
+    },
+    async (params) => {
+      const result = await runMcpTool2(
+        params.filePath,
+        (ctx) => applyLayout(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.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 runMcpTool2(
+        params.filePath,
+        (ctx) => getOleContent(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.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 runMcpTool2(
+        params.filePath,
+        (ctx) => setOleSheetCell(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.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 runMcpTool2(
+        params.filePath,
+        (ctx) => setOleDocumentParagraph(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.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 runMcpTool2(
+        params.filePath,
+        (ctx) => setOleDeckSlideTitle(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.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 runMcpTool2(
+        params.filePath,
+        (ctx) => replaceOleFileT(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+  server.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 runMcpTool2(
+        params.filePath,
+        (ctx) => setOleObjectNameT(ctx, params)
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+}
+
+// src/mcp/cli.ts
+void createServer().connect(new StdioServerTransport());