orquesta-cli 0.1.12

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

@@ -0,0 +1,161 @@
+/**
+ * Word Formatting Tools
+ *
+ * Tools for font, paragraph, and break formatting 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 Set Font
+// =============================================================================
+
+const WORD_SET_FONT_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_set_font',
+    description: `Set font properties for the current selection in Word.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are setting font' },
+        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: 'Bold text' },
+        italic: { type: 'boolean', description: 'Italic text' },
+        underline: { type: 'boolean', description: 'Underline text' },
+        color: { type: 'string', description: 'Font color as hex (e.g., "#FF0000")' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executeWordSetFont(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordSetFont({
+      fontName: args['font_name'] as string | undefined,
+      fontSize: args['font_size'] as number | undefined,
+      bold: args['bold'] as boolean | undefined,
+      italic: args['italic'] as boolean | undefined,
+      underline: args['underline'] as boolean | undefined,
+      color: args['color'] as string | undefined,
+    });
+    if (response.success) {
+      return { success: true, result: 'Font properties set' };
+    }
+    return { success: false, error: response.error || 'Failed to set font' };
+  } catch (error) {
+    return { success: false, error: `Failed to set font: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordSetFontTool: LLMSimpleTool = {
+  definition: WORD_SET_FONT_DEFINITION,
+  execute: executeWordSetFont,
+  categories: OFFICE_CATEGORIES,
+  description: 'Set Word font properties',
+};
+
+// =============================================================================
+// Word Set Paragraph
+// =============================================================================
+
+const WORD_SET_PARAGRAPH_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_set_paragraph',
+    description: `Set paragraph formatting for the current selection in Word.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are setting paragraph format' },
+        alignment: { type: 'string', enum: ['left', 'center', 'right', 'justify'], description: 'Text alignment' },
+        line_spacing: { type: 'number', description: 'Line spacing multiplier' },
+        space_before: { type: 'number', description: 'Space before paragraph in points' },
+        space_after: { type: 'number', description: 'Space after paragraph in points' },
+        first_line_indent: { type: 'number', description: 'First line indent in points' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executeWordSetParagraph(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordSetParagraph({
+      alignment: args['alignment'] as 'left' | 'center' | 'right' | 'justify' | undefined,
+      lineSpacing: args['line_spacing'] as number | undefined,
+      spaceBefore: args['space_before'] as number | undefined,
+      spaceAfter: args['space_after'] as number | undefined,
+      firstLineIndent: args['first_line_indent'] as number | undefined,
+    });
+    if (response.success) {
+      return { success: true, result: 'Paragraph formatting set' };
+    }
+    return { success: false, error: response.error || 'Failed to set paragraph' };
+  } catch (error) {
+    return { success: false, error: `Failed to set paragraph: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordSetParagraphTool: LLMSimpleTool = {
+  definition: WORD_SET_PARAGRAPH_DEFINITION,
+  execute: executeWordSetParagraph,
+  categories: OFFICE_CATEGORIES,
+  description: 'Set Word paragraph format',
+};
+
+// =============================================================================
+// Word Insert Break
+// =============================================================================
+
+const WORD_INSERT_BREAK_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_insert_break',
+    description: `Insert a page break, line break, or section break.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are inserting a break' },
+        break_type: { type: 'string', enum: ['page', 'line', 'section'], description: 'Type of break (default: page)' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executeWordInsertBreak(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordInsertBreak(
+      args['break_type'] as 'page' | 'line' | 'section' ?? 'page'
+    );
+    if (response.success) {
+      return { success: true, result: `${args['break_type'] || 'page'} break inserted` };
+    }
+    return { success: false, error: response.error || 'Failed to insert break' };
+  } catch (error) {
+    return { success: false, error: `Failed to insert break: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordInsertBreakTool: LLMSimpleTool = {
+  definition: WORD_INSERT_BREAK_DEFINITION,
+  execute: executeWordInsertBreak,
+  categories: OFFICE_CATEGORIES,
+  description: 'Insert Word break',
+};
+
+// =============================================================================
+// Export Formatting Tools
+// =============================================================================
+
+export const formattingTools: LLMSimpleTool[] = [
+  wordSetFontTool,
+  wordSetParagraphTool,
+  wordInsertBreakTool,
+];

package/src/tools/office/word-tools/headers-footers.ts

@@ -0,0 +1,155 @@
+/**
+ * Word Headers and Footers Tools
+ *
+ * Tools for inserting headers, footers, and page numbers 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 Insert Header
+// =============================================================================
+
+const WORD_INSERT_HEADER_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_insert_header',
+    description: `Insert header text to the document.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are inserting header' },
+        text: { type: 'string', description: 'Header text' },
+        font_name: { type: 'string', description: 'Font name (optional)' },
+        font_size: { type: 'number', description: 'Font size (optional)' },
+      },
+      required: ['reason', 'text'],
+    },
+  },
+};
+
+async function executeWordInsertHeader(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordInsertHeader(
+      args['text'] as string,
+      {
+        fontName: args['font_name'] as string | undefined,
+        fontSize: args['font_size'] as number | undefined,
+      }
+    );
+    if (response.success) {
+      return { success: true, result: 'Header inserted' };
+    }
+    return { success: false, error: response.error || 'Failed to insert header' };
+  } catch (error) {
+    return { success: false, error: `Failed to insert header: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordInsertHeaderTool: LLMSimpleTool = {
+  definition: WORD_INSERT_HEADER_DEFINITION,
+  execute: executeWordInsertHeader,
+  categories: OFFICE_CATEGORIES,
+  description: 'Insert Word header',
+};
+
+// =============================================================================
+// Word Insert Footer
+// =============================================================================
+
+const WORD_INSERT_FOOTER_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_insert_footer',
+    description: `Insert footer text to the document.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are inserting footer' },
+        text: { type: 'string', description: 'Footer text' },
+        font_name: { type: 'string', description: 'Font name (optional)' },
+        font_size: { type: 'number', description: 'Font size (optional)' },
+      },
+      required: ['reason', 'text'],
+    },
+  },
+};
+
+async function executeWordInsertFooter(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordInsertFooter(
+      args['text'] as string,
+      {
+        fontName: args['font_name'] as string | undefined,
+        fontSize: args['font_size'] as number | undefined,
+      }
+    );
+    if (response.success) {
+      return { success: true, result: 'Footer inserted' };
+    }
+    return { success: false, error: response.error || 'Failed to insert footer' };
+  } catch (error) {
+    return { success: false, error: `Failed to insert footer: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordInsertFooterTool: LLMSimpleTool = {
+  definition: WORD_INSERT_FOOTER_DEFINITION,
+  execute: executeWordInsertFooter,
+  categories: OFFICE_CATEGORIES,
+  description: 'Insert Word footer',
+};
+
+// =============================================================================
+// Word Insert Page Number
+// =============================================================================
+
+const WORD_INSERT_PAGE_NUMBER_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_insert_page_number',
+    description: `Insert page numbers to the document footer.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are inserting page numbers' },
+        alignment: { type: 'string', enum: ['left', 'center', 'right'], description: 'Page number alignment (default: center)' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executeWordInsertPageNumber(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordInsertPageNumber(
+      args['alignment'] as 'left' | 'center' | 'right' ?? 'center'
+    );
+    if (response.success) {
+      return { success: true, result: 'Page numbers inserted' };
+    }
+    return { success: false, error: response.error || 'Failed to insert page numbers' };
+  } catch (error) {
+    return { success: false, error: `Failed to insert page numbers: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordInsertPageNumberTool: LLMSimpleTool = {
+  definition: WORD_INSERT_PAGE_NUMBER_DEFINITION,
+  execute: executeWordInsertPageNumber,
+  categories: OFFICE_CATEGORIES,
+  description: 'Insert Word page numbers',
+};
+
+// =============================================================================
+// Export Headers-Footers Tools
+// =============================================================================
+
+export const headersFootersTools: LLMSimpleTool[] = [
+  wordInsertHeaderTool,
+  wordInsertFooterTool,
+  wordInsertPageNumberTool,
+];

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

@@ -0,0 +1,57 @@
+/**
+ * Word Tools - Barrel Export
+ *
+ * Re-exports all Word tool modules and provides unified WORD_TOOLS array
+ */
+
+// Domain exports
+export * from './launch.js';
+export * from './text.js';
+export * from './formatting.js';
+export * from './tables.js';
+export * from './content.js';
+export * from './lists.js';
+export * from './headers-footers.js';
+export * from './page-setup.js';
+export * from './bookmarks.js';
+export * from './comments.js';
+export * from './watermarks.js';
+export * from './navigation.js';
+export * from './undo-redo.js';
+export * from './export.js';
+
+// Import tool arrays for unified export
+import { launchTools } from './launch.js';
+import { textTools } from './text.js';
+import { formattingTools } from './formatting.js';
+import { tablesTools } from './tables.js';
+import { contentTools } from './content.js';
+import { listsTools } from './lists.js';
+import { headersFootersTools } from './headers-footers.js';
+import { pageSetupTools } from './page-setup.js';
+import { bookmarksTools } from './bookmarks.js';
+import { commentsTools } from './comments.js';
+import { watermarksTools } from './watermarks.js';
+import { navigationTools } from './navigation.js';
+import { undoRedoTools } from './undo-redo.js';
+import { exportTools } from './export.js';
+
+/**
+ * All Word tools combined into a single array
+ */
+export const WORD_TOOLS = [
+  ...launchTools,
+  ...textTools,
+  ...formattingTools,
+  ...tablesTools,
+  ...contentTools,
+  ...listsTools,
+  ...headersFootersTools,
+  ...pageSetupTools,
+  ...bookmarksTools,
+  ...commentsTools,
+  ...watermarksTools,
+  ...navigationTools,
+  ...undoRedoTools,
+  ...exportTools,
+];

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

