@datalayer/jupyter-react 1.1.7 → 1.1.9

package/lib/tools/operations/deleteCell.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Platform-agnostic cell deletion operation.
+ *
+ * @module tools/operations/deleteCell
+ */
+import type { ToolOperation } from '../core/interfaces';
+import { type DeleteCellParams } from '../schemas/deleteCell';
+/**
+ * Information about a deleted cell.
+ */
+export interface DeletedCellInfo {
+    /** Original index of the deleted cell */
+    index: number;
+    /** Cell type (code, markdown, raw) */
+    type: string;
+    /** Cell source content */
+    source: string;
+}
+/**
+ * Result from deleteCell operation.
+ */
+export interface DeleteCellResult {
+    success: boolean;
+    deletedCells: DeletedCellInfo[];
+    message: string;
+}
+/**
+ * Deletes one or more cells from a notebook at the specified indices.
+ *
+ * Cells are deleted in reverse order (highest index first) to prevent
+ * index shifting issues during multi-cell deletion. This matches the
+ * behavior of the Jupyter MCP Server.
+ *
+ * @example
+ * ```typescript
+ * // Delete single cell
+ * await deleteCellOperation.execute(
+ *   { indices: [2] },
+ *   { documentId: "file:///path/to/notebook.ipynb", executor }
+ * );
+ *
+ * // Delete multiple cells
+ * await deleteCellOperation.execute(
+ *   { indices: [1, 3, 5] },
+ *   { documentId: "file:///path/to/notebook.ipynb", executor }
+ * );
+ * ```
+ */
+export declare const deleteCellOperation: ToolOperation<DeleteCellParams, DeleteCellResult>;

package/lib/tools/operations/deleteCell.js

