@daniel.stefan/metalink 1.3.1

package/packages/core/dist/server/batch-executor.js

@@ -0,0 +1,291 @@
+/**
+ * v1.2.0: Batch Executor Module
+ * Handles parallel tool execution with dependency resolution and error handling
+ */
+/**
+ * Batch executor - handles parallel and sequential task execution
+ */
+export class BatchExecutor {
+    /**
+     * Execute a batch of tasks with dependency resolution
+     */
+    static async executeBatch(request, toolExecutor) {
+        const startTime = Date.now();
+        const results = [];
+        const taskMap = new Map(request.tasks.map(t => [t.id, t]));
+        const resultMap = new Map();
+        const errors = [];
+        try {
+            // Validate and build dependency graph
+            const depGraph = this.buildDependencyGraph(request.tasks);
+            // Get execution order (topological sort)
+            const executionOrder = this.topologicalSort(depGraph);
+            // Execute tasks
+            const parallel = request.options?.parallel !== false;
+            const batchTimeout = request.options?.timeout || 60000;
+            const stopOnError = request.options?.stopOnError === true;
+            let theoreticalDuration = 0;
+            const startTimes = new Map();
+            const endTimes = new Map();
+            if (parallel) {
+                // Execute independent tasks concurrently
+                await this.executeParallel(executionOrder, taskMap, depGraph, resultMap, toolExecutor, stopOnError, batchTimeout, startTimes, endTimes, errors);
+                // Calculate parallelism savings
+                theoreticalDuration = Math.max(...Array.from(endTimes.values()).map(t => t - (Math.min(...Array.from(startTimes.values())) || 0)));
+            }
+            else {
+                // Execute tasks sequentially
+                for (const taskId of executionOrder) {
+                    if (stopOnError && errors.length > 0)
+                        break;
+                    const task = taskMap.get(taskId);
+                    if (!task)
+                        continue;
+                    const result = await this.executeTask(task, toolExecutor);
+                    resultMap.set(taskId, result);
+                    if (result.status === 'error') {
+                        errors.push({ taskId, error: result.error?.message || 'Unknown error' });
+                    }
+                }
+            }
+            // Collect results in request order
+            for (const task of request.tasks) {
+                const result = resultMap.get(task.id);
+                if (result) {
+                    results.push(result);
+                }
+            }
+            const totalDuration = Date.now() - startTime;
+            const successCount = results.filter(r => r.status === 'success').length;
+            const errorCount = results.filter(r => r.status === 'error').length;
+            const skippedCount = results.filter(r => r.status === 'skipped').length;
+            // Calculate parallelism savings
+            let parallelismSavings = 0;
+            if (parallel && theoreticalDuration > 0) {
+                const sequentialEstimate = results.reduce((sum, r) => sum + r.duration, 0);
+                parallelismSavings = ((sequentialEstimate - totalDuration) / sequentialEstimate) * 100;
+            }
+            return {
+                id: request.id,
+                results,
+                stats: {
+                    totalDuration,
+                    successCount,
+                    errorCount,
+                    skippedCount,
+                    parallelismSavings: Math.max(0, parallelismSavings)
+                },
+                ...(errors.length > 0 ? { errors } : {})
+            };
+        }
+        catch (error) {
+            throw new Error(`Batch execution failed: ${error.message}`);
+        }
+    }
+    /**
+     * Build dependency graph from tasks
+     */
+    static buildDependencyGraph(tasks) {
+        const graph = new Map();
+        // Initialize nodes
+        for (const task of tasks) {
+            graph.set(task.id, {
+                taskId: task.id,
+                dependencies: new Set(task.dependsOn || []),
+                dependents: new Set()
+            });
+        }
+        // Build reverse edges (dependents)
+        for (const task of tasks) {
+            if (task.dependsOn) {
+                for (const depId of task.dependsOn) {
+                    const depNode = graph.get(depId);
+                    if (depNode) {
+                        depNode.dependents.add(task.id);
+                    }
+                }
+            }
+        }
+        // Detect circular dependencies
+        this.detectCircularDependencies(graph);
+        return graph;
+    }
+    /**
+     * Detect circular dependencies in the graph
+     */
+    static detectCircularDependencies(graph) {
+        const visited = new Set();
+        const visiting = new Set();
+        const dfs = (nodeId) => {
+            if (visited.has(nodeId))
+                return;
+            if (visiting.has(nodeId)) {
+                throw new Error(`Circular dependency detected involving task: ${nodeId}`);
+            }
+            visiting.add(nodeId);
+            const node = graph.get(nodeId);
+            if (node) {
+                for (const depId of node.dependencies) {
+                    dfs(depId);
+                }
+            }
+            visiting.delete(nodeId);
+            visited.add(nodeId);
+        };
+        for (const taskId of graph.keys()) {
+            if (!visited.has(taskId)) {
+                dfs(taskId);
+            }
+        }
+    }
+    /**
+     * Topological sort of task dependencies
+     */
+    static topologicalSort(graph) {
+        const result = [];
+        const visited = new Set();
+        const visiting = new Set();
+        const visit = (nodeId) => {
+            if (visited.has(nodeId))
+                return;
+            if (visiting.has(nodeId)) {
+                throw new Error(`Circular dependency detected involving task: ${nodeId}`);
+            }
+            visiting.add(nodeId);
+            const node = graph.get(nodeId);
+            if (node) {
+                for (const depId of node.dependencies) {
+                    visit(depId);
+                }
+            }
+            visiting.delete(nodeId);
+            visited.add(nodeId);
+            result.push(nodeId);
+        };
+        for (const taskId of graph.keys()) {
+            if (!visited.has(taskId)) {
+                visit(taskId);
+            }
+        }
+        return result;
+    }
+    /**
+     * Execute independent tasks in parallel
+     */
+    static async executeParallel(executionOrder, taskMap, depGraph, resultMap, toolExecutor, stopOnError, batchTimeout, startTimes, endTimes, errors) {
+        const completed = new Set();
+        const batchStartTime = Date.now();
+        for (const taskId of executionOrder) {
+            // Check batch timeout
+            if (Date.now() - batchStartTime > batchTimeout) {
+                throw new Error(`Batch timeout exceeded (${batchTimeout}ms)`);
+            }
+            // Check if dependencies are met
+            const node = depGraph.get(taskId);
+            if (node && node.dependencies.size > 0) {
+                const unmetDeps = Array.from(node.dependencies).filter(d => !completed.has(d));
+                if (unmetDeps.length > 0) {
+                    // Wait for dependencies
+                    continue;
+                }
+            }
+            const task = taskMap.get(taskId);
+            if (!task)
+                continue;
+            if (stopOnError && errors.length > 0) {
+                resultMap.set(taskId, {
+                    taskId,
+                    status: 'skipped',
+                    duration: 0,
+                    attempt: 1
+                });
+                continue;
+            }
+            startTimes.set(taskId, Date.now());
+            const result = await this.executeTask(task, toolExecutor);
+            endTimes.set(taskId, Date.now());
+            resultMap.set(taskId, result);
+            completed.add(taskId);
+            if (result.status === 'error') {
+                errors.push({ taskId, error: result.error?.message || 'Unknown error' });
+            }
+        }
+    }
+    /**
+     * Execute a single task with retry logic
+     */
+    static async executeTask(task, toolExecutor) {
+        const startTime = Date.now();
+        const maxRetries = task.retryCount || 0;
+        let lastError = null;
+        for (let attempt = 1; attempt <= maxRetries + 1; attempt++) {
+            try {
+                const result = await toolExecutor(task.tool, task.arguments, task.timeout);
+                return {
+                    taskId: task.id,
+                    status: 'success',
+                    result,
+                    duration: Date.now() - startTime,
+                    attempt
+                };
+            }
+            catch (error) {
+                lastError = error;
+                if (attempt < maxRetries + 1) {
+                    // Exponential backoff: 100ms * 2^(attempt-1)
+                    const delay = 100 * Math.pow(2, attempt - 1);
+                    await new Promise(resolve => setTimeout(resolve, delay));
+                }
+            }
+        }
+        // All retries exhausted
+        return {
+            taskId: task.id,
+            status: 'error',
+            error: {
+                code: 'TOOL_EXECUTION_FAILED',
+                message: lastError?.message || 'Tool execution failed',
+                data: lastError
+            },
+            duration: Date.now() - startTime,
+            attempt: maxRetries + 1
+        };
+    }
+}
+/**
+ * Helper: Resolve output references in task arguments
+ * Example: "${task-1.result.id}" refers to task-1's result.id
+ */
+export function resolveOutputReferences(arguments_, resultMap) {
+    const resolved = {};
+    for (const [key, value] of Object.entries(arguments_)) {
+        if (typeof value === 'string' && value.startsWith('${') && value.endsWith('}')) {
+            // Parse reference: ${taskId.resultPath}
+            const refContent = value.slice(2, -1); // Remove ${ and }
+            const [taskId, ...pathParts] = refContent.split('.');
+            const taskResult = resultMap.get(taskId);
+            if (taskResult && taskResult.status === 'success') {
+                // Navigate through result object
+                let current = taskResult.result;
+                for (const part of pathParts) {
+                    if (current && typeof current === 'object') {
+                        current = current[part];
+                    }
+                    else {
+                        current = undefined;
+                        break;
+                    }
+                }
+                resolved[key] = current;
+            }
+            else {
+                resolved[key] = null; // Reference to failed task
+            }
+        }
+        else {
+            resolved[key] = value;
+        }
+    }
+    return resolved;
+}
+//# sourceMappingURL=batch-executor.js.map

