orquesta-cli 0.1.12

package/src/tools/office/excel-tools/rows-columns.ts

@@ -0,0 +1,386 @@
+/**
+ * Excel Rows & Columns Tools
+ *
+ * Tools for managing Excel rows and columns:
+ * - setColumnWidth, setRowHeight
+ * - insertRow, deleteRow
+ * - hideRow, hideColumn, showRow, showColumn
+ */
+
+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 Set Column Width
+// =============================================================================
+
+const EXCEL_SET_COLUMN_WIDTH_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_set_column_width',
+    description: `Set column width or auto-fit.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are setting column width' },
+        column: { type: 'string', description: 'Column letter (e.g., "A", "B")' },
+        width: { type: 'number', description: 'Width in characters (ignored if auto_fit is true)' },
+        auto_fit: { type: 'boolean', description: 'Auto-fit column width to content' },
+        sheet: { type: 'string', description: 'Sheet name (optional)' },
+      },
+      required: ['reason', 'column'],
+    },
+  },
+};
+
+async function executeExcelSetColumnWidth(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelSetColumnWidth(
+      args['column'] as string,
+      args['width'] as number | undefined,
+      args['auto_fit'] as boolean | undefined,
+      args['sheet'] as string | undefined
+    );
+    if (response.success) {
+      return { success: true, result: `Column ${args['column']} width set` };
+    }
+    return { success: false, error: response.error || 'Failed to set column width' };
+  } catch (error) {
+    return { success: false, error: `Failed to set column width: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelSetColumnWidthTool: LLMSimpleTool = {
+  definition: EXCEL_SET_COLUMN_WIDTH_DEFINITION,
+  execute: executeExcelSetColumnWidth,
+  categories: OFFICE_CATEGORIES,
+  description: 'Set Excel column width',
+};
+
+// =============================================================================
+// Excel Set Row Height
+// =============================================================================
+
+const EXCEL_SET_ROW_HEIGHT_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_set_row_height',
+    description: `Set row height or auto-fit.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are setting row height' },
+        row: { type: 'number', description: 'Row number' },
+        height: { type: 'number', description: 'Height in points (ignored if auto_fit is true)' },
+        auto_fit: { type: 'boolean', description: 'Auto-fit row height to content' },
+        sheet: { type: 'string', description: 'Sheet name (optional)' },
+      },
+      required: ['reason', 'row'],
+    },
+  },
+};
+
+async function executeExcelSetRowHeight(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelSetRowHeight(
+      args['row'] as number,
+      args['height'] as number | undefined,
+      args['auto_fit'] as boolean | undefined,
+      args['sheet'] as string | undefined
+    );
+    if (response.success) {
+      return { success: true, result: `Row ${args['row']} height set` };
+    }
+    return { success: false, error: response.error || 'Failed to set row height' };
+  } catch (error) {
+    return { success: false, error: `Failed to set row height: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelSetRowHeightTool: LLMSimpleTool = {
+  definition: EXCEL_SET_ROW_HEIGHT_DEFINITION,
+  execute: executeExcelSetRowHeight,
+  categories: OFFICE_CATEGORIES,
+  description: 'Set Excel row height',
+};
+
+// =============================================================================
+// Excel Insert Row
+// =============================================================================
+
+const EXCEL_INSERT_ROW_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_insert_row',
+    description: `Insert rows at a specific position.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are inserting rows' },
+        row: { type: 'number', description: 'Row number to insert at' },
+        count: { type: 'number', description: 'Number of rows to insert (default: 1)' },
+        sheet: { type: 'string', description: 'Sheet name (optional)' },
+      },
+      required: ['reason', 'row'],
+    },
+  },
+};
+
+async function executeExcelInsertRow(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const count = args['count'] as number ?? 1;
+    const response = await excelClient.excelInsertRow(
+      args['row'] as number,
+      count,
+      args['sheet'] as string | undefined
+    );
+    if (response.success) {
+      return { success: true, result: `${count} row(s) inserted at row ${args['row']}` };
+    }
+    return { success: false, error: response.error || 'Failed to insert row' };
+  } catch (error) {
+    return { success: false, error: `Failed to insert row: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelInsertRowTool: LLMSimpleTool = {
+  definition: EXCEL_INSERT_ROW_DEFINITION,
+  execute: executeExcelInsertRow,
+  categories: OFFICE_CATEGORIES,
+  description: 'Insert Excel rows',
+};
+
+// =============================================================================
+// Excel Delete Row
+// =============================================================================
+
+const EXCEL_DELETE_ROW_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_delete_row',
+    description: `Delete rows at a specific position.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are deleting rows' },
+        row: { type: 'number', description: 'Row number to delete' },
+        count: { type: 'number', description: 'Number of rows to delete (default: 1)' },
+        sheet: { type: 'string', description: 'Sheet name (optional)' },
+      },
+      required: ['reason', 'row'],
+    },
+  },
+};
+
+async function executeExcelDeleteRow(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const count = args['count'] as number ?? 1;
+    const response = await excelClient.excelDeleteRow(
+      args['row'] as number,
+      count,
+      args['sheet'] as string | undefined
+    );
+    if (response.success) {
+      return { success: true, result: `${count} row(s) deleted at row ${args['row']}` };
+    }
+    return { success: false, error: response.error || 'Failed to delete row' };
+  } catch (error) {
+    return { success: false, error: `Failed to delete row: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelDeleteRowTool: LLMSimpleTool = {
+  definition: EXCEL_DELETE_ROW_DEFINITION,
+  execute: executeExcelDeleteRow,
+  categories: OFFICE_CATEGORIES,
+  description: 'Delete Excel rows',
+};
+
+// =============================================================================
+// Excel Hide Column
+// =============================================================================
+
+const EXCEL_HIDE_COLUMN_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_hide_column',
+    description: `Hide a column.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are hiding column' },
+        column: { type: 'string', description: 'Column letter (e.g., "A", "B")' },
+        sheet: { type: 'string', description: 'Sheet name (optional)' },
+      },
+      required: ['reason', 'column'],
+    },
+  },
+};
+
+async function executeExcelHideColumn(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelHideColumn(
+      args['column'] as string,
+      args['sheet'] as string | undefined
+    );
+    if (response.success) {
+      return { success: true, result: `Column ${args['column']} hidden` };
+    }
+    return { success: false, error: response.error || 'Failed to hide column' };
+  } catch (error) {
+    return { success: false, error: `Failed to hide column: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelHideColumnTool: LLMSimpleTool = {
+  definition: EXCEL_HIDE_COLUMN_DEFINITION,
+  execute: executeExcelHideColumn,
+  categories: OFFICE_CATEGORIES,
+  description: 'Hide Excel column',
+};
+
+// =============================================================================
+// Excel Show Column
+// =============================================================================
+
+const EXCEL_SHOW_COLUMN_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_show_column',
+    description: `Show a hidden column.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are showing column' },
+        column: { type: 'string', description: 'Column letter (e.g., "A", "B")' },
+        sheet: { type: 'string', description: 'Sheet name (optional)' },
+      },
+      required: ['reason', 'column'],
+    },
+  },
+};
+
+async function executeExcelShowColumn(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelShowColumn(
+      args['column'] as string,
+      args['sheet'] as string | undefined
+    );
+    if (response.success) {
+      return { success: true, result: `Column ${args['column']} shown` };
+    }
+    return { success: false, error: response.error || 'Failed to show column' };
+  } catch (error) {
+    return { success: false, error: `Failed to show column: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelShowColumnTool: LLMSimpleTool = {
+  definition: EXCEL_SHOW_COLUMN_DEFINITION,
+  execute: executeExcelShowColumn,
+  categories: OFFICE_CATEGORIES,
+  description: 'Show Excel column',
+};
+
+// =============================================================================
+// Excel Hide Row
+// =============================================================================
+
+const EXCEL_HIDE_ROW_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_hide_row',
+    description: `Hide a row.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are hiding row' },
+        row: { type: 'number', description: 'Row number' },
+        sheet: { type: 'string', description: 'Sheet name (optional)' },
+      },
+      required: ['reason', 'row'],
+    },
+  },
+};
+
+async function executeExcelHideRow(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelHideRow(
+      args['row'] as number,
+      args['sheet'] as string | undefined
+    );
+    if (response.success) {
+      return { success: true, result: `Row ${args['row']} hidden` };
+    }
+    return { success: false, error: response.error || 'Failed to hide row' };
+  } catch (error) {
+    return { success: false, error: `Failed to hide row: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelHideRowTool: LLMSimpleTool = {
+  definition: EXCEL_HIDE_ROW_DEFINITION,
+  execute: executeExcelHideRow,
+  categories: OFFICE_CATEGORIES,
+  description: 'Hide Excel row',
+};
+
+// =============================================================================
+// Excel Show Row
+// =============================================================================
+
+const EXCEL_SHOW_ROW_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_show_row',
+    description: `Show a hidden row.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are showing row' },
+        row: { type: 'number', description: 'Row number' },
+        sheet: { type: 'string', description: 'Sheet name (optional)' },
+      },
+      required: ['reason', 'row'],
+    },
+  },
+};
+
+async function executeExcelShowRow(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelShowRow(
+      args['row'] as number,
+      args['sheet'] as string | undefined
+    );
+    if (response.success) {
+      return { success: true, result: `Row ${args['row']} shown` };
+    }
+    return { success: false, error: response.error || 'Failed to show row' };
+  } catch (error) {
+    return { success: false, error: `Failed to show row: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelShowRowTool: LLMSimpleTool = {
+  definition: EXCEL_SHOW_ROW_DEFINITION,
+  execute: executeExcelShowRow,
+  categories: OFFICE_CATEGORIES,
+  description: 'Show Excel row',
+};
+
+// =============================================================================
+// Export all tools
+// =============================================================================
+
+export const rowsColumnsTools: LLMSimpleTool[] = [
+  excelSetColumnWidthTool,
+  excelSetRowHeightTool,
+  excelInsertRowTool,
+  excelDeleteRowTool,
+  excelHideColumnTool,
+  excelShowColumnTool,
+  excelHideRowTool,
+  excelShowRowTool,
+];

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