@@ -0,0 +1,103 @@
+/*
+ * Copyright (c) 2021-2023 Datalayer, Inc.
+ *
+ * MIT License
+ */
+import { readAllCellsOperation } from './readAllCells';
+import { validateWithZod } from '../core/zodUtils';
+import { deleteCellParamsSchema, } from '../schemas/deleteCell';
+/**
+ * Deletes one or more cells from a notebook at the specified indices.
+ *
+ * Cells are deleted in reverse order (highest index first) to prevent
+ * index shifting issues during multi-cell deletion. This matches the
+ * behavior of the Jupyter MCP Server.
+ *
+ * @example
+ * ```typescript
+ * // Delete single cell
+ * await deleteCellOperation.execute(
+ *   { indices: [2] },
+ *   { documentId: "file:///path/to/notebook.ipynb", executor }
+ * );
+ *
+ * // Delete multiple cells
+ * await deleteCellOperation.execute(
+ *   { indices: [1, 3, 5] },
+ *   { documentId: "file:///path/to/notebook.ipynb", executor }
+ * );
+ * ```
+ */
+export const deleteCellOperation = {
+    name: 'deleteCell',
+    async execute(params, context) {
+        // Validate params using Zod schema
+        const { indices } = validateWithZod(deleteCellParamsSchema, params, this.name);
+        const { documentId } = context;
+        if (!documentId) {
+            throw new Error('Document ID is required for deleteCell operation. ' +
+                'Ensure the tool execution context includes a valid documentId.');
+        }
+        // Ensure executor is available
+        if (!context.executor) {
+            throw new Error('Executor is required for deleteCell operation. ' +
+                'This should be provided by the platform (DefaultExecutor, BridgeExecutor, etc.)');
+        }
+        try {
+            // First, read all cells to get current state and validate indices
+            // Request detailed format to get full source for deletion confirmation
+            const cellsResult = await readAllCellsOperation.execute({ format: 'detailed' }, context);
+            if (!cellsResult.success || !cellsResult.cells) {
+                throw new Error('Failed to read cells for bounds validation');
+            }
+            const cellCount = cellsResult.cellCount || cellsResult.cells.length;
+            const cells = cellsResult.cells;
+            // Validate ALL indices are in range (match Jupyter MCP Server error format)
+            for (const index of indices) {
+                if (index < 0 || index >= cellCount) {
+                    throw new Error(`Cell index ${index} is out of range. Notebook has ${cellCount} cells.`);
+                }
+            }
+            // Sort indices in REVERSE order (highest to lowest) to prevent index shifting
+            // This matches the Jupyter MCP Server behavior
+            const sortedIndices = [...indices].sort((a, b) => b - a);
+            // Store information about cells before deletion
+            const deletedCells = [];
+            // Delete each cell in reverse order
+            for (const index of sortedIndices) {
+                // Store cell info before deletion (from original read)
+                const cell = cells[index];
+                // Execute deletion via executor
+                await context.executor.execute(this.name, {
+                    index,
+                });
+                // Track deletion with original index
+                deletedCells.push({
+                    index,
+                    type: cell.type,
+                    source: cell.source,
+                });
+            }
+            // Format message similar to Jupyter MCP Server
+            const message = deletedCells
+                .map(cell => {
+                return (`Deleted cell at index ${cell.index}:\n` +
+                    `Type: ${cell.type}\n` +
+                    `----------------------------------------`);
+            })
+                .join('\n\n');
+            // Return success result
+            return {
+                success: true,
+                deletedCells: deletedCells.reverse(), // Reverse to show in original order
+                message,
+            };
+        }
+        catch (error) {
+            // Convert error to descriptive error
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to delete cell(s): ${errorMessage}`);
+        }
+    },
+};
+//# sourceMappingURL=deleteCell.js.map

package/lib/tools/operations/deleteCell.js.map

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

package/lib/tools/operations/executeCode.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Platform-agnostic code execution operation.
+ * Executes code directly in the kernel without creating or modifying cells.
+ *
+ * @module tools/operations/executeCode
+ */
+import type { ToolOperation } from '../core/interfaces';
+import { type ExecuteCodeParams } from '../schemas/executeCode';
+/**
+ * Result from executeCode operation.
+ */
+export interface ExecuteCodeResult {
+    success: boolean;
+    /** Execution outputs (streams, results, errors) */
+    outputs?: Array<{
+        type: 'stream' | 'execute_result' | 'display_data' | 'error';
+        content: unknown;
+    }>;
+    /** Error message if execution failed */
+    error?: string;
+    /** Execution count (if stored in history) */
+    executionCount?: number;
+}
+/**
+ * Executes code directly in the kernel without creating a cell.
+ *
+ * This is useful for:
+ * - Variable inspection
+ * - Environment setup
+ * - Background tasks
+ * - Tool introspection
+ */
+export declare const executeCodeOperation: ToolOperation<ExecuteCodeParams, ExecuteCodeResult>;

package/lib/tools/operations/executeCode.js

@@ -0,0 +1,45 @@
+/*
+ * Copyright (c) 2021-2023 Datalayer, Inc.
+ *
+ * MIT License
+ */
+import { validateWithZod } from '../core/zodUtils';
+import { executeCodeParamsSchema, } from '../schemas/executeCode';
+/**
+ * Executes code directly in the kernel without creating a cell.
+ *
+ * This is useful for:
+ * - Variable inspection
+ * - Environment setup
+ * - Background tasks
+ * - Tool introspection
+ */
+export const executeCodeOperation = {
+    name: 'executeCode',
+    async execute(params, context) {
+        // Validate params using Zod schema
+        validateWithZod(executeCodeParamsSchema, params, this.name);
+        const { documentId } = context;
+        if (!documentId) {
+            return {
+                success: false,
+                error: 'Document ID is required for this operation.',
+            };
+        }
+        // Ensure executor is available
+        if (!context.executor) {
+            throw new Error('Executor is required for executeCode operation. ' +
+                'This should be provided by the platform (DefaultExecutor, BridgeExecutor, etc.)');
+        }
+        try {
+            // Call executor (uses this.name for DRY principle)
+            const result = await context.executor.execute(this.name, params);
+            return result;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to execute code: ${errorMessage}`);
+        }
+    },
+};
+//# sourceMappingURL=executeCode.js.map

