@datalayer/jupyter-react 1.1.8 → 1.1.9

package/lib/tools/core/formatter.js

@@ -0,0 +1,41 @@
+/*
+ * Copyright (c) 2021-2023 Datalayer, Inc.
+ *
+ * MIT License
+ */
+/**
+ * Response formatting utilities for tool operations.
+ * Supports JSON (default, structured) and TOON (human/LLM-readable).
+ *
+ * @module tools/core/formatter
+ */
+import { encode } from '@toon-format/toon';
+/**
+ * Format tool response based on requested format.
+ *
+ * @template T - Type of the data being formatted
+ * @param data - Tool result to format
+ * @param format - Desired output format ("toon" default, or "json")
+ * @returns Formatted response (string for TOON, object for JSON)
+ *
+ * @example
+ * ```typescript
+ * // TOON format (default) - returns human-readable string
+ * const toonResult = formatResponse({ success: true, cells: [...] });
+ * // Returns: "success: true\ncells:\n  - type: code\n    source: print('hello')\n..."
+ *
+ * // JSON format - returns structured object
+ * const jsonResult = formatResponse({ success: true, cells: [...] }, "json");
+ * // Returns: { success: true, cells: [...] }
+ * ```
+ */
+export function formatResponse(data, format) {
+    // Return JSON (structured object) if explicitly requested
+    if (format === 'json') {
+        return data;
+    }
+    // Default to TOON format - encode as human/LLM-readable string
+    // This is the default because most tool operations are called by LLMs
+    return encode(data);
+}
+//# sourceMappingURL=formatter.js.map

package/lib/tools/core/formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../../../src/tools/core/formatter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAO,EACP,MAAwB;IAExB,0DAA0D;IAC1D,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,+DAA+D;IAC/D,sEAAsE;IACtE,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC"}

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

@@ -0,0 +1,18 @@
+/**
+ * Core tool operations, interfaces, and utilities.
+ *
+ * @module tools/core
+ */
+export * from '../operations/insertCell';
+export * from '../operations/deleteCell';
+export * from '../operations/updateCell';
+export * from '../operations/readCell';
+export * from '../operations/readAllCells';
+export * from '../operations/runCell';
+export * from '../operations/executeCode';
+export * from './interfaces';
+export * from './formatter';
+export * from './executor';
+export * from './operationRunner';
+export * from './schema';
+export * from './types';

package/lib/tools/core/index.js

@@ -0,0 +1,24 @@
+/*
+ * Copyright (c) 2021-2023 Datalayer, Inc.
+ *
+ * MIT License
+ */
+/**
+ * Core tool operations, interfaces, and utilities.
+ *
+ * @module tools/core
+ */
+export * from '../operations/insertCell';
+export * from '../operations/deleteCell';
+export * from '../operations/updateCell';
+export * from '../operations/readCell';
+export * from '../operations/readAllCells';
+export * from '../operations/runCell';
+export * from '../operations/executeCode';
+export * from './interfaces';
+export * from './formatter';
+export * from './executor';
+export * from './operationRunner';
+export * from './schema';
+export * from './types';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/core/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AAEH,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAE1C,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}

package/lib/tools/core/interfaces.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Core interfaces for platform-agnostic tool operations.
+ *
+ * @module tools/core/interfaces
+ */
+import type { ToolExecutor } from './executor';
+/**
+ * Execution context for tool operations.
+ */
+export interface ToolExecutionContext {
+    /** Tool executor (DefaultExecutor, BridgeExecutor, etc.) */
+    executor: ToolExecutor;
+    /** Document identifier - universal for notebooks, lexicals, etc. (file URI or document UID) */
+    documentId?: string;
+    /** Response format: "json" (default) or "toon" */
+    format?: 'json' | 'toon';
+    /** Platform-specific additional context */
+    extras?: Record<string, unknown>;
+}
+/**
+ * Platform-agnostic tool operation interface.
+ *
+ * @template TParams - Tool parameter type
+ * @template TResult - Tool result type
+ */
+export interface ToolOperation<TParams, TResult> {
+    /** Operation name (matches ToolDefinition.operation field) */
+    name: string;
+    /**
+     * Execute the operation.
+     *
+     * @param params - Tool parameters
+     * @param context - Execution context
+     * @returns Operation result
+     */
+    execute(params: TParams, context: ToolExecutionContext): Promise<TResult>;
+}
+export type { ToolExecutor };

