@od-oneapp/config 2026.2.2001-canary.1

package/typescript/dist/src/server/structured-clone-tool.js

@@ -0,0 +1,450 @@
+import { safeThrowIfAborted } from './abort-support';
+import { runWithContext } from './context';
+import { createEnhancedMCPErrorResponse } from './error-handling';
+import { benchmarkCloneMethods, cloneArrayStream, CloneUtils, enhancedClone, isStructuredCloneAvailable, StructuredCloneCache, } from './structured-clone';
+function generateDemoDataFunction(type, size = 100) {
+    switch (type) {
+        case 'simple':
+            return { name: 'test', value: 42, active: true };
+        case 'complex':
+            return {
+                id: 'complex-object',
+                metadata: {
+                    created: new Date().toISOString(),
+                    version: '1.0.0',
+                    tags: ['demo', 'structured-clone', 'performance'],
+                },
+                data: Array.from({ length: size }, (_, i) => ({
+                    index: i,
+                    value: (i * 13 + 7) % 1000,
+                    label: `Item ${i}`,
+                })),
+                config: {
+                    enabled: true,
+                    settings: {
+                        timeout: 5000,
+                        retry: 3,
+                        cache: true,
+                    },
+                },
+            };
+        case 'nested':
+            const createNested = (depth) => {
+                if (depth <= 0)
+                    return { value: 'leaf', depth };
+                return {
+                    depth,
+                    nested: createNested(depth - 1),
+                    data: Array.from({ length: 3 }, (_, i) => ({
+                        index: i,
+                        value: `depth-${depth}-${i}`,
+                    })),
+                };
+            };
+            return createNested(size > 20 ? 20 : size);
+        case 'large':
+            return {
+                largeArray: Array.from({ length: size * 100 }, (_, i) => ({
+                    id: i,
+                    data: `Large item ${i} with some content to make it bigger`,
+                    nested: {
+                        value: (i * 7 + 3) / 1000,
+                        timestamp: Date.now(),
+                        tags: Array.from({ length: 5 }, (_, j) => `tag-${i}-${j}`),
+                    },
+                })),
+                metadata: {
+                    size: size * 100,
+                    created: new Date().toISOString(),
+                },
+            };
+        case 'circular':
+            const obj = { name: 'circular-test', data: {} };
+            obj.self = obj;
+            obj.data.parent = obj;
+            return obj;
+        default:
+            return { type: 'unknown', value: type };
+    }
+}
+export const structuredCloneTool = {
+    name: 'structured_clone',
+    description: 'Node.js 22+ Performance Optimization with structuredClone()',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            action: {
+                type: 'string',
+                enum: [
+                    'clone',
+                    'isAvailable',
+                    'benchmark',
+                    'cloneArray',
+                    'cacheDemo',
+                    'configClone',
+                    'safeClone',
+                    'optimizedClone',
+                    'validateClone',
+                    'performanceClone',
+                ],
+                description: 'Structured clone action to perform',
+            },
+            data: {
+                type: 'object',
+                description: 'Data to clone (any JSON-serializable object)',
+            },
+            fallbackToJson: {
+                type: 'boolean',
+                description: 'Whether to fallback to JSON if structuredClone fails',
+                default: true,
+            },
+            validateClone: {
+                type: 'boolean',
+                description: 'Whether to validate the cloned data',
+                default: false,
+            },
+            trackPerformance: {
+                type: 'boolean',
+                description: 'Whether to track cloning performance',
+                default: false,
+            },
+            performanceMarker: {
+                type: 'string',
+                description: 'Performance marker name for tracking',
+            },
+            expectedType: {
+                type: 'string',
+                description: 'Expected type of cloned data for validation',
+            },
+            batchSize: {
+                type: 'number',
+                description: 'Batch size for array streaming',
+                default: 100,
+            },
+            iterations: {
+                type: 'number',
+                description: 'Number of iterations for benchmarking',
+                default: 1000,
+            },
+            cacheSize: {
+                type: 'number',
+                description: 'Size of cache for demo',
+                default: 10,
+            },
+            fallback: {
+                type: 'object',
+                description: 'Fallback value for safe cloning',
+            },
+            generateDemoData: {
+                type: 'boolean',
+                description: 'Whether to generate demo data',
+                default: false,
+            },
+            demoDataType: {
+                type: 'string',
+                enum: ['simple', 'complex', 'nested', 'circular', 'large'],
+                description: 'Type of demo data to generate',
+                default: 'complex',
+            },
+            demoDataSize: {
+                type: 'number',
+                description: 'Size parameter for demo data',
+                default: 100,
+            },
+            signal: {
+                type: 'object',
+                description: 'AbortSignal for cancelling the operation',
+            },
+        },
+        required: ['action'],
+    },
+    async execute(args) {
+        try {
+            const { action, data: inputData, fallbackToJson = true, validateClone = false, trackPerformance = false, performanceMarker, expectedType, batchSize = 100, iterations = 1000, cacheSize = 10, fallback, generateDemoData = false, demoDataType = 'complex', demoDataSize = 100, signal, } = args;
+            safeThrowIfAborted(signal);
+            return runWithContext({
+                toolName: 'structured_clone',
+                metadata: { action, generateDemoData, demoDataType },
+            }, async () => {
+                let data = inputData;
+                if (args.generateDemoData || !data) {
+                    data = generateDemoDataFunction(demoDataType, demoDataSize);
+                }
+                switch (action) {
+                    case 'isAvailable': {
+                        const available = isStructuredCloneAvailable();
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify({
+                                        success: true,
+                                        action: 'isAvailable',
+                                        structuredCloneAvailable: available,
+                                        nodeVersion: process.version,
+                                        recommendation: available
+                                            ? 'Use structuredClone for better performance'
+                                            : 'Use JSON fallback for compatibility',
+                                    }, null, 2),
+                                },
+                            ],
+                        };
+                    }
+                    case 'clone': {
+                        const options = {
+                            fallbackToJson,
+                            validateClone,
+                            trackPerformance,
+                            performanceMarker,
+                            expectedType,
+                        };
+                        const result = enhancedClone(data, options);
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify({
+                                        success: true,
+                                        action: 'clone',
+                                        cloneMethod: result.method,
+                                        clonedData: result.data,
+                                        performance: result.performance,
+                                        warnings: result.warnings,
+                                        options,
+                                    }, null, 2),
+                                },
+                            ],
+                        };
+                    }
+                    case 'benchmark': {
+                        if (!data) {
+                            throw new Error('Data required for benchmarking');
+                        }
+                        const benchmark = benchmarkCloneMethods(data, iterations);
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify({
+                                        success: true,
+                                        action: 'benchmark',
+                                        iterations,
+                                        results: benchmark,
+                                        dataSize: JSON.stringify(data).length,
+                                        conclusion: {
+                                            recommended: benchmark.recommendation,
+                                            reason: benchmark.structuredClone && benchmark.json
+                                                ? benchmark.structuredClone.avgMs < benchmark.json.avgMs
+                                                    ? 'structuredClone is faster'
+                                                    : 'JSON is faster'
+                                                : 'Unable to compare both methods',
+                                        },
+                                    }, null, 2),
+                                },
+                            ],
+                        };
+                    }
+                    case 'cloneArray': {
+                        if (!Array.isArray(data)) {
+                            throw new Error('Data must be an array for cloneArray action');
+                        }
+                        const results = [];
+                        let index = 0;
+                        for await (const result of cloneArrayStream(data, {
+                            batchSize,
+                            fallbackToJson,
+                            trackPerformance,
+                        })) {
+                            results.push(result);
+                            index++;
+                            safeThrowIfAborted(signal);
+                            if (index >= 20)
+                                break;
+                        }
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify({
+                                        success: true,
+                                        action: 'cloneArray',
+                                        originalLength: data.length,
+                                        processedCount: results.length,
+                                        truncated: results.length >= 20,
+                                        batchSize,
+                                        results: results.slice(0, 5),
+                                        summary: {
+                                            structuredCloneUsed: results.filter(r => r.method === 'structuredClone')
+                                                .length,
+                                            jsonUsed: results.filter(r => r.method === 'json').length,
+                                            failed: results.filter(r => r.method === 'failed').length,
+                                        },
+                                    }, null, 2),
+                                },
+                            ],
+                        };
+                    }
+                    case 'cacheDemo': {
+                        const cache = new StructuredCloneCache({
+                            fallbackToJson,
+                            trackPerformance: true,
+                        });
+                        const demoItems = Array.from({ length: cacheSize }, (_, i) => ({
+                            id: i,
+                            name: `Item ${i}`,
+                            data: generateDemoDataFunction('simple'),
+                        }));
+                        demoItems.forEach((item, i) => {
+                            cache.set(`item-${i}`, item);
+                        });
+                        const retrieved = cache.get('item-0');
+                        if (retrieved) {
+                            retrieved.modified = true;
+                            retrieved.timestamp = Date.now();
+                        }
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify({
+                                        success: true,
+                                        action: 'cacheDemo',
+                                        cacheSize: cache.size,
+                                        originalItem: demoItems[0],
+                                        retrievedItem: retrieved,
+                                        demonstratesIsolation: !demoItems[0].modified && retrieved?.modified,
+                                        cacheKeys: Array.from(cache.keys()),
+                                    }, null, 2),
+                                },
+                            ],
+                        };
+                    }
+                    case 'configClone': {
+                        const result = CloneUtils.cloneConfig(data);
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify({
+                                        success: true,
+                                        action: 'configClone',
+                                        originalConfig: data,
+                                        clonedConfig: result.data,
+                                        cloneMethod: result.method,
+                                        validated: result.warnings ? false : true,
+                                        warnings: result.warnings,
+                                    }, null, 2),
+                                },
+                            ],
+                        };
+                    }
+                    case 'safeClone': {
+                        const safeResult = CloneUtils.safeClone(data, fallback ?? { error: 'fallback used' });
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify({
+                                        success: true,
+                                        action: 'safeClone',
+                                        originalData: data,
+                                        clonedData: safeResult,
+                                        fallbackUsed: safeResult === (fallback ?? { error: 'fallback used' }),
+                                        fallbackData: fallback,
+                                    }, null, 2),
+                                },
+                            ],
+                        };
+                    }
+                    case 'optimizedClone': {
+                        const result = await CloneUtils.optimizedClone(data);
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify({
+                                        success: true,
+                                        action: 'optimizedClone',
+                                        optimizedMethod: result.method,
+                                        clonedData: result.data,
+                                        performance: result.performance,
+                                        automaticallyOptimized: true,
+                                    }, null, 2),
+                                },
+                            ],
+                        };
+                    }
+                    case 'validateClone': {
+                        const result = enhancedClone(data, {
+                            validateClone: true,
+                            expectedType,
+                            fallbackToJson,
+                            trackPerformance: true,
+                            performanceMarker: 'validation-clone',
+                        });
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify({
+                                        success: true,
+                                        action: 'validateClone',
+                                        originalData: data,
+                                        clonedData: result.data,
+                                        cloneMethod: result.method,
+                                        validationPassed: !result.warnings || result.warnings.length === 0,
+                                        warnings: result.warnings,
+                                        performance: result.performance,
+                                        expectedType,
+                                    }, null, 2),
+                                },
+                            ],
+                        };
+                    }
+                    case 'performanceClone': {
+                        const marker = performanceMarker || `perf-clone-${Date.now()}`;
+                        const result = CloneUtils.cloneWithMetrics(data, marker);
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify({
+                                        success: true,
+                                        action: 'performanceClone',
+                                        cloneMethod: result.method,
+                                        clonedData: result.data,
+                                        performance: result.performance,
+                                        performanceMarker: marker,
+                                        dataSize: JSON.stringify(data).length,
+                                        efficiency: result.performance
+                                            ? JSON.stringify(data).length / result.performance.durationMs
+                                            : undefined,
+                                    }, null, 2),
+                                },
+                            ],
+                        };
+                    }
+                    default:
+                        throw new Error(`Unknown structured clone action: ${action}`);
+                }
+            });
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('aborted')) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({ success: false, aborted: true }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            return createEnhancedMCPErrorResponse(error, 'structured_clone', {
+                contextInfo: 'Structured Clone Operations',
+            });
+        }
+    },
+};
+//# sourceMappingURL=structured-clone-tool.js.map