package/lib/tools/operations/executeCode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executeCode.js","sourceRoot":"","sources":["../../../src/tools/operations/executeCode.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EACL,uBAAuB,GAExB,MAAM,wBAAwB,CAAC;AAkBhC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAG7B;IACF,IAAI,EAAE,aAAa;IAEnB,KAAK,CAAC,OAAO,CACX,MAAe,EACf,OAA6B;QAE7B,mCAAmC;QACnC,eAAe,CAAC,uBAAuB,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAE5D,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;QAE/B,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,6CAA6C;aACrD,CAAC;QACJ,CAAC;QAED,+BAA+B;QAC/B,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,kDAAkD;gBAChD,iFAAiF,CACpF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,mDAAmD;YACnD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAEjE,OAAO,MAA2B,CAAC;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACzD,MAAM,IAAI,KAAK,CAAC,2BAA2B,YAAY,EAAE,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}

package/lib/tools/operations/insertCell.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Platform-agnostic cell insertion operation.
+ *
+ * @module tools/operations/insertCell
+ */
+import type { ToolOperation } from '../core/interfaces';
+import { type InsertCellParams } from '../schemas/insertCell';
+/**
+ * Result from insertCell operation.
+ */
+export interface InsertCellResult {
+    success: boolean;
+    index: number;
+    message: string;
+}
+/**
+ * Inserts a cell into a notebook at the specified position.
+ *
+ * @example
+ * ```typescript
+ * await insertCellOperation.execute(
+ *   { type: 'code', source: 'print("Hello")' },
+ *   { documentId: 'file:///path/to/notebook.ipynb', executor }
+ * );
+ * ```
+ */
+export declare const insertCellOperation: ToolOperation<InsertCellParams, InsertCellResult>;

package/lib/tools/operations/insertCell.js

@@ -0,0 +1,56 @@
+/*
+ * Copyright (c) 2021-2023 Datalayer, Inc.
+ *
+ * MIT License
+ */
+import { validateWithZod } from '../core/zodUtils';
+import { insertCellParamsSchema, } from '../schemas/insertCell';
+/**
+ * Inserts a cell into a notebook at the specified position.
+ *
+ * @example
+ * ```typescript
+ * await insertCellOperation.execute(
+ *   { type: 'code', source: 'print("Hello")' },
+ *   { documentId: 'file:///path/to/notebook.ipynb', executor }
+ * );
+ * ```
+ */
+export const insertCellOperation = {
+    name: 'insertCell',
+    async execute(params, context) {
+        // Validate params using Zod schema
+        const { type, source, index } = validateWithZod(insertCellParamsSchema, params, this.name);
+        const { documentId } = context;
+        // Validate context
+        if (!documentId) {
+            throw new Error('Document ID is required for insertCell operation. ' +
+                'Ensure the tool execution context includes a valid documentId.');
+        }
+        // Ensure executor is available
+        if (!context.executor) {
+            throw new Error('Executor is required for insertCell operation. ' +
+                'This should be provided by the platform (DefaultExecutor, BridgeExecutor, etc.)');
+        }
+        try {
+            // Call executor (uses this.name for DRY principle)
+            await context.executor.execute(this.name, {
+                type,
+                source,
+                index, // undefined means insert at end
+            });
+            // Return success result
+            return {
+                success: true,
+                index: index ?? -1,
+                message: `Cell inserted at index ${index ?? -1}`,
+            };
+        }
+        catch (error) {
+            // Convert error to result with failure status
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to insert cell: ${errorMessage}`);
+        }
+    },
+};
+//# sourceMappingURL=insertCell.js.map

package/lib/tools/operations/insertCell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"insertCell.js","sourceRoot":"","sources":["../../../src/tools/operations/insertCell.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EACL,sBAAsB,GAEvB,MAAM,uBAAuB,CAAC;AAW/B;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAG5B;IACF,IAAI,EAAE,YAAY;IAElB,KAAK,CAAC,OAAO,CACX,MAAe,EACf,OAA6B;QAE7B,mCAAmC;QACnC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,eAAe,CAC7C,sBAAsB,EACtB,MAAM,EACN,IAAI,CAAC,IAAI,CACV,CAAC;QACF,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;QAE/B,mBAAmB;QACnB,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,oDAAoD;gBAClD,gEAAgE,CACnE,CAAC;QACJ,CAAC;QAED,+BAA+B;QAC/B,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,iDAAiD;gBAC/C,iFAAiF,CACpF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,mDAAmD;YACnD,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE;gBACxC,IAAI;gBACJ,MAAM;gBACN,KAAK,EAAE,gCAAgC;aACxC,CAAC,CAAC;YAEH,wBAAwB;YACxB,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,KAAK,EAAE,KAAK,IAAI,CAAC,CAAC;gBAClB,OAAO,EAAE,0BAA0B,KAAK,IAAI,CAAC,CAAC,EAAE;aACjD,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,8CAA8C;YAC9C,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACzD,MAAM,IAAI,KAAK,CAAC,0BAA0B,YAAY,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;CACF,CAAC"}

package/lib/tools/operations/readAllCells.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Platform-agnostic operation to read all cells.
+ *
+ * @module tools/operations/readAllCells
+ */
+import type { ToolOperation } from '../core/interfaces';
+import type { BriefCell, DetailedCell } from '../core/types';
+import { type ReadAllCellsParams } from '../schemas/readAllCells';
+/**
+ * Result from readAllCells operation.
+ */
+export interface ReadAllCellsResult {
+    success: boolean;
+    cells?: BriefCell[] | DetailedCell[];
+    cellCount?: number;
+    error?: string;
+}
+/**
+ * Reads all cells from a notebook with source and outputs.
+ */
+export declare const readAllCellsOperation: ToolOperation<ReadAllCellsParams, ReadAllCellsResult>;

package/lib/tools/operations/readAllCells.js

@@ -0,0 +1,45 @@
+/*
+ * Copyright (c) 2021-2023 Datalayer, Inc.
+ *
+ * MIT License
+ */
+import { validateWithZod } from '../core/zodUtils';
+import { readAllCellsParamsSchema, } from '../schemas/readAllCells';
+/**
+ * Reads all cells from a notebook with source and outputs.
+ */
+export const readAllCellsOperation = {
+    name: 'readAllCells',
+    async execute(params, context) {
+        // Validate params using Zod
+        const validatedParams = validateWithZod(readAllCellsParamsSchema, params || {}, 'readAllCells');
+        const { format = 'brief' } = validatedParams;
+        const { documentId } = context;
+        if (!documentId) {
+            return {
+                success: false,
+                error: 'Document ID is required for this operation.',
+            };
+        }
+        if (!context.executor) {
+            throw new Error('Executor is required for readAllCells operation. ' +
+                'This should be provided by the platform (DefaultExecutor, BridgeExecutor, etc.)');
+        }
+        try {
+            // Call executor with format parameter
+            const cells = (await context.executor.execute(this.name, {
+                format,
+            }));
+            return {
+                success: true,
+                cells,
+                cellCount: cells.length,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to read all cells: ${errorMessage}`);
+        }
+    },
+};
+//# sourceMappingURL=readAllCells.js.map