package/lib/tools/core/interfaces.js

@@ -0,0 +1,7 @@
+/*
+ * Copyright (c) 2021-2023 Datalayer, Inc.
+ *
+ * MIT License
+ */
+export {};
+//# sourceMappingURL=interfaces.js.map

package/lib/tools/core/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../src/tools/core/interfaces.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/lib/tools/core/operationRunner.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Operation runner that executes operations and applies formatting.
+ *
+ * @module tools/core/operationRunner
+ */
+import type { ToolOperation, ToolExecutionContext } from './interfaces';
+/**
+ * Executes tool operations and applies formatting to results.
+ *
+ * Operations return pure typed data. The runner applies formatting
+ * based on context.format:
+ * - 'json' → Returns structured object (TResult)
+ * - 'toon' → Returns TOON-encoded string
+ */
+export declare class OperationRunner {
+    /**
+     * Execute an operation and format its result.
+     *
+     * @template TParams - Operation parameter type
+     * @template TResult - Operation result type
+     * @param operation - Tool operation to execute
+     * @param params - Operation parameters
+     * @param context - Execution context
+     * @returns Formatted result (object or string based on context.format)
+     */
+    execute<TParams, TResult>(operation: ToolOperation<TParams, TResult>, params: TParams, context: ToolExecutionContext): Promise<TResult | string>;
+}

package/lib/tools/core/operationRunner.js

@@ -0,0 +1,33 @@
+/*
+ * Copyright (c) 2021-2023 Datalayer, Inc.
+ *
+ * MIT License
+ */
+import { formatResponse } from './formatter';
+/**
+ * Executes tool operations and applies formatting to results.
+ *
+ * Operations return pure typed data. The runner applies formatting
+ * based on context.format:
+ * - 'json' → Returns structured object (TResult)
+ * - 'toon' → Returns TOON-encoded string
+ */
+export class OperationRunner {
+    /**
+     * Execute an operation and format its result.
+     *
+     * @template TParams - Operation parameter type
+     * @template TResult - Operation result type
+     * @param operation - Tool operation to execute
+     * @param params - Operation parameters
+     * @param context - Execution context
+     * @returns Formatted result (object or string based on context.format)
+     */
+    async execute(operation, params, context) {
+        // Execute operation (returns pure typed data)
+        const result = await operation.execute(params, context);
+        // Apply formatting based on context.format
+        return formatResponse(result, context.format);
+    }
+}
+//# sourceMappingURL=operationRunner.js.map

package/lib/tools/core/operationRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operationRunner.js","sourceRoot":"","sources":["../../../src/tools/core/operationRunner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;;;;GAOG;AACH,MAAM,OAAO,eAAe;IAC1B;;;;;;;;;OASG;IACH,KAAK,CAAC,OAAO,CACX,SAA0C,EAC1C,MAAe,EACf,OAA6B;QAE7B,8CAA8C;QAC9C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAExD,2CAA2C;QAC3C,OAAO,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC;CACF"}

package/lib/tools/core/schema.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Platform-agnostic tool configuration and definition schemas.
+ *
+ * @module tools/core/schema
+ */
+/**
+ * Tool configuration interface.
+ */
+export interface ToolConfig<TParams = unknown> {
+    /** Confirmation message from parameters */
+    confirmationMessage?: (params: TParams) => string;
+    /** Invocation message from parameters */
+    invocationMessage?: (params: TParams) => string;
+    /** Require user confirmation */
+    requiresConfirmation?: boolean;
+    /** Can be referenced in prompts */
+    canBeReferencedInPrompt?: boolean;
+    /** Priority for suggestion ranking */
+    priority?: 'low' | 'medium' | 'high';
+    /** Platform-specific config extensions */
+    [key: string]: unknown;
+}
+/**
+ * Tool definition interface.
+ */
+export interface ToolDefinition<TParams = unknown> {
+    /** Vendor-prefixed tool name (e.g., "datalayer_insertCell") */
+    name: string;
+    /** Display name */
+    displayName: string;
+    /** User-facing reference name (e.g., "insertCell") */
+    toolReferenceName: string;
+    /** Tool description */
+    description: string;
+    /** JSON Schema for parameters */
+    parameters: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+    /** Operation handler name */
+    operation: string;
+    /** Tool configuration */
+    config?: ToolConfig<TParams>;
+    /** Categorization tags */
+    tags?: string[];
+}

