@datalayer/jupyter-react 1.1.7 → 1.1.9

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":"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"}

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"}

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

@@ -0,0 +1,24 @@
+/**
+ * Zod schema for insertCell operation parameters
+ *
+ * @module tools/schemas/insertCell
+ */
+import { z } from 'zod';
+/**
+ * Schema for insertCell parameters
+ *
+ * Validates cell type, source content, and optional insertion index.
+ */
+export declare const insertCellParamsSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        code: "code";
+        raw: "raw";
+        markdown: "markdown";
+    }>;
+    source: z.ZodString;
+    index: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * TypeScript type inferred from Zod schema.
+ */
+export type InsertCellParams = z.infer<typeof insertCellParamsSchema>;

package/lib/tools/schemas/insertCell.js

@@ -0,0 +1,29 @@
+/*
+ * Copyright (c) 2021-2023 Datalayer, Inc.
+ *
+ * MIT License
+ */
+/**
+ * Zod schema for insertCell operation parameters
+ *
+ * @module tools/schemas/insertCell
+ */
+import { z } from 'zod';
+/**
+ * Schema for insertCell parameters
+ *
+ * Validates cell type, source content, and optional insertion index.
+ */
+export const insertCellParamsSchema = z.object({
+    type: z
+        .enum(['code', 'markdown', 'raw'])
+        .describe("Cell type: 'code', 'markdown', or 'raw'"),
+    source: z.string().describe('Cell source content'),
+    index: z
+        .number()
+        .int()
+        .nonnegative()
+        .optional()
+        .describe('Insert position (0-based index). If omitted, cell is inserted at the end.'),
+});
+//# sourceMappingURL=insertCell.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"insertCell.js","sourceRoot":"","sources":["../../../src/tools/schemas/insertCell.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,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;SACjC,QAAQ,CAAC,yCAAyC,CAAC;IACtD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IAClD,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,WAAW,EAAE;SACb,QAAQ,EAAE;SACV,QAAQ,CACP,2EAA2E,CAC5E;CACJ,CAAC,CAAC"}

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

@@ -0,0 +1,19 @@
+/**
+ * Zod schema for readAllCells operation parameters
+ *
+ * @module tools/schemas/readAllCells
+ */
+import { z } from 'zod';
+/**
+ * Schema for readAllCells parameters
+ */
+export declare const readAllCellsParamsSchema: z.ZodObject<{
+    format: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+        brief: "brief";
+        detailed: "detailed";
+    }>>>;
+}, z.core.$strip>;
+/**
+ * TypeScript type inferred from Zod schema.
+ */
+export type ReadAllCellsParams = z.infer<typeof readAllCellsParamsSchema>;

package/lib/tools/schemas/readAllCells.js

@@ -0,0 +1,18 @@
+/*
+ * Copyright (c) 2021-2023 Datalayer, Inc.
+ *
+ * MIT License
+ */
+/**
+ * Zod schema for readAllCells operation parameters
+ *
+ * @module tools/schemas/readAllCells
+ */
+import { z } from 'zod';
+/**
+ * Schema for readAllCells parameters
+ */
+export const readAllCellsParamsSchema = z.object({
+    format: z.enum(['brief', 'detailed']).default('brief').optional(),
+});
+//# sourceMappingURL=readAllCells.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"readAllCells.js","sourceRoot":"","sources":["../../../src/tools/schemas/readAllCells.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE;CAClE,CAAC,CAAC"}

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

