@datalayer/core 0.0.19 → 0.0.21

package/lib/tools/adapters/agui/AgUIToolAdapter.d.ts

@@ -1,75 +0,0 @@
-/**
- * ag-ui/CopilotKit Tool Adapter
- *
- * Converts unified tool definitions to CopilotKit's useCopilotAction format.
- *
- * @see https://docs.copilotkit.ai/langgraph/frontend-actions
- * @module tools/adapters/agui/AgUIToolAdapter
- */
-import type { ToolDefinition, ToolOperation, ToolExecutionContext } from '@datalayer/jupyter-react';
-/**
- * Type signature for CopilotKit's useFrontendTool hook
- * This is shared across both notebook and lexical adapters
- */
-export type UseFrontendToolFn = (tool: {
-    name: string;
-    description: string;
-    parameters: any;
-    handler: (params: any) => Promise<string>;
-    render?: (props: any) => any;
-}, dependencies?: any[]) => void;
-/**
- * Component to register a single action with CopilotKit
- * Must be used inside CopilotKit context
- */
-export declare function ActionRegistrar({ action, useFrontendTool, }: {
-    action: any;
-    useFrontendTool: UseFrontendToolFn;
-}): null;
-/**
- * CopilotKit parameter definition (array format, not JSON Schema)
- */
-export interface CopilotKitParameter {
-    name: string;
-    type?: 'string' | 'number' | 'boolean' | 'object' | 'object[]';
-    description?: string;
-    required?: boolean;
-    attributes?: CopilotKitParameter[];
-}
-/**
- * CopilotKit action definition (matches useCopilotAction interface)
- */
-export interface CopilotKitAction {
-    /** Action name */
-    name: string;
-    /** Description for AI model */
-    description: string;
-    /** Parameters array (NOT JSON Schema) */
-    parameters: CopilotKitParameter[];
-    /** Handler function */
-    handler: (params: unknown) => Promise<string>;
-    /** Optional custom UI renderer */
-    render?: (props: {
-        status: string;
-        args: unknown;
-        result: unknown;
-    }) => React.ReactNode;
-}
-/**
- * Converts unified tool definition to CopilotKit action format
- *
- * @param definition - Tool definition
- * @param operation - Core operation
- * @param context - Execution context (documentId + executor)
- * @returns CopilotKit action
- */
-export declare function createCopilotKitAction(definition: ToolDefinition, operation: ToolOperation<unknown, unknown>, context: ToolExecutionContext): CopilotKitAction;
-/**
- * Creates CopilotKit actions from all tool definitions
- *
- * @param definitions - Tool definitions
- * @param operations - Core operations registry
- * @param context - Execution context (documentId + executor)
- * @returns CopilotKit actions
- */
-export declare function createAllCopilotKitActions(definitions: ToolDefinition[], operations: Record<string, ToolOperation<unknown, unknown>>, context: ToolExecutionContext): CopilotKitAction[];

package/lib/tools/adapters/agui/AgUIToolAdapter.js