package/typescript/dist/src/server/structured-clone-tool.js.map

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

package/typescript/dist/src/server/structured-clone.d.ts

@@ -0,0 +1,59 @@
+export interface StructuredCloneOptions {
+    fallbackToJson?: boolean;
+    validateClone?: boolean;
+    trackPerformance?: boolean;
+    performanceMarker?: string;
+    expectedType?: string;
+    transfer?: any[];
+    onError?: (error: unknown, fallbackUsed: boolean) => void;
+}
+export interface CloneResult<T> {
+    data: T;
+    method: 'structuredClone' | 'json' | 'failed';
+    performance?: {
+        durationMs: number;
+        marker?: string;
+    };
+    warnings?: string[];
+}
+export declare function isStructuredCloneAvailable(): boolean;
+export declare function enhancedClone<T>(data: T, options?: StructuredCloneOptions): CloneResult<T>;
+export declare function cloneArrayStream<T>(array: T[], options?: StructuredCloneOptions & {
+    batchSize?: number;
+}): AsyncGenerator<CloneResult<T>, void, unknown>;
+export declare function benchmarkCloneMethods<T>(data: T, iterations?: number): {
+    structuredClone?: {
+        avgMs: number;
+        totalMs: number;
+        errors: number;
+    };
+    json?: {
+        avgMs: number;
+        totalMs: number;
+        errors: number;
+    };
+    recommendation: 'structuredClone' | 'json' | 'inconclusive';
+};
+export declare class StructuredCloneCache<K, V> {
+    private cache;
+    private cloneOptions;
+    constructor(options?: StructuredCloneOptions);
+    set(key: K, value: V): void;
+    get(key: K): V | undefined;
+    has(key: K): boolean;
+    delete(key: K): boolean;
+    clear(): void;
+    get size(): number;
+    keys(): IterableIterator<K>;
+    values(): IterableIterator<V>;
+    entries(): IterableIterator<[K, V]>;
+}
+export declare const CloneUtils: {
+    cloneConfig<T extends Record<string, any>>(config: T): CloneResult<T>;
+    cloneForSerialization<T>(data: T): CloneResult<T>;
+    cloneWithMetrics<T>(data: T, marker: string): CloneResult<T>;
+    safeClone<T>(data: T, fallback: T): T;
+    optimizedClone<T>(data: T): Promise<CloneResult<T>>;
+};
+export { benchmarkCloneMethods as benchmark, StructuredCloneCache as Cache, enhancedClone as clone, isStructuredCloneAvailable as isAvailable, };
+//# sourceMappingURL=structured-clone.d.ts.map

package/typescript/dist/src/server/structured-clone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-clone.d.ts","sourceRoot":"","sources":["../../../../../core-utils/src/server/structured-clone.ts"],"names":[],"mappings":"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"}