orquesta-cli 0.1.12

package/src/tools/office/word-tools/lists.ts

@@ -0,0 +1,97 @@
+/**
+ * Word Lists Tools
+ *
+ * Tools for creating bullet and numbered lists in Word documents.
+ */
+
+import { ToolDefinition } from '../../../types/index.js';
+import { LLMSimpleTool, ToolResult } from '../../types.js';
+import { wordClient } from '../word-client.js';
+import { OFFICE_CATEGORIES } from '../common/constants.js';
+
+// =============================================================================
+// Word Create Bullet List
+// =============================================================================
+
+const WORD_CREATE_BULLET_LIST_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_create_bullet_list',
+    description: `Create a bullet list with the specified items.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are creating bullet list' },
+        items: { type: 'array', items: { type: 'string' }, description: 'List items' },
+      },
+      required: ['reason', 'items'],
+    },
+  },
+};
+
+async function executeWordCreateBulletList(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordCreateBulletList(args['items'] as string[]);
+    if (response.success) {
+      return { success: true, result: response.message || 'Bullet list created' };
+    }
+    return { success: false, error: response.error || 'Failed to create bullet list' };
+  } catch (error) {
+    return { success: false, error: `Failed to create bullet list: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordCreateBulletListTool: LLMSimpleTool = {
+  definition: WORD_CREATE_BULLET_LIST_DEFINITION,
+  execute: executeWordCreateBulletList,
+  categories: OFFICE_CATEGORIES,
+  description: 'Create Word bullet list',
+};
+
+// =============================================================================
+// Word Create Numbered List
+// =============================================================================
+
+const WORD_CREATE_NUMBERED_LIST_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_create_numbered_list',
+    description: `Create a numbered list with the specified items.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are creating numbered list' },
+        items: { type: 'array', items: { type: 'string' }, description: 'List items' },
+      },
+      required: ['reason', 'items'],
+    },
+  },
+};
+
+async function executeWordCreateNumberedList(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordCreateNumberedList(args['items'] as string[]);
+    if (response.success) {
+      return { success: true, result: response.message || 'Numbered list created' };
+    }
+    return { success: false, error: response.error || 'Failed to create numbered list' };
+  } catch (error) {
+    return { success: false, error: `Failed to create numbered list: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordCreateNumberedListTool: LLMSimpleTool = {
+  definition: WORD_CREATE_NUMBERED_LIST_DEFINITION,
+  execute: executeWordCreateNumberedList,
+  categories: OFFICE_CATEGORIES,
+  description: 'Create Word numbered list',
+};
+
+// =============================================================================
+// Export All Lists Tools
+// =============================================================================
+
+export const listsTools: LLMSimpleTool[] = [
+  wordCreateBulletListTool,
+  wordCreateNumberedListTool,
+];

package/src/tools/office/word-tools/navigation.ts