package/lib/tools/core/schema.js

@@ -0,0 +1,7 @@
+/*
+ * Copyright (c) 2021-2023 Datalayer, Inc.
+ *
+ * MIT License
+ */
+export {};
+//# sourceMappingURL=schema.js.map

package/lib/tools/core/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/tools/core/schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/lib/tools/core/types.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Types for notebook tool operations.
+ *
+ * @module tools/core/types
+ */
+/**
+ * Cell format for controlling response detail level
+ */
+export type CellFormat = 'brief' | 'detailed';
+/**
+ * Brief cell representation for structure queries
+ * Includes index, type, and a 40-char content preview
+ */
+export interface BriefCell {
+    /** Cell index in notebook */
+    index: number;
+    /** Cell type (code, markdown, raw) */
+    type: string;
+    /** 40-character preview of cell source */
+    preview: string;
+}
+/**
+ * Detailed cell representation with full content
+ */
+export interface DetailedCell {
+    /** Cell index in notebook */
+    index: number;
+    /** Cell type (code, markdown, raw) */
+    type: string;
+    /** Full cell source code */
+    source: string;
+    /** Execution count for code cells */
+    execution_count?: number | null;
+    /** Cell outputs (for code cells) */
+    outputs?: string[];
+}

package/lib/tools/core/types.js

@@ -0,0 +1,7 @@
+/*
+ * Copyright (c) 2021-2023 Datalayer, Inc.
+ *
+ * MIT License
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/lib/tools/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/core/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/lib/tools/core/zodUtils.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Zod utility functions for tool parameter validation
+ *
+ * @module tools/core/zodUtils
+ */
+import { z } from 'zod';
+import type { ToolDefinition } from './schema';
+/**
+ * Converts a Zod schema to ToolDefinition parameters (JSON Schema format).
+ *
+ * This enables a single source of truth: define the schema once with Zod,
+ * and automatically generate the JSON Schema for LLM tool calling.
+ *
+ * @param schema - Zod schema defining the tool's input parameters
+ * @returns JSON Schema object compatible with ToolDefinition.parameters
+ *
+ * @example
+ * ```typescript
+ * const schema = z.object({
+ *   index: z.number().int().describe('Cell index'),
+ *   source: z.string().describe('Cell content')
+ * });
+ *
+ * const parameters = zodToToolParameters(schema);
+ * // Returns: { type: 'object', properties: {...}, required: [...] }
+ * ```
+ */
+export declare function zodToToolParameters(schema: any): ToolDefinition['parameters'];
+/**
+ * Validates parameters using a Zod schema with user-friendly error messages.
+ *
+ * This replaces manual type guard functions with automatic runtime validation.
+ * On validation failure, throws a descriptive error that helps both developers
+ * and LLMs understand what went wrong.
+ *
+ * @param schema - Zod schema to validate against
+ * @param params - Unknown parameters to validate
+ * @param operationName - Name of the operation (for error messages)
+ * @returns Validated parameters with proper TypeScript type
+ * @throws Error with detailed validation failure information
+ *
+ * @example
+ * ```typescript
+ * const schema = z.object({ index: z.number().int() });
+ *
+ * // Valid params
+ * const validated = validateWithZod(schema, { index: 5 }, 'readCell');
+ * // Returns: { index: 5 } with type { index: number }
+ *
+ * // Invalid params
+ * validateWithZod(schema, { index: 'invalid' }, 'readCell');
+ * // Throws: Error: Invalid parameters for readCell:
+ * //   - index: Expected number, received string
+ * ```
+ */
+export declare function validateWithZod<T>(schema: z.ZodType<T>, params: unknown, operationName: string): T;

package/lib/tools/core/zodUtils.js

