orquesta-cli 0.1.2

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

@@ -0,0 +1,186 @@
+/**
+ * Word Bookmark Tools
+ *
+ * Bookmark-related tools for Microsoft Word
+ * - addBookmark, getBookmarks, deleteBookmark, gotoBookmark
+ */
+
+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 Add Bookmark
+// =============================================================================
+
+const WORD_ADD_BOOKMARK_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_add_bookmark',
+    description: `Add a bookmark at the current selection or with specified text.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are adding a bookmark' },
+        name: { type: 'string', description: 'Bookmark name (no spaces)' },
+        text: { type: 'string', description: 'Optional text to mark (will be selected)' },
+      },
+      required: ['reason', 'name'],
+    },
+  },
+};
+
+async function executeWordAddBookmark(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordAddBookmark(
+      args['name'] as string,
+      args['text'] as string | undefined
+    );
+    if (response.success) {
+      return { success: true, result: `Bookmark "${args['name']}" added` };
+    }
+    return { success: false, error: response.error || 'Failed to add bookmark' };
+  } catch (error) {
+    return { success: false, error: `Failed to add bookmark: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordAddBookmarkTool: LLMSimpleTool = {
+  definition: WORD_ADD_BOOKMARK_DEFINITION,
+  execute: executeWordAddBookmark,
+  categories: OFFICE_CATEGORIES,
+  description: 'Add Word bookmark',
+};
+
+// =============================================================================
+// Word Get Bookmarks
+// =============================================================================
+
+const WORD_GET_BOOKMARKS_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_get_bookmarks',
+    description: `Get all bookmarks in the document.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you need bookmark list' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executeWordGetBookmarks(_args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordGetBookmarks();
+    if (response.success) {
+      const bookmarks = response['bookmarks'] as Array<{ name: string; text: string }> || [];
+      if (bookmarks.length === 0) {
+        return { success: true, result: 'No bookmarks found' };
+      }
+      const list = bookmarks.map(b => `- ${b.name}: "${b.text}"`).join('\n');
+      return { success: true, result: `Bookmarks:\n${list}` };
+    }
+    return { success: false, error: response.error || 'Failed to get bookmarks' };
+  } catch (error) {
+    return { success: false, error: `Failed to get bookmarks: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordGetBookmarksTool: LLMSimpleTool = {
+  definition: WORD_GET_BOOKMARKS_DEFINITION,
+  execute: executeWordGetBookmarks,
+  categories: OFFICE_CATEGORIES,
+  description: 'Get Word bookmarks',
+};
+
+// =============================================================================
+// Word Delete Bookmark
+// =============================================================================
+
+const WORD_DELETE_BOOKMARK_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_delete_bookmark',
+    description: `Delete a bookmark from the document.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are deleting the bookmark' },
+        name: { type: 'string', description: 'Bookmark name to delete' },
+      },
+      required: ['reason', 'name'],
+    },
+  },
+};
+
+async function executeWordDeleteBookmark(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordDeleteBookmark(args['name'] as string);
+    if (response.success) {
+      return { success: true, result: `Bookmark "${args['name']}" deleted` };
+    }
+    return { success: false, error: response.error || 'Failed to delete bookmark' };
+  } catch (error) {
+    return { success: false, error: `Failed to delete bookmark: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordDeleteBookmarkTool: LLMSimpleTool = {
+  definition: WORD_DELETE_BOOKMARK_DEFINITION,
+  execute: executeWordDeleteBookmark,
+  categories: OFFICE_CATEGORIES,
+  description: 'Delete Word bookmark',
+};
+
+// =============================================================================
+// Word Goto Bookmark
+// =============================================================================
+
+const WORD_GOTO_BOOKMARK_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_goto_bookmark',
+    description: `Navigate to a bookmark in the document.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are navigating to bookmark' },
+        name: { type: 'string', description: 'Bookmark name' },
+      },
+      required: ['reason', 'name'],
+    },
+  },
+};
+
+async function executeWordGotoBookmark(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordGotoBookmark(args['name'] as string);
+    if (response.success) {
+      return { success: true, result: `Moved to bookmark "${args['name']}"` };
+    }
+    return { success: false, error: response.error || 'Failed to goto bookmark' };
+  } catch (error) {
+    return { success: false, error: `Failed to goto bookmark: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordGotoBookmarkTool: LLMSimpleTool = {
+  definition: WORD_GOTO_BOOKMARK_DEFINITION,
+  execute: executeWordGotoBookmark,
+  categories: OFFICE_CATEGORIES,
+  description: 'Goto Word bookmark',
+};
+
+// =============================================================================
+// Export All Bookmark Tools
+// =============================================================================
+
+export const bookmarksTools: LLMSimpleTool[] = [
+  wordAddBookmarkTool,
+  wordGetBookmarksTool,
+  wordDeleteBookmarkTool,
+  wordGotoBookmarkTool,
+];

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

