orquesta-cli 0.1.12

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

@@ -0,0 +1,359 @@
+/**
+ * Excel Cells Tools
+ *
+ * Cell read/write and range operations for Excel.
+ * Tools: writeCell, readCell, writeRange, readRange, copyRange, pasteRange, clearRange
+ */
+
+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 Write Cell
+// =============================================================================
+
+const EXCEL_WRITE_CELL_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_write_cell',
+    description: `Write a value to a specific cell in Excel with optional font settings.
+Use cell references like "A1", "B2", "C10", etc.
+- Numbers are automatically recognized (e.g., "123", "45.67")
+- Dates in YYYY-MM-DD format are converted to Excel dates (e.g., "2024-01-19")
+- Use as_text=true to force text format (prevents auto-conversion)`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Explanation of why you are writing to this cell' },
+        cell: { type: 'string', description: 'Cell reference (e.g., "A1", "B2")' },
+        value: { type: 'string', description: 'Value to write to the cell' },
+        sheet: { type: 'string', description: 'Sheet name (optional, uses active sheet if not specified)' },
+        font_name: { type: 'string', description: 'Font name (e.g., "Arial", "Malgun Gothic")' },
+        font_size: { type: 'number', description: 'Font size in points' },
+        bold: { type: 'boolean', description: 'Whether to make the text bold' },
+        as_text: { type: 'boolean', description: 'Force text format (prevents number/date conversion)' },
+      },
+      required: ['reason', 'cell', 'value'],
+    },
+  },
+};
+
+async function executeExcelWriteCell(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelWriteCell(
+      args['cell'] as string,
+      args['value'],
+      args['sheet'] as string | undefined,
+      {
+        fontName: args['font_name'] as string | undefined,
+        fontSize: args['font_size'] as number | undefined,
+        bold: args['bold'] as boolean | undefined,
+        asText: args['as_text'] as boolean | undefined,
+      }
+    );
+    if (response.success) {
+      return { success: true, result: `Value written to cell ${args['cell']}` };
+    }
+    return { success: false, error: response.error || 'Failed to write cell' };
+  } catch (error) {
+    return { success: false, error: `Failed to write cell: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelWriteCellTool: LLMSimpleTool = {
+  definition: EXCEL_WRITE_CELL_DEFINITION,
+  execute: executeExcelWriteCell,
+  categories: OFFICE_CATEGORIES,
+  description: 'Write value to Excel cell',
+};
+
+// =============================================================================
+// Excel Read Cell
+// =============================================================================
+
+const EXCEL_READ_CELL_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_read_cell',
+    description: `Read a value from a specific cell in Excel.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Explanation of why you are reading this cell' },
+        cell: { type: 'string', description: 'Cell reference (e.g., "A1", "B2")' },
+        sheet: { type: 'string', description: 'Sheet name (optional)' },
+      },
+      required: ['reason', 'cell'],
+    },
+  },
+};
+
+async function executeExcelReadCell(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelReadCell(
+      args['cell'] as string,
+      args['sheet'] as string | undefined
+    );
+    if (response.success) {
+      const value = response['value'];
+      return { success: true, result: `Cell ${args['cell']}: ${value ?? '(empty)'}` };
+    }
+    return { success: false, error: response.error || 'Failed to read cell' };
+  } catch (error) {
+    return { success: false, error: `Failed to read cell: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelReadCellTool: LLMSimpleTool = {
+  definition: EXCEL_READ_CELL_DEFINITION,
+  execute: executeExcelReadCell,
+  categories: OFFICE_CATEGORIES,
+  description: 'Read value from Excel cell',
+};
+
+// =============================================================================
+// Excel Write Range
+// =============================================================================
+
+const EXCEL_WRITE_RANGE_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_write_range',
+    description: `Write multiple values to a range of cells in Excel.
+Provide a 2D array of values starting from the specified cell.
+Example: start_cell="A1", values=[["Name", "Age"], ["John", 25]]`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Explanation of why you are writing this range' },
+        start_cell: { type: 'string', description: 'Starting cell reference (e.g., "A1")' },
+        values: { type: 'array', items: { type: 'array', items: {} }, description: '2D array of values to write' },
+        sheet: { type: 'string', description: 'Sheet name (optional)' },
+      },
+      required: ['reason', 'start_cell', 'values'],
+    },
+  },
+};
+
+async function executeExcelWriteRange(args: Record<string, unknown>): Promise<ToolResult> {
+  const values = args['values'] as unknown[][];
+  try {
+    const response = await excelClient.excelWriteRange(
+      args['start_cell'] as string,
+      values,
+      args['sheet'] as string | undefined
+    );
+    if (response.success) {
+      const rows = values.length;
+      const cols = values[0]?.length || 0;
+      return { success: true, result: `Written ${rows}x${cols} values starting at ${args['start_cell']}` };
+    }
+    return { success: false, error: response.error || 'Failed to write range' };
+  } catch (error) {
+    return { success: false, error: `Failed to write range: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelWriteRangeTool: LLMSimpleTool = {
+  definition: EXCEL_WRITE_RANGE_DEFINITION,
+  execute: executeExcelWriteRange,
+  categories: OFFICE_CATEGORIES,
+  description: 'Write values to Excel range',
+};
+
+// =============================================================================
+// Excel Read Range
+// =============================================================================
+
+const EXCEL_READ_RANGE_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_read_range',
+    description: `Read values from a range of cells in Excel.
+Returns a 2D array of values.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Explanation of why you are reading this range' },
+        range: { type: 'string', description: 'Range reference (e.g., "A1:C10")' },
+        sheet: { type: 'string', description: 'Sheet name (optional)' },
+      },
+      required: ['reason', 'range'],
+    },
+  },
+};
+
+async function executeExcelReadRange(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelReadRange(
+      args['range'] as string,
+      args['sheet'] as string | undefined
+    );
+    if (response.success) {
+      const values = response['values'];
+      const rows = response['rows'] as number || 0;
+      const cols = response['columns'] as number || 0;
+      return {
+        success: true,
+        result: `Range ${args['range']} (${rows}x${cols}):\n${JSON.stringify(values, null, 2)}`,
+      };
+    }
+    return { success: false, error: response.error || 'Failed to read range' };
+  } catch (error) {
+    return { success: false, error: `Failed to read range: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelReadRangeTool: LLMSimpleTool = {
+  definition: EXCEL_READ_RANGE_DEFINITION,
+  execute: executeExcelReadRange,
+  categories: OFFICE_CATEGORIES,
+  description: 'Read values from Excel range',
+};
+
+// =============================================================================
+// Excel Copy Range
+// =============================================================================
+
+const EXCEL_COPY_RANGE_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_copy_range',
+    description: `Copy a range to clipboard.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are copying' },
+        range: { type: 'string', description: 'Range to copy (e.g., "A1:B10")' },
+        sheet: { type: 'string', description: 'Sheet name (optional)' },
+      },
+      required: ['reason', 'range'],
+    },
+  },
+};
+
+async function executeExcelCopyRange(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelCopyRange(
+      args['range'] as string,
+      args['sheet'] as string | undefined
+    );
+    if (response.success) {
+      return { success: true, result: `Range ${args['range']} copied to clipboard` };
+    }
+    return { success: false, error: response.error || 'Failed to copy range' };
+  } catch (error) {
+    return { success: false, error: `Failed to copy range: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelCopyRangeTool: LLMSimpleTool = {
+  definition: EXCEL_COPY_RANGE_DEFINITION,
+  execute: executeExcelCopyRange,
+  categories: OFFICE_CATEGORIES,
+  description: 'Copy Excel range',
+};
+
+// =============================================================================
+// Excel Paste Range
+// =============================================================================
+
+const EXCEL_PASTE_RANGE_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_paste_range',
+    description: `Paste clipboard content to a destination cell.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are pasting' },
+        destination: { type: 'string', description: 'Destination cell (e.g., "A1")' },
+        sheet: { type: 'string', description: 'Sheet name (optional)' },
+      },
+      required: ['reason', 'destination'],
+    },
+  },
+};
+
+async function executeExcelPasteRange(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelPasteRange(
+      args['destination'] as string,
+      args['sheet'] as string | undefined
+    );
+    if (response.success) {
+      return { success: true, result: `Pasted to ${args['destination']}` };
+    }
+    return { success: false, error: response.error || 'Failed to paste' };
+  } catch (error) {
+    return { success: false, error: `Failed to paste: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelPasteRangeTool: LLMSimpleTool = {
+  definition: EXCEL_PASTE_RANGE_DEFINITION,
+  execute: executeExcelPasteRange,
+  categories: OFFICE_CATEGORIES,
+  description: 'Paste to Excel range',
+};
+
+// =============================================================================
+// Excel Clear Range
+// =============================================================================
+
+const EXCEL_CLEAR_RANGE_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_clear_range',
+    description: `Clear a range (all content, values only, formats only, or comments only).`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are clearing' },
+        range: { type: 'string', description: 'Range to clear (e.g., "A1:B10")' },
+        clear_type: { type: 'string', enum: ['all', 'contents', 'formats', 'comments'], description: 'What to clear (default: all)' },
+        sheet: { type: 'string', description: 'Sheet name (optional)' },
+      },
+      required: ['reason', 'range'],
+    },
+  },
+};
+
+async function executeExcelClearRange(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelClearRange(
+      args['range'] as string,
+      args['clear_type'] as 'all' | 'contents' | 'formats' | 'comments' ?? 'all',
+      args['sheet'] as string | undefined
+    );
+    if (response.success) {
+      return { success: true, result: response.message || `Range ${args['range']} cleared` };
+    }
+    return { success: false, error: response.error || 'Failed to clear range' };
+  } catch (error) {
+    return { success: false, error: `Failed to clear range: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelClearRangeTool: LLMSimpleTool = {
+  definition: EXCEL_CLEAR_RANGE_DEFINITION,
+  execute: executeExcelClearRange,
+  categories: OFFICE_CATEGORIES,
+  description: 'Clear Excel range',
+};
+
+// =============================================================================
+// Export: Cells Tools Array
+// =============================================================================
+
+export const cellsTools: LLMSimpleTool[] = [
+  excelWriteCellTool,
+  excelReadCellTool,
+  excelWriteRangeTool,
+  excelReadRangeTool,
+  excelCopyRangeTool,
+  excelPasteRangeTool,
+  excelClearRangeTool,
+];

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

@@ -0,0 +1,166 @@
+/**
+ * Excel Chart Tools
+ *
+ * Chart management tools for Excel.
+ * Tools: addChart, setChartTitle, deleteChart
+ */
+
+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 Add Chart
+// =============================================================================
+
+const EXCEL_ADD_CHART_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_add_chart',
+    description: `Add a chart based on data range.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are adding a chart' },
+        data_range: { type: 'string', description: 'Data range (e.g., "A1:B10")' },
+        chart_type: { type: 'string', enum: ['column', 'bar', 'line', 'pie', 'area', 'scatter', 'doughnut'], description: 'Chart type' },
+        title: { type: 'string', description: 'Chart title (optional)' },
+        left: { type: 'number', description: 'Left position in points (optional)' },
+        top: { type: 'number', description: 'Top position in points (optional)' },
+        width: { type: 'number', description: 'Width in points (optional)' },
+        height: { type: 'number', description: 'Height in points (optional)' },
+        sheet: { type: 'string', description: 'Sheet name (optional)' },
+      },
+      required: ['reason', 'data_range', 'chart_type'],
+    },
+  },
+};
+
+async function executeExcelAddChart(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelAddChart(
+      args['data_range'] as string,
+      args['chart_type'] as 'column' | 'bar' | 'line' | 'pie' | 'area' | 'scatter' | 'doughnut',
+      {
+        title: args['title'] as string | undefined,
+        left: args['left'] as number | undefined,
+        top: args['top'] as number | undefined,
+        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: `Chart added: ${response['chart_name']}` };
+    }
+    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 excelAddChartTool: LLMSimpleTool = {
+  definition: EXCEL_ADD_CHART_DEFINITION,
+  execute: executeExcelAddChart,
+  categories: OFFICE_CATEGORIES,
+  description: 'Add Excel chart',
+};
+
+// =============================================================================
+// Excel Set Chart Title
+// =============================================================================
+
+const EXCEL_SET_CHART_TITLE_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_set_chart_title',
+    description: `Set or change the title of a chart.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are setting chart title' },
+        chart_index: { type: 'number', description: 'Chart index (1-based)' },
+        title: { type: 'string', description: 'New chart title' },
+        sheet: { type: 'string', description: 'Sheet name (optional)' },
+      },
+      required: ['reason', 'chart_index', 'title'],
+    },
+  },
+};
+
+async function executeExcelSetChartTitle(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelSetChartTitle(
+      args['chart_index'] as number,
+      args['title'] as string,
+      args['sheet'] as string | undefined
+    );
+    if (response.success) {
+      return { success: true, result: 'Chart title set' };
+    }
+    return { success: false, error: response.error || 'Failed to set chart title' };
+  } catch (error) {
+    return { success: false, error: `Failed to set chart title: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelSetChartTitleTool: LLMSimpleTool = {
+  definition: EXCEL_SET_CHART_TITLE_DEFINITION,
+  execute: executeExcelSetChartTitle,
+  categories: OFFICE_CATEGORIES,
+  description: 'Set Excel chart title',
+};
+
+// =============================================================================
+// Excel Delete Chart
+// =============================================================================
+
+const EXCEL_DELETE_CHART_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_delete_chart',
+    description: `Delete a chart from the worksheet.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are deleting the chart' },
+        chart_index: { type: 'number', description: 'Chart index (1-based)' },
+        sheet: { type: 'string', description: 'Sheet name (optional)' },
+      },
+      required: ['reason', 'chart_index'],
+    },
+  },
+};
+
+async function executeExcelDeleteChart(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelDeleteChart(
+      args['chart_index'] as number,
+      args['sheet'] as string | undefined
+    );
+    if (response.success) {
+      return { success: true, result: 'Chart deleted' };
+    }
+    return { success: false, error: response.error || 'Failed to delete chart' };
+  } catch (error) {
+    return { success: false, error: `Failed to delete chart: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelDeleteChartTool: LLMSimpleTool = {
+  definition: EXCEL_DELETE_CHART_DEFINITION,
+  execute: executeExcelDeleteChart,
+  categories: OFFICE_CATEGORIES,
+  description: 'Delete Excel chart',
+};
+
+// =============================================================================
+// Export: Chart Tools Array
+// =============================================================================
+
+export const chartsTools: LLMSimpleTool[] = [
+  excelAddChartTool,
+  excelSetChartTitleTool,
+  excelDeleteChartTool,
+];

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

@@ -0,0 +1,155 @@
+/**
+ * Excel Comments Tools
+ *
+ * Tools for managing cell comments in Excel
+ */
+
+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 Comment
+// =============================================================================
+
+const EXCEL_ADD_COMMENT_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_add_comment',
+    description: `Add a comment to a cell.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are adding comment' },
+        cell: { type: 'string', description: 'Cell address (e.g., "A1")' },
+        text: { type: 'string', description: 'Comment text' },
+        sheet: { type: 'string', description: 'Sheet name (optional)' },
+      },
+      required: ['reason', 'cell', 'text'],
+    },
+  },
+};
+
+async function executeExcelAddComment(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelAddComment(
+      args['cell'] as string,
+      args['text'] as string,
+      undefined,
+      args['sheet'] as string | undefined
+    );
+    if (response.success) {
+      return { success: true, result: `Comment added to ${args['cell']}` };
+    }
+    return { success: false, error: response.error || 'Failed to add comment' };
+  } catch (error) {
+    return { success: false, error: `Failed to add comment: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelAddCommentTool: LLMSimpleTool = {
+  definition: EXCEL_ADD_COMMENT_DEFINITION,
+  execute: executeExcelAddComment,
+  categories: OFFICE_CATEGORIES,
+  description: 'Add Excel comment',
+};
+
+// =============================================================================
+// Excel Get Comment
+// =============================================================================
+
+const EXCEL_GET_COMMENT_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_get_comment',
+    description: `Get comment from a cell.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you need the comment' },
+        cell: { type: 'string', description: 'Cell address (e.g., "A1")' },
+        sheet: { type: 'string', description: 'Sheet name (optional)' },
+      },
+      required: ['reason', 'cell'],
+    },
+  },
+};
+
+async function executeExcelGetComment(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelGetComment(
+      args['cell'] as string,
+      args['sheet'] as string | undefined
+    );
+    if (response.success) {
+      if (response['has_comment']) {
+        return { success: true, result: `Comment at ${args['cell']}: "${response['text']}"` };
+      }
+      return { success: true, result: `No comment at ${args['cell']}` };
+    }
+    return { success: false, error: response.error || 'Failed to get comment' };
+  } catch (error) {
+    return { success: false, error: `Failed to get comment: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelGetCommentTool: LLMSimpleTool = {
+  definition: EXCEL_GET_COMMENT_DEFINITION,
+  execute: executeExcelGetComment,
+  categories: OFFICE_CATEGORIES,
+  description: 'Get Excel comment',
+};
+
+// =============================================================================
+// Excel Delete Comment
+// =============================================================================
+
+const EXCEL_DELETE_COMMENT_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'excel_delete_comment',
+    description: `Delete comment from a cell.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are deleting comment' },
+        cell: { type: 'string', description: 'Cell address (e.g., "A1")' },
+        sheet: { type: 'string', description: 'Sheet name (optional)' },
+      },
+      required: ['reason', 'cell'],
+    },
+  },
+};
+
+async function executeExcelDeleteComment(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await excelClient.excelDeleteComment(
+      args['cell'] as string,
+      args['sheet'] as string | undefined
+    );
+    if (response.success) {
+      return { success: true, result: `Comment deleted from ${args['cell']}` };
+    }
+    return { success: false, error: response.error || 'Failed to delete comment' };
+  } catch (error) {
+    return { success: false, error: `Failed to delete comment: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const excelDeleteCommentTool: LLMSimpleTool = {
+  definition: EXCEL_DELETE_COMMENT_DEFINITION,
+  execute: executeExcelDeleteComment,
+  categories: OFFICE_CATEGORIES,
+  description: 'Delete Excel comment',
+};
+
+// =============================================================================
+// Export all comment tools
+// =============================================================================
+
+export const commentsTools: LLMSimpleTool[] = [
+  excelAddCommentTool,
+  excelGetCommentTool,
+  excelDeleteCommentTool,
+];