@datalayer/jupyter-react 1.1.8 → 1.2.0

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>;

package/lib/tools/operations/runCell.js

@@ -0,0 +1,124 @@
+/*
+ * Copyright (c) 2021-2023 Datalayer, Inc.
+ *
+ * MIT License
+ */
+import { readAllCellsOperation } from './readAllCells';
+import { validateWithZod } from '../core/zodUtils';
+import { runCellParamsSchema } from '../schemas/runCell';
+/**
+ * Executes a cell and displays its output.
+ */
+export const runCellOperation = {
+    name: 'runCell',
+    async execute(params, context) {
+        // Validate params using Zod schema
+        const { index, timeoutSeconds, stream = false, progressInterval = 5, } = validateWithZod(runCellParamsSchema, 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 runCell operation. ' +
+                'This should be provided by the platform (DefaultExecutor, BridgeExecutor, etc.)');
+        }
+        const startTime = Date.now();
+        try {
+            // If index is provided, validate that it's within bounds
+            if (index !== undefined) {
+                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
+                if (index < 0 || index >= cellCount) {
+                    return {
+                        success: false,
+                        error: `Index ${index} is out of bounds. The notebook has ${cellCount} cell${cellCount !== 1 ? 's' : ''} (valid indices: 0-${cellCount - 1}).`,
+                    };
+                }
+            }
+            // Call executor with timeout and streaming parameters
+            const executionPromise = context.executor.execute(this.name, {
+                index,
+                timeoutSeconds,
+                stream,
+                progressInterval,
+            });
+            // Only enforce timeout if explicitly provided
+            let result;
+            if (timeoutSeconds !== undefined) {
+                // Wrap execution with timeout
+                const timeoutPromise = new Promise((_, reject) => {
+                    setTimeout(() => {
+                        reject(new Error(`TIMEOUT_ERROR: Cell execution exceeded ${timeoutSeconds} seconds`));
+                    }, timeoutSeconds * 1000);
+                });
+                // Race between execution and timeout
+                result = await Promise.race([executionPromise, timeoutPromise]);
+            }
+            else {
+                // No timeout - wait indefinitely (normal Jupyter behavior)
+                result = await executionPromise;
+            }
+            // Calculate elapsed time
+            const elapsed_time = (Date.now() - startTime) / 1000;
+            // Extract outputs from result
+            const executionResult = result;
+            const message = index !== undefined
+                ? `Cell at index ${index} executed in ${elapsed_time.toFixed(2)}s`
+                : `Active cell executed in ${elapsed_time.toFixed(2)}s`;
+            return {
+                success: true,
+                index,
+                execution_count: executionResult.execution_count ?? null,
+                outputs: executionResult.outputs ?? [],
+                elapsed_time,
+                message,
+            };
+        }
+        catch (error) {
+            const elapsed_time = (Date.now() - startTime) / 1000;
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            // Check if this is a timeout error
+            if (errorMessage.includes('TIMEOUT_ERROR')) {
+                // Try to get partial outputs
+                let partialOutputs = [];
+                try {
+                    const cellData = await context.executor.execute('readCell', {
+                        index,
+                        includeOutputs: true,
+                    });
+                    if (cellData &&
+                        typeof cellData === 'object' &&
+                        'outputs' in cellData) {
+                        partialOutputs =
+                            cellData.outputs ?? [];
+                    }
+                }
+                catch {
+                    // Ignore errors reading partial outputs
+                }
+                return {
+                    success: false,
+                    timeout: true,
+                    index,
+                    outputs: [
+                        `[TIMEOUT ERROR: Cell execution exceeded ${timeoutSeconds} seconds. Partial outputs may be available.]`,
+                        ...partialOutputs,
+                    ],
+                    elapsed_time,
+                    error: `Execution timed out after ${timeoutSeconds} seconds`,
+                };
+            }
+            // Regular error (not timeout)
+            throw new Error(`Failed to run cell: ${errorMessage}`);
+        }
+    },
+};
+//# sourceMappingURL=runCell.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runCell.js","sourceRoot":"","sources":["../../../src/tools/operations/runCell.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAsB,MAAM,oBAAoB,CAAC;AAgB7E;;GAEG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAgD;IAC3E,IAAI,EAAE,SAAS;IAEf,KAAK,CAAC,OAAO,CACX,MAAe,EACf,OAA6B;QAE7B,mCAAmC;QACnC,MAAM,EACJ,KAAK,EACL,cAAc,EACd,MAAM,GAAG,KAAK,EACd,gBAAgB,GAAG,CAAC,GACrB,GAAG,eAAe,CAAC,mBAAmB,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5D,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,8CAA8C;gBAC5C,iFAAiF,CACpF,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,IAAI,CAAC;YACH,yDAAyD;YACzD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,MAAM,WAAW,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;gBAErE,IAAI,CAAC,WAAW,CAAC,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;oBAC/C,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;gBAChE,CAAC;gBAED,MAAM,SAAS,GAAG,WAAW,CAAC,SAAS,IAAI,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC;gBAEpE,wBAAwB;gBACxB,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,IAAI,SAAS,EAAE,CAAC;oBACpC,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,SAAS,KAAK,uCAAuC,SAAS,QAAQ,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,sBAAsB,SAAS,GAAG,CAAC,IAAI;qBAC/I,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,sDAAsD;YACtD,MAAM,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE;gBAC3D,KAAK;gBACL,cAAc;gBACd,MAAM;gBACN,gBAAgB;aACjB,CAAC,CAAC;YAEH,8CAA8C;YAC9C,IAAI,MAAM,CAAC;YACX,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;gBACjC,8BAA8B;gBAC9B,MAAM,cAAc,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;oBACtD,UAAU,CAAC,GAAG,EAAE;wBACd,MAAM,CACJ,IAAI,KAAK,CACP,0CAA0C,cAAc,UAAU,CACnE,CACF,CAAC;oBACJ,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC,CAAC;gBAC5B,CAAC,CAAC,CAAC;gBAEH,qCAAqC;gBACrC,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC,CAAC;YAClE,CAAC;iBAAM,CAAC;gBACN,2DAA2D;gBAC3D,MAAM,GAAG,MAAM,gBAAgB,CAAC;YAClC,CAAC;YAED,yBAAyB;YACzB,MAAM,YAAY,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC;YAErD,8BAA8B;YAC9B,MAAM,eAAe,GAAG,MAGvB,CAAC;YAEF,MAAM,OAAO,GACX,KAAK,KAAK,SAAS;gBACjB,CAAC,CAAC,iBAAiB,KAAK,gBAAgB,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;gBAClE,CAAC,CAAC,2BAA2B,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;YAE5D,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,KAAK;gBACL,eAAe,EAAE,eAAe,CAAC,eAAe,IAAI,IAAI;gBACxD,OAAO,EAAE,eAAe,CAAC,OAAO,IAAI,EAAE;gBACtC,YAAY;gBACZ,OAAO;aACR,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC;YACrD,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAEzD,mCAAmC;YACnC,IAAI,YAAY,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;gBAC3C,6BAA6B;gBAC7B,IAAI,cAAc,GAAkB,EAAE,CAAC;gBACvC,IAAI,CAAC;oBACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE;wBAC1D,KAAK;wBACL,cAAc,EAAE,IAAI;qBACrB,CAAC,CAAC;oBACH,IACE,QAAQ;wBACR,OAAO,QAAQ,KAAK,QAAQ;wBAC5B,SAAS,IAAI,QAAQ,EACrB,CAAC;wBACD,cAAc;4BACX,QAAwC,CAAC,OAAO,IAAI,EAAE,CAAC;oBAC5D,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,wCAAwC;gBAC1C,CAAC;gBAED,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,OAAO,EAAE,IAAI;oBACb,KAAK;oBACL,OAAO,EAAE;wBACP,2CAA2C,cAAc,8CAA8C;wBACvG,GAAG,cAAc;qBAClB;oBACD,YAAY;oBACZ,KAAK,EAAE,6BAA6B,cAAc,UAAU;iBAC7D,CAAC;YACJ,CAAC;YAED,8BAA8B;YAC9B,MAAM,IAAI,KAAK,CAAC,uBAAuB,YAAY,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,27 @@
+/**
+ * Platform-agnostic cell update operation.
+ *
+ * @module tools/operations/updateCell
+ */
+import type { ToolOperation } from '../core/interfaces';
+import { type UpdateCellParams } from '../schemas/updateCell';
+/**
+ * Result from updateCell operation.
+ */
+export interface UpdateCellResult {
+    success: boolean;
+    message: string;
+    diff?: string;
+}
+/**
+ * Updates cell source content at the specified index.
+ *
+ * @example
+ * ```typescript
+ * await updateCellOperation.execute(
+ *   { index: 0, source: 'print("Updated")' },
+ *   { documentId: 'file:///notebook.ipynb', executor }
+ * );
+ * ```
+ */
+export declare const updateCellOperation: ToolOperation<UpdateCellParams, UpdateCellResult>;

