orquesta-cli 0.1.12

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

@@ -0,0 +1,294 @@
+/**
+ * Microsoft Word Text Tools
+ *
+ * Text-related tools for Word document manipulation:
+ * - writeText: Write text to the document
+ * - readDocument: Read document content
+ * - findReplace: Find and replace text
+ * - setStyle: Apply style to selection
+ * - getSelectedText: Get selected text
+ * - selectAll: Select all content
+ */
+
+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 Write
+// =============================================================================
+
+const WORD_WRITE_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_write',
+    description: `Write text to the active Word document with font settings.
+The text will be inserted at the current cursor position.
+By default, a new paragraph is created after the text (new_paragraph=true).
+This prevents formatting from bleeding between sections.
+Set new_paragraph=false only when continuing on the same line.
+IMPORTANT: Always specify font_name and font_size for proper formatting.
+Recommended: font_name="Malgun Gothic" or "Arial", font_size=11 for body text, 16-24 for titles.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Explanation of why you are writing this text' },
+        text: { type: 'string', description: 'The text to write to the document' },
+        font_name: { type: 'string', description: 'Font name (e.g., "Arial", "Times New Roman", "Malgun Gothic")' },
+        font_size: { type: 'number', description: 'Font size in points (e.g., 12, 14, 16)' },
+        bold: { type: 'boolean', description: 'Whether to make the text bold' },
+        italic: { type: 'boolean', description: 'Whether to make the text italic' },
+        new_paragraph: { type: 'boolean', description: 'Add paragraph break after text (default: true). Set false to continue on same line.' },
+      },
+      required: ['reason', 'text'],
+    },
+  },
+};
+
+async function executeWordWrite(args: Record<string, unknown>): Promise<ToolResult> {
+  const text = args['text'] as string;
+  const fontName = args['font_name'] as string | undefined;
+  const fontSize = args['font_size'] as number | undefined;
+  const bold = args['bold'] as boolean | undefined;
+  const italic = args['italic'] as boolean | undefined;
+  const newParagraph = args['new_paragraph'] as boolean | undefined;
+
+  try {
+    const response = await wordClient.wordWrite(text, { fontName, fontSize, bold, italic, newParagraph });
+    if (response.success) {
+      return { success: true, result: `Text written to document (${text.length} characters)` };
+    }
+    return { success: false, error: response.error || 'Failed to write text' };
+  } catch (error) {
+    return { success: false, error: `Failed to write text: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordWriteTool: LLMSimpleTool = {
+  definition: WORD_WRITE_DEFINITION,
+  execute: executeWordWrite,
+  categories: OFFICE_CATEGORIES,
+  description: 'Write text to Word document',
+};
+
+// =============================================================================
+// Word Read
+// =============================================================================
+
+const WORD_READ_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_read',
+    description: `Read the content of the active Word document.
+Returns the full text content of the document.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Explanation of why you are reading the document' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executeWordRead(_args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordRead();
+    if (response.success) {
+      const content = response['content'] as string || '';
+      const docName = response['document_name'] as string || 'Unknown';
+      return {
+        success: true,
+        result: `Document: ${docName}\n\nContent:\n${content || '(empty document)'}`,
+      };
+    }
+    return { success: false, error: response.error || 'Failed to read document' };
+  } catch (error) {
+    return { success: false, error: `Failed to read document: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordReadTool: LLMSimpleTool = {
+  definition: WORD_READ_DEFINITION,
+  execute: executeWordRead,
+  categories: OFFICE_CATEGORIES,
+  description: 'Read Word document content',
+};
+
+// =============================================================================
+// Word Find Replace
+// =============================================================================
+
+const WORD_FIND_REPLACE_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_find_replace',
+    description: `Find and replace text in the Word document.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are doing find/replace' },
+        find: { type: 'string', description: 'Text to find' },
+        replace: { type: 'string', description: 'Replacement text' },
+        replace_all: { type: 'boolean', description: 'Replace all occurrences (default: true)' },
+      },
+      required: ['reason', 'find', 'replace'],
+    },
+  },
+};
+
+async function executeWordFindReplace(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordFindReplace(
+      args['find'] as string,
+      args['replace'] as string,
+      args['replace_all'] as boolean ?? true
+    );
+    if (response.success) {
+      return { success: true, result: `Replaced "${args['find']}" with "${args['replace']}"` };
+    }
+    return { success: false, error: response.error || 'Failed to find/replace' };
+  } catch (error) {
+    return { success: false, error: `Failed to find/replace: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordFindReplaceTool: LLMSimpleTool = {
+  definition: WORD_FIND_REPLACE_DEFINITION,
+  execute: executeWordFindReplace,
+  categories: OFFICE_CATEGORIES,
+  description: 'Find and replace in Word',
+};
+
+// =============================================================================
+// Word Set Style
+// =============================================================================
+
+const WORD_SET_STYLE_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_set_style',
+    description: `Apply a style to the current selection. IMPORTANT: Style names depend on Office language. English: "Normal", "Heading 1", "Title". Korean: "표준", "제목 1", "제목".`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are applying a style' },
+        style: { type: 'string', description: 'Style name' },
+      },
+      required: ['reason', 'style'],
+    },
+  },
+};
+
+async function executeWordSetStyle(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordSetStyle(args['style'] as string);
+    if (response.success) {
+      return { success: true, result: `Style "${args['style']}" applied` };
+    }
+    return { success: false, error: response.error || 'Failed to set style' };
+  } catch (error) {
+    return { success: false, error: `Failed to set style: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordSetStyleTool: LLMSimpleTool = {
+  definition: WORD_SET_STYLE_DEFINITION,
+  execute: executeWordSetStyle,
+  categories: OFFICE_CATEGORIES,
+  description: 'Apply Word style',
+};
+
+// =============================================================================
+// Word Get Selected Text
+// =============================================================================
+
+const WORD_GET_SELECTED_TEXT_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_get_selected_text',
+    description: `Get the currently selected text.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you need selected text' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executeWordGetSelectedText(_args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordGetSelectedText();
+    if (response.success) {
+      const text = response['text'] as string || '';
+      if (!text || text.length === 0) {
+        return { success: true, result: 'No text selected' };
+      }
+      return { success: true, result: `Selected text: "${text}"` };
+    }
+    return { success: false, error: response.error || 'Failed to get selected text' };
+  } catch (error) {
+    return { success: false, error: `Failed to get selected text: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordGetSelectedTextTool: LLMSimpleTool = {
+  definition: WORD_GET_SELECTED_TEXT_DEFINITION,
+  execute: executeWordGetSelectedText,
+  categories: OFFICE_CATEGORIES,
+  description: 'Get Word selected text',
+};
+
+// =============================================================================
+// Word Select All
+// =============================================================================
+
+const WORD_SELECT_ALL_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_select_all',
+    description: `Select all content in the document.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are selecting all' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executeWordSelectAll(_args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordSelectAll();
+    if (response.success) {
+      return { success: true, result: 'All content selected' };
+    }
+    return { success: false, error: response.error || 'Failed to select all' };
+  } catch (error) {
+    return { success: false, error: `Failed to select all: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordSelectAllTool: LLMSimpleTool = {
+  definition: WORD_SELECT_ALL_DEFINITION,
+  execute: executeWordSelectAll,
+  categories: OFFICE_CATEGORIES,
+  description: 'Select all in Word',
+};
+
+// =============================================================================
+// Export All Text Tools
+// =============================================================================
+
+export const textTools: LLMSimpleTool[] = [
+  wordWriteTool,
+  wordReadTool,
+  wordFindReplaceTool,
+  wordSetStyleTool,
+  wordGetSelectedTextTool,
+  wordSelectAllTool,
+];

package/src/tools/office/word-tools/undo-redo.ts

@@ -0,0 +1,97 @@
+/**
+ * Word Undo/Redo Tools
+ *
+ * Tools for undoing and redoing actions 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 Undo
+// =============================================================================
+
+const WORD_UNDO_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_undo',
+    description: `Undo the last action(s).`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are undoing' },
+        times: { type: 'number', description: 'Number of times to undo (default: 1)' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executeWordUndo(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordUndo(args['times'] as number ?? 1);
+    if (response.success) {
+      return { success: true, result: response.message || 'Undo performed' };
+    }
+    return { success: false, error: response.error || 'Failed to undo' };
+  } catch (error) {
+    return { success: false, error: `Failed to undo: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordUndoTool: LLMSimpleTool = {
+  definition: WORD_UNDO_DEFINITION,
+  execute: executeWordUndo,
+  categories: OFFICE_CATEGORIES,
+  description: 'Undo Word action',
+};
+
+// =============================================================================
+// Word Redo
+// =============================================================================
+
+const WORD_REDO_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_redo',
+    description: `Redo the last undone action(s).`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are redoing' },
+        times: { type: 'number', description: 'Number of times to redo (default: 1)' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executeWordRedo(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordRedo(args['times'] as number ?? 1);
+    if (response.success) {
+      return { success: true, result: response.message || 'Redo performed' };
+    }
+    return { success: false, error: response.error || 'Failed to redo' };
+  } catch (error) {
+    return { success: false, error: `Failed to redo: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordRedoTool: LLMSimpleTool = {
+  definition: WORD_REDO_DEFINITION,
+  execute: executeWordRedo,
+  categories: OFFICE_CATEGORIES,
+  description: 'Redo Word action',
+};
+
+// =============================================================================
+// Export Undo/Redo Tools
+// =============================================================================
+
+export const undoRedoTools: LLMSimpleTool[] = [
+  wordUndoTool,
+  wordRedoTool,
+];

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

@@ -0,0 +1,105 @@
+/**
+ * Word Watermark Tools
+ *
+ * Tools for managing watermarks 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 Add Watermark
+// =============================================================================
+
+const WORD_ADD_WATERMARK_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_add_watermark',
+    description: `Add a text watermark to the document.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are adding watermark' },
+        text: { type: 'string', description: 'Watermark text' },
+        font_name: { type: 'string', description: 'Font name (default: Arial)' },
+        font_size: { type: 'number', description: 'Font size (default: 72)' },
+        color: { type: 'string', description: 'Color as hex (default: light gray)' },
+        semitransparent: { type: 'boolean', description: 'Make semitransparent (default: true)' },
+      },
+      required: ['reason', 'text'],
+    },
+  },
+};
+
+async function executeWordAddWatermark(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordAddWatermark(args['text'] as string, {
+      fontName: args['font_name'] as string | undefined,
+      fontSize: args['font_size'] as number | undefined,
+      color: args['color'] as string | undefined,
+      semitransparent: args['semitransparent'] as boolean | undefined,
+    });
+    if (response.success) {
+      return { success: true, result: 'Watermark added' };
+    }
+    return { success: false, error: response.error || 'Failed to add watermark' };
+  } catch (error) {
+    return { success: false, error: `Failed to add watermark: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordAddWatermarkTool: LLMSimpleTool = {
+  definition: WORD_ADD_WATERMARK_DEFINITION,
+  execute: executeWordAddWatermark,
+  categories: OFFICE_CATEGORIES,
+  description: 'Add Word watermark',
+};
+
+// =============================================================================
+// Word Remove Watermark
+// =============================================================================
+
+const WORD_REMOVE_WATERMARK_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_remove_watermark',
+    description: `Remove watermark from the document.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are removing watermark' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executeWordRemoveWatermark(_args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordRemoveWatermark();
+    if (response.success) {
+      return { success: true, result: 'Watermark removed' };
+    }
+    return { success: false, error: response.error || 'Failed to remove watermark' };
+  } catch (error) {
+    return { success: false, error: `Failed to remove watermark: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordRemoveWatermarkTool: LLMSimpleTool = {
+  definition: WORD_REMOVE_WATERMARK_DEFINITION,
+  execute: executeWordRemoveWatermark,
+  categories: OFFICE_CATEGORIES,
+  description: 'Remove Word watermark',
+};
+
+// =============================================================================
+// Export Watermarks Tools
+// =============================================================================
+
+export const watermarksTools: LLMSimpleTool[] = [
+  wordAddWatermarkTool,
+  wordRemoveWatermarkTool,
+];

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

@@ -0,0 +1,9 @@
+/**
+ * Microsoft Word Tools
+ *
+ * This file re-exports from the modularized word-tools directory.
+ * Maintaining backwards compatibility with existing imports.
+ */
+
+export * from './word-tools/index.js';
+export { WORD_TOOLS } from './word-tools/index.js';