@@ -0,0 +1,185 @@
+/**
+ * Word Comments Tools
+ *
+ * Tools for managing comments 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 Comment
+// =============================================================================
+
+const WORD_ADD_COMMENT_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_add_comment',
+    description: `Add a comment to the current selection.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are adding a comment' },
+        text: { type: 'string', description: 'Comment text' },
+        author: { type: 'string', description: 'Author name (optional)' },
+      },
+      required: ['reason', 'text'],
+    },
+  },
+};
+
+async function executeWordAddComment(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordAddComment(
+      args['text'] as string,
+      args['author'] as string | undefined
+    );
+    if (response.success) {
+      return { success: true, result: 'Comment added' };
+    }
+    return { success: false, error: response.error || 'Failed to add comment' };
+  } catch (error) {
+    return { success: false, error: `Failed to add comment: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordAddCommentTool: LLMSimpleTool = {
+  definition: WORD_ADD_COMMENT_DEFINITION,
+  execute: executeWordAddComment,
+  categories: OFFICE_CATEGORIES,
+  description: 'Add Word comment',
+};
+
+// =============================================================================
+// Word Get Comments
+// =============================================================================
+
+const WORD_GET_COMMENTS_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_get_comments',
+    description: `Get all comments in the document.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you need comments' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executeWordGetComments(_args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordGetComments();
+    if (response.success) {
+      const comments = response['comments'] as Array<{ index: number; author: string; text: string; scope: string }> || [];
+      const count = response['count'] as number || 0;
+      if (count === 0) {
+        return { success: true, result: 'No comments found' };
+      }
+      const list = comments.map(c => `[${c.index}] ${c.author}: "${c.text}" (on: "${c.scope?.slice(0, 30)}...")`).join('\n');
+      return { success: true, result: `${count} comments:\n${list}` };
+    }
+    return { success: false, error: response.error || 'Failed to get comments' };
+  } catch (error) {
+    return { success: false, error: `Failed to get comments: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordGetCommentsTool: LLMSimpleTool = {
+  definition: WORD_GET_COMMENTS_DEFINITION,
+  execute: executeWordGetComments,
+  categories: OFFICE_CATEGORIES,
+  description: 'Get Word comments',
+};
+
+// =============================================================================
+// Word Delete Comment
+// =============================================================================
+
+const WORD_DELETE_COMMENT_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_delete_comment',
+    description: `Delete a comment by index.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are deleting comment' },
+        index: { type: 'number', description: 'Comment index (1-based)' },
+      },
+      required: ['reason', 'index'],
+    },
+  },
+};
+
+async function executeWordDeleteComment(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordDeleteComment(args['index'] as number);
+    if (response.success) {
+      return { success: true, result: `Comment ${args['index']} deleted` };
+    }
+    return { success: false, error: response.error || 'Failed to delete comment' };
+  } catch (error) {
+    return { success: false, error: `Failed to delete comment: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordDeleteCommentTool: LLMSimpleTool = {
+  definition: WORD_DELETE_COMMENT_DEFINITION,
+  execute: executeWordDeleteComment,
+  categories: OFFICE_CATEGORIES,
+  description: 'Delete Word comment',
+};
+
+// =============================================================================
+// Word Delete All Comments
+// =============================================================================
+
+const WORD_DELETE_ALL_COMMENTS_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_delete_all_comments',
+    description: `Delete all comments in the document.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are deleting all comments' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executeWordDeleteAllComments(_args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordDeleteAllComments();
+    if (response.success) {
+      return { success: true, result: response.message || 'All comments deleted' };
+    }
+    return { success: false, error: response.error || 'Failed to delete comments' };
+  } catch (error) {
+    return { success: false, error: `Failed to delete comments: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordDeleteAllCommentsTool: LLMSimpleTool = {
+  definition: WORD_DELETE_ALL_COMMENTS_DEFINITION,
+  execute: executeWordDeleteAllComments,
+  categories: OFFICE_CATEGORIES,
+  description: 'Delete all Word comments',
+};
+
+// =============================================================================
+// Export All Comment Tools
+// =============================================================================
+
+export const commentsTools: LLMSimpleTool[] = [
+  wordAddCommentTool,
+  wordGetCommentsTool,
+  wordDeleteCommentTool,
+  wordDeleteAllCommentsTool,
+];

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

@@ -0,0 +1,229 @@
+/**
+ * Word Content Tools
+ *
+ * Tools for adding content elements to Word documents:
+ * - Images
+ * - Hyperlinks
+ * - Textboxes
+ * - Shapes
+ */
+
+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 Image
+// =============================================================================
+
+const WORD_ADD_IMAGE_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_add_image',
+    description: `Add an image to the Word document. WSL paths are automatically converted to Windows paths.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are adding an image' },
+        path: { type: 'string', description: 'Image file path. Can use Linux/WSL paths or Windows paths.' },
+        width: { type: 'number', description: 'Image width in points (optional)' },
+        height: { type: 'number', description: 'Image height in points (optional)' },
+      },
+      required: ['reason', 'path'],
+    },
+  },
+};
+
+async function executeWordAddImage(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordAddImage(
+      args['path'] as string,
+      args['width'] as number | undefined,
+      args['height'] as number | undefined
+    );
+    if (response.success) {
+      return { success: true, result: 'Image added' };
+    }
+    return { success: false, error: response.error || 'Failed to add image' };
+  } catch (error) {
+    return { success: false, error: `Failed to add image: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordAddImageTool: LLMSimpleTool = {
+  definition: WORD_ADD_IMAGE_DEFINITION,
+  execute: executeWordAddImage,
+  categories: OFFICE_CATEGORIES,
+  description: 'Add Word image',
+};
+
+// =============================================================================
+// Word Add Hyperlink
+// =============================================================================
+
+const WORD_ADD_HYPERLINK_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_add_hyperlink',
+    description: `Add a hyperlink to the Word document.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are adding a hyperlink' },
+        text: { type: 'string', description: 'Display text' },
+        url: { type: 'string', description: 'URL to link to' },
+      },
+      required: ['reason', 'text', 'url'],
+    },
+  },
+};
+
+async function executeWordAddHyperlink(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordAddHyperlink(
+      args['text'] as string,
+      args['url'] as string
+    );
+    if (response.success) {
+      return { success: true, result: `Hyperlink added: ${args['text']}` };
+    }
+    return { success: false, error: response.error || 'Failed to add hyperlink' };
+  } catch (error) {
+    return { success: false, error: `Failed to add hyperlink: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordAddHyperlinkTool: LLMSimpleTool = {
+  definition: WORD_ADD_HYPERLINK_DEFINITION,
+  execute: executeWordAddHyperlink,
+  categories: OFFICE_CATEGORIES,
+  description: 'Add Word hyperlink',
+};
+
+// =============================================================================
+// Word Add Textbox
+// =============================================================================
+
+const WORD_ADD_TEXTBOX_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_add_textbox',
+    description: `Add a textbox to the document.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are adding textbox' },
+        text: { type: 'string', description: 'Textbox content' },
+        left: { type: 'number', description: 'Left position in points' },
+        top: { type: 'number', description: 'Top position in points' },
+        width: { type: 'number', description: 'Width in points' },
+        height: { type: 'number', description: 'Height in points' },
+        font_name: { type: 'string', description: 'Font name' },
+        font_size: { type: 'number', description: 'Font size' },
+        border_color: { type: 'string', description: 'Border color as hex' },
+        fill_color: { type: 'string', description: 'Fill color as hex' },
+      },
+      required: ['reason', 'text', 'left', 'top', 'width', 'height'],
+    },
+  },
+};
+
+async function executeWordAddTextbox(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordAddTextbox(
+      args['text'] as string,
+      args['left'] as number,
+      args['top'] as number,
+      args['width'] as number,
+      args['height'] as number,
+      {
+        fontName: args['font_name'] as string | undefined,
+        fontSize: args['font_size'] as number | undefined,
+        borderColor: args['border_color'] as string | undefined,
+        fillColor: args['fill_color'] as string | undefined,
+      }
+    );
+    if (response.success) {
+      return { success: true, result: `Textbox added: ${response['shape_name']}` };
+    }
+    return { success: false, error: response.error || 'Failed to add textbox' };
+  } catch (error) {
+    return { success: false, error: `Failed to add textbox: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordAddTextboxTool: LLMSimpleTool = {
+  definition: WORD_ADD_TEXTBOX_DEFINITION,
+  execute: executeWordAddTextbox,
+  categories: OFFICE_CATEGORIES,
+  description: 'Add Word textbox',
+};
+
+// =============================================================================
+// Word Add Shape
+// =============================================================================
+
+const WORD_ADD_SHAPE_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_add_shape',
+    description: `Add a shape to the document.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are adding shape' },
+        shape_type: { type: 'string', enum: ['rectangle', 'oval', 'roundedRectangle', 'triangle', 'diamond', 'arrow', 'line'], description: 'Shape type' },
+        left: { type: 'number', description: 'Left position in points' },
+        top: { type: 'number', description: 'Top position in points' },
+        width: { type: 'number', description: 'Width in points' },
+        height: { type: 'number', description: 'Height in points' },
+        fill_color: { type: 'string', description: 'Fill color as hex' },
+        line_color: { type: 'string', description: 'Line color as hex' },
+        line_weight: { type: 'number', description: 'Line weight in points' },
+      },
+      required: ['reason', 'shape_type', 'left', 'top', 'width', 'height'],
+    },
+  },
+};
+
+async function executeWordAddShape(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordAddShape(
+      args['shape_type'] as 'rectangle' | 'oval' | 'roundedRectangle' | 'triangle' | 'diamond' | 'arrow' | 'line',
+      args['left'] as number,
+      args['top'] as number,
+      args['width'] as number,
+      args['height'] as number,
+      {
+        fillColor: args['fill_color'] as string | undefined,
+        lineColor: args['line_color'] as string | undefined,
+        lineWeight: args['line_weight'] as number | undefined,
+      }
+    );
+    if (response.success) {
+      return { success: true, result: `Shape added: ${response['shape_name']}` };
+    }
+    return { success: false, error: response.error || 'Failed to add shape' };
+  } catch (error) {
+    return { success: false, error: `Failed to add shape: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordAddShapeTool: LLMSimpleTool = {
+  definition: WORD_ADD_SHAPE_DEFINITION,
+  execute: executeWordAddShape,
+  categories: OFFICE_CATEGORIES,
+  description: 'Add Word shape',
+};
+
+// =============================================================================
+// Export Content Tools
+// =============================================================================
+
+export const contentTools: LLMSimpleTool[] = [
+  wordAddImageTool,
+  wordAddHyperlinkTool,
+  wordAddTextboxTool,
+  wordAddShapeTool,
+];

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

