orquesta-cli 0.1.12

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

@@ -0,0 +1,303 @@
+/**
+ * Excel Launch Tools
+ *
+ * Tools for launching, creating, opening, closing, and quitting Excel
+ * Also includes screenshot functionality
+ */
+
+import { ToolDefinition } from '../../../types/index.js';
+import { LLMSimpleTool, ToolResult } from '../../types.js';
+import { excelClient } from '../excel-client.js';
+import { saveScreenshot } from '../common/utils.js';
+import { OFFICE_SCREENSHOT_PATH_DESC, OFFICE_CATEGORIES } from '../common/constants.js';
+
+// =============================================================================
+// Excel Launch
+// =============================================================================
+
+const EXCEL_LAUNCH_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_launch',
+    description: `Launch Microsoft Excel for spreadsheet editing.
+Use this tool to start Excel before working with spreadsheets.
+The Excel 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 Excel' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executeExcelLaunch(_args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelLaunch();
+    if (response.success) {
+      return { success: true, result: response.message || 'Excel launched successfully' };
+    }
+    return { success: false, error: response.error || 'Failed to launch Excel' };
+  } catch (error) {
+    return { success: false, error: `Failed to launch Excel: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelLaunchTool: LLMSimpleTool = {
+  definition: EXCEL_LAUNCH_DEFINITION,
+  execute: executeExcelLaunch,
+  categories: OFFICE_CATEGORIES,
+  description: 'Launch Microsoft Excel',
+};
+
+// =============================================================================
+// Excel Create
+// =============================================================================
+
+const EXCEL_CREATE_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_create',
+    description: `Create a new Excel workbook.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are creating a workbook' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executeExcelCreate(_args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelCreate();
+    if (response.success) {
+      return { success: true, result: response.message || 'New workbook created' };
+    }
+    return { success: false, error: response.error || 'Failed to create workbook' };
+  } catch (error) {
+    return { success: false, error: `Failed to create workbook: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelCreateTool: LLMSimpleTool = {
+  definition: EXCEL_CREATE_DEFINITION,
+  execute: executeExcelCreate,
+  categories: OFFICE_CATEGORIES,
+  description: 'Create new Excel workbook',
+};
+
+// =============================================================================
+// Excel Open
+// =============================================================================
+
+const EXCEL_OPEN_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_open',
+    description: `Open an existing Excel workbook. WSL paths are automatically converted to Windows paths.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are opening this workbook' },
+        path: { type: 'string', description: 'File path to open. Can use Linux/WSL paths or Windows paths.' },
+      },
+      required: ['reason', 'path'],
+    },
+  },
+};
+
+async function executeExcelOpen(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelOpen(args['path'] as string);
+    if (response.success) {
+      return { success: true, result: `Workbook opened: ${response['workbook_name'] || args['path']}` };
+    }
+    return { success: false, error: response.error || 'Failed to open workbook' };
+  } catch (error) {
+    return { success: false, error: `Failed to open workbook: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelOpenTool: LLMSimpleTool = {
+  definition: EXCEL_OPEN_DEFINITION,
+  execute: executeExcelOpen,
+  categories: OFFICE_CATEGORIES,
+  description: 'Open existing Excel workbook',
+};
+
+// =============================================================================
+// Excel Save
+// =============================================================================
+
+const EXCEL_SAVE_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_save',
+    description: `Save the active Excel workbook. WSL paths are automatically converted to Windows paths.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Explanation of why you are saving' },
+        path: { type: 'string', description: 'File path to save to (optional)' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executeExcelSave(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelSave(args['path'] as string | undefined);
+    if (response.success) {
+      return { success: true, result: `Workbook saved: ${response['path'] || 'current location'}` };
+    }
+    return { success: false, error: response.error || 'Failed to save workbook' };
+  } catch (error) {
+    return { success: false, error: `Failed to save workbook: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelSaveTool: LLMSimpleTool = {
+  definition: EXCEL_SAVE_DEFINITION,
+  execute: executeExcelSave,
+  categories: OFFICE_CATEGORIES,
+  description: 'Save Excel workbook',
+};
+
+// =============================================================================
+// Excel Screenshot
+// =============================================================================
+
+const EXCEL_SCREENSHOT_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_screenshot',
+    description: `Take a screenshot of the current Excel worksheet.
+Captures the used range and saves to ${OFFICE_SCREENSHOT_PATH_DESC}.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Explanation of why you are taking a screenshot' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executeExcelScreenshot(_args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelScreenshot();
+    if (response.success && response.image) {
+      const filePath = await saveScreenshot(response.image, 'excel');
+      return {
+        success: true,
+        result: `Excel 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 excelScreenshotTool: LLMSimpleTool = {
+  definition: EXCEL_SCREENSHOT_DEFINITION,
+  execute: executeExcelScreenshot,
+  categories: OFFICE_CATEGORIES,
+  description: 'Take Excel window screenshot',
+};
+
+// =============================================================================
+// Excel Close
+// =============================================================================
+
+const EXCEL_CLOSE_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_close',
+    description: `Close the active Excel workbook.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Explanation of why you are closing' },
+        save: { type: 'boolean', description: 'Whether to save before closing (default: false)' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executeExcelClose(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelClose(args['save'] === true);
+    if (response.success) {
+      return { success: true, result: `Workbook closed${args['save'] ? ' (saved)' : ''}` };
+    }
+    return { success: false, error: response.error || 'Failed to close workbook' };
+  } catch (error) {
+    return { success: false, error: `Failed to close workbook: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelCloseTool: LLMSimpleTool = {
+  definition: EXCEL_CLOSE_DEFINITION,
+  execute: executeExcelClose,
+  categories: OFFICE_CATEGORIES,
+  description: 'Close Excel workbook',
+};
+
+// =============================================================================
+// Excel Quit
+// =============================================================================
+
+const EXCEL_QUIT_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_quit',
+    description: `Quit Microsoft Excel application entirely.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Explanation of why you are quitting Excel' },
+        save: { type: 'boolean', description: 'Whether to save all workbooks before quitting (default: false)' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executeExcelQuit(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelQuit(args['save'] === true);
+    if (response.success) {
+      return { success: true, result: `Excel closed${args['save'] ? ' (all workbooks saved)' : ''}` };
+    }
+    return { success: false, error: response.error || 'Failed to quit Excel' };
+  } catch (error) {
+    return { success: false, error: `Failed to quit Excel: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelQuitTool: LLMSimpleTool = {
+  definition: EXCEL_QUIT_DEFINITION,
+  execute: executeExcelQuit,
+  categories: OFFICE_CATEGORIES,
+  description: 'Quit Microsoft Excel',
+};
+
+// =============================================================================
+// Export All Launch Tools
+// =============================================================================
+
+export const launchTools: LLMSimpleTool[] = [
+  excelLaunchTool,
+  excelCreateTool,
+  excelOpenTool,
+  excelSaveTool,
+  excelScreenshotTool,
+  excelCloseTool,
+  excelQuitTool,
+];

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