@@ -0,0 +1,179 @@
+/*
+ * Copyright (c) 2021-2023 Datalayer, Inc.
+ *
+ * MIT License
+ */
+/**
+ * Zod utility functions for tool parameter validation
+ *
+ * @module tools/core/zodUtils
+ */
+import { z } from 'zod';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+/**
+ * Converts a Zod schema to ToolDefinition parameters (JSON Schema format).
+ *
+ * This enables a single source of truth: define the schema once with Zod,
+ * and automatically generate the JSON Schema for LLM tool calling.
+ *
+ * @param schema - Zod schema defining the tool's input parameters
+ * @returns JSON Schema object compatible with ToolDefinition.parameters
+ *
+ * @example
+ * ```typescript
+ * const schema = z.object({
+ *   index: z.number().int().describe('Cell index'),
+ *   source: z.string().describe('Cell content')
+ * });
+ *
+ * const parameters = zodToToolParameters(schema);
+ * // Returns: { type: 'object', properties: {...}, required: [...] }
+ * ```
+ */
+export function zodToToolParameters(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+schema) {
+    // Manual conversion for Zod v3/v4 compatibility
+    // zod-to-json-schema@3.x doesn't fully support Zod v4
+    // Handle both Zod v3 (_def.type === 'object') and Zod v4 (_def.typeName === 'ZodObject')
+    const isZodObject = schema?._def?.typeName === 'ZodObject' || schema?._def?.type === 'object';
+    if (isZodObject && schema._def?.shape) {
+        // Get shape object - handle both Zod v3 (shape is object) and Zod v4 (shape is function)
+        const shape = typeof schema._def.shape === 'function'
+            ? schema._def.shape()
+            : schema._def.shape;
+        const properties = {};
+        const required = [];
+        for (const [key, value] of Object.entries(shape)) {
+            let zodField = value;
+            // Build property schema
+            const prop = {};
+            // Unwrap optional/default modifiers to get to the base type
+            // Support both Zod v3 (def/def) and Zod v4 (_def)
+            let isOptional = false;
+            while (zodField._def?.typeName === 'ZodOptional' ||
+                zodField._def?.typeName === 'ZodDefault' ||
+                zodField._def?.type === 'optional' ||
+                zodField._def?.type === 'default' ||
+                zodField.def?.type === 'optional' ||
+                zodField.def?.type === 'default') {
+                if (zodField._def?.typeName === 'ZodOptional' ||
+                    zodField._def?.type === 'optional' ||
+                    zodField.def?.type === 'optional') {
+                    isOptional = true;
+                }
+                // Unwrap to get the inner type - try all possible paths
+                zodField =
+                    zodField._def?.innerType || zodField.def?.innerType || zodField;
+            }
+            // Extract description (check at each level)
+            // Support both Zod v3 (def.description) and Zod v4 (_def.description)
+            const description = value._def?.description ||
+                value.def?.description ||
+                value.description;
+            if (description) {
+                prop.description = description;
+            }
+            // Handle type based on unwrapped field
+            // Support both Zod v3 (def.type) and Zod v4 (_def.typeName or _def.type)
+            const typeName = zodField._def?.typeName || zodField._def?.type || zodField.def?.type;
+            if (typeName === 'ZodString' || typeName === 'string') {
+                prop.type = 'string';
+            }
+            else if (typeName === 'ZodNumber' || typeName === 'number') {
+                prop.type = 'number';
+            }
+            else if (typeName === 'ZodBoolean' || typeName === 'boolean') {
+                prop.type = 'boolean';
+            }
+            else if (typeName === 'ZodEnum' || typeName === 'enum') {
+                prop.type = 'string';
+                // Enum values can be in different places depending on Zod version:
+                // - Zod v4: _def.values (array)
+                // - Zod v3: def.entries (object), options (array), or enum (object)
+                const enumValues = zodField._def?.values ||
+                    zodField.def?.values ||
+                    zodField.options ||
+                    (zodField.def?.entries ? Object.keys(zodField.def.entries) : null) ||
+                    (zodField.enum ? Object.keys(zodField.enum) : null) ||
+                    [];
+                prop.enum = Array.isArray(enumValues)
+                    ? enumValues
+                    : Object.keys(enumValues || {});
+            }
+            properties[key] = prop;
+            // Mark as required if not optional
+            if (!isOptional) {
+                required.push(key);
+            }
+        }
+        return {
+            type: 'object',
+            properties,
+            required,
+        };
+    }
+    // Fallback to zod-to-json-schema for other schema types
+    // Note: This may not work correctly with Zod v4
+    const jsonSchema = zodToJsonSchema(schema, {
+        target: 'openApi3',
+        $refStrategy: 'none',
+    });
+    const schemaProperties = jsonSchema.properties || {};
+    const requiredFields = jsonSchema.required || [];
+    return {
+        type: 'object',
+        properties: schemaProperties,
+        required: requiredFields,
+    };
+}
+/**
+ * Validates parameters using a Zod schema with user-friendly error messages.
+ *
+ * This replaces manual type guard functions with automatic runtime validation.
+ * On validation failure, throws a descriptive error that helps both developers
+ * and LLMs understand what went wrong.
+ *
+ * @param schema - Zod schema to validate against
+ * @param params - Unknown parameters to validate
+ * @param operationName - Name of the operation (for error messages)
+ * @returns Validated parameters with proper TypeScript type
+ * @throws Error with detailed validation failure information
+ *
+ * @example
+ * ```typescript
+ * const schema = z.object({ index: z.number().int() });
+ *
+ * // Valid params
+ * const validated = validateWithZod(schema, { index: 5 }, 'readCell');
+ * // Returns: { index: 5 } with type { index: number }
+ *
+ * // Invalid params
+ * validateWithZod(schema, { index: 'invalid' }, 'readCell');
+ * // Throws: Error: Invalid parameters for readCell:
+ * //   - index: Expected number, received string
+ * ```
+ */
+export function validateWithZod(schema, params, operationName) {
+    try {
+        // Parse and validate parameters
+        return schema.parse(params);
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            // Convert Zod validation errors to user-friendly format
+            const issues = error.issues
+                .map(issue => {
+                // Build path string (e.g., "cells[0].type" for nested errors)
+                const path = issue.path.length > 0 ? issue.path.join('.') : 'root';
+                return `  - ${path}: ${issue.message}`;
+            })
+                .join('\n');
+            throw new Error(`Invalid parameters for ${operationName}:\n${issues}\n\n` +
+                `Received: ${JSON.stringify(params)}`);
+        }
+        // Re-throw non-Zod errors
+        throw error;
+    }
+}
+//# sourceMappingURL=zodUtils.js.map