@@ -0,0 +1,312 @@
+/**
+ * Word Launch Tools
+ *
+ * Tools for launching, creating, opening, saving, closing Word and taking screenshots
+ */
+
+import { ToolDefinition } from '../../../types/index.js';
+import { LLMSimpleTool, ToolResult } from '../../types.js';
+import { wordClient } from '../word-client.js';
+import { saveScreenshot } from '../common/utils.js';
+import { OFFICE_SCREENSHOT_PATH_DESC, OFFICE_CATEGORIES } from '../common/constants.js';
+
+// =============================================================================
+// Word Launch
+// =============================================================================
+
+const WORD_LAUNCH_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_launch',
+    description: `Launch Microsoft Word for document editing.
+Use this tool to start Word before creating or editing documents.
+The Word window will be visible so you can see the changes in real-time.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Explanation of why you are launching Word' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executeWordLaunch(_args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordLaunch();
+    if (response.success) {
+      return { success: true, result: response.message || 'Word launched successfully' };
+    }
+    return { success: false, error: response.error || 'Failed to launch Word' };
+  } catch (error) {
+    return { success: false, error: `Failed to launch Word: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordLaunchTool: LLMSimpleTool = {
+  definition: WORD_LAUNCH_DEFINITION,
+  execute: executeWordLaunch,
+  categories: OFFICE_CATEGORIES,
+  description: 'Launch Microsoft Word',
+};
+
+// =============================================================================
+// Word Create
+// =============================================================================
+
+const WORD_CREATE_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_create',
+    description: `Create a new Word document.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are creating a document' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executeWordCreate(_args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordCreate();
+    if (response.success) {
+      return { success: true, result: response.message || 'New document created' };
+    }
+    return { success: false, error: response.error || 'Failed to create document' };
+  } catch (error) {
+    return { success: false, error: `Failed to create document: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordCreateTool: LLMSimpleTool = {
+  definition: WORD_CREATE_DEFINITION,
+  execute: executeWordCreate,
+  categories: OFFICE_CATEGORIES,
+  description: 'Create new Word document',
+};
+
+// =============================================================================
+// Word Open
+// =============================================================================
+
+const WORD_OPEN_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_open',
+    description: `Open an existing Word document. WSL paths are automatically converted to Windows paths.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are opening this document' },
+        path: { type: 'string', description: 'File path to open. Can use Linux/WSL paths or Windows paths.' },
+      },
+      required: ['reason', 'path'],
+    },
+  },
+};
+
+async function executeWordOpen(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordOpen(args['path'] as string);
+    if (response.success) {
+      return { success: true, result: `Document opened: ${response['document_name'] || args['path']}` };
+    }
+    return { success: false, error: response.error || 'Failed to open document' };
+  } catch (error) {
+    return { success: false, error: `Failed to open document: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordOpenTool: LLMSimpleTool = {
+  definition: WORD_OPEN_DEFINITION,
+  execute: executeWordOpen,
+  categories: OFFICE_CATEGORIES,
+  description: 'Open existing Word document',
+};
+
+// =============================================================================
+// Word Save
+// =============================================================================
+
+const WORD_SAVE_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_save',
+    description: `Save the active Word document. WSL paths are automatically converted to Windows paths.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Explanation of why you are saving' },
+        path: { type: 'string', description: 'File path to save to (optional). Can use Linux/WSL paths or Windows paths.' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executeWordSave(args: Record<string, unknown>): Promise<ToolResult> {
+  const filePath = args['path'] as string | undefined;
+
+  try {
+    const response = await wordClient.wordSave(filePath);
+    if (response.success) {
+      const savedPath = response['path'] as string || filePath || 'current location';
+      return { success: true, result: `Document saved to: ${savedPath}` };
+    }
+    return { success: false, error: response.error || 'Failed to save document' };
+  } catch (error) {
+    return { success: false, error: `Failed to save document: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordSaveTool: LLMSimpleTool = {
+  definition: WORD_SAVE_DEFINITION,
+  execute: executeWordSave,
+  categories: OFFICE_CATEGORIES,
+  description: 'Save Word document',
+};
+
+// =============================================================================
+// Word Screenshot
+// =============================================================================
+
+const WORD_SCREENSHOT_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_screenshot',
+    description: `Take a screenshot of the current Word document.
+Captures the document content and saves to ${OFFICE_SCREENSHOT_PATH_DESC}.
+Use this to verify document formatting or show the user what the document looks like.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Explanation of why you are taking a screenshot' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executeWordScreenshot(_args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordScreenshot();
+    if (response.success && response.image) {
+      const filePath = await saveScreenshot(response.image, 'word');
+      return {
+        success: true,
+        result: `Word screenshot saved to: ${filePath}\n\nYou can view this image using read_file tool if your LLM supports vision.`,
+      };
+    }
+    return { success: false, error: response.error || 'Failed to capture screenshot' };
+  } catch (error) {
+    return { success: false, error: `Failed to capture screenshot: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordScreenshotTool: LLMSimpleTool = {
+  definition: WORD_SCREENSHOT_DEFINITION,
+  execute: executeWordScreenshot,
+  categories: OFFICE_CATEGORIES,
+  description: 'Take Word window screenshot',
+};
+
+// =============================================================================
+// Word Close
+// =============================================================================
+
+const WORD_CLOSE_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_close',
+    description: `Close the active Word document.
+Optionally save before closing.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Explanation of why you are closing' },
+        save: { type: 'boolean', description: 'Whether to save before closing (default: false)' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executeWordClose(args: Record<string, unknown>): Promise<ToolResult> {
+  const save = args['save'] === true;
+
+  try {
+    const response = await wordClient.wordClose(save);
+    if (response.success) {
+      return { success: true, result: `Document closed${save ? ' (saved)' : ''}` };
+    }
+    return { success: false, error: response.error || 'Failed to close document' };
+  } catch (error) {
+    return { success: false, error: `Failed to close document: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordCloseTool: LLMSimpleTool = {
+  definition: WORD_CLOSE_DEFINITION,
+  execute: executeWordClose,
+  categories: OFFICE_CATEGORIES,
+  description: 'Close Word document',
+};
+
+// =============================================================================
+// Word Quit
+// =============================================================================
+
+const WORD_QUIT_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_quit',
+    description: `Quit Microsoft Word application entirely.
+Optionally save all documents before quitting.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Explanation of why you are quitting Word' },
+        save: { type: 'boolean', description: 'Whether to save all documents before quitting (default: false)' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executeWordQuit(args: Record<string, unknown>): Promise<ToolResult> {
+  const save = args['save'] === true;
+
+  try {
+    const response = await wordClient.wordQuit(save);
+    if (response.success) {
+      return { success: true, result: `Word closed${save ? ' (all documents saved)' : ''}` };
+    }
+    return { success: false, error: response.error || 'Failed to quit Word' };
+  } catch (error) {
+    return { success: false, error: `Failed to quit Word: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordQuitTool: LLMSimpleTool = {
+  definition: WORD_QUIT_DEFINITION,
+  execute: executeWordQuit,
+  categories: OFFICE_CATEGORIES,
+  description: 'Quit Microsoft Word',
+};
+
+// =============================================================================
+// Export Launch Tools
+// =============================================================================
+
+export const launchTools: LLMSimpleTool[] = [
+  wordLaunchTool,
+  wordCreateTool,
+  wordOpenTool,
+  wordSaveTool,
+  wordScreenshotTool,
+  wordCloseTool,
+  wordQuitTool,
+];