orquesta-cli 0.1.12 → 0.1.14

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

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

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

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

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