package/lib/tools/core/zodUtils.js.map

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

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

@@ -0,0 +1,7 @@
+/**
+ * Delete cell tool definition.
+ *
+ * @module tools/definitions/deleteCell
+ */
+import type { ToolDefinition } from '../core/schema';
+export declare const deleteCellTool: ToolDefinition;

package/lib/tools/definitions/deleteCell.js

@@ -0,0 +1,25 @@
+/*
+ * Copyright (c) 2021-2023 Datalayer, Inc.
+ *
+ * MIT License
+ */
+import { zodToToolParameters } from '../core/zodUtils';
+import { deleteCellParamsSchema } from '../schemas/deleteCell';
+export const deleteCellTool = {
+    name: 'datalayer_deleteCell',
+    displayName: 'Delete Notebook Cell(s)',
+    toolReferenceName: 'deleteCell',
+    description: 'Deletes one or more cells from a Jupyter notebook at the specified indices. Cells are deleted in reverse order to prevent index shifting.',
+    // Generate parameters from Zod schema (single source of truth)
+    parameters: zodToToolParameters(deleteCellParamsSchema),
+    operation: 'deleteCell',
+    config: {
+        confirmationMessage: (params) => `Delete ${params.indices.length} cell${params.indices.length !== 1 ? 's' : ''} at ${params.indices.length === 1 ? `index ${params.indices[0]}` : `indices ${params.indices.join(', ')}`}?`,
+        invocationMessage: (params) => `Deleting ${params.indices.length} cell${params.indices.length !== 1 ? 's' : ''}`,
+        requiresConfirmation: true,
+        canBeReferencedInPrompt: true,
+        priority: 'medium',
+    },
+    tags: ['cell', 'notebook', 'manipulation', 'delete'],
+};
+//# sourceMappingURL=deleteCell.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deleteCell.js","sourceRoot":"","sources":["../../../src/tools/definitions/deleteCell.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE,yBAAyB;IACtC,iBAAiB,EAAE,YAAY;IAC/B,WAAW,EACT,2IAA2I;IAE7I,+DAA+D;IAC/D,UAAU,EAAE,mBAAmB,CAAC,sBAAsB,CAAC;IAEvD,SAAS,EAAE,YAAY;IAEvB,MAAM,EAAE;QACN,mBAAmB,EAAE,CAAC,MAA6B,EAAE,EAAE,CACrD,UAAU,MAAM,CAAC,OAAO,CAAC,MAAM,QAAQ,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG;QAC5L,iBAAiB,EAAE,CAAC,MAA6B,EAAE,EAAE,CACnD,YAAY,MAAM,CAAC,OAAO,CAAC,MAAM,QAAQ,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACnF,oBAAoB,EAAE,IAAI;QAC1B,uBAAuB,EAAE,IAAI;QAC7B,QAAQ,EAAE,QAAQ;KACnB;IAED,IAAI,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,cAAc,EAAE,QAAQ,CAAC;CACrD,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * Execute code tool definition.
+ *
+ * @module tools/definitions/executeCode
+ */
+import type { ToolDefinition } from '../core/schema';
+export declare const executeCodeTool: ToolDefinition;

