orquesta-cli 0.1.12

package/src/tools/office/powerpoint-tools/shapes.ts

@@ -0,0 +1,870 @@
+/**
+ * PowerPoint Shape Tools
+ *
+ * Tools for managing shapes in PowerPoint presentations:
+ * - Basic: add, delete, duplicate, rotate
+ * - Info: get info, set name, list
+ * - Transform: position, size, style, opacity
+ * - Z-Order: bring to front, send to back, bring forward, send backward
+ * - Multi-shape: align, distribute, group, ungroup
+ */
+
+import { ToolDefinition } from '../../../types/index.js';
+import { LLMSimpleTool, ToolResult } from '../../types.js';
+import { powerpointClient } from '../powerpoint-client.js';
+import { OFFICE_CATEGORIES } from '../common/constants.js';
+
+// =============================================================================
+// PowerPoint Add Shape
+// =============================================================================
+
+const POWERPOINT_ADD_SHAPE_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'powerpoint_add_shape',
+    description: `Add a shape to a slide.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are adding a shape' },
+        slide: { type: 'number', description: 'Slide number' },
+        shape_type: { type: 'string', enum: ['rectangle', 'oval', 'triangle', 'arrow', 'star'], description: 'Type of shape' },
+        left: { type: 'number', description: 'Left position in points' },
+        top: { type: 'number', description: 'Top position in points' },
+        width: { type: 'number', description: 'Width in points' },
+        height: { type: 'number', description: 'Height in points' },
+        fill_color: { type: 'string', description: 'Fill color as hex (optional)' },
+      },
+      required: ['reason', 'slide', 'shape_type', 'left', 'top', 'width', 'height'],
+    },
+  },
+};
+
+async function executePowerPointAddShape(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await powerpointClient.powerpointAddShape(
+      args['slide'] as number,
+      args['shape_type'] as 'rectangle' | 'oval' | 'triangle' | 'arrow' | 'star',
+      args['left'] as number,
+      args['top'] as number,
+      args['width'] as number,
+      args['height'] as number,
+      args['fill_color'] as string | undefined
+    );
+    if (response.success) {
+      return { success: true, result: `${args['shape_type']} shape added to slide ${args['slide']}` };
+    }
+    return { success: false, error: response.error || 'Failed to add shape' };
+  } catch (error) {
+    return { success: false, error: `Failed to add shape: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const powerpointAddShapeTool: LLMSimpleTool = {
+  definition: POWERPOINT_ADD_SHAPE_DEFINITION,
+  execute: executePowerPointAddShape,
+  categories: OFFICE_CATEGORIES,
+  description: 'Add PowerPoint shape',
+};
+
+// =============================================================================
+// PowerPoint Delete Shape
+// =============================================================================
+
+const POWERPOINT_DELETE_SHAPE_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'powerpoint_delete_shape',
+    description: `Delete a shape from a slide.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        slide_number: { type: 'number', description: 'Slide number' },
+        shape_index: { type: 'number', description: 'Shape index to delete' },
+      },
+      required: ['slide_number', 'shape_index'],
+    },
+  },
+};
+
+async function executePowerPointDeleteShape(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await powerpointClient.powerpointDeleteShape(
+      args['slide_number'] as number,
+      args['shape_index'] as number
+    );
+    if (response.success) {
+      return { success: true, result: response.message || 'Shape deleted' };
+    }
+    return { success: false, error: response.error || 'Failed to delete shape' };
+  } catch (error) {
+    return { success: false, error: `Failed to delete shape: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const powerpointDeleteShapeTool: LLMSimpleTool = {
+  definition: POWERPOINT_DELETE_SHAPE_DEFINITION,
+  execute: executePowerPointDeleteShape,
+  categories: OFFICE_CATEGORIES,
+  description: 'Delete shape from slide',
+};
+
+// =============================================================================
+// PowerPoint Duplicate Shape
+// =============================================================================
+
+const POWERPOINT_DUPLICATE_SHAPE_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'powerpoint_duplicate_shape',
+    description: `Duplicate a shape on a slide.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        slide_number: { type: 'number', description: 'Slide number' },
+        shape_index: { type: 'number', description: 'Shape index to duplicate' },
+      },
+      required: ['slide_number', 'shape_index'],
+    },
+  },
+};
+
+async function executePowerPointDuplicateShape(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await powerpointClient.powerpointDuplicateShape(
+      args['slide_number'] as number,
+      args['shape_index'] as number
+    );
+    if (response.success) {
+      return { success: true, result: `Shape duplicated. New shape index: ${response['new_shape_index']}` };
+    }
+    return { success: false, error: response.error || 'Failed to duplicate shape' };
+  } catch (error) {
+    return { success: false, error: `Failed to duplicate shape: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const powerpointDuplicateShapeTool: LLMSimpleTool = {
+  definition: POWERPOINT_DUPLICATE_SHAPE_DEFINITION,
+  execute: executePowerPointDuplicateShape,
+  categories: OFFICE_CATEGORIES,
+  description: 'Duplicate shape',
+};
+
+// =============================================================================
+// PowerPoint Rotate Shape
+// =============================================================================
+
+const POWERPOINT_ROTATE_SHAPE_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'powerpoint_rotate_shape',
+    description: `Rotate a shape to a specific angle.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        slide_number: { type: 'number', description: 'Slide number' },
+        shape_index: { type: 'number', description: 'Shape index' },
+        angle: { type: 'number', description: 'Rotation angle in degrees (0-360)' },
+      },
+      required: ['slide_number', 'shape_index', 'angle'],
+    },
+  },
+};
+
+async function executePowerPointRotateShape(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await powerpointClient.powerpointRotateShape(
+      args['slide_number'] as number,
+      args['shape_index'] as number,
+      args['angle'] as number
+    );
+    if (response.success) {
+      return { success: true, result: response.message || 'Shape rotated' };
+    }
+    return { success: false, error: response.error || 'Failed to rotate shape' };
+  } catch (error) {
+    return { success: false, error: `Failed to rotate shape: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const powerpointRotateShapeTool: LLMSimpleTool = {
+  definition: POWERPOINT_ROTATE_SHAPE_DEFINITION,
+  execute: executePowerPointRotateShape,
+  categories: OFFICE_CATEGORIES,
+  description: 'Rotate shape',
+};
+
+// =============================================================================
+// PowerPoint Get Shape Info
+// =============================================================================
+
+const POWERPOINT_GET_SHAPE_INFO_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'powerpoint_get_shape_info',
+    description: `Get detailed information about a shape.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        slide_number: { type: 'number', description: 'Slide number' },
+        shape_index: { type: 'number', description: 'Shape index' },
+      },
+      required: ['slide_number', 'shape_index'],
+    },
+  },
+};
+
+async function executePowerPointGetShapeInfo(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await powerpointClient.powerpointGetShapeInfo(
+      args['slide_number'] as number,
+      args['shape_index'] as number
+    );
+    if (response.success) {
+      return { success: true, result: JSON.stringify(response, null, 2) };
+    }
+    return { success: false, error: response.error || 'Failed to get shape info' };
+  } catch (error) {
+    return { success: false, error: `Failed to get shape info: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const powerpointGetShapeInfoTool: LLMSimpleTool = {
+  definition: POWERPOINT_GET_SHAPE_INFO_DEFINITION,
+  execute: executePowerPointGetShapeInfo,
+  categories: OFFICE_CATEGORIES,
+  description: 'Get shape information',
+};
+
+// =============================================================================
+// PowerPoint Set Shape Name
+// =============================================================================
+
+const POWERPOINT_SET_SHAPE_NAME_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'powerpoint_set_shape_name',
+    description: `Set a name for a shape (for easier identification).`,
+    parameters: {
+      type: 'object',
+      properties: {
+        slide_number: { type: 'number', description: 'Slide number' },
+        shape_index: { type: 'number', description: 'Shape index' },
+        name: { type: 'string', description: 'Shape name' },
+      },
+      required: ['slide_number', 'shape_index', 'name'],
+    },
+  },
+};
+
+async function executePowerPointSetShapeName(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await powerpointClient.powerpointSetShapeName(
+      args['slide_number'] as number,
+      args['shape_index'] as number,
+      args['name'] as string
+    );
+    if (response.success) {
+      return { success: true, result: response.message || 'Shape name set' };
+    }
+    return { success: false, error: response.error || 'Failed to set shape name' };
+  } catch (error) {
+    return { success: false, error: `Failed to set shape name: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const powerpointSetShapeNameTool: LLMSimpleTool = {
+  definition: POWERPOINT_SET_SHAPE_NAME_DEFINITION,
+  execute: executePowerPointSetShapeName,
+  categories: OFFICE_CATEGORIES,
+  description: 'Set shape name',
+};
+
+// =============================================================================
+// PowerPoint Get Shape List
+// =============================================================================
+
+const POWERPOINT_GET_SHAPE_LIST_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'powerpoint_get_shape_list',
+    description: `Get list of all shapes on a slide.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        slide_number: { type: 'number', description: 'Slide number' },
+      },
+      required: ['slide_number'],
+    },
+  },
+};
+
+async function executePowerPointGetShapeList(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await powerpointClient.powerpointGetShapeList(args['slide_number'] as number);
+    if (response.success) {
+      return { success: true, result: JSON.stringify(response, null, 2) };
+    }
+    return { success: false, error: response.error || 'Failed to get shape list' };
+  } catch (error) {
+    return { success: false, error: `Failed to get shape list: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const powerpointGetShapeListTool: LLMSimpleTool = {
+  definition: POWERPOINT_GET_SHAPE_LIST_DEFINITION,
+  execute: executePowerPointGetShapeList,
+  categories: OFFICE_CATEGORIES,
+  description: 'Get list of shapes on slide',
+};
+
+// =============================================================================
+// PowerPoint Set Shape Position
+// =============================================================================
+
+const POWERPOINT_SET_SHAPE_POSITION_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'powerpoint_set_shape_position',
+    description: `Set the position of a shape on a slide.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        slide_number: { type: 'number', description: 'Slide number' },
+        shape_index: { type: 'number', description: 'Shape index' },
+        left: { type: 'number', description: 'Left position in points' },
+        top: { type: 'number', description: 'Top position in points' },
+      },
+      required: ['slide_number', 'shape_index', 'left', 'top'],
+    },
+  },
+};
+
+async function executePowerPointSetShapePosition(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await powerpointClient.powerpointSetShapePosition(
+      args['slide_number'] as number,
+      args['shape_index'] as number,
+      args['left'] as number,
+      args['top'] as number
+    );
+    if (response.success) {
+      return { success: true, result: response.message || 'Shape position set' };
+    }
+    return { success: false, error: response.error || 'Failed to set shape position' };
+  } catch (error) {
+    return { success: false, error: `Failed to set shape position: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const powerpointSetShapePositionTool: LLMSimpleTool = {
+  definition: POWERPOINT_SET_SHAPE_POSITION_DEFINITION,
+  execute: executePowerPointSetShapePosition,
+  categories: OFFICE_CATEGORIES,
+  description: 'Set shape position',
+};
+
+// =============================================================================
+// PowerPoint Set Shape Size
+// =============================================================================
+
+const POWERPOINT_SET_SHAPE_SIZE_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'powerpoint_set_shape_size',
+    description: `Set the size of a shape.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        slide_number: { type: 'number', description: 'Slide number' },
+        shape_index: { type: 'number', description: 'Shape index' },
+        width: { type: 'number', description: 'Width in points' },
+        height: { type: 'number', description: 'Height in points' },
+        lock_aspect_ratio: { type: 'boolean', description: 'Lock aspect ratio (default: false)' },
+      },
+      required: ['slide_number', 'shape_index', 'width', 'height'],
+    },
+  },
+};
+
+async function executePowerPointSetShapeSize(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await powerpointClient.powerpointSetShapeSize(
+      args['slide_number'] as number,
+      args['shape_index'] as number,
+      args['width'] as number,
+      args['height'] as number,
+      args['lock_aspect_ratio'] as boolean | undefined
+    );
+    if (response.success) {
+      return { success: true, result: response.message || 'Shape size set' };
+    }
+    return { success: false, error: response.error || 'Failed to set shape size' };
+  } catch (error) {
+    return { success: false, error: `Failed to set shape size: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const powerpointSetShapeSizeTool: LLMSimpleTool = {
+  definition: POWERPOINT_SET_SHAPE_SIZE_DEFINITION,
+  execute: executePowerPointSetShapeSize,
+  categories: OFFICE_CATEGORIES,
+  description: 'Set shape size',
+};
+
+// =============================================================================
+// PowerPoint Set Shape Style
+// =============================================================================
+
+const POWERPOINT_SET_SHAPE_STYLE_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'powerpoint_set_shape_style',
+    description: `Set the fill and line style of a shape.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        slide_number: { type: 'number', description: 'Slide number' },
+        shape_index: { type: 'number', description: 'Shape index' },
+        fill_color: { type: 'string', description: 'Fill color (hex: #RRGGBB)' },
+        fill_transparency: { type: 'number', description: 'Fill transparency (0-100)' },
+        line_color: { type: 'string', description: 'Line/border color (hex)' },
+        line_weight: { type: 'number', description: 'Line weight in points' },
+        line_style: { type: 'string', enum: ['solid', 'dash', 'dot', 'dashDot'], description: 'Line style' },
+        no_fill: { type: 'boolean', description: 'Remove fill' },
+        no_line: { type: 'boolean', description: 'Remove line/border' },
+      },
+      required: ['slide_number', 'shape_index'],
+    },
+  },
+};
+
+async function executePowerPointSetShapeStyle(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await powerpointClient.powerpointSetShapeStyle(
+      args['slide_number'] as number,
+      args['shape_index'] as number,
+      {
+        fillColor: args['fill_color'] as string | undefined,
+        fillTransparency: args['fill_transparency'] as number | undefined,
+        lineColor: args['line_color'] as string | undefined,
+        lineWeight: args['line_weight'] as number | undefined,
+        lineStyle: args['line_style'] as 'solid' | 'dash' | 'dot' | 'dashDot' | undefined,
+        noFill: args['no_fill'] as boolean | undefined,
+        noLine: args['no_line'] as boolean | undefined,
+      }
+    );
+    if (response.success) {
+      return { success: true, result: response.message || 'Shape style updated' };
+    }
+    return { success: false, error: response.error || 'Failed to set shape style' };
+  } catch (error) {
+    return { success: false, error: `Failed to set shape style: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const powerpointSetShapeStyleTool: LLMSimpleTool = {
+  definition: POWERPOINT_SET_SHAPE_STYLE_DEFINITION,
+  execute: executePowerPointSetShapeStyle,
+  categories: OFFICE_CATEGORIES,
+  description: 'Set shape fill and line style',
+};
+
+// =============================================================================
+// PowerPoint Set Shape Opacity
+// =============================================================================
+
+const POWERPOINT_SET_SHAPE_OPACITY_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'powerpoint_set_shape_opacity',
+    description: `Set the opacity/transparency of a shape.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        slide_number: { type: 'number', description: 'Slide number' },
+        shape_index: { type: 'number', description: 'Shape index' },
+        opacity: { type: 'number', description: 'Opacity percentage (0-100, where 0 is fully transparent)' },
+      },
+      required: ['slide_number', 'shape_index', 'opacity'],
+    },
+  },
+};
+
+async function executePowerPointSetShapeOpacity(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await powerpointClient.powerpointSetShapeOpacity(
+      args['slide_number'] as number,
+      args['shape_index'] as number,
+      args['opacity'] as number
+    );
+    if (response.success) {
+      return { success: true, result: response.message || 'Shape opacity set' };
+    }
+    return { success: false, error: response.error || 'Failed to set shape opacity' };
+  } catch (error) {
+    return { success: false, error: `Failed to set shape opacity: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const powerpointSetShapeOpacityTool: LLMSimpleTool = {
+  definition: POWERPOINT_SET_SHAPE_OPACITY_DEFINITION,
+  execute: executePowerPointSetShapeOpacity,
+  categories: OFFICE_CATEGORIES,
+  description: 'Set shape opacity',
+};
+
+// =============================================================================
+// PowerPoint Z-Order Functions
+// =============================================================================
+
+const POWERPOINT_BRING_TO_FRONT_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'powerpoint_bring_to_front',
+    description: `Bring a shape to the front (topmost layer).`,
+    parameters: {
+      type: 'object',
+      properties: {
+        slide_number: { type: 'number', description: 'Slide number' },
+        shape_index: { type: 'number', description: 'Shape index' },
+      },
+      required: ['slide_number', 'shape_index'],
+    },
+  },
+};
+
+async function executePowerPointBringToFront(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await powerpointClient.powerpointBringToFront(
+      args['slide_number'] as number,
+      args['shape_index'] as number
+    );
+    if (response.success) {
+      return { success: true, result: response.message || 'Shape brought to front' };
+    }
+    return { success: false, error: response.error || 'Failed to bring shape to front' };
+  } catch (error) {
+    return { success: false, error: `Failed to bring shape to front: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const powerpointBringToFrontTool: LLMSimpleTool = {
+  definition: POWERPOINT_BRING_TO_FRONT_DEFINITION,
+  execute: executePowerPointBringToFront,
+  categories: OFFICE_CATEGORIES,
+  description: 'Bring shape to front',
+};
+
+const POWERPOINT_SEND_TO_BACK_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'powerpoint_send_to_back',
+    description: `Send a shape to the back (bottommost layer).`,
+    parameters: {
+      type: 'object',
+      properties: {
+        slide_number: { type: 'number', description: 'Slide number' },
+        shape_index: { type: 'number', description: 'Shape index' },
+      },
+      required: ['slide_number', 'shape_index'],
+    },
+  },
+};
+
+async function executePowerPointSendToBack(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await powerpointClient.powerpointSendToBack(
+      args['slide_number'] as number,
+      args['shape_index'] as number
+    );
+    if (response.success) {
+      return { success: true, result: response.message || 'Shape sent to back' };
+    }
+    return { success: false, error: response.error || 'Failed to send shape to back' };
+  } catch (error) {
+    return { success: false, error: `Failed to send shape to back: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const powerpointSendToBackTool: LLMSimpleTool = {
+  definition: POWERPOINT_SEND_TO_BACK_DEFINITION,
+  execute: executePowerPointSendToBack,
+  categories: OFFICE_CATEGORIES,
+  description: 'Send shape to back',
+};
+
+const POWERPOINT_BRING_FORWARD_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'powerpoint_bring_forward',
+    description: `Bring a shape forward one layer.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        slide_number: { type: 'number', description: 'Slide number' },
+        shape_index: { type: 'number', description: 'Shape index' },
+      },
+      required: ['slide_number', 'shape_index'],
+    },
+  },
+};
+
+async function executePowerPointBringForward(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await powerpointClient.powerpointBringForward(
+      args['slide_number'] as number,
+      args['shape_index'] as number
+    );
+    if (response.success) {
+      return { success: true, result: response.message || 'Shape brought forward' };
+    }
+    return { success: false, error: response.error || 'Failed to bring shape forward' };
+  } catch (error) {
+    return { success: false, error: `Failed to bring shape forward: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const powerpointBringForwardTool: LLMSimpleTool = {
+  definition: POWERPOINT_BRING_FORWARD_DEFINITION,
+  execute: executePowerPointBringForward,
+  categories: OFFICE_CATEGORIES,
+  description: 'Bring shape forward one layer',
+};
+
+const POWERPOINT_SEND_BACKWARD_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'powerpoint_send_backward',
+    description: `Send a shape backward one layer.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        slide_number: { type: 'number', description: 'Slide number' },
+        shape_index: { type: 'number', description: 'Shape index' },
+      },
+      required: ['slide_number', 'shape_index'],
+    },
+  },
+};
+
+async function executePowerPointSendBackward(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await powerpointClient.powerpointSendBackward(
+      args['slide_number'] as number,
+      args['shape_index'] as number
+    );
+    if (response.success) {
+      return { success: true, result: response.message || 'Shape sent backward' };
+    }
+    return { success: false, error: response.error || 'Failed to send shape backward' };
+  } catch (error) {
+    return { success: false, error: `Failed to send shape backward: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const powerpointSendBackwardTool: LLMSimpleTool = {
+  definition: POWERPOINT_SEND_BACKWARD_DEFINITION,
+  execute: executePowerPointSendBackward,
+  categories: OFFICE_CATEGORIES,
+  description: 'Send shape backward one layer',
+};
+
+// =============================================================================
+// PowerPoint Align Shapes
+// =============================================================================
+
+const POWERPOINT_ALIGN_SHAPES_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'powerpoint_align_shapes',
+    description: `Align multiple shapes.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        slide_number: { type: 'number', description: 'Slide number' },
+        shape_indices: { type: 'array', items: { type: 'number' }, description: 'Array of shape indices to align' },
+        alignment: { type: 'string', enum: ['left', 'center', 'right', 'top', 'middle', 'bottom'], description: 'Alignment type' },
+      },
+      required: ['slide_number', 'shape_indices', 'alignment'],
+    },
+  },
+};
+
+async function executePowerPointAlignShapes(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await powerpointClient.powerpointAlignShapes(
+      args['slide_number'] as number,
+      args['shape_indices'] as number[],
+      args['alignment'] as 'left' | 'center' | 'right' | 'top' | 'middle' | 'bottom'
+    );
+    if (response.success) {
+      return { success: true, result: response.message || 'Shapes aligned' };
+    }
+    return { success: false, error: response.error || 'Failed to align shapes' };
+  } catch (error) {
+    return { success: false, error: `Failed to align shapes: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const powerpointAlignShapesTool: LLMSimpleTool = {
+  definition: POWERPOINT_ALIGN_SHAPES_DEFINITION,
+  execute: executePowerPointAlignShapes,
+  categories: OFFICE_CATEGORIES,
+  description: 'Align multiple shapes',
+};
+
+// =============================================================================
+// PowerPoint Distribute Shapes
+// =============================================================================
+
+const POWERPOINT_DISTRIBUTE_SHAPES_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'powerpoint_distribute_shapes',
+    description: `Distribute shapes evenly.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        slide_number: { type: 'number', description: 'Slide number' },
+        shape_indices: { type: 'array', items: { type: 'number' }, description: 'Array of shape indices' },
+        direction: { type: 'string', enum: ['horizontal', 'vertical'], description: 'Distribution direction' },
+      },
+      required: ['slide_number', 'shape_indices', 'direction'],
+    },
+  },
+};
+
+async function executePowerPointDistributeShapes(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await powerpointClient.powerpointDistributeShapes(
+      args['slide_number'] as number,
+      args['shape_indices'] as number[],
+      args['direction'] as 'horizontal' | 'vertical'
+    );
+    if (response.success) {
+      return { success: true, result: response.message || 'Shapes distributed' };
+    }
+    return { success: false, error: response.error || 'Failed to distribute shapes' };
+  } catch (error) {
+    return { success: false, error: `Failed to distribute shapes: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const powerpointDistributeShapesTool: LLMSimpleTool = {
+  definition: POWERPOINT_DISTRIBUTE_SHAPES_DEFINITION,
+  execute: executePowerPointDistributeShapes,
+  categories: OFFICE_CATEGORIES,
+  description: 'Distribute shapes evenly',
+};
+
+// =============================================================================
+// PowerPoint Group Shapes
+// =============================================================================
+
+const POWERPOINT_GROUP_SHAPES_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'powerpoint_group_shapes',
+    description: `Group multiple shapes together.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        slide_number: { type: 'number', description: 'Slide number' },
+        shape_indices: { type: 'array', items: { type: 'number' }, description: 'Array of shape indices to group' },
+      },
+      required: ['slide_number', 'shape_indices'],
+    },
+  },
+};
+
+async function executePowerPointGroupShapes(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await powerpointClient.powerpointGroupShapes(
+      args['slide_number'] as number,
+      args['shape_indices'] as number[]
+    );
+    if (response.success) {
+      return { success: true, result: `Shapes grouped. Group index: ${response['group_index']}` };
+    }
+    return { success: false, error: response.error || 'Failed to group shapes' };
+  } catch (error) {
+    return { success: false, error: `Failed to group shapes: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const powerpointGroupShapesTool: LLMSimpleTool = {
+  definition: POWERPOINT_GROUP_SHAPES_DEFINITION,
+  execute: executePowerPointGroupShapes,
+  categories: OFFICE_CATEGORIES,
+  description: 'Group shapes together',
+};
+
+// =============================================================================
+// PowerPoint Ungroup Shapes
+// =============================================================================
+
+const POWERPOINT_UNGROUP_SHAPES_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'powerpoint_ungroup_shapes',
+    description: `Ungroup a grouped shape.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        slide_number: { type: 'number', description: 'Slide number' },
+        group_index: { type: 'number', description: 'Group shape index' },
+      },
+      required: ['slide_number', 'group_index'],
+    },
+  },
+};
+
+async function executePowerPointUngroupShapes(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await powerpointClient.powerpointUngroupShapes(
+      args['slide_number'] as number,
+      args['group_index'] as number
+    );
+    if (response.success) {
+      return { success: true, result: `Group ungrouped. ${response['shape_count']} shapes` };
+    }
+    return { success: false, error: response.error || 'Failed to ungroup shapes' };
+  } catch (error) {
+    return { success: false, error: `Failed to ungroup shapes: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const powerpointUngroupShapesTool: LLMSimpleTool = {
+  definition: POWERPOINT_UNGROUP_SHAPES_DEFINITION,
+  execute: executePowerPointUngroupShapes,
+  categories: OFFICE_CATEGORIES,
+  description: 'Ungroup shapes',
+};
+
+// =============================================================================
+// Export
+// =============================================================================
+
+export const shapesTools: LLMSimpleTool[] = [
+  powerpointAddShapeTool,
+  powerpointDeleteShapeTool,
+  powerpointDuplicateShapeTool,
+  powerpointRotateShapeTool,
+  powerpointGetShapeInfoTool,
+  powerpointSetShapeNameTool,
+  powerpointGetShapeListTool,
+  powerpointSetShapePositionTool,
+  powerpointSetShapeSizeTool,
+  powerpointSetShapeStyleTool,
+  powerpointSetShapeOpacityTool,
+  powerpointBringToFrontTool,
+  powerpointSendToBackTool,
+  powerpointBringForwardTool,
+  powerpointSendBackwardTool,
+  powerpointAlignShapesTool,
+  powerpointDistributeShapesTool,
+  powerpointGroupShapesTool,
+  powerpointUngroupShapesTool,
+];