@@ -0,0 +1,228 @@
+/**
+ * Excel Sheet Management Tools
+ *
+ * Tools for managing worksheets in Excel workbooks:
+ * - Add, delete, rename sheets
+ * - Get sheet list
+ * - Select/activate sheets
+ */
+
+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 Sheet
+// =============================================================================
+
+const EXCEL_ADD_SHEET_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_add_sheet',
+    description: `Add a new worksheet.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are adding a sheet' },
+        name: { type: 'string', description: 'Sheet name (optional)' },
+        position: { type: 'string', description: 'Position: "start", "end", or after specific sheet name' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executeExcelAddSheet(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelAddSheet(
+      args['name'] as string | undefined,
+      args['position'] as string | undefined
+    );
+    if (response.success) {
+      return { success: true, result: `Sheet added: ${response['sheet_name'] || 'new sheet'}` };
+    }
+    return { success: false, error: response.error || 'Failed to add sheet' };
+  } catch (error) {
+    return { success: false, error: `Failed to add sheet: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelAddSheetTool: LLMSimpleTool = {
+  definition: EXCEL_ADD_SHEET_DEFINITION,
+  execute: executeExcelAddSheet,
+  categories: OFFICE_CATEGORIES,
+  description: 'Add Excel worksheet',
+};
+
+// =============================================================================
+// Excel Delete Sheet
+// =============================================================================
+
+const EXCEL_DELETE_SHEET_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_delete_sheet',
+    description: `Delete a worksheet.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are deleting this sheet' },
+        name: { type: 'string', description: 'Sheet name to delete' },
+      },
+      required: ['reason', 'name'],
+    },
+  },
+};
+
+async function executeExcelDeleteSheet(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelDeleteSheet(args['name'] as string);
+    if (response.success) {
+      return { success: true, result: `Sheet deleted: ${args['name']}` };
+    }
+    return { success: false, error: response.error || 'Failed to delete sheet' };
+  } catch (error) {
+    return { success: false, error: `Failed to delete sheet: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelDeleteSheetTool: LLMSimpleTool = {
+  definition: EXCEL_DELETE_SHEET_DEFINITION,
+  execute: executeExcelDeleteSheet,
+  categories: OFFICE_CATEGORIES,
+  description: 'Delete Excel worksheet',
+};
+
+// =============================================================================
+// Excel Rename Sheet
+// =============================================================================
+
+const EXCEL_RENAME_SHEET_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_rename_sheet',
+    description: `Rename a worksheet.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are renaming this sheet' },
+        old_name: { type: 'string', description: 'Current sheet name' },
+        new_name: { type: 'string', description: 'New sheet name' },
+      },
+      required: ['reason', 'old_name', 'new_name'],
+    },
+  },
+};
+
+async function executeExcelRenameSheet(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelRenameSheet(
+      args['old_name'] as string,
+      args['new_name'] as string
+    );
+    if (response.success) {
+      return { success: true, result: `Sheet renamed: ${args['old_name']} → ${args['new_name']}` };
+    }
+    return { success: false, error: response.error || 'Failed to rename sheet' };
+  } catch (error) {
+    return { success: false, error: `Failed to rename sheet: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelRenameSheetTool: LLMSimpleTool = {
+  definition: EXCEL_RENAME_SHEET_DEFINITION,
+  execute: executeExcelRenameSheet,
+  categories: OFFICE_CATEGORIES,
+  description: 'Rename Excel worksheet',
+};
+
+// =============================================================================
+// Excel Get Sheets
+// =============================================================================
+
+const EXCEL_GET_SHEETS_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_get_sheets',
+    description: `Get list of all worksheets in the workbook.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you need the sheet list' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executeExcelGetSheets(_args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelGetSheets();
+    if (response.success) {
+      const sheets = response['sheets'] as string[] || [];
+      return { success: true, result: `Sheets: ${sheets.join(', ')}` };
+    }
+    return { success: false, error: response.error || 'Failed to get sheets' };
+  } catch (error) {
+    return { success: false, error: `Failed to get sheets: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelGetSheetsTool: LLMSimpleTool = {
+  definition: EXCEL_GET_SHEETS_DEFINITION,
+  execute: executeExcelGetSheets,
+  categories: OFFICE_CATEGORIES,
+  description: 'Get Excel worksheet list',
+};
+
+// =============================================================================
+// Excel Select Sheet
+// =============================================================================
+
+const EXCEL_SELECT_SHEET_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_select_sheet',
+    description: `Activate/select a worksheet.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are selecting sheet' },
+        name: { type: 'string', description: 'Sheet name to select' },
+      },
+      required: ['reason', 'name'],
+    },
+  },
+};
+
+async function executeExcelSelectSheet(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelSelectSheet(args['name'] as string);
+    if (response.success) {
+      return { success: true, result: `Sheet "${args['name']}" activated` };
+    }
+    return { success: false, error: response.error || 'Failed to select sheet' };
+  } catch (error) {
+    return { success: false, error: `Failed to select sheet: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelSelectSheetTool: LLMSimpleTool = {
+  definition: EXCEL_SELECT_SHEET_DEFINITION,
+  execute: executeExcelSelectSheet,
+  categories: OFFICE_CATEGORIES,
+  description: 'Select Excel sheet',
+};
+
+// =============================================================================
+// Export All Sheet Tools
+// =============================================================================
+
+export const sheetsTools: LLMSimpleTool[] = [
+  excelAddSheetTool,
+  excelDeleteSheetTool,
+  excelRenameSheetTool,
+  excelGetSheetsTool,
+  excelSelectSheetTool,
+];