@@ -1,244 +0,0 @@
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-import { OperationRunner } from '@datalayer/jupyter-react';
-/**
- * Component to register a single action with CopilotKit
- * Must be used inside CopilotKit context
- */
-export function ActionRegistrar({ action, useFrontendTool, }) {
-    useFrontendTool(action, [action]);
-    return null;
-}
-/**
- * Deduplication cache to prevent executing the same operation multiple times
- * Maps operation signature (hash of tool + params) to timestamp
- */
-const executionCache = new Map();
-const CACHE_TTL_MS = 2000; // 2 seconds - operations within this window are considered duplicates
-/**
- * Generate a unique signature for an operation call
- */
-function getOperationSignature(toolName, params) {
-    return `${toolName}:${JSON.stringify(params)}`;
-}
-/**
- * Check if this operation was recently executed
- */
-function isRecentDuplicate(toolName, params) {
-    const signature = getOperationSignature(toolName, params);
-    const lastExecution = executionCache.get(signature);
-    if (lastExecution) {
-        const timeSinceExecution = Date.now() - lastExecution;
-        if (timeSinceExecution < CACHE_TTL_MS) {
-            console.log(`[ag-ui] 🚫 DUPLICATE DETECTED - Skipping execution (${timeSinceExecution}ms since last call)`);
-            return true;
-        }
-    }
-    // Clean up old entries while we're here
-    for (const [key, timestamp] of executionCache.entries()) {
-        if (Date.now() - timestamp > CACHE_TTL_MS * 2) {
-            executionCache.delete(key);
-        }
-    }
-    // Mark this execution
-    executionCache.set(signature, Date.now());
-    return false;
-}
-/**
- * Parses array parameters from CopilotKit's string format to actual arrays.
- *
- * CopilotKit doesn't have native support for primitive arrays, so it sends them
- * as JSON strings (e.g., "[1, 2, 3]"). This function parses those strings back
- * into actual arrays based on the schema definition.
- *
- * @param params - Raw parameters from CopilotKit
- * @param jsonSchema - JSON Schema definition to identify array parameters
- * @returns Parsed parameters with arrays converted from strings
- */
-function parseArrayParameters(params, jsonSchema) {
-    if (typeof params !== 'object' || params === null) {
-        return params;
-    }
-    const parsedParams = { ...params };
-    // Iterate through schema properties to find array types
-    for (const [name, schema] of Object.entries(jsonSchema.properties || {})) {
-        const propSchema = schema;
-        // If this property is an array type and the value is a string, parse it
-        if (propSchema.type === 'array' && typeof parsedParams[name] === 'string') {
-            try {
-                const parsed = JSON.parse(parsedParams[name]);
-                // Validate it's actually an array after parsing
-                if (Array.isArray(parsed)) {
-                    parsedParams[name] = parsed;
-                }
-            }
-            catch (error) {
-                // If parsing fails, log warning but keep original value
-                console.warn(`[ag-ui] Failed to parse array parameter "${name}":`, error);
-            }
-        }
-    }
-    return parsedParams;
-}
-/**
- * Converts JSON Schema to CopilotKit parameter array format
- *
- * @param jsonSchema - JSON Schema parameters object
- * @returns CopilotKit parameters array
- */
-function jsonSchemaToParameters(jsonSchema) {
-    const parameters = [];
-    const required = jsonSchema.required || [];
-    for (const [name, schema] of Object.entries(jsonSchema.properties || {})) {
-        const propSchema = schema;
-        // Map JSON Schema type to CopilotKit type
-        let copilotType = 'string';
-        if (propSchema.type === 'array') {
-            // Handle array types based on items type
-            const itemsType = propSchema.items?.type;
-            if (itemsType === 'object') {
-                copilotType = 'object[]';
-            }
-            else {
-                // For primitive arrays (number[], string[], etc.)
-                // CopilotKit doesn't have explicit support, but we can use the description
-                // to clarify and handle parsing in the handler
-                copilotType = 'string'; // Will be parsed as JSON array string
-                // Enhance description to clarify it's an array
-                propSchema.description =
-                    `${propSchema.description || ''} (JSON array of ${itemsType || 'values'})`.trim();
-            }
-        }
-        else {
-            // Original logic for non-array types
-            copilotType =
-                propSchema.type || 'string';
-        }
-        const param = {
-            name,
-            type: copilotType,
-            description: propSchema.description,
-            required: required.includes(name),
-        };
-        // Handle nested object properties (for object types)
-        if (propSchema.type === 'object' && propSchema.properties) {
-            // Cast to proper type for recursive call
-            param.attributes = jsonSchemaToParameters({
-                type: 'object',
-                properties: propSchema.properties, // eslint-disable-line @typescript-eslint/no-explicit-any
-                required: propSchema.required || [],
-            });
-        }
-        parameters.push(param);
-    }
-    console.log('[ag-ui] Converted parameters:', JSON.stringify(parameters, null, 2));
-    return parameters;
-}
-/**
- * Converts unified tool definition to CopilotKit action format
- *
- * @param definition - Tool definition
- * @param operation - Core operation
- * @param context - Execution context (documentId + executor)
- * @returns CopilotKit action
- */
-export function createCopilotKitAction(definition, operation, context) {
-    // Create runner instance for this action
-    const runner = new OperationRunner();
-    const action = {
-        name: definition.toolReferenceName || definition.name,
-        description: definition.description,
-        parameters: jsonSchemaToParameters(definition.parameters),
-        // CRITICAL FIX: Set to true to enable CopilotKit's deduplication mechanism
-        // See https://github.com/CopilotKit/CopilotKit/issues/2310
-        // Without this, actions get re-executed cumulatively (A → A,B → A,B,C)
-        _isRenderAndWait: true,
-        handler: async (params) => {
-            console.log(`[ag-ui] ========== HANDLER CALLED ==========`);
-            console.log(`[ag-ui] Tool: ${definition.name}`);
-            console.log(`[ag-ui] Operation: ${definition.operation}`);
-            console.log(`[ag-ui] Params:`, params);
-            console.log(`[ag-ui] Context:`, context);
-            // Check for duplicate execution
-            const signature = `${definition.name}:${JSON.stringify(params)}`;
-            console.log(`[ag-ui] 🔍 Signature:`, signature.substring(0, 150));
-            if (isRecentDuplicate(definition.name, params)) {
-                console.log(`[ag-ui] 🚫 DUPLICATE DETECTED - Returning early`);
-                return 'Operation already executed recently (duplicate detected and skipped)';
-            }
-            console.log(`[ag-ui] ✅ NOT a duplicate - Proceeding with execution`);
-            try {
-                // Parse array parameters that CopilotKit sends as JSON strings
-                // CopilotKit doesn't have native support for primitive arrays, so they're sent as strings
-                const parsedParams = parseArrayParameters(params, definition.parameters);
-                console.log(`[ag-ui] Calling runner.execute with TOON format...`);
-                console.log(`[ag-ui] Operation name:`, operation);
-                console.log(`[ag-ui] Parsed params being passed:`, JSON.stringify(parsedParams, null, 2));
-                console.log(`[ag-ui] Context being passed:`, JSON.stringify(context, null, 2));
-                // Use OperationRunner to execute operation with TOON format
-                // TOON format returns human/LLM-readable string (default)
-                const result = await runner.execute(operation, parsedParams, {
-                    ...context,
-                    format: 'toon', // CopilotKit expects string responses
-                });
-                console.log(`[ag-ui] Operation result:`, result);
-                // Result is already a string (TOON format)
-                if (typeof result === 'string') {
-                    return result;
-                }
-                // Fallback: if somehow we got an object (shouldn't happen with format='toon')
-                if (typeof result === 'object' && result !== null) {
-                    const resultObj = result;
-                    // Return success message if available
-                    if (resultObj.message) {
-                        return resultObj.message;
-                    }
-                    // Return error if failed
-                    if (resultObj.success === false && resultObj.error) {
-                        return `❌ Error: ${resultObj.error}`;
-                    }
-                    // Otherwise format as JSON
-                    return JSON.stringify(result, null, 2);
-                }
-                return String(result);
-            }
-            catch (error) {
-                console.error(`[ag-ui] ❌ ERROR in handler:`, error);
-                console.error(`[ag-ui] Error stack:`, error instanceof Error ? error.stack : 'N/A');
-                const errorMessage = error instanceof Error ? error.message : String(error);
-                return `❌ Error: ${errorMessage}`;
-            }
-        },
-        // Optional: Custom render function for ag-ui
-        // Note: config supports platform-specific extensions, cast to any for flexibility
-        render: definition.config?.agui?.renderingHints?.customRender
-            ? definition.config.agui.renderingHints
-                .customRender
-            : undefined,
-    };
-    return action;
-}
-/**
- * Creates CopilotKit actions from all tool definitions
- *
- * @param definitions - Tool definitions
- * @param operations - Core operations registry
- * @param context - Execution context (documentId + executor)
- * @returns CopilotKit actions
- */
-export function createAllCopilotKitActions(definitions, operations, context) {
-    const actions = [];
-    for (const definition of definitions) {
-        const operation = operations[definition.operation];
-        if (!operation) {
-            console.warn(`[ag-ui Tools] No operation found for ${definition.name} (operation: ${definition.operation})`);
-            continue;
-        }
-        const action = createCopilotKitAction(definition, operation, context);
-        actions.push(action);
-    }
-    console.log(`[ag-ui Tools] Created ${actions.length} CopilotKit actions`);
-    return actions;
-}