package/lib/tools/operations/updateCell.js

@@ -0,0 +1,53 @@
+/*
+ * Copyright (c) 2021-2023 Datalayer, Inc.
+ *
+ * MIT License
+ */
+import { validateWithZod } from '../core/zodUtils';
+import { updateCellParamsSchema, } from '../schemas/updateCell';
+/**
+ * Updates cell source content at the specified index.
+ *
+ * @example
+ * ```typescript
+ * await updateCellOperation.execute(
+ *   { index: 0, source: 'print("Updated")' },
+ *   { documentId: 'file:///notebook.ipynb', executor }
+ * );
+ * ```
+ */
+export const updateCellOperation = {
+    name: 'updateCell',
+    async execute(params, context) {
+        // Validate params using Zod schema
+        const { index, source } = validateWithZod(updateCellParamsSchema, params, this.name);
+        const { documentId } = context;
+        if (!documentId) {
+            throw new Error('Document ID is required for updateCell operation.');
+        }
+        if (!context.executor) {
+            throw new Error('Executor is required for updateCell operation.');
+        }
+        try {
+            // Call executor - adapter returns diff string
+            const diff = (await context.executor.execute(this.name, {
+                index,
+                source,
+            }));
+            // Format message like MCP server
+            const message = diff
+                ? `Cell ${index} overwritten successfully:\n\n\`\`\`diff\n${diff}\n\`\`\``
+                : `Cell ${index} overwritten successfully - no changes detected`;
+            return {
+                success: true,
+                message,
+                diff,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to update cell: ${errorMessage}`);
+        }
+    },
+};
+//# sourceMappingURL=updateCell.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"updateCell.js","sourceRoot":"","sources":["../../../src/tools/operations/updateCell.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EACL,sBAAsB,GAEvB,MAAM,uBAAuB,CAAC;AAW/B;;;;;;;;;;GAUG;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAG5B;IACF,IAAI,EAAE,YAAY;IAElB,KAAK,CAAC,OAAO,CACX,MAAe,EACf,OAA6B;QAE7B,mCAAmC;QACnC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,eAAe,CACvC,sBAAsB,EACtB,MAAM,EACN,IAAI,CAAC,IAAI,CACV,CAAC;QACF,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;QAE/B,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,CAAC;QAED,IAAI,CAAC;YACH,8CAA8C;YAC9C,MAAM,IAAI,GAAG,CAAC,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE;gBACtD,KAAK;gBACL,MAAM;aACP,CAAC,CAAW,CAAC;YAEd,iCAAiC;YACjC,MAAM,OAAO,GAAG,IAAI;gBAClB,CAAC,CAAC,QAAQ,KAAK,6CAA6C,IAAI,UAAU;gBAC1E,CAAC,CAAC,QAAQ,KAAK,iDAAiD,CAAC;YAEnE,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO;gBACP,IAAI;aACL,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,0BAA0B,YAAY,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,20 @@
+/**
+ * Zod schema for deleteCell operation parameters
+ *
+ * @module tools/schemas/deleteCell
+ */
+import { z } from 'zod';
+/**
+ * Schema for deleteCell parameters
+ *
+ * Validates that indices is a non-empty array of non-negative integers.
+ */
+export declare const deleteCellParamsSchema: z.ZodObject<{
+    indices: z.ZodArray<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * TypeScript type inferred from Zod schema.
+ *
+ * This replaces the manual interface definition and is guaranteed to stay in sync with the schema.
+ */
+export type DeleteCellParams = z.infer<typeof deleteCellParamsSchema>;

package/lib/tools/schemas/deleteCell.js

@@ -0,0 +1,24 @@
+/*
+ * Copyright (c) 2021-2023 Datalayer, Inc.
+ *
+ * MIT License
+ */
+/**
+ * Zod schema for deleteCell operation parameters
+ *
+ * @module tools/schemas/deleteCell
+ */
+import { z } from 'zod';
+/**
+ * Schema for deleteCell parameters
+ *
+ * Validates that indices is a non-empty array of non-negative integers.
+ */
+export const deleteCellParamsSchema = z.object({
+    indices: z
+        .array(z.number().int().nonnegative())
+        .min(1)
+        .describe('Array of cell indices (0-based) to delete. ' +
+        'Cells will be deleted in reverse order (highest index first) to prevent index shifting.'),
+});
+//# sourceMappingURL=deleteCell.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deleteCell.js","sourceRoot":"","sources":["../../../src/tools/schemas/deleteCell.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,OAAO,EAAE,CAAC;SACP,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;SACrC,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,6CAA6C;QAC3C,yFAAyF,CAC5F;CACJ,CAAC,CAAC"}

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

@@ -0,0 +1,19 @@
+/**
+ * Zod schema for executeCode operation parameters
+ *
+ * @module tools/schemas/executeCode
+ */
+import { z } from 'zod';
+/**
+ * Schema for executeCode parameters
+ *
+ * Validates code string and optional timeout with range constraint.
+ */
+export declare const executeCodeParamsSchema: z.ZodObject<{
+    code: z.ZodString;
+    timeout: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * TypeScript type inferred from Zod schema.
+ */
+export type ExecuteCodeParams = z.infer<typeof executeCodeParamsSchema>;

package/lib/tools/schemas/executeCode.js

@@ -0,0 +1,28 @@
+/*
+ * Copyright (c) 2021-2023 Datalayer, Inc.
+ *
+ * MIT License
+ */
+/**
+ * Zod schema for executeCode operation parameters
+ *
+ * @module tools/schemas/executeCode
+ */
+import { z } from 'zod';
+/**
+ * Schema for executeCode parameters
+ *
+ * Validates code string and optional timeout with range constraint.
+ */
+export const executeCodeParamsSchema = z.object({
+    code: z
+        .string()
+        .describe('Code to execute (supports magic commands with %, shell commands with !)'),
+    timeout: z
+        .number()
+        .min(0)
+        .max(60)
+        .optional()
+        .describe('Execution timeout in seconds (default: 30, maximum: 60)'),
+});
+//# sourceMappingURL=executeCode.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executeCode.js","sourceRoot":"","sources":["../../../src/tools/schemas/executeCode.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,CACP,yEAAyE,CAC1E;IACH,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,EAAE;SACV,QAAQ,CAAC,yDAAyD,CAAC;CACvE,CAAC,CAAC"}

package/lib/tools/schemas/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Central export for all tool parameter schemas.
+ *
+ * @module tools/schemas
+ */
+export * from './deleteCell';
+export * from './insertCell';
+export * from './updateCell';
+export * from './readCell';
+export * from './executeCode';
+export * from './runCell';
+export * from './readAllCells';

package/lib/tools/schemas/index.js

@@ -0,0 +1,18 @@
+/*
+ * Copyright (c) 2021-2023 Datalayer, Inc.
+ *
+ * MIT License
+ */
+/**
+ * Central export for all tool parameter schemas.
+ *
+ * @module tools/schemas
+ */
+export * from './deleteCell';
+export * from './insertCell';
+export * from './updateCell';
+export * from './readCell';
+export * from './executeCode';
+export * from './runCell';
+export * from './readAllCells';
+//# sourceMappingURL=index.js.map

package/lib/tools/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC"}