@sowonai/crewx-sdk 0.1.0-dev.0 → 0.1.0-dev.2

package/dist/core/parallel/helpers.d.ts

@@ -0,0 +1,27 @@
+import type { ParallelRunnerMetrics } from './types';
+import { type AgentQueryRequest, type AgentExecuteRequest, type AgentResult } from '../agent';
+export interface RetryPolicy {
+    maxRetries: number;
+    retryDelay: number;
+}
+export interface ParallelConfig {
+    concurrency?: number;
+    timeout?: number;
+    retryPolicy?: RetryPolicy;
+    onProgress?: (completed: number, total: number) => void;
+    onComplete?: (result: HelperResult<AgentResult>) => void;
+}
+export interface HelperResult<T = AgentResult> {
+    total: number;
+    completed: number;
+    successCount: number;
+    failureCount: number;
+    results: T[];
+    errors: Array<{
+        index: number;
+        error: Error;
+    }>;
+    metrics: ParallelRunnerMetrics;
+}
+export declare const runQueriesParallel: (queries: AgentQueryRequest[], config?: ParallelConfig) => Promise<AgentResult[]>;
+export declare const runExecutesParallel: (requests: AgentExecuteRequest[], config?: ParallelConfig) => Promise<AgentResult[]>;

package/dist/core/parallel/helpers.js