@@ -0,0 +1,19 @@
+/**
+ * Zod schema for readCell operation parameters
+ *
+ * @module tools/schemas/readCell
+ */
+import { z } from 'zod';
+/**
+ * Schema for readCell parameters
+ *
+ * Validates cell index and optional output inclusion flag.
+ */
+export declare const readCellParamsSchema: z.ZodObject<{
+    index: z.ZodNumber;
+    includeOutputs: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * TypeScript type inferred from Zod schema.
+ */
+export type ReadCellParams = z.infer<typeof readCellParamsSchema>;

package/lib/tools/schemas/readCell.js

@@ -0,0 +1,24 @@
+/*
+ * Copyright (c) 2021-2023 Datalayer, Inc.
+ *
+ * MIT License
+ */
+/**
+ * Zod schema for readCell operation parameters
+ *
+ * @module tools/schemas/readCell
+ */
+import { z } from 'zod';
+/**
+ * Schema for readCell parameters
+ *
+ * Validates cell index and optional output inclusion flag.
+ */
+export const readCellParamsSchema = z.object({
+    index: z.number().int().nonnegative().describe('Cell index (0-based)'),
+    includeOutputs: z
+        .boolean()
+        .optional()
+        .describe('Whether to include cell outputs in the response (default: true)'),
+});
+//# sourceMappingURL=readCell.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"readCell.js","sourceRoot":"","sources":["../../../src/tools/schemas/readCell.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IACtE,cAAc,EAAE,CAAC;SACd,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,iEAAiE,CAClE;CACJ,CAAC,CAAC"}

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

@@ -0,0 +1,21 @@
+/**
+ * Zod schema for runCell operation parameters
+ *
+ * @module tools/schemas/runCell
+ */
+import { z } from 'zod';
+/**
+ * Schema for runCell parameters
+ *
+ * Validates optional cell index, timeout, streaming, and progress interval settings.
+ */
+export declare const runCellParamsSchema: z.ZodObject<{
+    index: z.ZodOptional<z.ZodNumber>;
+    timeoutSeconds: z.ZodOptional<z.ZodNumber>;
+    stream: z.ZodOptional<z.ZodBoolean>;
+    progressInterval: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * TypeScript type inferred from Zod schema.
+ */
+export type RunCellParams = z.infer<typeof runCellParamsSchema>;

package/lib/tools/schemas/runCell.js

@@ -0,0 +1,39 @@
+/*
+ * Copyright (c) 2021-2023 Datalayer, Inc.
+ *
+ * MIT License
+ */
+/**
+ * Zod schema for runCell operation parameters
+ *
+ * @module tools/schemas/runCell
+ */
+import { z } from 'zod';
+/**
+ * Schema for runCell parameters
+ *
+ * Validates optional cell index, timeout, streaming, and progress interval settings.
+ */
+export const runCellParamsSchema = z.object({
+    index: z
+        .number()
+        .int()
+        .nonnegative()
+        .optional()
+        .describe('Cell index to execute (0-based). If omitted, executes the currently active cell.'),
+    timeoutSeconds: z
+        .number()
+        .positive()
+        .optional()
+        .describe('Execution timeout in seconds. If omitted, no timeout is enforced (normal Jupyter behavior).'),
+    stream: z
+        .boolean()
+        .optional()
+        .describe('Enable streaming progress updates (default: false)'),
+    progressInterval: z
+        .number()
+        .positive()
+        .optional()
+        .describe('Progress update interval in seconds when stream=true (default: 5)'),
+});
+//# sourceMappingURL=runCell.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runCell.js","sourceRoot":"","sources":["../../../src/tools/schemas/runCell.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,WAAW,EAAE;SACb,QAAQ,EAAE;SACV,QAAQ,CACP,kFAAkF,CACnF;IACH,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CACP,6FAA6F,CAC9F;IACH,MAAM,EAAE,CAAC;SACN,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,oDAAoD,CAAC;IACjE,gBAAgB,EAAE,CAAC;SAChB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CACP,mEAAmE,CACpE;CACJ,CAAC,CAAC"}

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

@@ -0,0 +1,19 @@
+/**
+ * Zod schema for updateCell operation parameters
+ *
+ * @module tools/schemas/updateCell
+ */
+import { z } from 'zod';
+/**
+ * Schema for updateCell parameters
+ *
+ * Validates cell index and new source content.
+ */
+export declare const updateCellParamsSchema: z.ZodObject<{
+    index: z.ZodNumber;
+    source: z.ZodString;
+}, z.core.$strip>;
+/**
+ * TypeScript type inferred from Zod schema.
+ */
+export type UpdateCellParams = z.infer<typeof updateCellParamsSchema>;

package/lib/tools/schemas/updateCell.js

@@ -0,0 +1,21 @@
+/*
+ * Copyright (c) 2021-2023 Datalayer, Inc.
+ *
+ * MIT License
+ */
+/**
+ * Zod schema for updateCell operation parameters
+ *
+ * @module tools/schemas/updateCell
+ */
+import { z } from 'zod';
+/**
+ * Schema for updateCell parameters
+ *
+ * Validates cell index and new source content.
+ */
+export const updateCellParamsSchema = z.object({
+    index: z.number().int().nonnegative().describe('Cell index (0-based)'),
+    source: z.string().describe('New cell source content'),
+});
+//# sourceMappingURL=updateCell.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"updateCell.js","sourceRoot":"","sources":["../../../src/tools/schemas/updateCell.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,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IACtE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;CACvD,CAAC,CAAC"}