Open a PowerPoint presentation, initialize an isolated editing session with a working copy, and return session status and presentation overview.

Save session working copy back to the original presentation path, creating an automatic timestamped backup before writing.

Save session working copy to a specified new destination file path without modifying the original.

Discard current uncommitted edits and revert working copy to original state or a specified backup timestamp.

Inspect high-level presentation metadata, slide count, dimensions, master layout names, and titles without modifying any state.

Inspect shapes on a specific slide with filtering and detail control. Defaults to concise agent-friendly summary. Supports text_only=True, include_geometry, include_style, include_images, shape_types, and semantic_roles filters.

Efficiently inspect all text-bearing shapes on a slide without full shape-tree overhead. Returns concise shape IDs, semantic roles, text content, font styling, and coordinates.

Get exhaustive details for a single shape on a slide, including all text frames, paragraphs, runs, margins, line styling, fill properties, and OOXML snippet.

Compare geometric, typographic, and semantic layout properties between two slides, matching corresponding shapes with multi-factor confidence scores.

Run rule-based geometric and typographic validation on a slide, detecting overlaps (VAL-01), boundary clipping (VAL-02), off-slide elements (VAL-03), text overflow (VAL-04), tiny fonts (VAL-05), and duplicate objects (VAL-07). Returns structured summary counts and issue descriptions.

Analyze the complete semantic layout hierarchy, shape roles (slide_title, subtitle, card, card_title, metric, badge, body, bullet, footer, icon, image, connector), confidence scores, and logical container nesting.

Identify logical containers (cards, group boxes) and their contained child elements on a slide with bounding boxes, relative child positions, and container confidence scores.

Deterministically update a shape's coordinates, dimensions, rotation, z-order, or apply multi-shape alignment and distribution. Only provided properties are modified.

Update text content and formatting in a text frame. Supports replacing full text or individual runs while strictly preserving surrounding rich-text typography (font, size, colors, weights). Supports absolute font sizing, relative deltas (font_size_delta), scaling (font_size_scale), and bounds (min_font_size, max_font_size).

Proportionally scale or adjust font sizes across all text-bearing shapes on an entire slide while strictly preserving typography hierarchy and paragraph/bullet formatting.

Clone an existing shape with all formatting, fills, lines, and text styles preserved onto the same or a different slide.

Move a shape by specifying absolute coordinates (x, y) or relative deltas (dx, dy) in inches.

Resize a shape using absolute width/height in inches or scaling multipliers with optional aspect ratio lock.

Delete a shape cleanly from a slide.

Modify multiple text shapes on a slide in a single transaction with pre-validation. Preserves existing paragraph bullets and indent structures by default.

Modify multiple shape geometries (positions, sizes, rotations, z-orders) on a slide in a single transaction. Pre-validates all shape IDs and applies atomic geometry changes.

Align multiple shapes along a common edge or center line (left, center, right, top, middle, bottom) without manual coordinate math.

Distribute 3 or more shapes evenly across a horizontal or vertical axis using equal gaps or equal centers.

Set an exact fixed gap in inches between consecutive adjacent shapes horizontally or vertically.

Equalize width, height, or both across multiple shapes deterministically using first, max, min, avg, or target dimensions.

Move a logical container (card) and all its nested child shapes atomically without breaking alignment or child offsets.

Resize a logical container (card) and proportionally adjust/reflow contained children to maintain padding and prevent overflow.

Deterministically stack and organize all child elements vertically inside a container with clean padding and even vertical gaps.

Apply standard design style presets (card_default, card_accent, badge_neutral, badge_success, badge_warning, badge_danger, title_hero, title_section, metric_kpi) or transfer fill/border/font styles directly from a source shape without changing text content.

Create a clean multi-step flow or process diagram with aligned nodes, connecting arrows, and typography presets without manual coordinate arithmetic.

Controlled low-level OOXML manipulation helper for features like gradients, transparency, drop shadows, and raw XML manipulation. Creates safety backup before mutation.

Render a single slide to high-resolution PNG using PowerPoint COM (Windows) or LibreOffice headless.

Render all slides in the presentation to PNG images.

Perform deterministic pixel-level image comparison between two slide renders, generating a diff image, changed bounding boxes, and similarity metrics.