package/lib/tools/adapters/agui/index.d.ts

@@ -1,10 +0,0 @@
-/**
- * ag-ui/CopilotKit adapter module.
- * Exports: CopilotKit adapters, hooks (useNotebookToolActions, useLexicalToolActions).
- * Note: DefaultExecutor is imported from datalayer-react/tools/core/executor
- *
- * @module tools/adapters/agui
- */
-export * from './AgUIToolAdapter';
-export * from './notebookHooks';
-export * from './lexicalHooks';

package/lib/tools/adapters/agui/index.js

@@ -1,19 +0,0 @@
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-/*
- * Copyright (c) 2021-2025 Datalayer, Inc.
- *
- * MIT License
- */
-/**
- * ag-ui/CopilotKit adapter module.
- * Exports: CopilotKit adapters, hooks (useNotebookToolActions, useLexicalToolActions).
- * Note: DefaultExecutor is imported from datalayer-react/tools/core/executor
- *
- * @module tools/adapters/agui
- */
-export * from './AgUIToolAdapter';
-export * from './notebookHooks';
-export * from './lexicalHooks';

package/lib/tools/adapters/agui/lexicalHooks.d.ts

@@ -1,27 +0,0 @@
-import { createAllCopilotKitActions, ActionRegistrar, type UseFrontendToolFn } from './AgUIToolAdapter';
-type ToolExecutionContext = any;
-export { ActionRegistrar, type UseFrontendToolFn };
-/**
- * Hook that creates CopilotKit actions for lexical tools.
- * Returns stable actions array that won't cause re-renders.
- *
- * @param documentId - Document ID (lexical document identifier)
- * @param contextOverrides - Optional context overrides (format, extras, etc.)
- * @returns CopilotKit actions
- *
- * @example
- * ```typescript
- * // Default context (toon format for AI)
- * const actions = useLexicalToolActions("doc-123");
- *
- * // Custom format
- * const actions = useLexicalToolActions("doc-123", { format: 'json' });
- *
- * // With extras
- * const actions = useLexicalToolActions("doc-123", {
- *   format: 'toon',
- *   extras: { userId: '123', theme: 'dark' }
- * });
- * ```
- */
-export declare function useLexicalToolActions(documentId: string, contextOverrides?: Partial<Omit<ToolExecutionContext, 'executor' | 'documentId'>>): ReturnType<typeof createAllCopilotKitActions>;

