orquesta-cli 0.1.12

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

@@ -0,0 +1,263 @@
+/**
+ * PowerPoint Launch Tools
+ *
+ * Tools for launching, creating, opening, closing, quitting PowerPoint
+ * and taking screenshots.
+ */
+
+import { ToolDefinition } from '../../../types/index.js';
+import { LLMSimpleTool, ToolResult } from '../../types.js';
+import { powerpointClient } from '../powerpoint-client.js';
+import { saveScreenshot } from '../common/utils.js';
+import { OFFICE_SCREENSHOT_PATH_DESC, OFFICE_CATEGORIES } from '../common/constants.js';
+
+// =============================================================================
+// PowerPoint Launch
+// =============================================================================
+
+const POWERPOINT_LAUNCH_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'powerpoint_launch',
+    description: `Launch Microsoft PowerPoint for presentation editing.
+Use this tool to start PowerPoint before working with presentations.
+The PowerPoint window will be visible so you can see the changes in real-time.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Explanation of why you are launching PowerPoint' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executePowerPointLaunch(_args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await powerpointClient.powerpointLaunch();
+    if (response.success) {
+      return { success: true, result: response.message || 'PowerPoint launched successfully' };
+    }
+    return { success: false, error: response.error || 'Failed to launch PowerPoint' };
+  } catch (error) {
+    return { success: false, error: `Failed to launch PowerPoint: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const powerpointLaunchTool: LLMSimpleTool = {
+  definition: POWERPOINT_LAUNCH_DEFINITION,
+  execute: executePowerPointLaunch,
+  categories: OFFICE_CATEGORIES,
+  description: 'Launch Microsoft PowerPoint',
+};
+
+// =============================================================================
+// PowerPoint Create
+// =============================================================================
+
+const POWERPOINT_CREATE_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'powerpoint_create',
+    description: `Create a new PowerPoint presentation.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are creating a presentation' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executePowerPointCreate(_args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await powerpointClient.powerpointCreate();
+    if (response.success) {
+      return { success: true, result: response.message || 'New presentation created' };
+    }
+    return { success: false, error: response.error || 'Failed to create presentation' };
+  } catch (error) {
+    return { success: false, error: `Failed to create presentation: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const powerpointCreateTool: LLMSimpleTool = {
+  definition: POWERPOINT_CREATE_DEFINITION,
+  execute: executePowerPointCreate,
+  categories: OFFICE_CATEGORIES,
+  description: 'Create new PowerPoint presentation',
+};
+
+// =============================================================================
+// PowerPoint Open
+// =============================================================================
+
+const POWERPOINT_OPEN_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'powerpoint_open',
+    description: `Open an existing PowerPoint presentation. WSL paths are automatically converted to Windows paths.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are opening this presentation' },
+        path: { type: 'string', description: 'File path to open. Can use Linux/WSL paths or Windows paths.' },
+      },
+      required: ['reason', 'path'],
+    },
+  },
+};
+
+async function executePowerPointOpen(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await powerpointClient.powerpointOpen(args['path'] as string);
+    if (response.success) {
+      return { success: true, result: `Presentation opened: ${response['presentation_name'] || args['path']}` };
+    }
+    return { success: false, error: response.error || 'Failed to open presentation' };
+  } catch (error) {
+    return { success: false, error: `Failed to open presentation: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const powerpointOpenTool: LLMSimpleTool = {
+  definition: POWERPOINT_OPEN_DEFINITION,
+  execute: executePowerPointOpen,
+  categories: OFFICE_CATEGORIES,
+  description: 'Open existing PowerPoint presentation',
+};
+
+// =============================================================================
+// PowerPoint Screenshot
+// =============================================================================
+
+const POWERPOINT_SCREENSHOT_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'powerpoint_screenshot',
+    description: `Take a screenshot of the current slide.
+Saves to ${OFFICE_SCREENSHOT_PATH_DESC}.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are taking a screenshot' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executePowerPointScreenshot(_args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await powerpointClient.powerpointScreenshot();
+    if (response.success && response.image) {
+      const filePath = await saveScreenshot(response.image, 'powerpoint');
+      return {
+        success: true,
+        result: `PowerPoint screenshot saved to: ${filePath}`,
+      };
+    }
+    return { success: false, error: response.error || 'Failed to capture screenshot' };
+  } catch (error) {
+    return { success: false, error: `Failed to capture screenshot: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const powerpointScreenshotTool: LLMSimpleTool = {
+  definition: POWERPOINT_SCREENSHOT_DEFINITION,
+  execute: executePowerPointScreenshot,
+  categories: OFFICE_CATEGORIES,
+  description: 'Take PowerPoint slide screenshot',
+};
+
+// =============================================================================
+// PowerPoint Close
+// =============================================================================
+
+const POWERPOINT_CLOSE_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'powerpoint_close',
+    description: `Close the active presentation.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are closing' },
+        save: { type: 'boolean', description: 'Whether to save before closing (default: false)' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executePowerPointClose(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await powerpointClient.powerpointClose(args['save'] === true);
+    if (response.success) {
+      return { success: true, result: `Presentation closed${args['save'] ? ' (saved)' : ''}` };
+    }
+    return { success: false, error: response.error || 'Failed to close presentation' };
+  } catch (error) {
+    return { success: false, error: `Failed to close presentation: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const powerpointCloseTool: LLMSimpleTool = {
+  definition: POWERPOINT_CLOSE_DEFINITION,
+  execute: executePowerPointClose,
+  categories: OFFICE_CATEGORIES,
+  description: 'Close PowerPoint presentation',
+};
+
+// =============================================================================
+// PowerPoint Quit
+// =============================================================================
+
+const POWERPOINT_QUIT_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'powerpoint_quit',
+    description: `Quit Microsoft PowerPoint application entirely.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are quitting PowerPoint' },
+        save: { type: 'boolean', description: 'Whether to save all presentations before quitting (default: false)' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executePowerPointQuit(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await powerpointClient.powerpointQuit(args['save'] === true);
+    if (response.success) {
+      return { success: true, result: `PowerPoint closed${args['save'] ? ' (all presentations saved)' : ''}` };
+    }
+    return { success: false, error: response.error || 'Failed to quit PowerPoint' };
+  } catch (error) {
+    return { success: false, error: `Failed to quit PowerPoint: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const powerpointQuitTool: LLMSimpleTool = {
+  definition: POWERPOINT_QUIT_DEFINITION,
+  execute: executePowerPointQuit,
+  categories: OFFICE_CATEGORIES,
+  description: 'Quit Microsoft PowerPoint',
+};
+
+// =============================================================================
+// Export
+// =============================================================================
+
+export const launchTools: LLMSimpleTool[] = [
+  powerpointLaunchTool,
+  powerpointCreateTool,
+  powerpointOpenTool,
+  powerpointScreenshotTool,
+  powerpointCloseTool,
+  powerpointQuitTool,
+];

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