@@ -0,0 +1,114 @@
+/**
+ * Word Navigation Tools
+ *
+ * Navigation-related tools for Microsoft Word:
+ * - word_goto: Navigate to page, line, or bookmark
+ * - word_get_document_info: Get document statistics
+ */
+
+import { ToolDefinition } from '../../../types/index.js';
+import { LLMSimpleTool, ToolResult } from '../../types.js';
+import { wordClient } from '../word-client.js';
+import { OFFICE_CATEGORIES } from '../common/constants.js';
+
+// =============================================================================
+// Word Goto
+// =============================================================================
+
+const WORD_GOTO_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_goto',
+    description: `Navigate to a specific page, line, or bookmark.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are navigating' },
+        what: { type: 'string', enum: ['page', 'line', 'bookmark'], description: 'Navigation target type' },
+        target: { type: 'string', description: 'Page/line number or bookmark name' },
+      },
+      required: ['reason', 'what', 'target'],
+    },
+  },
+};
+
+async function executeWordGoto(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const target = args['what'] === 'bookmark' ? args['target'] as string : parseInt(args['target'] as string);
+    const response = await wordClient.wordGoto(
+      args['what'] as 'page' | 'line' | 'bookmark',
+      target
+    );
+    if (response.success) {
+      return { success: true, result: `Navigated to ${args['what']} ${args['target']}` };
+    }
+    return { success: false, error: response.error || 'Failed to navigate' };
+  } catch (error) {
+    return { success: false, error: `Failed to navigate: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordGotoTool: LLMSimpleTool = {
+  definition: WORD_GOTO_DEFINITION,
+  execute: executeWordGoto,
+  categories: OFFICE_CATEGORIES,
+  description: 'Navigate in Word',
+};
+
+// =============================================================================
+// Word Get Document Info
+// =============================================================================
+
+const WORD_GET_DOCUMENT_INFO_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_get_document_info',
+    description: `Get document statistics (pages, words, characters, etc.).`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you need document info' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executeWordGetDocumentInfo(_args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordGetDocumentInfo();
+    if (response.success) {
+      return {
+        success: true,
+        result: `Document: ${response['name']}
+Pages: ${response['pages']}
+Words: ${response['words']}
+Characters: ${response['characters']}
+Characters (with spaces): ${response['characters_with_spaces']}
+Paragraphs: ${response['paragraphs']}
+Lines: ${response['lines']}
+Saved: ${response['saved'] ? 'Yes' : 'No'}
+Read-only: ${response['read_only'] ? 'Yes' : 'No'}`,
+      };
+    }
+    return { success: false, error: response.error || 'Failed to get document info' };
+  } catch (error) {
+    return { success: false, error: `Failed to get document info: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordGetDocumentInfoTool: LLMSimpleTool = {
+  definition: WORD_GET_DOCUMENT_INFO_DEFINITION,
+  execute: executeWordGetDocumentInfo,
+  categories: OFFICE_CATEGORIES,
+  description: 'Get Word document info',
+};
+
+// =============================================================================
+// Export Navigation Tools
+// =============================================================================
+
+export const navigationTools: LLMSimpleTool[] = [
+  wordGotoTool,
+  wordGetDocumentInfoTool,
+];

package/src/tools/office/word-tools/page-setup.ts

@@ -0,0 +1,195 @@
+/**
+ * Word Page Setup Tools
+ *
+ * Page setup related tools: margins, orientation, page size, columns
+ */
+
+import { ToolDefinition } from '../../../types/index.js';
+import { LLMSimpleTool, ToolResult } from '../../types.js';
+import { wordClient } from '../word-client.js';
+import { OFFICE_CATEGORIES } from '../common/index.js';
+
+// =============================================================================
+// Word Set Page Margins
+// =============================================================================
+
+const WORD_SET_PAGE_MARGINS_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_set_page_margins',
+    description: `Set page margins (in points, 72 points = 1 inch).`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are setting margins' },
+        top: { type: 'number', description: 'Top margin in points' },
+        bottom: { type: 'number', description: 'Bottom margin in points' },
+        left: { type: 'number', description: 'Left margin in points' },
+        right: { type: 'number', description: 'Right margin in points' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executeWordSetPageMargins(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordSetPageMargins({
+      top: args['top'] as number | undefined,
+      bottom: args['bottom'] as number | undefined,
+      left: args['left'] as number | undefined,
+      right: args['right'] as number | undefined,
+    });
+    if (response.success) {
+      return { success: true, result: 'Page margins updated' };
+    }
+    return { success: false, error: response.error || 'Failed to set margins' };
+  } catch (error) {
+    return { success: false, error: `Failed to set margins: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordSetPageMarginsTool: LLMSimpleTool = {
+  definition: WORD_SET_PAGE_MARGINS_DEFINITION,
+  execute: executeWordSetPageMargins,
+  categories: OFFICE_CATEGORIES,
+  description: 'Set Word page margins',
+};
+
+// =============================================================================
+// Word Set Page Orientation
+// =============================================================================
+
+const WORD_SET_PAGE_ORIENTATION_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_set_page_orientation',
+    description: `Set page orientation.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are changing orientation' },
+        orientation: { type: 'string', enum: ['portrait', 'landscape'], description: 'Page orientation' },
+      },
+      required: ['reason', 'orientation'],
+    },
+  },
+};
+
+async function executeWordSetPageOrientation(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordSetPageOrientation(args['orientation'] as 'portrait' | 'landscape');
+    if (response.success) {
+      return { success: true, result: `Page orientation set to ${args['orientation']}` };
+    }
+    return { success: false, error: response.error || 'Failed to set orientation' };
+  } catch (error) {
+    return { success: false, error: `Failed to set orientation: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordSetPageOrientationTool: LLMSimpleTool = {
+  definition: WORD_SET_PAGE_ORIENTATION_DEFINITION,
+  execute: executeWordSetPageOrientation,
+  categories: OFFICE_CATEGORIES,
+  description: 'Set Word page orientation',
+};
+
+// =============================================================================
+// Word Set Page Size
+// =============================================================================
+
+const WORD_SET_PAGE_SIZE_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_set_page_size',
+    description: `Set page size.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are changing page size' },
+        size: { type: 'string', enum: ['A4', 'Letter', 'Legal', 'A3', 'B5', 'custom'], description: 'Page size' },
+        width: { type: 'number', description: 'Custom width in points (for custom size)' },
+        height: { type: 'number', description: 'Custom height in points (for custom size)' },
+      },
+      required: ['reason', 'size'],
+    },
+  },
+};
+
+async function executeWordSetPageSize(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordSetPageSize(
+      args['size'] as 'A4' | 'Letter' | 'Legal' | 'A3' | 'B5' | 'custom',
+      args['width'] as number | undefined,
+      args['height'] as number | undefined
+    );
+    if (response.success) {
+      return { success: true, result: response.message || 'Page size updated' };
+    }
+    return { success: false, error: response.error || 'Failed to set page size' };
+  } catch (error) {
+    return { success: false, error: `Failed to set page size: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordSetPageSizeTool: LLMSimpleTool = {
+  definition: WORD_SET_PAGE_SIZE_DEFINITION,
+  execute: executeWordSetPageSize,
+  categories: OFFICE_CATEGORIES,
+  description: 'Set Word page size',
+};
+
+// =============================================================================
+// Word Set Columns
+// =============================================================================
+
+const WORD_SET_COLUMNS_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_set_columns',
+    description: `Set the number of columns for the document layout.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are setting columns' },
+        count: { type: 'number', description: 'Number of columns (1-4)' },
+        spacing: { type: 'number', description: 'Spacing between columns in points (optional)' },
+      },
+      required: ['reason', 'count'],
+    },
+  },
+};
+
+async function executeWordSetColumns(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordSetColumns(
+      args['count'] as number,
+      args['spacing'] as number | undefined
+    );
+    if (response.success) {
+      return { success: true, result: `Columns set to ${args['count']}` };
+    }
+    return { success: false, error: response.error || 'Failed to set columns' };
+  } catch (error) {
+    return { success: false, error: `Failed to set columns: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordSetColumnsTool: LLMSimpleTool = {
+  definition: WORD_SET_COLUMNS_DEFINITION,
+  execute: executeWordSetColumns,
+  categories: OFFICE_CATEGORIES,
+  description: 'Set Word columns',
+};
+
+// =============================================================================
+// Export All Page Setup Tools
+// =============================================================================
+
+export const pageSetupTools: LLMSimpleTool[] = [
+  wordSetPageMarginsTool,
+  wordSetPageOrientationTool,
+  wordSetPageSizeTool,
+  wordSetColumnsTool,
+];

package/src/tools/office/word-tools/tables.ts

@@ -0,0 +1,262 @@
+/**
+ * Word Table Tools
+ *
+ * Tools for table manipulation in Word documents:
+ * - addTable, setTableCell, mergeTableCells, setTableStyle, setTableBorder
+ */
+
+import { ToolDefinition } from '../../../types/index.js';
+import { LLMSimpleTool, ToolResult } from '../../types.js';
+import { wordClient } from '../word-client.js';
+import { OFFICE_CATEGORIES } from '../common/constants.js';
+
+// =============================================================================
+// Word Add Table
+// =============================================================================
+
+const WORD_ADD_TABLE_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_add_table',
+    description: `Add a table to the Word document.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are adding a table' },
+        rows: { type: 'number', description: 'Number of rows' },
+        cols: { type: 'number', description: 'Number of columns' },
+        data: { type: 'array', items: { type: 'array', items: { type: 'string' } }, description: '2D array of cell data' },
+      },
+      required: ['reason', 'rows', 'cols'],
+    },
+  },
+};
+
+async function executeWordAddTable(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordAddTable(
+      args['rows'] as number,
+      args['cols'] as number,
+      args['data'] as string[][] | undefined
+    );
+    if (response.success) {
+      return { success: true, result: `Table added (${args['rows']}x${args['cols']})` };
+    }
+    return { success: false, error: response.error || 'Failed to add table' };
+  } catch (error) {
+    return { success: false, error: `Failed to add table: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordAddTableTool: LLMSimpleTool = {
+  definition: WORD_ADD_TABLE_DEFINITION,
+  execute: executeWordAddTable,
+  categories: OFFICE_CATEGORIES,
+  description: 'Add Word table',
+};
+
+// =============================================================================
+// Word Set Table Cell
+// =============================================================================
+
+const WORD_SET_TABLE_CELL_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_set_table_cell',
+    description: `Set the content of a specific cell in a Word table.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are setting table cell' },
+        table_index: { type: 'number', description: 'Table index (1-based)' },
+        row: { type: 'number', description: 'Row number (1-based)' },
+        col: { type: 'number', description: 'Column number (1-based)' },
+        text: { type: 'string', description: 'Text to set in the cell' },
+        font_name: { type: 'string', description: 'Font name (optional)' },
+        font_size: { type: 'number', description: 'Font size (optional)' },
+        bold: { type: 'boolean', description: 'Bold text (optional)' },
+      },
+      required: ['reason', 'table_index', 'row', 'col', 'text'],
+    },
+  },
+};
+
+async function executeWordSetTableCell(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordSetTableCell(
+      args['table_index'] as number,
+      args['row'] as number,
+      args['col'] as number,
+      args['text'] as string,
+      {
+        fontName: args['font_name'] as string | undefined,
+        fontSize: args['font_size'] as number | undefined,
+        bold: args['bold'] as boolean | undefined,
+      }
+    );
+    if (response.success) {
+      return { success: true, result: response.message || 'Table cell updated' };
+    }
+    return { success: false, error: response.error || 'Failed to set table cell' };
+  } catch (error) {
+    return { success: false, error: `Failed to set table cell: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordSetTableCellTool: LLMSimpleTool = {
+  definition: WORD_SET_TABLE_CELL_DEFINITION,
+  execute: executeWordSetTableCell,
+  categories: OFFICE_CATEGORIES,
+  description: 'Set Word table cell',
+};
+
+// =============================================================================
+// Word Merge Table Cells
+// =============================================================================
+
+const WORD_MERGE_TABLE_CELLS_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_merge_table_cells',
+    description: `Merge cells in a Word table.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are merging cells' },
+        table_index: { type: 'number', description: 'Table index (1-based)' },
+        start_row: { type: 'number', description: 'Start row (1-based)' },
+        start_col: { type: 'number', description: 'Start column (1-based)' },
+        end_row: { type: 'number', description: 'End row (1-based)' },
+        end_col: { type: 'number', description: 'End column (1-based)' },
+      },
+      required: ['reason', 'table_index', 'start_row', 'start_col', 'end_row', 'end_col'],
+    },
+  },
+};
+
+async function executeWordMergeTableCells(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordMergeTableCells(
+      args['table_index'] as number,
+      args['start_row'] as number,
+      args['start_col'] as number,
+      args['end_row'] as number,
+      args['end_col'] as number
+    );
+    if (response.success) {
+      return { success: true, result: 'Table cells merged' };
+    }
+    return { success: false, error: response.error || 'Failed to merge cells' };
+  } catch (error) {
+    return { success: false, error: `Failed to merge cells: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordMergeTableCellsTool: LLMSimpleTool = {
+  definition: WORD_MERGE_TABLE_CELLS_DEFINITION,
+  execute: executeWordMergeTableCells,
+  categories: OFFICE_CATEGORIES,
+  description: 'Merge Word table cells',
+};
+
+// =============================================================================
+// Word Set Table Style
+// =============================================================================
+
+const WORD_SET_TABLE_STYLE_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_set_table_style',
+    description: `Apply a style to a Word table.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are setting table style' },
+        table_index: { type: 'number', description: 'Table index (1-based)' },
+        style: { type: 'string', description: 'Style name (e.g., "Table Grid", "Light Shading")' },
+      },
+      required: ['reason', 'table_index', 'style'],
+    },
+  },
+};
+
+async function executeWordSetTableStyle(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordSetTableStyle(
+      args['table_index'] as number,
+      args['style'] as string
+    );
+    if (response.success) {
+      return { success: true, result: `Table style set to "${args['style']}"` };
+    }
+    return { success: false, error: response.error || 'Failed to set table style' };
+  } catch (error) {
+    return { success: false, error: `Failed to set table style: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordSetTableStyleTool: LLMSimpleTool = {
+  definition: WORD_SET_TABLE_STYLE_DEFINITION,
+  execute: executeWordSetTableStyle,
+  categories: OFFICE_CATEGORIES,
+  description: 'Set Word table style',
+};
+
+// =============================================================================
+// Word Set Table Border
+// =============================================================================
+
+const WORD_SET_TABLE_BORDER_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_set_table_border',
+    description: `Set border style for a Word table.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are setting table border' },
+        table_index: { type: 'number', description: 'Table index (1-based)' },
+        style: { type: 'string', enum: ['single', 'double', 'thick', 'none'], description: 'Border style' },
+        color: { type: 'string', description: 'Border color as hex (e.g., "#000000")' },
+      },
+      required: ['reason', 'table_index'],
+    },
+  },
+};
+
+async function executeWordSetTableBorder(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordSetTableBorder(
+      args['table_index'] as number,
+      {
+        style: args['style'] as 'single' | 'double' | 'thick' | 'none' | undefined,
+        color: args['color'] as string | undefined,
+      }
+    );
+    if (response.success) {
+      return { success: true, result: 'Table border set' };
+    }
+    return { success: false, error: response.error || 'Failed to set table border' };
+  } catch (error) {
+    return { success: false, error: `Failed to set table border: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordSetTableBorderTool: LLMSimpleTool = {
+  definition: WORD_SET_TABLE_BORDER_DEFINITION,
+  execute: executeWordSetTableBorder,
+  categories: OFFICE_CATEGORIES,
+  description: 'Set Word table border',
+};
+
+// =============================================================================
+// Export All Table Tools
+// =============================================================================
+
+export const tablesTools: LLMSimpleTool[] = [
+  wordAddTableTool,
+  wordSetTableCellTool,
+  wordMergeTableCellsTool,
+  wordSetTableStyleTool,
+  wordSetTableBorderTool,
+];