@@ -0,0 +1,252 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runExecutesParallel = exports.runQueriesParallel = void 0;
+const parallel_runner_1 = require("./parallel-runner");
+const agent_1 = require("../agent");
+const DEFAULT_CONCURRENCY = 3;
+const DEFAULT_TIMEOUT_MS = 30000;
+const DEFAULT_RETRY_DELAY_MS = 500;
+const normalizeConcurrency = (value) => {
+    if (typeof value !== 'number' || Number.isNaN(value) || !Number.isFinite(value)) {
+        return DEFAULT_CONCURRENCY;
+    }
+    const normalized = Math.floor(value);
+    return normalized > 0 ? normalized : DEFAULT_CONCURRENCY;
+};
+const normalizeTimeout = (value) => {
+    if (value === undefined) {
+        return DEFAULT_TIMEOUT_MS;
+    }
+    if (typeof value !== 'number' || Number.isNaN(value) || value <= 0) {
+        return DEFAULT_TIMEOUT_MS;
+    }
+    return value;
+};
+const normalizeRetryPolicy = (policy) => {
+    if (!policy) {
+        return { maxRetries: 0, retryDelay: DEFAULT_RETRY_DELAY_MS };
+    }
+    const maxRetries = Number.isInteger(policy.maxRetries) && policy.maxRetries >= 0
+        ? policy.maxRetries
+        : 0;
+    const retryDelay = typeof policy.retryDelay === 'number' && policy.retryDelay >= 0
+        ? policy.retryDelay
+        : DEFAULT_RETRY_DELAY_MS;
+    return { maxRetries, retryDelay };
+};
+const createAbortError = (signal) => {
+    const reason = signal.reason;
+    if (reason instanceof Error) {
+        return reason;
+    }
+    if (typeof reason === 'string') {
+        return new Error(reason);
+    }
+    return new Error('Parallel operation aborted');
+};
+const waitForDelay = (delayMs, signal) => {
+    if (delayMs <= 0) {
+        return Promise.resolve();
+    }
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            signal.removeEventListener('abort', onAbort);
+            resolve();
+        }, delayMs);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(createAbortError(signal));
+        };
+        if (signal.aborted) {
+            onAbort();
+            return;
+        }
+        signal.addEventListener('abort', onAbort, { once: true });
+    });
+};
+const executeWithRetry = async (execute, retryPolicy, signal) => {
+    let lastFailureResult;
+    let lastError;
+    for (let attempt = 0; attempt <= retryPolicy.maxRetries; attempt += 1) {
+        if (signal.aborted) {
+            throw createAbortError(signal);
+        }
+        try {
+            const result = await execute();
+            lastFailureResult = result;
+            if (result.success || attempt === retryPolicy.maxRetries) {
+                return result;
+            }
+        }
+        catch (error) {
+            lastError = error;
+            if (signal.aborted) {
+                throw createAbortError(signal);
+            }
+            if (attempt === retryPolicy.maxRetries) {
+                const normalizedError = error instanceof Error ? error : new Error(String(error));
+                throw normalizedError;
+            }
+        }
+        if (attempt < retryPolicy.maxRetries) {
+            await waitForDelay(retryPolicy.retryDelay, signal);
+        }
+    }
+    if (lastFailureResult) {
+        return lastFailureResult;
+    }
+    if (lastError) {
+        throw lastError instanceof Error ? lastError : new Error(String(lastError));
+    }
+    throw new Error('Parallel helper encountered an unexpected state');
+};
+const recordProgress = (callbacks, state, wasSuccessful) => {
+    state.completed += 1;
+    if (wasSuccessful) {
+        state.success += 1;
+    }
+    else {
+        state.failure += 1;
+    }
+    try {
+        callbacks.onProgress?.(state.completed, state.total);
+    }
+    catch (error) {
+        if (process.env.NODE_ENV !== 'production') {
+            console.warn('Parallel helper onProgress callback threw an error:', error);
+        }
+    }
+};
+const mapResults = (taskResults) => {
+    return taskResults.map((taskResult) => ({
+        metadata: taskResult.metadata,
+        taskResult,
+    }));
+};
+const buildAgentResults = (decoratedResults) => {
+    const ordered = decoratedResults.slice().sort((a, b) => a.metadata.index - b.metadata.index);
+    return ordered.map(({ metadata, taskResult }) => {
+        if (taskResult.value) {
+            const baseResult = taskResult.value;
+            return {
+                ...baseResult,
+                agentId: baseResult.agentId ?? metadata.request.agentId,
+                metadata: {
+                    ...baseResult.metadata,
+                    requestIndex: metadata.index,
+                    mode: metadata.mode,
+                },
+            };
+        }
+        const error = taskResult.error ?? new Error('Unknown error');
+        return {
+            agentId: metadata.request.agentId,
+            content: error.message,
+            success: false,
+            metadata: {
+                error: error.message,
+                aborted: taskResult.aborted ?? false,
+                requestIndex: metadata.index,
+                mode: metadata.mode,
+            },
+        };
+    });
+};
+const collectErrors = (decoratedResults) => {
+    return decoratedResults
+        .filter(({ taskResult }) => !taskResult.success)
+        .map(({ metadata, taskResult }) => {
+        if (taskResult.error instanceof Error) {
+            return { index: metadata.index, error: taskResult.error };
+        }
+        if (taskResult.value && !taskResult.value.success) {
+            const errorMessage = taskResult.value.metadata?.error
+                ?? taskResult.value.content
+                ?? 'Agent returned unsuccessful result';
+            return { index: metadata.index, error: new Error(errorMessage) };
+        }
+        return { index: metadata.index, error: new Error('Unknown failure') };
+    });
+};
+const createCallbacks = (progressState, config) => ({
+    onTaskComplete: async (result) => {
+        recordProgress(config, progressState, result.success);
+    },
+    onError: async () => {
+        recordProgress(config, progressState, false);
+    },
+});
+const runAgentOperations = async (requests, mode, config = {}) => {
+    if (!Array.isArray(requests)) {
+        throw new TypeError('Parallel helpers expect an array of requests');
+    }
+    if (requests.length === 0) {
+        const emptyMetrics = {
+            totalTasks: 0,
+            startedTasks: 0,
+            completedTasks: 0,
+            successCount: 0,
+            failureCount: 0,
+            totalDurationMs: 0,
+            averageDurationMs: 0,
+            throughput: 0,
+        };
+        const summary = {
+            total: 0,
+            completed: 0,
+            successCount: 0,
+            failureCount: 0,
+            results: [],
+            errors: [],
+            metrics: emptyMetrics,
+        };
+        config.onComplete?.(summary);
+        return [];
+    }
+    const concurrency = normalizeConcurrency(config.concurrency);
+    const timeout = normalizeTimeout(config.timeout);
+    const retryPolicy = normalizeRetryPolicy(config.retryPolicy);
+    const runner = new parallel_runner_1.ParallelRunner();
+    const runtime = new agent_1.AgentRuntime();
+    const runSingleOperation = (request) => (mode === 'query'
+        ? runtime.query(request)
+        : runtime.execute(request));
+    const tasks = requests.map((request, index) => ({
+        id: `${mode}:${request.agentId ?? 'anonymous'}:${index}`,
+        metadata: { index, mode, request },
+        run: (context) => executeWithRetry(() => runSingleOperation(request), retryPolicy, context.signal),
+    }));
+    const progressState = {
+        completed: 0,
+        success: 0,
+        failure: 0,
+        total: requests.length,
+    };
+    const runnerOptions = {
+        maxConcurrency: concurrency,
+        timeoutMs: timeout,
+        evaluateTaskSuccess: (value) => value.success,
+        callbacks: createCallbacks(progressState, config),
+    };
+    const taskResults = await runner.run(tasks, runnerOptions);
+    const decoratedResults = mapResults(taskResults);
+    const agentResults = buildAgentResults(decoratedResults);
+    const errors = collectErrors(decoratedResults);
+    const metrics = runner.getMetrics();
+    const summary = {
+        total: requests.length,
+        completed: requests.length,
+        successCount: agentResults.filter((item) => item.success).length,
+        failureCount: agentResults.filter((item) => !item.success).length,
+        results: agentResults,
+        errors,
+        metrics,
+    };
+    config.onComplete?.(summary);
+    return agentResults;
+};
+const runQueriesParallel = (queries, config) => runAgentOperations(queries, 'query', config);
+exports.runQueriesParallel = runQueriesParallel;
+const runExecutesParallel = (requests, config) => runAgentOperations(requests, 'execute', config);
+exports.runExecutesParallel = runExecutesParallel;
+//# sourceMappingURL=helpers.js.map

