orquesta-cli 0.1.13 → 0.1.14

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

@@ -1,303 +0,0 @@
-/**
- * Excel Launch Tools
- *
- * Tools for launching, creating, opening, closing, and quitting Excel
- * Also includes screenshot functionality
- */
-
-import { ToolDefinition } from '../../../types/index.js';
-import { LLMSimpleTool, ToolResult } from '../../types.js';
-import { excelClient } from '../excel-client.js';
-import { saveScreenshot } from '../common/utils.js';
-import { OFFICE_SCREENSHOT_PATH_DESC, OFFICE_CATEGORIES } from '../common/constants.js';
-
-// =============================================================================
-// Excel Launch
-// =============================================================================
-
-const EXCEL_LAUNCH_DEFINITION: ToolDefinition = {
-  type: 'function',
-  function: {
-    name: 'excel_launch',
-    description: `Launch Microsoft Excel for spreadsheet editing.
-Use this tool to start Excel before working with spreadsheets.
-The Excel 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 Excel' },
-      },
-      required: ['reason'],
-    },
-  },
-};
-
-async function executeExcelLaunch(_args: Record<string, unknown>): Promise<ToolResult> {
-  try {
-    const response = await excelClient.excelLaunch();
-    if (response.success) {
-      return { success: true, result: response.message || 'Excel launched successfully' };
-    }
-    return { success: false, error: response.error || 'Failed to launch Excel' };
-  } catch (error) {
-    return { success: false, error: `Failed to launch Excel: ${error instanceof Error ? error.message : String(error)}` };
-  }
-}
-
-export const excelLaunchTool: LLMSimpleTool = {
-  definition: EXCEL_LAUNCH_DEFINITION,
-  execute: executeExcelLaunch,
-  categories: OFFICE_CATEGORIES,
-  description: 'Launch Microsoft Excel',
-};
-
-// =============================================================================
-// Excel Create
-// =============================================================================
-
-const EXCEL_CREATE_DEFINITION: ToolDefinition = {
-  type: 'function',
-  function: {
-    name: 'excel_create',
-    description: `Create a new Excel workbook.`,
-    parameters: {
-      type: 'object',
-      properties: {
-        reason: { type: 'string', description: 'Why you are creating a workbook' },
-      },
-      required: ['reason'],
-    },
-  },
-};
-
-async function executeExcelCreate(_args: Record<string, unknown>): Promise<ToolResult> {
-  try {
-    const response = await excelClient.excelCreate();
-    if (response.success) {
-      return { success: true, result: response.message || 'New workbook created' };
-    }
-    return { success: false, error: response.error || 'Failed to create workbook' };
-  } catch (error) {
-    return { success: false, error: `Failed to create workbook: ${error instanceof Error ? error.message : String(error)}` };
-  }
-}
-
-export const excelCreateTool: LLMSimpleTool = {
-  definition: EXCEL_CREATE_DEFINITION,
-  execute: executeExcelCreate,
-  categories: OFFICE_CATEGORIES,
-  description: 'Create new Excel workbook',
-};
-
-// =============================================================================
-// Excel Open
-// =============================================================================
-
-const EXCEL_OPEN_DEFINITION: ToolDefinition = {
-  type: 'function',
-  function: {
-    name: 'excel_open',
-    description: `Open an existing Excel workbook. WSL paths are automatically converted to Windows paths.`,
-    parameters: {
-      type: 'object',
-      properties: {
-        reason: { type: 'string', description: 'Why you are opening this workbook' },
-        path: { type: 'string', description: 'File path to open. Can use Linux/WSL paths or Windows paths.' },
-      },
-      required: ['reason', 'path'],
-    },
-  },
-};
-
-async function executeExcelOpen(args: Record<string, unknown>): Promise<ToolResult> {
-  try {
-    const response = await excelClient.excelOpen(args['path'] as string);
-    if (response.success) {
-      return { success: true, result: `Workbook opened: ${response['workbook_name'] || args['path']}` };
-    }
-    return { success: false, error: response.error || 'Failed to open workbook' };
-  } catch (error) {
-    return { success: false, error: `Failed to open workbook: ${error instanceof Error ? error.message : String(error)}` };
-  }
-}
-
-export const excelOpenTool: LLMSimpleTool = {
-  definition: EXCEL_OPEN_DEFINITION,
-  execute: executeExcelOpen,
-  categories: OFFICE_CATEGORIES,
-  description: 'Open existing Excel workbook',
-};
-
-// =============================================================================
-// Excel Save
-// =============================================================================
-
-const EXCEL_SAVE_DEFINITION: ToolDefinition = {
-  type: 'function',
-  function: {
-    name: 'excel_save',
-    description: `Save the active Excel workbook. 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)' },
-      },
-      required: ['reason'],
-    },
-  },
-};
-
-async function executeExcelSave(args: Record<string, unknown>): Promise<ToolResult> {
-  try {
-    const response = await excelClient.excelSave(args['path'] as string | undefined);
-    if (response.success) {
-      return { success: true, result: `Workbook saved: ${response['path'] || 'current location'}` };
-    }
-    return { success: false, error: response.error || 'Failed to save workbook' };
-  } catch (error) {
-    return { success: false, error: `Failed to save workbook: ${error instanceof Error ? error.message : String(error)}` };
-  }
-}
-
-export const excelSaveTool: LLMSimpleTool = {
-  definition: EXCEL_SAVE_DEFINITION,
-  execute: executeExcelSave,
-  categories: OFFICE_CATEGORIES,
-  description: 'Save Excel workbook',
-};
-
-// =============================================================================
-// Excel Screenshot
-// =============================================================================
-
-const EXCEL_SCREENSHOT_DEFINITION: ToolDefinition = {
-  type: 'function',
-  function: {
-    name: 'excel_screenshot',
-    description: `Take a screenshot of the current Excel worksheet.
-Captures the used range and saves to ${OFFICE_SCREENSHOT_PATH_DESC}.`,
-    parameters: {
-      type: 'object',
-      properties: {
-        reason: { type: 'string', description: 'Explanation of why you are taking a screenshot' },
-      },
-      required: ['reason'],
-    },
-  },
-};
-
-async function executeExcelScreenshot(_args: Record<string, unknown>): Promise<ToolResult> {
-  try {
-    const response = await excelClient.excelScreenshot();
-    if (response.success && response.image) {
-      const filePath = await saveScreenshot(response.image, 'excel');
-      return {
-        success: true,
-        result: `Excel screenshot saved to: ${filePath}`,
-      };
-    }
-    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 excelScreenshotTool: LLMSimpleTool = {
-  definition: EXCEL_SCREENSHOT_DEFINITION,
-  execute: executeExcelScreenshot,
-  categories: OFFICE_CATEGORIES,
-  description: 'Take Excel window screenshot',
-};
-
-// =============================================================================
-// Excel Close
-// =============================================================================
-
-const EXCEL_CLOSE_DEFINITION: ToolDefinition = {
-  type: 'function',
-  function: {
-    name: 'excel_close',
-    description: `Close the active Excel workbook.`,
-    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 executeExcelClose(args: Record<string, unknown>): Promise<ToolResult> {
-  try {
-    const response = await excelClient.excelClose(args['save'] === true);
-    if (response.success) {
-      return { success: true, result: `Workbook closed${args['save'] ? ' (saved)' : ''}` };
-    }
-    return { success: false, error: response.error || 'Failed to close workbook' };
-  } catch (error) {
-    return { success: false, error: `Failed to close workbook: ${error instanceof Error ? error.message : String(error)}` };
-  }
-}
-
-export const excelCloseTool: LLMSimpleTool = {
-  definition: EXCEL_CLOSE_DEFINITION,
-  execute: executeExcelClose,
-  categories: OFFICE_CATEGORIES,
-  description: 'Close Excel workbook',
-};
-
-// =============================================================================
-// Excel Quit
-// =============================================================================
-
-const EXCEL_QUIT_DEFINITION: ToolDefinition = {
-  type: 'function',
-  function: {
-    name: 'excel_quit',
-    description: `Quit Microsoft Excel application entirely.`,
-    parameters: {
-      type: 'object',
-      properties: {
-        reason: { type: 'string', description: 'Explanation of why you are quitting Excel' },
-        save: { type: 'boolean', description: 'Whether to save all workbooks before quitting (default: false)' },
-      },
-      required: ['reason'],
-    },
-  },
-};
-
-async function executeExcelQuit(args: Record<string, unknown>): Promise<ToolResult> {
-  try {
-    const response = await excelClient.excelQuit(args['save'] === true);
-    if (response.success) {
-      return { success: true, result: `Excel closed${args['save'] ? ' (all workbooks saved)' : ''}` };
-    }
-    return { success: false, error: response.error || 'Failed to quit Excel' };
-  } catch (error) {
-    return { success: false, error: `Failed to quit Excel: ${error instanceof Error ? error.message : String(error)}` };
-  }
-}
-
-export const excelQuitTool: LLMSimpleTool = {
-  definition: EXCEL_QUIT_DEFINITION,
-  execute: executeExcelQuit,
-  categories: OFFICE_CATEGORIES,
-  description: 'Quit Microsoft Excel',
-};
-
-// =============================================================================
-// Export All Launch Tools
-// =============================================================================
-
-export const launchTools: LLMSimpleTool[] = [
-  excelLaunchTool,
-  excelCreateTool,
-  excelOpenTool,
-  excelSaveTool,
-  excelScreenshotTool,
-  excelCloseTool,
-  excelQuitTool,
-];

package/src/tools/office/excel-tools/media.ts

@@ -1,117 +0,0 @@
-/**
- * Excel Media Tools
- *
- * Tools for adding images and hyperlinks to Excel worksheets
- */
-
-import { ToolDefinition } from '../../../types/index.js';
-import { LLMSimpleTool, ToolResult } from '../../types.js';
-import { excelClient } from '../excel-client.js';
-import { OFFICE_CATEGORIES } from '../common/constants.js';
-
-// =============================================================================
-// Excel Add Image
-// =============================================================================
-
-const EXCEL_ADD_IMAGE_DEFINITION: ToolDefinition = {
-  type: 'function',
-  function: {
-    name: 'excel_add_image',
-    description: `Add an image to the worksheet. WSL paths are automatically converted.`,
-    parameters: {
-      type: 'object',
-      properties: {
-        reason: { type: 'string', description: 'Why you are adding image' },
-        image_path: { type: 'string', description: 'Image file path' },
-        cell: { type: 'string', description: 'Cell to position image (e.g., "A1")' },
-        width: { type: 'number', description: 'Image width (optional)' },
-        height: { type: 'number', description: 'Image height (optional)' },
-        sheet: { type: 'string', description: 'Sheet name (optional)' },
-      },
-      required: ['reason', 'image_path', 'cell'],
-    },
-  },
-};
-
-async function executeExcelAddImage(args: Record<string, unknown>): Promise<ToolResult> {
-  try {
-    const response = await excelClient.excelAddImage(
-      args['image_path'] as string,
-      args['cell'] as string,
-      {
-        width: args['width'] as number | undefined,
-        height: args['height'] as number | undefined,
-        sheet: args['sheet'] as string | undefined,
-      }
-    );
-    if (response.success) {
-      return { success: true, result: `Image added at ${args['cell']}` };
-    }
-    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 excelAddImageTool: LLMSimpleTool = {
-  definition: EXCEL_ADD_IMAGE_DEFINITION,
-  execute: executeExcelAddImage,
-  categories: OFFICE_CATEGORIES,
-  description: 'Add Excel image',
-};
-
-// =============================================================================
-// Excel Add Hyperlink
-// =============================================================================
-
-const EXCEL_ADD_HYPERLINK_DEFINITION: ToolDefinition = {
-  type: 'function',
-  function: {
-    name: 'excel_add_hyperlink',
-    description: `Add a hyperlink to a cell.`,
-    parameters: {
-      type: 'object',
-      properties: {
-        reason: { type: 'string', description: 'Why you are adding hyperlink' },
-        cell: { type: 'string', description: 'Cell address (e.g., "A1")' },
-        url: { type: 'string', description: 'URL to link to' },
-        display_text: { type: 'string', description: 'Display text (optional, defaults to URL)' },
-        sheet: { type: 'string', description: 'Sheet name (optional)' },
-      },
-      required: ['reason', 'cell', 'url'],
-    },
-  },
-};
-
-async function executeExcelAddHyperlink(args: Record<string, unknown>): Promise<ToolResult> {
-  try {
-    const response = await excelClient.excelAddHyperlink(
-      args['cell'] as string,
-      args['url'] as string,
-      args['display_text'] as string | undefined,
-      args['sheet'] as string | undefined
-    );
-    if (response.success) {
-      return { success: true, result: `Hyperlink added to ${args['cell']}` };
-    }
-    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 excelAddHyperlinkTool: LLMSimpleTool = {
-  definition: EXCEL_ADD_HYPERLINK_DEFINITION,
-  execute: executeExcelAddHyperlink,
-  categories: OFFICE_CATEGORIES,
-  description: 'Add Excel hyperlink',
-};
-
-// =============================================================================
-// Export all media tools
-// =============================================================================
-
-export const mediaTools: LLMSimpleTool[] = [
-  excelAddImageTool,
-  excelAddHyperlinkTool,
-];

package/src/tools/office/excel-tools/named-ranges.ts

@@ -1,148 +0,0 @@
-/**
- * Excel Named Ranges Tools
- *
- * Named range management tools for Excel.
- * Tools: createNamedRange, getNamedRanges, deleteNamedRange
- */
-
-import { ToolDefinition } from '../../../types/index.js';
-import { LLMSimpleTool, ToolResult } from '../../types.js';
-import { excelClient } from '../excel-client.js';
-import { OFFICE_CATEGORIES } from '../common/index.js';
-
-// =============================================================================
-// Excel Create Named Range
-// =============================================================================
-
-const EXCEL_CREATE_NAMED_RANGE_DEFINITION: ToolDefinition = {
-  type: 'function',
-  function: {
-    name: 'excel_create_named_range',
-    description: `Create a named range.`,
-    parameters: {
-      type: 'object',
-      properties: {
-        reason: { type: 'string', description: 'Why you are creating named range' },
-        name: { type: 'string', description: 'Name for the range' },
-        range: { type: 'string', description: 'Range address (e.g., "A1:B10")' },
-        sheet: { type: 'string', description: 'Sheet name (optional)' },
-      },
-      required: ['reason', 'name', 'range'],
-    },
-  },
-};
-
-async function executeExcelCreateNamedRange(args: Record<string, unknown>): Promise<ToolResult> {
-  try {
-    const response = await excelClient.excelCreateNamedRange(
-      args['name'] as string,
-      args['range'] as string,
-      args['sheet'] as string | undefined
-    );
-    if (response.success) {
-      return { success: true, result: `Named range "${args['name']}" created` };
-    }
-    return { success: false, error: response.error || 'Failed to create named range' };
-  } catch (error) {
-    return { success: false, error: `Failed to create named range: ${error instanceof Error ? error.message : String(error)}` };
-  }
-}
-
-export const excelCreateNamedRangeTool: LLMSimpleTool = {
-  definition: EXCEL_CREATE_NAMED_RANGE_DEFINITION,
-  execute: executeExcelCreateNamedRange,
-  categories: OFFICE_CATEGORIES,
-  description: 'Create Excel named range',
-};
-
-// =============================================================================
-// Excel Get Named Ranges
-// =============================================================================
-
-const EXCEL_GET_NAMED_RANGES_DEFINITION: ToolDefinition = {
-  type: 'function',
-  function: {
-    name: 'excel_get_named_ranges',
-    description: `Get all named ranges in the workbook.`,
-    parameters: {
-      type: 'object',
-      properties: {
-        reason: { type: 'string', description: 'Why you need named ranges' },
-      },
-      required: ['reason'],
-    },
-  },
-};
-
-async function executeExcelGetNamedRanges(_args: Record<string, unknown>): Promise<ToolResult> {
-  try {
-    const response = await excelClient.excelGetNamedRanges();
-    if (response.success) {
-      const ranges = response['named_ranges'] as Array<{ name: string; refersTo: string }> || [];
-      if (ranges.length === 0) {
-        return { success: true, result: 'No named ranges found' };
-      }
-      const list = ranges.map(r => `- ${r.name}: ${r.refersTo}`).join('\n');
-      return { success: true, result: `Named ranges:\n${list}` };
-    }
-    return { success: false, error: response.error || 'Failed to get named ranges' };
-  } catch (error) {
-    return { success: false, error: `Failed to get named ranges: ${error instanceof Error ? error.message : String(error)}` };
-  }
-}
-
-export const excelGetNamedRangesTool: LLMSimpleTool = {
-  definition: EXCEL_GET_NAMED_RANGES_DEFINITION,
-  execute: executeExcelGetNamedRanges,
-  categories: OFFICE_CATEGORIES,
-  description: 'Get Excel named ranges',
-};
-
-// =============================================================================
-// Excel Delete Named Range
-// =============================================================================
-
-const EXCEL_DELETE_NAMED_RANGE_DEFINITION: ToolDefinition = {
-  type: 'function',
-  function: {
-    name: 'excel_delete_named_range',
-    description: `Delete a named range.`,
-    parameters: {
-      type: 'object',
-      properties: {
-        reason: { type: 'string', description: 'Why you are deleting named range' },
-        name: { type: 'string', description: 'Name of the range to delete' },
-      },
-      required: ['reason', 'name'],
-    },
-  },
-};
-
-async function executeExcelDeleteNamedRange(args: Record<string, unknown>): Promise<ToolResult> {
-  try {
-    const response = await excelClient.excelDeleteNamedRange(args['name'] as string);
-    if (response.success) {
-      return { success: true, result: `Named range "${args['name']}" deleted` };
-    }
-    return { success: false, error: response.error || 'Failed to delete named range' };
-  } catch (error) {
-    return { success: false, error: `Failed to delete named range: ${error instanceof Error ? error.message : String(error)}` };
-  }
-}
-
-export const excelDeleteNamedRangeTool: LLMSimpleTool = {
-  definition: EXCEL_DELETE_NAMED_RANGE_DEFINITION,
-  execute: executeExcelDeleteNamedRange,
-  categories: OFFICE_CATEGORIES,
-  description: 'Delete Excel named range',
-};
-
-// =============================================================================
-// Export: Named Ranges Tools Array
-// =============================================================================
-
-export const namedRangesTools: LLMSimpleTool[] = [
-  excelCreateNamedRangeTool,
-  excelGetNamedRangesTool,
-  excelDeleteNamedRangeTool,
-];

package/src/tools/office/excel-tools/protection.ts

@@ -1,105 +0,0 @@
-/**
- * Excel Protection Tools
- *
- * Tools for protecting and unprotecting Excel worksheets
- */
-
-import { ToolDefinition } from '../../../types/index.js';
-import { LLMSimpleTool, ToolResult } from '../../types.js';
-import { excelClient } from '../excel-client.js';
-import { OFFICE_CATEGORIES } from '../common/constants.js';
-
-// =============================================================================
-// Excel Protect Sheet
-// =============================================================================
-
-const EXCEL_PROTECT_SHEET_DEFINITION: ToolDefinition = {
-  type: 'function',
-  function: {
-    name: 'excel_protect_sheet',
-    description: `Protect a worksheet.`,
-    parameters: {
-      type: 'object',
-      properties: {
-        reason: { type: 'string', description: 'Why you are protecting sheet' },
-        password: { type: 'string', description: 'Protection password (optional)' },
-        sheet: { type: 'string', description: 'Sheet name (optional, protects active sheet)' },
-      },
-      required: ['reason'],
-    },
-  },
-};
-
-async function executeExcelProtectSheet(args: Record<string, unknown>): Promise<ToolResult> {
-  try {
-    const response = await excelClient.excelProtectSheet(
-      args['password'] as string | undefined,
-      args['sheet'] as string | undefined
-    );
-    if (response.success) {
-      return { success: true, result: 'Sheet protected' };
-    }
-    return { success: false, error: response.error || 'Failed to protect sheet' };
-  } catch (error) {
-    return { success: false, error: `Failed to protect sheet: ${error instanceof Error ? error.message : String(error)}` };
-  }
-}
-
-export const excelProtectSheetTool: LLMSimpleTool = {
-  definition: EXCEL_PROTECT_SHEET_DEFINITION,
-  execute: executeExcelProtectSheet,
-  categories: OFFICE_CATEGORIES,
-  description: 'Protect Excel sheet',
-};
-
-// =============================================================================
-// Excel Unprotect Sheet
-// =============================================================================
-
-const EXCEL_UNPROTECT_SHEET_DEFINITION: ToolDefinition = {
-  type: 'function',
-  function: {
-    name: 'excel_unprotect_sheet',
-    description: `Unprotect a worksheet.`,
-    parameters: {
-      type: 'object',
-      properties: {
-        reason: { type: 'string', description: 'Why you are unprotecting sheet' },
-        password: { type: 'string', description: 'Protection password (if protected)' },
-        sheet: { type: 'string', description: 'Sheet name (optional)' },
-      },
-      required: ['reason'],
-    },
-  },
-};
-
-async function executeExcelUnprotectSheet(args: Record<string, unknown>): Promise<ToolResult> {
-  try {
-    const response = await excelClient.excelUnprotectSheet(
-      args['password'] as string | undefined,
-      args['sheet'] as string | undefined
-    );
-    if (response.success) {
-      return { success: true, result: 'Sheet unprotected' };
-    }
-    return { success: false, error: response.error || 'Failed to unprotect sheet' };
-  } catch (error) {
-    return { success: false, error: `Failed to unprotect sheet: ${error instanceof Error ? error.message : String(error)}` };
-  }
-}
-
-export const excelUnprotectSheetTool: LLMSimpleTool = {
-  definition: EXCEL_UNPROTECT_SHEET_DEFINITION,
-  execute: executeExcelUnprotectSheet,
-  categories: OFFICE_CATEGORIES,
-  description: 'Unprotect Excel sheet',
-};
-
-// =============================================================================
-// Export
-// =============================================================================
-
-export const protectionTools: LLMSimpleTool[] = [
-  excelProtectSheetTool,
-  excelUnprotectSheetTool,
-];