package/lib/tools/adapters/agui/lexicalHooks.js

@@ -1,64 +0,0 @@
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-/**
- * React hooks and components for ag-ui (CopilotKit) lexical tool registration.
- * Provides: useLexicalToolActions, ActionRegistrar, UseFrontendToolFn.
- *
- * @module tools/adapters/agui/lexicalHooks
- */
-import { useMemo } from 'react';
-// TODO: Re-enable when @datalayer/jupyter-react exports these
-// import type { ToolExecutionContext } from '@datalayer/jupyter-react';
-import { createAllCopilotKitActions, ActionRegistrar, } from './AgUIToolAdapter';
-// TODO: Re-enable when @datalayer/jupyter-react exports these
-// import type { ToolExecutionContext } from '@datalayer/jupyter-react';
-// Import from patched @datalayer/jupyter-lexical package
-import { useLexicalStore, DefaultExecutor as LexicalDefaultExecutor, lexicalToolDefinitions, lexicalToolOperations, } from '@datalayer/jupyter-lexical';
-// Re-export shared types and components for convenience
-export { ActionRegistrar };
-/**
- * Hook that creates CopilotKit actions for lexical tools.
- * Returns stable actions array that won't cause re-renders.
- *
- * @param documentId - Document ID (lexical document identifier)
- * @param contextOverrides - Optional context overrides (format, extras, etc.)
- * @returns CopilotKit actions
- *
- * @example
- * ```typescript
- * // Default context (toon format for AI)
- * const actions = useLexicalToolActions("doc-123");
- *
- * // Custom format
- * const actions = useLexicalToolActions("doc-123", { format: 'json' });
- *
- * // With extras
- * const actions = useLexicalToolActions("doc-123", {
- *   format: 'toon',
- *   extras: { userId: '123', theme: 'dark' }
- * });
- * ```
- */
-export function useLexicalToolActions(documentId, contextOverrides) {
-    // Call useLexicalStore() with no selector to get state object (matches notebook pattern)
-    const lexicalStoreState = useLexicalStore();
-    // Create LexicalDefaultExecutor (stable reference)
-    // Only recreate when documentId changes, not on every state update
-    // The executor holds a reference to the store which is always current
-    const executor = useMemo(() => new LexicalDefaultExecutor(documentId, lexicalStoreState), [documentId]);
-    // Create stable context object with useMemo
-    // Defaults: format='toon' for conversational AI responses
-    // Can be overridden with contextOverrides parameter
-    const context = useMemo(() => ({
-        documentId,
-        executor,
-        format: 'toon', // Default format
-        ...contextOverrides, // Override with user-provided values
-    }), [documentId, executor, contextOverrides]);
-    // Create and return CopilotKit actions (stable reference)
-    // Only re-create when context changes (i.e., when documentId or contextOverrides change)
-    const actions = useMemo(() => createAllCopilotKitActions(lexicalToolDefinitions, lexicalToolOperations, context), [context]);
-    return actions;
-}

package/lib/tools/adapters/agui/notebookHooks.d.ts