package/dist/core/parallel/helpers.js.map

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

package/dist/core/parallel/index.d.ts

@@ -0,0 +1,4 @@
+export { ParallelRunner, ParallelRunnerTimeoutError, createDefaultParallelRunner, } from './parallel-runner';
+export type { ParallelRunnerMetrics, ParallelRunnerOptions, Task, TaskResult, TaskCallbacks, TaskExecutionContext, } from './types';
+export { runQueriesParallel, runExecutesParallel, } from './helpers';
+export type { ParallelConfig, HelperResult, RetryPolicy, } from './helpers';

package/dist/core/parallel/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runExecutesParallel = exports.runQueriesParallel = exports.createDefaultParallelRunner = exports.ParallelRunnerTimeoutError = exports.ParallelRunner = void 0;
+var parallel_runner_1 = require("./parallel-runner");
+Object.defineProperty(exports, "ParallelRunner", { enumerable: true, get: function () { return parallel_runner_1.ParallelRunner; } });
+Object.defineProperty(exports, "ParallelRunnerTimeoutError", { enumerable: true, get: function () { return parallel_runner_1.ParallelRunnerTimeoutError; } });
+Object.defineProperty(exports, "createDefaultParallelRunner", { enumerable: true, get: function () { return parallel_runner_1.createDefaultParallelRunner; } });
+var helpers_1 = require("./helpers");
+Object.defineProperty(exports, "runQueriesParallel", { enumerable: true, get: function () { return helpers_1.runQueriesParallel; } });
+Object.defineProperty(exports, "runExecutesParallel", { enumerable: true, get: function () { return helpers_1.runExecutesParallel; } });
+//# sourceMappingURL=index.js.map

package/dist/core/parallel/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/parallel/index.ts"],"names":[],"mappings":";;;AAAA,qDAI2B;AAHzB,iHAAA,cAAc,OAAA;AACd,6HAAA,0BAA0B,OAAA;AAC1B,8HAAA,2BAA2B,OAAA;AAU7B,qCAGmB;AAFjB,6GAAA,kBAAkB,OAAA;AAClB,8GAAA,mBAAmB,OAAA"}

package/dist/core/parallel/parallel-runner.d.ts

@@ -0,0 +1,16 @@
+import type { ParallelRunnerMetrics, ParallelRunnerOptions, Task, TaskResult } from './types';
+export declare class ParallelRunnerTimeoutError extends Error {
+    readonly taskId: string;
+    readonly timeoutMs: number;
+    constructor(taskId: string, timeoutMs: number);
+}
+export declare class ParallelRunner {
+    private readonly defaults;
+    private metrics;
+    constructor(defaults?: ParallelRunnerOptions);
+    run<T>(tasks: Task<T>[], options?: ParallelRunnerOptions<T>): Promise<TaskResult<T>[]>;
+    getMetrics(): ParallelRunnerMetrics;
+    private mergeOptions;
+    private mergeCallbacks;
+}
+export declare const createDefaultParallelRunner: () => ParallelRunner;

package/dist/core/parallel/parallel-runner.js

