@nexus-cortex/executors 4.26.0

package/dist/implementations/notebook/NotebookEditTool.js

@@ -0,0 +1,390 @@
+/**
+ * NotebookEdit Tool Executor
+ *
+ * Edit Jupyter notebook cells - supports replace, insert, and delete operations.
+ * Works with .ipynb files (JSON format).
+ */
+import { BaseTool } from '../../base/index.js';
+import { SchemaValidator } from '../../utils/SchemaValidator.js';
+import fs from 'fs/promises';
+import path from 'path';
+/**
+ * NotebookEdit Tool Executor
+ *
+ * Features:
+ * - Read and parse .ipynb JSON files
+ * - Replace cell content by cell_id
+ * - Insert new cells at specific positions
+ * - Delete cells by cell_id
+ * - Preserve notebook metadata and structure
+ */
+export class NotebookEditTool extends BaseTool {
+    config;
+    constructor(config) {
+        super('NotebookEdit', 'NotebookEdit', `Completely replaces the contents of a specific cell in a Jupyter notebook (.ipynb file) with new source. Jupyter notebooks are interactive documents that combine code, text, and visualizations, commonly used for data analysis and scientific computing. The notebook_path parameter must be an absolute path, not a relative path. The cell_number is 0-indexed. Use edit_mode=insert to add a new cell at the index specified by cell_number. Use edit_mode=delete to delete the cell at the index specified by cell_number.`, {
+            type: 'object',
+            properties: {
+                notebook_path: {
+                    type: 'string',
+                    description: 'The absolute path to the Jupyter notebook file to edit (must be absolute, not relative)',
+                },
+                cell_id: {
+                    type: 'string',
+                    description: 'The ID of the cell to edit. When inserting a new cell, the new cell will be inserted after the cell with this ID, or at the beginning if not specified.',
+                },
+                cell_type: {
+                    type: 'string',
+                    enum: ['code', 'markdown'],
+                    description: 'The type of the cell (code or markdown). If not specified, it defaults to the current cell type. If using edit_mode=insert, this is required.',
+                },
+                edit_mode: {
+                    type: 'string',
+                    enum: ['replace', 'insert', 'delete'],
+                    description: 'The type of edit to make (replace, insert, delete). Defaults to replace.',
+                },
+                new_source: {
+                    type: 'string',
+                    description: 'The new source for the cell',
+                },
+            },
+            required: ['notebook_path', 'new_source'],
+        });
+        this.config = config;
+    }
+    validateToolParams(params) {
+        // Schema validation
+        const schemaError = SchemaValidator.validate(this.parameterSchema, params);
+        if (schemaError) {
+            return schemaError;
+        }
+        // Validate notebook path
+        if (!params.notebook_path || !params.notebook_path.trim()) {
+            return 'Notebook path cannot be empty.';
+        }
+        // Ensure absolute path
+        if (!path.isAbsolute(params.notebook_path)) {
+            return 'Notebook path must be absolute, not relative.';
+        }
+        // Validate file extension
+        if (!params.notebook_path.endsWith('.ipynb')) {
+            return 'Notebook path must end with .ipynb extension.';
+        }
+        // Validate edit_mode
+        const editMode = params.edit_mode || 'replace';
+        if (!['replace', 'insert', 'delete'].includes(editMode)) {
+            return `Invalid edit_mode: ${editMode}. Must be 'replace', 'insert', or 'delete'.`;
+        }
+        // Validate cell_type
+        if (params.cell_type && !['code', 'markdown'].includes(params.cell_type)) {
+            return `Invalid cell_type: ${params.cell_type}. Must be 'code' or 'markdown'.`;
+        }
+        // For insert mode, cell_type is required
+        if (editMode === 'insert' && !params.cell_type) {
+            return 'cell_type is required when edit_mode is "insert".';
+        }
+        // For delete mode, new_source should be empty or ignored
+        if (editMode === 'delete' && params.new_source.trim().length > 0) {
+            return 'new_source should be empty when edit_mode is "delete".';
+        }
+        return null;
+    }
+    getDescription(params) {
+        const mode = params.edit_mode || 'replace';
+        const cellId = params.cell_id || 'new cell';
+        return `${mode} cell ${cellId} in ${path.basename(params.notebook_path)}`;
+    }
+    async execute(params, signal, updateOutput) {
+        const startTime = Date.now();
+        try {
+            // Check for abort
+            if (signal.aborted) {
+                return {
+                    ...this.createErrorResult('Notebook edit was cancelled'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                    },
+                };
+            }
+            // Validate parameters
+            const validationError = this.validateToolParams(params);
+            if (validationError) {
+                return {
+                    ...this.createErrorResult(validationError),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                    },
+                };
+            }
+            // Resolve absolute path
+            const notebookPath = path.resolve(params.notebook_path);
+            // Check if file exists
+            let notebookExists = false;
+            try {
+                await fs.access(notebookPath);
+                notebookExists = true;
+            }
+            catch {
+                notebookExists = false;
+            }
+            if (!notebookExists) {
+                return {
+                    ...this.createErrorResult(`Notebook file not found: ${notebookPath}`),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                        notebookPath,
+                    },
+                };
+            }
+            // Read and parse notebook
+            const notebookContent = await fs.readFile(notebookPath, 'utf-8');
+            let notebook;
+            try {
+                notebook = JSON.parse(notebookContent);
+            }
+            catch (parseError) {
+                return {
+                    ...this.createErrorResult(`Failed to parse notebook JSON: ${parseError.message}`),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                        notebookPath,
+                    },
+                };
+            }
+            // Validate notebook structure
+            if (!notebook.cells || !Array.isArray(notebook.cells)) {
+                return {
+                    ...this.createErrorResult('Invalid notebook structure: missing or invalid cells array'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                        notebookPath,
+                    },
+                };
+            }
+            // Perform edit operation
+            const editMode = params.edit_mode || 'replace';
+            const editResult = await this.performEdit(notebook, params, editMode, signal);
+            if (!editResult.success) {
+                return {
+                    ...this.createErrorResult(editResult.error || 'Edit operation failed'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                        notebookPath,
+                        cellCount: notebook.cells.length,
+                    },
+                };
+            }
+            // Write modified notebook back to file
+            const modifiedContent = JSON.stringify(notebook, null, 2);
+            await fs.writeFile(notebookPath, modifiedContent, 'utf-8');
+            // Format success message
+            const message = this.formatSuccessMessage(params, editMode, notebook);
+            return {
+                ...this.createSuccessResult(message),
+                metadata: {
+                    executionTime: Date.now() - startTime,
+                    notebookPath,
+                    editMode,
+                    cellId: params.cell_id,
+                    cellType: params.cell_type,
+                    cellCount: notebook.cells.length,
+                },
+            };
+        }
+        catch (error) {
+            // Check for abort
+            if (signal.aborted) {
+                return {
+                    ...this.createErrorResult('Notebook edit was cancelled'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                    },
+                };
+            }
+            const errorMessage = error.message || String(error);
+            return {
+                ...this.createErrorResult(`Error editing notebook: ${errorMessage}`),
+                metadata: {
+                    executionTime: Date.now() - startTime,
+                    error: errorMessage,
+                },
+            };
+        }
+    }
+    /**
+     * Perform the edit operation on the notebook
+     */
+    async performEdit(notebook, params, editMode, signal) {
+        if (signal.aborted) {
+            return { success: false, error: 'Operation cancelled' };
+        }
+        switch (editMode) {
+            case 'replace':
+                return this.replaceCell(notebook, params);
+            case 'insert':
+                return this.insertCell(notebook, params);
+            case 'delete':
+                return this.deleteCell(notebook, params);
+            default:
+                return { success: false, error: `Unknown edit mode: ${editMode}` };
+        }
+    }
+    /**
+     * Get the cell ID from a cell (checks both cell.id and cell.metadata.id)
+     * Jupyter notebooks may store cell IDs in either location
+     */
+    getCellId(cell) {
+        return cell.id || cell.metadata?.id;
+    }
+    /**
+     * Find a cell by ID (checks both cell.id and cell.metadata.id)
+     */
+    findCellIndex(notebook, cellId) {
+        return notebook.cells.findIndex((c) => this.getCellId(c) === cellId);
+    }
+    /**
+     * Replace an existing cell's content
+     */
+    replaceCell(notebook, params) {
+        if (!params.cell_id) {
+            return {
+                success: false,
+                error: 'cell_id is required for replace mode',
+            };
+        }
+        const cellIndex = this.findCellIndex(notebook, params.cell_id);
+        if (cellIndex === -1) {
+            // Provide helpful error with available cell IDs
+            const availableIds = notebook.cells
+                .map((c, i) => this.getCellId(c) || `[index ${i}]`)
+                .join(', ');
+            return {
+                success: false,
+                error: `Cell with id "${params.cell_id}" not found. Available cell IDs: ${availableIds}`,
+            };
+        }
+        const cell = notebook.cells[cellIndex];
+        if (!cell) {
+            return { success: false, error: 'Cell is undefined' };
+        }
+        // Update cell content
+        cell.source = this.normalizeSource(params.new_source);
+        // Update cell type if provided
+        if (params.cell_type) {
+            cell.cell_type = params.cell_type;
+        }
+        // Clear outputs for code cells
+        if (cell.cell_type === 'code') {
+            cell.outputs = [];
+            cell.execution_count = null;
+        }
+        return { success: true };
+    }
+    /**
+     * Insert a new cell
+     */
+    insertCell(notebook, params) {
+        if (!params.cell_type) {
+            return {
+                success: false,
+                error: 'cell_type is required for insert mode',
+            };
+        }
+        // Create new cell
+        const newCell = {
+            cell_type: params.cell_type,
+            id: this.generateCellId(),
+            metadata: {},
+            source: this.normalizeSource(params.new_source),
+        };
+        // Add code cell specific fields
+        if (params.cell_type === 'code') {
+            newCell.outputs = [];
+            newCell.execution_count = null;
+        }
+        // Find insertion position
+        let insertIndex = notebook.cells.length; // Default: append to end
+        if (params.cell_id) {
+            const refIndex = this.findCellIndex(notebook, params.cell_id);
+            if (refIndex === -1) {
+                // Provide helpful error with available cell IDs
+                const availableIds = notebook.cells
+                    .map((c, i) => this.getCellId(c) || `[index ${i}]`)
+                    .join(', ');
+                return {
+                    success: false,
+                    error: `Reference cell with id "${params.cell_id}" not found. Available cell IDs: ${availableIds}`,
+                };
+            }
+            insertIndex = refIndex + 1; // Insert after reference cell
+        }
+        // Insert the new cell
+        notebook.cells.splice(insertIndex, 0, newCell);
+        return { success: true };
+    }
+    /**
+     * Delete a cell
+     */
+    deleteCell(notebook, params) {
+        if (!params.cell_id) {
+            return { success: false, error: 'cell_id is required for delete mode' };
+        }
+        const cellIndex = this.findCellIndex(notebook, params.cell_id);
+        if (cellIndex === -1) {
+            // Provide helpful error with available cell IDs
+            const availableIds = notebook.cells
+                .map((c, i) => this.getCellId(c) || `[index ${i}]`)
+                .join(', ');
+            return {
+                success: false,
+                error: `Cell with id "${params.cell_id}" not found. Available cell IDs: ${availableIds}`,
+            };
+        }
+        // Remove the cell
+        notebook.cells.splice(cellIndex, 1);
+        return { success: true };
+    }
+    /**
+     * Normalize source content to array of lines
+     */
+    normalizeSource(source) {
+        // Split into lines, preserving newlines
+        const lines = source.split('\n');
+        return lines.map((line, i) => i < lines.length - 1 ? line + '\n' : line);
+    }
+    /**
+     * Generate a unique cell ID
+     */
+    generateCellId() {
+        // Generate a simple unique ID (8 random hex characters)
+        return Math.random().toString(16).substring(2, 10);
+    }
+    /**
+     * Format success message
+     */
+    formatSuccessMessage(params, editMode, notebook) {
+        const lines = [];
+        const filename = path.basename(params.notebook_path);
+        lines.push('=== Notebook Edit Successful ===\n\n');
+        switch (editMode) {
+            case 'replace':
+                lines.push(`Replaced cell "${params.cell_id}" in ${filename}\n`);
+                lines.push(`Cell type: ${params.cell_type || 'unchanged'}\n`);
+                break;
+            case 'insert':
+                lines.push(`Inserted new ${params.cell_type} cell in ${filename}\n`);
+                if (params.cell_id) {
+                    lines.push(`Position: after cell "${params.cell_id}"\n`);
+                }
+                else {
+                    lines.push(`Position: at the end\n`);
+                }
+                break;
+            case 'delete':
+                lines.push(`Deleted cell "${params.cell_id}" from ${filename}\n`);
+                break;
+        }
+        lines.push(`\nTotal cells: ${notebook.cells.length}\n`);
+        return lines.join('');
+    }
+}
+//# sourceMappingURL=NotebookEditTool.js.map