@@ -0,0 +1,117 @@
+/**
+ * Excel Media Tools
+ *
+ * Tools for adding images and hyperlinks to Excel worksheets
+ */
+
+import { ToolDefinition } from '../../../types/index.js';
+import { LLMSimpleTool, ToolResult } from '../../types.js';
+import { excelClient } from '../excel-client.js';
+import { OFFICE_CATEGORIES } from '../common/constants.js';
+
+// =============================================================================
+// Excel Add Image
+// =============================================================================
+
+const EXCEL_ADD_IMAGE_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_add_image',
+    description: `Add an image to the worksheet. WSL paths are automatically converted.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are adding image' },
+        image_path: { type: 'string', description: 'Image file path' },
+        cell: { type: 'string', description: 'Cell to position image (e.g., "A1")' },
+        width: { type: 'number', description: 'Image width (optional)' },
+        height: { type: 'number', description: 'Image height (optional)' },
+        sheet: { type: 'string', description: 'Sheet name (optional)' },
+      },
+      required: ['reason', 'image_path', 'cell'],
+    },
+  },
+};
+
+async function executeExcelAddImage(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelAddImage(
+      args['image_path'] as string,
+      args['cell'] as string,
+      {
+        width: args['width'] as number | undefined,
+        height: args['height'] as number | undefined,
+        sheet: args['sheet'] as string | undefined,
+      }
+    );
+    if (response.success) {
+      return { success: true, result: `Image added at ${args['cell']}` };
+    }
+    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 excelAddImageTool: LLMSimpleTool = {
+  definition: EXCEL_ADD_IMAGE_DEFINITION,
+  execute: executeExcelAddImage,
+  categories: OFFICE_CATEGORIES,
+  description: 'Add Excel image',
+};
+
+// =============================================================================
+// Excel Add Hyperlink
+// =============================================================================
+
+const EXCEL_ADD_HYPERLINK_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_add_hyperlink',
+    description: `Add a hyperlink to a cell.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are adding hyperlink' },
+        cell: { type: 'string', description: 'Cell address (e.g., "A1")' },
+        url: { type: 'string', description: 'URL to link to' },
+        display_text: { type: 'string', description: 'Display text (optional, defaults to URL)' },
+        sheet: { type: 'string', description: 'Sheet name (optional)' },
+      },
+      required: ['reason', 'cell', 'url'],
+    },
+  },
+};
+
+async function executeExcelAddHyperlink(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelAddHyperlink(
+      args['cell'] as string,
+      args['url'] as string,
+      args['display_text'] as string | undefined,
+      args['sheet'] as string | undefined
+    );
+    if (response.success) {
+      return { success: true, result: `Hyperlink added to ${args['cell']}` };
+    }
+    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 excelAddHyperlinkTool: LLMSimpleTool = {
+  definition: EXCEL_ADD_HYPERLINK_DEFINITION,
+  execute: executeExcelAddHyperlink,
+  categories: OFFICE_CATEGORIES,
+  description: 'Add Excel hyperlink',
+};
+
+// =============================================================================
+// Export all media tools
+// =============================================================================
+
+export const mediaTools: LLMSimpleTool[] = [
+  excelAddImageTool,
+  excelAddHyperlinkTool,
+];

package/src/tools/office/excel-tools/named-ranges.ts

@@ -0,0 +1,148 @@
+/**
+ * Excel Named Ranges Tools
+ *
+ * Named range management tools for Excel.
+ * Tools: createNamedRange, getNamedRanges, deleteNamedRange
+ */
+
+import { ToolDefinition } from '../../../types/index.js';
+import { LLMSimpleTool, ToolResult } from '../../types.js';
+import { excelClient } from '../excel-client.js';
+import { OFFICE_CATEGORIES } from '../common/index.js';
+
+// =============================================================================
+// Excel Create Named Range
+// =============================================================================
+
+const EXCEL_CREATE_NAMED_RANGE_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_create_named_range',
+    description: `Create a named range.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are creating named range' },
+        name: { type: 'string', description: 'Name for the range' },
+        range: { type: 'string', description: 'Range address (e.g., "A1:B10")' },
+        sheet: { type: 'string', description: 'Sheet name (optional)' },
+      },
+      required: ['reason', 'name', 'range'],
+    },
+  },
+};
+
+async function executeExcelCreateNamedRange(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelCreateNamedRange(
+      args['name'] as string,
+      args['range'] as string,
+      args['sheet'] as string | undefined
+    );
+    if (response.success) {
+      return { success: true, result: `Named range "${args['name']}" created` };
+    }
+    return { success: false, error: response.error || 'Failed to create named range' };
+  } catch (error) {
+    return { success: false, error: `Failed to create named range: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelCreateNamedRangeTool: LLMSimpleTool = {
+  definition: EXCEL_CREATE_NAMED_RANGE_DEFINITION,
+  execute: executeExcelCreateNamedRange,
+  categories: OFFICE_CATEGORIES,
+  description: 'Create Excel named range',
+};
+
+// =============================================================================
+// Excel Get Named Ranges
+// =============================================================================
+
+const EXCEL_GET_NAMED_RANGES_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_get_named_ranges',
+    description: `Get all named ranges in the workbook.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you need named ranges' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executeExcelGetNamedRanges(_args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelGetNamedRanges();
+    if (response.success) {
+      const ranges = response['named_ranges'] as Array<{ name: string; refersTo: string }> || [];
+      if (ranges.length === 0) {
+        return { success: true, result: 'No named ranges found' };
+      }
+      const list = ranges.map(r => `- ${r.name}: ${r.refersTo}`).join('\n');
+      return { success: true, result: `Named ranges:\n${list}` };
+    }
+    return { success: false, error: response.error || 'Failed to get named ranges' };
+  } catch (error) {
+    return { success: false, error: `Failed to get named ranges: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelGetNamedRangesTool: LLMSimpleTool = {
+  definition: EXCEL_GET_NAMED_RANGES_DEFINITION,
+  execute: executeExcelGetNamedRanges,
+  categories: OFFICE_CATEGORIES,
+  description: 'Get Excel named ranges',
+};
+
+// =============================================================================
+// Excel Delete Named Range
+// =============================================================================
+
+const EXCEL_DELETE_NAMED_RANGE_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_delete_named_range',
+    description: `Delete a named range.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are deleting named range' },
+        name: { type: 'string', description: 'Name of the range to delete' },
+      },
+      required: ['reason', 'name'],
+    },
+  },
+};
+
+async function executeExcelDeleteNamedRange(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelDeleteNamedRange(args['name'] as string);
+    if (response.success) {
+      return { success: true, result: `Named range "${args['name']}" deleted` };
+    }
+    return { success: false, error: response.error || 'Failed to delete named range' };
+  } catch (error) {
+    return { success: false, error: `Failed to delete named range: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelDeleteNamedRangeTool: LLMSimpleTool = {
+  definition: EXCEL_DELETE_NAMED_RANGE_DEFINITION,
+  execute: executeExcelDeleteNamedRange,
+  categories: OFFICE_CATEGORIES,
+  description: 'Delete Excel named range',
+};
+
+// =============================================================================
+// Export: Named Ranges Tools Array
+// =============================================================================
+
+export const namedRangesTools: LLMSimpleTool[] = [
+  excelCreateNamedRangeTool,
+  excelGetNamedRangesTool,
+  excelDeleteNamedRangeTool,
+];

package/src/tools/office/excel-tools/protection.ts

@@ -0,0 +1,105 @@
+/**
+ * Excel Protection Tools
+ *
+ * Tools for protecting and unprotecting Excel worksheets
+ */
+
+import { ToolDefinition } from '../../../types/index.js';
+import { LLMSimpleTool, ToolResult } from '../../types.js';
+import { excelClient } from '../excel-client.js';
+import { OFFICE_CATEGORIES } from '../common/constants.js';
+
+// =============================================================================
+// Excel Protect Sheet
+// =============================================================================
+
+const EXCEL_PROTECT_SHEET_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_protect_sheet',
+    description: `Protect a worksheet.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are protecting sheet' },
+        password: { type: 'string', description: 'Protection password (optional)' },
+        sheet: { type: 'string', description: 'Sheet name (optional, protects active sheet)' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executeExcelProtectSheet(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelProtectSheet(
+      args['password'] as string | undefined,
+      args['sheet'] as string | undefined
+    );
+    if (response.success) {
+      return { success: true, result: 'Sheet protected' };
+    }
+    return { success: false, error: response.error || 'Failed to protect sheet' };
+  } catch (error) {
+    return { success: false, error: `Failed to protect sheet: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelProtectSheetTool: LLMSimpleTool = {
+  definition: EXCEL_PROTECT_SHEET_DEFINITION,
+  execute: executeExcelProtectSheet,
+  categories: OFFICE_CATEGORIES,
+  description: 'Protect Excel sheet',
+};
+
+// =============================================================================
+// Excel Unprotect Sheet
+// =============================================================================
+
+const EXCEL_UNPROTECT_SHEET_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_unprotect_sheet',
+    description: `Unprotect a worksheet.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are unprotecting sheet' },
+        password: { type: 'string', description: 'Protection password (if protected)' },
+        sheet: { type: 'string', description: 'Sheet name (optional)' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executeExcelUnprotectSheet(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelUnprotectSheet(
+      args['password'] as string | undefined,
+      args['sheet'] as string | undefined
+    );
+    if (response.success) {
+      return { success: true, result: 'Sheet unprotected' };
+    }
+    return { success: false, error: response.error || 'Failed to unprotect sheet' };
+  } catch (error) {
+    return { success: false, error: `Failed to unprotect sheet: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelUnprotectSheetTool: LLMSimpleTool = {
+  definition: EXCEL_UNPROTECT_SHEET_DEFINITION,
+  execute: executeExcelUnprotectSheet,
+  categories: OFFICE_CATEGORIES,
+  description: 'Unprotect Excel sheet',
+};
+
+// =============================================================================
+// Export
+// =============================================================================
+
+export const protectionTools: LLMSimpleTool[] = [
+  excelProtectSheetTool,
+  excelUnprotectSheetTool,
+];