@@ -0,0 +1,291 @@
+/**
+ * PowerPoint Media Tools
+ *
+ * Tools for adding media content to PowerPoint slides:
+ * - Images
+ * - Videos
+ * - Audio
+ * - Hyperlinks
+ * - Charts
+ */
+
+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 Image
+// =============================================================================
+
+const POWERPOINT_ADD_IMAGE_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'powerpoint_add_image',
+    description: `Add an image to a slide. WSL paths are automatically converted to Windows paths.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are adding an image' },
+        slide: { type: 'number', description: 'Slide number' },
+        path: { type: 'string', description: 'Image file path' },
+        left: { type: 'number', description: 'Left position in points (default: 100)' },
+        top: { type: 'number', description: 'Top position in points (default: 100)' },
+        width: { type: 'number', description: 'Width in points (optional)' },
+        height: { type: 'number', description: 'Height in points (optional)' },
+      },
+      required: ['reason', 'slide', 'path'],
+    },
+  },
+};
+
+async function executePowerPointAddImage(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await powerpointClient.powerpointAddImage(
+      args['slide'] as number,
+      args['path'] as string,
+      args['left'] as number ?? 100,
+      args['top'] as number ?? 100,
+      args['width'] as number | undefined,
+      args['height'] as number | undefined
+    );
+    if (response.success) {
+      return { success: true, result: `Image added to slide ${args['slide']}` };
+    }
+    return { success: false, error: response.error || 'Failed to add image' };
+  } catch (error) {
+    return { success: false, error: `Failed to add image: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const powerpointAddImageTool: LLMSimpleTool = {
+  definition: POWERPOINT_ADD_IMAGE_DEFINITION,
+  execute: executePowerPointAddImage,
+  categories: OFFICE_CATEGORIES,
+  description: 'Add PowerPoint image',
+};
+
+// =============================================================================
+// PowerPoint Add Video
+// =============================================================================
+
+const POWERPOINT_ADD_VIDEO_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'powerpoint_add_video',
+    description: `Add a video to a slide.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        slide_number: { type: 'number', description: 'Slide number' },
+        video_path: { type: 'string', description: 'Path to video file' },
+        left: { type: 'number', description: 'Left position (default: 100)' },
+        top: { type: 'number', description: 'Top position (default: 100)' },
+        width: { type: 'number', description: 'Width (default: 400)' },
+        height: { type: 'number', description: 'Height (default: 300)' },
+      },
+      required: ['slide_number', 'video_path'],
+    },
+  },
+};
+
+async function executePowerPointAddVideo(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await powerpointClient.powerpointAddVideo(
+      args['slide_number'] as number,
+      args['video_path'] as string,
+      args['left'] as number | undefined,
+      args['top'] as number | undefined,
+      args['width'] as number | undefined,
+      args['height'] as number | undefined
+    );
+    if (response.success) {
+      return { success: true, result: `Video added. Shape index: ${response['shape_index']}` };
+    }
+    return { success: false, error: response.error || 'Failed to add video' };
+  } catch (error) {
+    return { success: false, error: `Failed to add video: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const powerpointAddVideoTool: LLMSimpleTool = {
+  definition: POWERPOINT_ADD_VIDEO_DEFINITION,
+  execute: executePowerPointAddVideo,
+  categories: OFFICE_CATEGORIES,
+  description: 'Add video to slide',
+};
+
+// =============================================================================
+// PowerPoint Add Audio
+// =============================================================================
+
+const POWERPOINT_ADD_AUDIO_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'powerpoint_add_audio',
+    description: `Add an audio file to a slide.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        slide_number: { type: 'number', description: 'Slide number' },
+        audio_path: { type: 'string', description: 'Path to audio file' },
+        left: { type: 'number', description: 'Left position (default: 100)' },
+        top: { type: 'number', description: 'Top position (default: 100)' },
+        play_in_background: { type: 'boolean', description: 'Play audio in background (default: false)' },
+      },
+      required: ['slide_number', 'audio_path'],
+    },
+  },
+};
+
+async function executePowerPointAddAudio(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await powerpointClient.powerpointAddAudio(
+      args['slide_number'] as number,
+      args['audio_path'] as string,
+      args['left'] as number | undefined,
+      args['top'] as number | undefined,
+      args['play_in_background'] as boolean | undefined
+    );
+    if (response.success) {
+      return { success: true, result: `Audio added. Shape index: ${response['shape_index']}` };
+    }
+    return { success: false, error: response.error || 'Failed to add audio' };
+  } catch (error) {
+    return { success: false, error: `Failed to add audio: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const powerpointAddAudioTool: LLMSimpleTool = {
+  definition: POWERPOINT_ADD_AUDIO_DEFINITION,
+  execute: executePowerPointAddAudio,
+  categories: OFFICE_CATEGORIES,
+  description: 'Add audio to slide',
+};
+
+// =============================================================================
+// PowerPoint Add Hyperlink
+// =============================================================================
+
+const POWERPOINT_ADD_HYPERLINK_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'powerpoint_add_hyperlink',
+    description: `Add a hyperlink to a shape.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        slide_number: { type: 'number', description: 'Slide number' },
+        shape_index: { type: 'number', description: 'Shape index' },
+        url: { type: 'string', description: 'Hyperlink URL' },
+        screen_tip: { type: 'string', description: 'Tooltip text when hovering' },
+      },
+      required: ['slide_number', 'shape_index', 'url'],
+    },
+  },
+};
+
+async function executePowerPointAddHyperlink(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await powerpointClient.powerpointAddHyperlink(
+      args['slide_number'] as number,
+      args['shape_index'] as number,
+      args['url'] as string,
+      args['screen_tip'] as string | undefined
+    );
+    if (response.success) {
+      return { success: true, result: response.message || 'Hyperlink added' };
+    }
+    return { success: false, error: response.error || 'Failed to add hyperlink' };
+  } catch (error) {
+    return { success: false, error: `Failed to add hyperlink: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const powerpointAddHyperlinkTool: LLMSimpleTool = {
+  definition: POWERPOINT_ADD_HYPERLINK_DEFINITION,
+  execute: executePowerPointAddHyperlink,
+  categories: OFFICE_CATEGORIES,
+  description: 'Add hyperlink to shape',
+};
+
+// =============================================================================
+// PowerPoint Add Chart
+// =============================================================================
+
+const POWERPOINT_ADD_CHART_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'powerpoint_add_chart',
+    description: `Add a chart to a slide.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        slide_number: { type: 'number', description: 'Slide number' },
+        chart_type: { type: 'string', enum: ['column', 'bar', 'line', 'pie', 'area', 'scatter'], description: 'Chart type' },
+        left: { type: 'number', description: 'Left position (default: 100)' },
+        top: { type: 'number', description: 'Top position (default: 100)' },
+        width: { type: 'number', description: 'Width (default: 400)' },
+        height: { type: 'number', description: 'Height (default: 300)' },
+        data: {
+          type: 'object',
+          description: 'Chart data',
+          properties: {
+            categories: { type: 'array', items: { type: 'string' }, description: 'Category labels' },
+            series: {
+              type: 'array',
+              items: {
+                type: 'object',
+                properties: {
+                  name: { type: 'string' },
+                  values: { type: 'array', items: { type: 'number' } },
+                },
+              },
+              description: 'Data series',
+            },
+          },
+        },
+      },
+      required: ['slide_number', 'chart_type'],
+    },
+  },
+};
+
+async function executePowerPointAddChart(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await powerpointClient.powerpointAddChart(
+      args['slide_number'] as number,
+      args['chart_type'] as 'column' | 'bar' | 'line' | 'pie' | 'area' | 'scatter',
+      args['left'] as number | undefined,
+      args['top'] as number | undefined,
+      args['width'] as number | undefined,
+      args['height'] as number | undefined,
+      args['data'] as { categories: string[]; series: { name: string; values: number[] }[] } | undefined
+    );
+    if (response.success) {
+      return { success: true, result: `Chart added. Shape index: ${response['shape_index']}` };
+    }
+    return { success: false, error: response.error || 'Failed to add chart' };
+  } catch (error) {
+    return { success: false, error: `Failed to add chart: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const powerpointAddChartTool: LLMSimpleTool = {
+  definition: POWERPOINT_ADD_CHART_DEFINITION,
+  execute: executePowerPointAddChart,
+  categories: OFFICE_CATEGORIES,
+  description: 'Add chart to slide',
+};
+
+// =============================================================================
+// Export
+// =============================================================================
+
+export const mediaTools: LLMSimpleTool[] = [
+  powerpointAddImageTool,
+  powerpointAddVideoTool,
+  powerpointAddAudioTool,
+  powerpointAddHyperlinkTool,
+  powerpointAddChartTool,
+];