@@ -0,0 +1,230 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDefaultParallelRunner = exports.ParallelRunner = exports.ParallelRunnerTimeoutError = void 0;
+const node_perf_hooks_1 = require("node:perf_hooks");
+class ParallelRunnerTimeoutError extends Error {
+    constructor(taskId, timeoutMs) {
+        super(`Task ${taskId} timed out after ${timeoutMs}ms`);
+        this.taskId = taskId;
+        this.timeoutMs = timeoutMs;
+        this.name = 'ParallelRunnerTimeoutError';
+    }
+}
+exports.ParallelRunnerTimeoutError = ParallelRunnerTimeoutError;
+class ParallelRunner {
+    constructor(defaults = {}) {
+        this.defaults = defaults;
+        this.metrics = {
+            totalTasks: 0,
+            startedTasks: 0,
+            completedTasks: 0,
+            successCount: 0,
+            failureCount: 0,
+            totalDurationMs: 0,
+            averageDurationMs: 0,
+            throughput: 0,
+        };
+    }
+    async run(tasks, options = {}) {
+        if (!Array.isArray(tasks)) {
+            throw new TypeError('ParallelRunner.run expects an array of tasks');
+        }
+        if (tasks.length === 0) {
+            this.metrics = {
+                totalTasks: 0,
+                startedTasks: 0,
+                completedTasks: 0,
+                successCount: 0,
+                failureCount: 0,
+                totalDurationMs: 0,
+                averageDurationMs: 0,
+                throughput: 0,
+            };
+            return [];
+        }
+        const merged = this.mergeOptions(options);
+        const maxConcurrency = Math.max(1, merged.maxConcurrency ?? 5);
+        const timeoutMs = merged.timeoutMs;
+        const failFast = merged.failFast ?? false;
+        const callbacks = merged.callbacks;
+        const evaluateTaskSuccess = merged.evaluateTaskSuccess ?? (() => true);
+        const results = [];
+        let successCount = 0;
+        let failureCount = 0;
+        let startedTasks = 0;
+        let aborted = false;
+        let cursor = 0;
+        const startedAt = node_perf_hooks_1.performance.now();
+        const executeTask = async (task) => {
+            if (callbacks?.onTaskStart) {
+                await callbacks.onTaskStart(task);
+            }
+            startedTasks += 1;
+            const controller = new AbortController();
+            const context = { signal: controller.signal };
+            let timeoutId;
+            let timeoutPromise;
+            if (typeof timeoutMs === 'number' && Number.isFinite(timeoutMs) && timeoutMs > 0) {
+                timeoutPromise = new Promise((_, reject) => {
+                    timeoutId = setTimeout(() => {
+                        const timeoutError = new ParallelRunnerTimeoutError(task.id, timeoutMs);
+                        controller.abort(timeoutError);
+                        reject(timeoutError);
+                    }, timeoutMs);
+                });
+            }
+            const startedAtTask = node_perf_hooks_1.performance.now();
+            const runPromise = task.run(context);
+            const combinedPromise = timeoutPromise
+                ? Promise.race([runPromise, timeoutPromise])
+                : runPromise;
+            try {
+                const value = await combinedPromise;
+                const finishedAtTask = node_perf_hooks_1.performance.now();
+                const durationMs = finishedAtTask - startedAtTask;
+                const success = evaluateTaskSuccess(value, task);
+                const result = {
+                    taskId: task.id,
+                    success,
+                    value,
+                    durationMs,
+                    startedAt: startedAtTask,
+                    finishedAt: finishedAtTask,
+                    metadata: task.metadata,
+                    aborted: false,
+                };
+                results.push(result);
+                success ? (successCount += 1) : (failureCount += 1);
+                if (callbacks?.onTaskComplete) {
+                    await callbacks.onTaskComplete(result);
+                }
+                if (failFast && !success) {
+                    aborted = true;
+                }
+            }
+            catch (rawError) {
+                const finishedAtTask = node_perf_hooks_1.performance.now();
+                const durationMs = finishedAtTask - startedAtTask;
+                const error = rawError instanceof Error ? rawError : new Error(String(rawError));
+                const result = {
+                    taskId: task.id,
+                    success: false,
+                    error,
+                    durationMs,
+                    startedAt: startedAtTask,
+                    finishedAt: finishedAtTask,
+                    metadata: task.metadata,
+                    aborted: controller.signal.aborted,
+                };
+                results.push(result);
+                failureCount += 1;
+                if (callbacks?.onError) {
+                    await callbacks.onError(task, error, durationMs);
+                }
+                if (failFast) {
+                    aborted = true;
+                }
+            }
+            finally {
+                if (timeoutId) {
+                    clearTimeout(timeoutId);
+                }
+                if (timeoutPromise) {
+                    runPromise.catch(() => undefined);
+                }
+            }
+        };
+        const worker = async () => {
+            while (true) {
+                if (aborted) {
+                    break;
+                }
+                const currentIndex = cursor;
+                if (currentIndex >= tasks.length) {
+                    break;
+                }
+                cursor += 1;
+                const task = tasks[currentIndex];
+                if (!task) {
+                    break;
+                }
+                await executeTask(task);
+                if (aborted) {
+                    break;
+                }
+            }
+        };
+        const workers = [];
+        const workerCount = Math.min(maxConcurrency, tasks.length);
+        for (let i = 0; i < workerCount; i += 1) {
+            workers.push(worker());
+        }
+        await Promise.all(workers);
+        const finishedAt = node_perf_hooks_1.performance.now();
+        const totalDurationMs = finishedAt - startedAt;
+        const averageDurationMs = results.length
+            ? results.reduce((sum, item) => sum + item.durationMs, 0) / results.length
+            : 0;
+        const throughput = totalDurationMs > 0
+            ? (results.length / (totalDurationMs / 1000))
+            : results.length;
+        this.metrics = {
+            totalTasks: tasks.length,
+            startedTasks,
+            completedTasks: results.length,
+            successCount,
+            failureCount,
+            totalDurationMs,
+            averageDurationMs,
+            throughput,
+        };
+        return results;
+    }
+    getMetrics() {
+        return this.metrics;
+    }
+    mergeOptions(options) {
+        return {
+            maxConcurrency: options.maxConcurrency ?? this.defaults.maxConcurrency,
+            timeoutMs: options.timeoutMs ?? this.defaults.timeoutMs,
+            failFast: options.failFast ?? this.defaults.failFast,
+            evaluateTaskSuccess: options.evaluateTaskSuccess ?? this.defaults.evaluateTaskSuccess,
+            callbacks: this.mergeCallbacks(this.defaults.callbacks, options.callbacks),
+        };
+    }
+    mergeCallbacks(base, override) {
+        if (!base && !override) {
+            return undefined;
+        }
+        return {
+            onTaskStart: async (task) => {
+                if (base?.onTaskStart) {
+                    await base.onTaskStart(task);
+                }
+                if (override?.onTaskStart) {
+                    await override.onTaskStart(task);
+                }
+            },
+            onTaskComplete: async (result) => {
+                if (base?.onTaskComplete) {
+                    await base.onTaskComplete(result);
+                }
+                if (override?.onTaskComplete) {
+                    await override.onTaskComplete(result);
+                }
+            },
+            onError: async (task, error, durationMs) => {
+                if (base?.onError) {
+                    await base.onError(task, error, durationMs);
+                }
+                if (override?.onError) {
+                    await override.onError(task, error, durationMs);
+                }
+            },
+        };
+    }
+}
+exports.ParallelRunner = ParallelRunner;
+const createDefaultParallelRunner = () => new ParallelRunner();
+exports.createDefaultParallelRunner = createDefaultParallelRunner;
+//# sourceMappingURL=parallel-runner.js.map