package/lib/tools/operations/readAllCells.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readAllCells.js","sourceRoot":"","sources":["../../../src/tools/operations/readAllCells.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EACL,wBAAwB,GAEzB,MAAM,yBAAyB,CAAC;AAYjC;;GAEG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAG9B;IACF,IAAI,EAAE,cAAc;IAEpB,KAAK,CAAC,OAAO,CACX,MAAe,EACf,OAA6B;QAE7B,4BAA4B;QAC5B,MAAM,eAAe,GAAG,eAAe,CACrC,wBAAwB,EACxB,MAAM,IAAI,EAAE,EACZ,cAAc,CACf,CAAC;QAEF,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE,GAAG,eAAe,CAAC;QAC7C,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;QAE/B,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,6CAA6C;aACrD,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,mDAAmD;gBACjD,iFAAiF,CACpF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,sCAAsC;YACtC,MAAM,KAAK,GAAG,CAAC,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE;gBACvD,MAAM;aACP,CAAC,CAAiC,CAAC;YAEpC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,KAAK;gBACL,SAAS,EAAE,KAAK,CAAC,MAAM;aACxB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACzD,MAAM,IAAI,KAAK,CAAC,6BAA6B,YAAY,EAAE,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;CACF,CAAC"}

package/lib/tools/operations/readCell.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Platform-agnostic cell read operation.
+ *
+ * @module tools/operations/readCell
+ */
+import type { ToolOperation } from '../core/interfaces';
+/**
+ * Parameters for readCell operation.
+ */
+export interface ReadCellParams {
+    /** Cell index (0-based) */
+    index: number;
+    /** Whether to include cell outputs in the response (default: true) */
+    includeOutputs?: boolean;
+}
+/**
+ * Result from readCell operation.
+ */
+export interface ReadCellResult {
+    success: boolean;
+    index?: number;
+    type?: string;
+    source?: string;
+    execution_count?: number | null;
+    outputs?: string[];
+    error?: string;
+}
+/**
+ * Reads cell content and metadata at the specified index.
+ *
+ * @example
+ * ```typescript
+ * const result = await readCellOperation.execute(
+ *   { index: 0 },
+ *   { documentId: 'file:///notebook.ipynb', executor }
+ * );
+ * ```
+ */
+export declare const readCellOperation: ToolOperation<ReadCellParams, ReadCellResult>;