@@ -1,27 +0,0 @@
-import { createAllCopilotKitActions, ActionRegistrar, type UseFrontendToolFn } from './AgUIToolAdapter';
-type ToolExecutionContext = any;
-export { ActionRegistrar, type UseFrontendToolFn };
-/**
- * Hook that creates CopilotKit actions for notebook tools.
- * Returns stable actions array that won't cause re-renders.
- *
- * @param documentId - Document ID (notebook identifier)
- * @param contextOverrides - Optional context overrides (format, extras, etc.)
- * @returns CopilotKit actions
- *
- * @example
- * ```typescript
- * // Default context (toon format for AI)
- * const actions = useNotebookToolActions("my-notebook-id");
- *
- * // Custom format
- * const actions = useNotebookToolActions("my-notebook-id", { format: 'json' });
- *
- * // With extras
- * const actions = useNotebookToolActions("my-notebook-id", {
- *   format: 'toon',
- *   extras: { userId: '123', theme: 'dark' }
- * });
- * ```
- */
-export declare function useNotebookToolActions(documentId: string, contextOverrides?: Partial<Omit<ToolExecutionContext, 'executor' | 'documentId'>>): ReturnType<typeof createAllCopilotKitActions>;

package/lib/tools/adapters/agui/notebookHooks.js

@@ -1,61 +0,0 @@
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-/**
- * React hooks and components for ag-ui (CopilotKit) notebook tool registration.
- * Provides: useNotebookToolActions, ActionRegistrar, UseFrontendToolFn.
- *
- * @module tools/adapters/agui/notebookHooks
- */
-import { useMemo } from 'react';
-// TODO: Re-enable when @datalayer/jupyter-react exports these
-// import type { ToolExecutionContext } from '@datalayer/jupyter-react';
-import { createAllCopilotKitActions, ActionRegistrar, } from './AgUIToolAdapter';
-// Import from patched @datalayer/jupyter-react package
-import { notebookStore2, DefaultExecutor, notebookToolDefinitions, notebookToolOperations, } from '@datalayer/jupyter-react';
-// Hook wrapper to get notebook store state
-const useNotebookStore2 = () => notebookStore2.getState();
-// Re-export shared types and components for convenience
-export { ActionRegistrar };
-/**
- * Hook that creates CopilotKit actions for notebook tools.
- * Returns stable actions array that won't cause re-renders.
- *
- * @param documentId - Document ID (notebook identifier)
- * @param contextOverrides - Optional context overrides (format, extras, etc.)
- * @returns CopilotKit actions
- *
- * @example
- * ```typescript
- * // Default context (toon format for AI)
- * const actions = useNotebookToolActions("my-notebook-id");
- *
- * // Custom format
- * const actions = useNotebookToolActions("my-notebook-id", { format: 'json' });
- *
- * // With extras
- * const actions = useNotebookToolActions("my-notebook-id", {
- *   format: 'toon',
- *   extras: { userId: '123', theme: 'dark' }
- * });
- * ```
- */
-export function useNotebookToolActions(documentId, contextOverrides) {
-    const notebookStore = useNotebookStore2();
-    // Create DefaultExecutor (stable reference)
-    // Only recreate when documentId changes, not on every state update
-    // The executor holds a reference to the store which is always current
-    const executor = useMemo(() => new DefaultExecutor(documentId, notebookStore), [documentId]);
-    // Create stable context object with useMemo
-    // Defaults: format='toon' for conversational AI responses
-    // Can be overridden with contextOverrides parameter
-    const context = useMemo(() => ({
-        documentId,
-        executor,
-        format: 'toon', // Default format
-        ...contextOverrides, // Override with user-provided values
-    }), [documentId, executor, contextOverrides]);
-    // Create and return CopilotKit actions (stable reference)
-    return useMemo(() => createAllCopilotKitActions(notebookToolDefinitions, notebookToolOperations, context), [context]);
-}

package/lib/tools/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * Platform-agnostic tools for notebook and lexical integration with AI frameworks
- *
- * @module tools
- */
-export * from './adapters/agui';

package/lib/tools/index.js

@@ -1,18 +0,0 @@
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-/**
- * Platform-agnostic tools for notebook and lexical integration with AI frameworks
- *
- * @module tools
- */
-// Export adapters
-export * from './adapters/agui';
-// TODO: Re-export tool types from jupyter-react when available
-// export type {
-//   ToolDefinition,
-//   ToolConfig,
-//   ToolOperation,
-//   ToolExecutionContext,
-// } from '@datalayer/jupyter-react';

package/lib/{models/AIAgent.js → views/index.js}

@@ -1,5 +1,5 @@
+export {};
 /*
  * Copyright (c) 2023-2025 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-export {};