package/lib/tools/definitions/executeCode.js

@@ -0,0 +1,33 @@
+/*
+ * Copyright (c) 2021-2023 Datalayer, Inc.
+ *
+ * MIT License
+ */
+import { zodToToolParameters } from '../core/zodUtils';
+import { executeCodeParamsSchema } from '../schemas/executeCode';
+export const executeCodeTool = {
+    name: 'datalayer_executeCode',
+    displayName: 'Execute Code in Kernel',
+    toolReferenceName: 'executeCode',
+    description: 'Execute code directly in the kernel (not saved to notebook) on the current activated notebook.\n\n' +
+        'Recommended to use in following cases:\n' +
+        '1. Execute Jupyter magic commands (e.g., %timeit, %pip install xxx)\n' +
+        '2. Performance profiling and debugging\n' +
+        '3. View intermediate variable values (e.g., print(xxx), df.head())\n' +
+        "4. Temporary calculations and quick tests (e.g., np.mean(df['xxx']))\n" +
+        '5. Execute Shell commands in Jupyter server (e.g., !git xxx)\n\n' +
+        'Under no circumstances should you use this tool to:\n' +
+        '1. Import new modules or perform variable assignments that affect subsequent Notebook execution\n' +
+        "2. Execute dangerous code that may harm the Jupyter server or the user's data without permission",
+    parameters: zodToToolParameters(executeCodeParamsSchema),
+    operation: 'executeCode',
+    config: {
+        confirmationMessage: (params) => `Execute code: ${params.code.substring(0, 50)}${params.code.length > 50 ? '...' : ''}?`,
+        invocationMessage: () => 'Executing code in kernel',
+        requiresConfirmation: false,
+        canBeReferencedInPrompt: true,
+        priority: 'high',
+    },
+    tags: ['kernel', 'notebook', 'execute', 'code', 'inspection', 'magic'],
+};
+//# sourceMappingURL=executeCode.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executeCode.js","sourceRoot":"","sources":["../../../src/tools/definitions/executeCode.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,MAAM,CAAC,MAAM,eAAe,GAAmB;IAC7C,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,wBAAwB;IACrC,iBAAiB,EAAE,aAAa;IAChC,WAAW,EACT,oGAAoG;QACpG,0CAA0C;QAC1C,uEAAuE;QACvE,0CAA0C;QAC1C,sEAAsE;QACtE,wEAAwE;QACxE,kEAAkE;QAClE,uDAAuD;QACvD,mGAAmG;QACnG,kGAAkG;IAEpG,UAAU,EAAE,mBAAmB,CAAC,uBAAuB,CAAC;IAExD,SAAS,EAAE,aAAa;IAExB,MAAM,EAAE;QACN,mBAAmB,EAAE,CAAC,MAAwB,EAAE,EAAE,CAChD,iBAAiB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG;QACzF,iBAAiB,EAAE,GAAG,EAAE,CAAC,0BAA0B;QACnD,oBAAoB,EAAE,KAAK;QAC3B,uBAAuB,EAAE,IAAI;QAC7B,QAAQ,EAAE,MAAM;KACjB;IAED,IAAI,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC;CACvE,CAAC"}