package/packages/core/dist/server/batch-executor.js.map

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

package/packages/core/dist/server/circuit-breaker.d.ts

@@ -0,0 +1,215 @@
+/**
+ * Circuit Breaker Implementation for MetaLink
+ *
+ * Prevents cascade failures by monitoring server health and temporarily
+ * blocking requests to failing servers. Implements the Circuit Breaker pattern
+ * with three states: CLOSED, OPEN, and HALF_OPEN.
+ *
+ * @see https://martinfowler.com/bliki/CircuitBreaker.html
+ */
+/**
+ * Circuit breaker states
+ *
+ * - CLOSED: Normal operation, requests flow through
+ * - OPEN: Server is failing, requests blocked immediately
+ * - HALF_OPEN: Testing if server has recovered, limited requests allowed
+ */
+export declare enum CircuitState {
+    CLOSED = "CLOSED",
+    OPEN = "OPEN",
+    HALF_OPEN = "HALF_OPEN"
+}
+/**
+ * Circuit breaker configuration options
+ */
+export interface CircuitBreakerConfig {
+    /**
+     * Number of consecutive failures before opening circuit
+     * @default 3
+     */
+    failureThreshold?: number;
+    /**
+     * Time in milliseconds before attempting to close circuit after opening
+     * @default 30000 (30 seconds)
+     */
+    resetTimeout?: number;
+    /**
+     * Number of consecutive successes in HALF_OPEN state to close circuit
+     * @default 1
+     */
+    halfOpenSuccessThreshold?: number;
+    /**
+     * Optional callback invoked when circuit state changes
+     */
+    onStateChange?: (oldState: CircuitState, newState: CircuitState, serverName: string) => void;
+}
+/**
+ * Circuit breaker metrics for monitoring
+ */
+export interface CircuitBreakerMetrics {
+    state: CircuitState;
+    failures: number;
+    successes: number;
+    lastFailureTime: number | null;
+    lastSuccessTime: number | null;
+    stateChangedAt: number;
+    totalRequests: number;
+    rejectedRequests: number;
+}
+/**
+ * Circuit Breaker implementation
+ *
+ * Monitors server health and prevents cascade failures by temporarily blocking
+ * requests to failing servers. Automatically recovers when server becomes healthy.
+ *
+ * @example
+ * ```typescript
+ * const breaker = new CircuitBreaker('memory-server', {
+ *   failureThreshold: 3,
+ *   resetTimeout: 30000,
+ *   halfOpenSuccessThreshold: 1,
+ * });
+ *
+ * // Before making request
+ * if (!breaker.canExecute()) {
+ *   throw new Error('Circuit breaker is OPEN');
+ * }
+ *
+ * try {
+ *   const result = await makeRequest();
+ *   breaker.recordSuccess();
+ *   return result;
+ * } catch (error) {
+ *   breaker.recordFailure();
+ *   throw error;
+ * }
+ * ```
+ */
+export declare class CircuitBreaker {
+    private readonly serverName;
+    private readonly config;
+    private state;
+    private failureCount;
+    private successCount;
+    private lastFailureTime;
+    private lastSuccessTime;
+    private stateChangedAt;
+    private resetTimer;
+    private totalRequests;
+    private rejectedRequests;
+    /**
+     * Create a new circuit breaker for a server
+     *
+     * @param serverName - Name of the server being protected
+     * @param config - Circuit breaker configuration options
+     */
+    constructor(serverName: string, config?: CircuitBreakerConfig);
+    /**
+     * Check if a request can be executed
+     *
+     * @returns true if request should proceed, false if circuit is OPEN
+     */
+    canExecute(): boolean;
+    /**
+     * Record a successful operation
+     *
+     * Resets failure count and may transition circuit to CLOSED state
+     */
+    recordSuccess(): void;
+    /**
+     * Record a failed operation
+     *
+     * Increments failure count and may transition circuit to OPEN state
+     */
+    recordFailure(): void;
+    /**
+     * Get current circuit breaker state
+     *
+     * @returns Current state (CLOSED, OPEN, or HALF_OPEN)
+     */
+    getState(): CircuitState;
+    /**
+     * Get circuit breaker metrics
+     *
+     * @returns Current metrics including state, failure count, etc.
+     */
+    getMetrics(): CircuitBreakerMetrics;
+    /**
+     * Manually reset the circuit breaker to CLOSED state
+     *
+     * Use with caution - typically only for testing or administrative override
+     */
+    reset(): void;
+    /**
+     * Check if enough time has passed to attempt reset
+     *
+     * @returns true if reset timeout has elapsed
+     */
+    private shouldAttemptReset;
+    /**
+     * Transition to a new circuit state
+     *
+     * @param newState - Target state
+     */
+    private transitionTo;
+    /**
+     * Clean up resources
+     *
+     * Call this when circuit breaker is no longer needed
+     */
+    destroy(): void;
+}
+/**
+ * Circuit Breaker Manager
+ *
+ * Manages multiple circuit breakers for different servers.
+ * Provides centralized monitoring and control.
+ */
+export declare class CircuitBreakerManager {
+    private breakers;
+    private readonly defaultConfig;
+    /**
+     * Create a new circuit breaker manager
+     *
+     * @param defaultConfig - Default configuration for all circuit breakers
+     */
+    constructor(defaultConfig?: CircuitBreakerConfig);
+    /**
+     * Get or create a circuit breaker for a server
+     *
+     * @param serverName - Name of the server
+     * @param config - Optional server-specific configuration
+     * @returns Circuit breaker instance
+     */
+    getBreaker(serverName: string, config?: CircuitBreakerConfig): CircuitBreaker;
+    /**
+     * Get all circuit breakers
+     *
+     * @returns Map of server names to circuit breakers
+     */
+    getAllBreakers(): Map<string, CircuitBreaker>;
+    /**
+     * Get aggregated metrics for all circuit breakers
+     *
+     * @returns Array of metrics for all servers
+     */
+    getAllMetrics(): Array<{
+        serverName: string;
+        metrics: CircuitBreakerMetrics;
+    }>;
+    /**
+     * Reset a specific circuit breaker
+     *
+     * @param serverName - Name of the server
+     */
+    reset(serverName: string): void;
+    /**
+     * Reset all circuit breakers
+     */
+    resetAll(): void;
+    /**
+     * Clean up all circuit breakers
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/packages/core/dist/server/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../src/server/circuit-breaker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;GAMG;AACH,oBAAY,YAAY;IACtB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,SAAS,cAAc;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAElC;;OAEG;IACH,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9F;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;IAExD,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,cAAc,CAAsB;IAC5C,OAAO,CAAC,UAAU,CAA+B;IAGjD,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,gBAAgB,CAAa;IAErC;;;;;OAKG;gBACS,UAAU,EAAE,MAAM,EAAE,MAAM,GAAE,oBAAyB;IAUjE;;;;OAIG;IACH,UAAU,IAAI,OAAO;IA0BrB;;;;OAIG;IACH,aAAa,IAAI,IAAI;IAyBrB;;;;OAIG;IACH,aAAa,IAAI,IAAI;IAuBrB;;;;OAIG;IACH,QAAQ,IAAI,YAAY;IAIxB;;;;OAIG;IACH,UAAU,IAAI,qBAAqB;IAanC;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAQb;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAmCpB;;;;OAIG;IACH,OAAO,IAAI,IAAI;CAMhB;AAED;;;;;GAKG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuB;IAErD;;;;OAIG;gBACS,aAAa,GAAE,oBAAyB;IAIpD;;;;;;OAMG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,oBAAoB,GAAG,cAAc;IAY7E;;;;OAIG;IACH,cAAc,IAAI,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC;IAI7C;;;;OAIG;IACH,aAAa,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,qBAAqB,CAAA;KAAE,CAAC;IAa9E;;;;OAIG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAO/B;;OAEG;IACH,QAAQ,IAAI,IAAI;IAMhB;;OAEG;IACH,OAAO,IAAI,IAAI;CAMhB"}