orquesta-cli 0.1.13 → 0.1.15

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

@@ -1,359 +0,0 @@
-/**
- * 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

@@ -1,166 +0,0 @@
-/**
- * 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

@@ -1,155 +0,0 @@
-/**
- * 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,
-];