package/dist/core/parallel/parallel-runner.js.map

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

package/dist/core/parallel/types.d.ts

@@ -0,0 +1,41 @@
+export interface Task<T> {
+    id: string;
+    metadata?: Record<string, unknown>;
+    run: (context: TaskExecutionContext) => Promise<T>;
+}
+export interface TaskExecutionContext {
+    signal: AbortSignal;
+}
+export interface TaskResult<T> {
+    taskId: string;
+    success: boolean;
+    value?: T;
+    error?: Error;
+    durationMs: number;
+    startedAt: number;
+    finishedAt: number;
+    metadata?: Record<string, unknown>;
+    aborted?: boolean;
+}
+export interface TaskCallbacks<T> {
+    onTaskStart?: (task: Task<T>) => void | Promise<void>;
+    onTaskComplete?: (result: TaskResult<T>) => void | Promise<void>;
+    onError?: (task: Task<T>, error: Error, durationMs: number) => void | Promise<void>;
+}
+export interface ParallelRunnerOptions<T = unknown> {
+    maxConcurrency?: number;
+    timeoutMs?: number;
+    failFast?: boolean;
+    callbacks?: TaskCallbacks<T>;
+    evaluateTaskSuccess?: (value: T, task: Task<T>) => boolean;
+}
+export interface ParallelRunnerMetrics {
+    totalTasks: number;
+    startedTasks: number;
+    completedTasks: number;
+    successCount: number;
+    failureCount: number;
+    totalDurationMs: number;
+    averageDurationMs: number;
+    throughput: number;
+}

package/dist/core/parallel/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/core/parallel/types.js.map

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