package/dist/implementations/notebook/NotebookEditTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotebookEditTool.js","sourceRoot":"","sources":["../../../src/implementations/notebook/NotebookEditTool.ts"],"names":[],"mappings":"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"}

package/dist/implementations/notebook/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Notebook Operations
+ *
+ * Tools for working with Jupyter notebooks (.ipynb files)
+ */
+export * from './NotebookEditTool.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/implementations/notebook/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/implementations/notebook/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,uBAAuB,CAAC"}

package/dist/implementations/notebook/index.js

@@ -0,0 +1,7 @@
+/**
+ * Notebook Operations
+ *
+ * Tools for working with Jupyter notebooks (.ipynb files)
+ */
+export * from './NotebookEditTool.js';
+//# sourceMappingURL=index.js.map

package/dist/implementations/notebook/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/implementations/notebook/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,uBAAuB,CAAC"}

package/dist/implementations/search/GlobTool.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Glob Tool Executor
+ *
+ * Finds files matching glob patterns with modification time sorting.
+ * Fast pattern-based file discovery for large codebases.
+ *
+ * Adapted and simplified from Gemini CLI patterns
+ * - Removed: FileDiscovery service, git-ignore filtering
+ * - Kept: Core glob matching, modification time sorting, security
+ */
+import { BaseTool, type ToolResult } from '../../base/index.js';
+import type { ExecutorConfig } from '../../base/ToolRegistry.js';
+/**
+ * Subset of 'Path' interface provided by 'glob' that we use
+ */
+export interface GlobPath {
+    fullpath(): string;
+    mtimeMs?: number;
+}
+/**
+ * Parameters for the Glob tool
+ */
+export interface GlobToolParams {
+    /**
+     * The glob pattern to match files against
+     */
+    pattern: string;
+    /**
+     * The directory to search in (optional, defaults to working directory)
+     */
+    path?: string;
+    /**
+     * Whether the search should be case-sensitive (optional, defaults to false)
+     */
+    case_sensitive?: boolean;
+    /**
+     * Maximum number of files to return (optional, defaults to 100)
+     * Set to -1 for unlimited (not recommended for large codebases)
+     */
+    limit?: number;
+    /**
+     * Number of files to skip (for pagination)
+     * Use with limit to page through large result sets
+     */
+    offset?: number;
+}
+/**
+ * Glob Tool Executor
+ *
+ * Features:
+ * - Fast pattern matching (e.g., star-star-slash-star.ts, src-star-star-slash-star.js)
+ * - Sorts results by modification time (newest first)
+ * - Then alphabetically for older files
+ * - Excludes node_modules and .git by default
+ * - Path normalization and security
+ */
+export declare class GlobTool extends BaseTool<GlobToolParams, ToolResult> {
+    private config;
+    private readonly RECENCY_THRESHOLD_MS;
+    private static readonly DEFAULT_MAX_RESULTS;
+    constructor(config: ExecutorConfig);
+    validateToolParams(params: GlobToolParams): string | null;
+    getDescription(params: GlobToolParams): string;
+    execute(params: GlobToolParams, signal: AbortSignal, updateOutput?: (output: string) => void): Promise<ToolResult>;
+    /**
+     * Sorts file entries based on recency and then alphabetically.
+     * Recent files (modified within 24 hours) are listed first, newest to oldest.
+     * Older files are listed after recent ones, sorted alphabetically by path.
+     * @private
+     */
+    private sortFilesByRecency;
+}
+//# sourceMappingURL=GlobTool.d.ts.map

package/dist/implementations/search/GlobTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobTool.d.ts","sourceRoot":"","sources":["../../../src/implementations/search/GlobTool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAMhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,IAAI,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,qBAAa,QAAS,SAAQ,QAAQ,CAAC,cAAc,EAAE,UAAU,CAAC;IAMpD,OAAO,CAAC,MAAM;IAJ1B,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAuB;IAE5D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAO;gBAE9B,MAAM,EAAE,cAAc;IA6B1C,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI;IA0CzD,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM;IAcxC,OAAO,CACX,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,WAAW,EACnB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GACtC,OAAO,CAAC,UAAU,CAAC;IAgGtB;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;CA+B3B"}