@@ -0,0 +1,97 @@
+/**
+ * Word Export Tools
+ *
+ * Export-related tools for Microsoft Word (PDF export, Print)
+ */
+
+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 Export to PDF
+// =============================================================================
+
+const WORD_EXPORT_PDF_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_export_pdf',
+    description: `Export the document to PDF. WSL paths are automatically converted to Windows paths.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are exporting to PDF' },
+        path: { type: 'string', description: 'Output PDF file path. Can use Linux/WSL paths or Windows paths.' },
+      },
+      required: ['reason', 'path'],
+    },
+  },
+};
+
+async function executeWordExportPDF(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordExportToPDF(args['path'] as string);
+    if (response.success) {
+      return { success: true, result: `Exported to PDF: ${response['path'] || args['path']}` };
+    }
+    return { success: false, error: response.error || 'Failed to export to PDF' };
+  } catch (error) {
+    return { success: false, error: `Failed to export to PDF: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordExportPDFTool: LLMSimpleTool = {
+  definition: WORD_EXPORT_PDF_DEFINITION,
+  execute: executeWordExportPDF,
+  categories: OFFICE_CATEGORIES,
+  description: 'Export Word to PDF',
+};
+
+// =============================================================================
+// Word Print
+// =============================================================================
+
+const WORD_PRINT_DEFINITION: ToolDefinition = {
+  type: 'function',
+  function: {
+    name: 'word_print',
+    description: `Print the document.`,
+    parameters: {
+      type: 'object',
+      properties: {
+        reason: { type: 'string', description: 'Why you are printing' },
+        copies: { type: 'number', description: 'Number of copies (default: 1)' },
+      },
+      required: ['reason'],
+    },
+  },
+};
+
+async function executeWordPrint(args: Record<string, unknown>): Promise<ToolResult> {
+  try {
+    const response = await wordClient.wordPrint(args['copies'] as number ?? 1);
+    if (response.success) {
+      return { success: true, result: `Print job sent (${args['copies'] ?? 1} copies)` };
+    }
+    return { success: false, error: response.error || 'Failed to print' };
+  } catch (error) {
+    return { success: false, error: `Failed to print: ${error instanceof Error ? error.message : String(error)}` };
+  }
+}
+
+export const wordPrintTool: LLMSimpleTool = {
+  definition: WORD_PRINT_DEFINITION,
+  execute: executeWordPrint,
+  categories: OFFICE_CATEGORIES,
+  description: 'Print Word document',
+};
+
+// =============================================================================
+// Export Tools Array
+// =============================================================================
+
+export const exportTools: LLMSimpleTool[] = [
+  wordExportPDFTool,
+  wordPrintTool,
+];