package/lib/tools/operations/readCell.js

@@ -0,0 +1,90 @@
+/*
+ * Copyright (c) 2021-2023 Datalayer, Inc.
+ *
+ * MIT License
+ */
+import { readAllCellsOperation } from './readAllCells';
+/**
+ * Validates ReadCellParams at runtime.
+ */
+function isReadCellParams(params) {
+    if (typeof params !== 'object' || params === null) {
+        return false;
+    }
+    const p = params;
+    // Validate required field
+    if (typeof p.index !== 'number') {
+        return false;
+    }
+    // Validate optional field
+    if (p.includeOutputs !== undefined && typeof p.includeOutputs !== 'boolean') {
+        return false;
+    }
+    return true;
+}
+/**
+ * Reads cell content and metadata at the specified index.
+ *
+ * @example
+ * ```typescript
+ * const result = await readCellOperation.execute(
+ *   { index: 0 },
+ *   { documentId: 'file:///notebook.ipynb', executor }
+ * );
+ * ```
+ */
+export const readCellOperation = {
+    name: 'readCell',
+    async execute(params, context) {
+        // Validate params using type guard
+        if (!isReadCellParams(params)) {
+            throw new Error(`Invalid parameters for readCell. Expected { index: number }. ` +
+                `Received: ${JSON.stringify(params)}`);
+        }
+        // Now TypeScript knows params is ReadCellParams!
+        const { index } = params;
+        const { documentId } = context;
+        if (!documentId) {
+            return {
+                success: false,
+                error: 'Document ID is required for this operation.',
+            };
+        }
+        if (!context.executor) {
+            throw new Error('Executor is required for readCell operation.');
+        }
+        try {
+            // First, validate that the index is within bounds
+            const cellsResult = await readAllCellsOperation.execute({}, context);
+            if (!cellsResult.success || !cellsResult.cells) {
+                throw new Error('Failed to read cells for bounds validation');
+            }
+            const cellCount = cellsResult.cellCount || cellsResult.cells.length;
+            // Validate index bounds (match Jupyter MCP Server error format)
+            if (index < 0 || index >= cellCount) {
+                return {
+                    success: false,
+                    error: `Cell index ${index} is out of range. Notebook has ${cellCount} cells.`,
+                };
+            }
+            // Call executor (uses this.name for DRY principle)
+            const includeOutputs = params.includeOutputs ?? true;
+            const cellData = await context.executor.execute(this.name, {
+                index,
+                includeOutputs,
+            });
+            const result = {
+                success: true,
+                ...(typeof cellData === 'object' && cellData !== null
+                    ? cellData
+                    : {}),
+            };
+            return result;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to read cell: ${errorMessage}`);
+        }
+    },
+};
+//# sourceMappingURL=readCell.js.map

package/lib/tools/operations/readCell.js.map

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

package/lib/tools/operations/runCell.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Platform-agnostic cell execution operation.
+ *
+ * @module tools/operations/runCell
+ */
+import type { ToolOperation } from '../core/interfaces';
+import { type RunCellParams } from '../schemas/runCell';
+/**
+ * Result from runCell operation (snake_case for outputs, matching MCP and existing tools).
+ */
+export interface RunCellResult {
+    success: boolean;
+    index?: number;
+    execution_count?: number | null;
+    outputs?: Array<string>;
+    elapsed_time?: number;
+    message?: string;
+    error?: string;
+    timeout?: boolean;
+}
+/**
+ * Executes a cell and displays its output.
+ */
+export declare const runCellOperation: ToolOperation<RunCellParams, RunCellResult>;