universal-agent-memory 1.0.17 → 1.0.19

package/dist/models/executor.js

@@ -0,0 +1,383 @@
+/**
+ * Task Executor
+ *
+ * Tier 2 of the Multi-Model Architecture.
+ * Responsible for:
+ * - Executing subtasks following planner specifications
+ * - Managing retries and fallbacks
+ * - Tracking execution results and costs
+ */
+const DEFAULT_OPTIONS = {
+    maxRetries: 2,
+    retryDelayMs: 1000,
+    stepTimeout: 120000,
+    enableFallback: true,
+    parallelExecution: true,
+    maxParallel: 3,
+};
+/**
+ * Task Executor - executes plans created by the planner
+ */
+export class TaskExecutor {
+    router;
+    config;
+    client;
+    options;
+    results;
+    constructor(router, config, client, options = {}) {
+        this.router = router;
+        this.config = config;
+        this.client = client;
+        this.options = { ...DEFAULT_OPTIONS, ...options };
+        this.results = new Map();
+    }
+    /**
+     * Execute a complete plan
+     */
+    async executePlan(plan, planner, onProgress) {
+        const allResults = [];
+        const outputs = new Map();
+        // Get execution order from planner
+        const executionOrder = planner.getExecutionOrder(plan);
+        for (const levelTasks of executionOrder) {
+            if (this.options.parallelExecution && levelTasks.length > 1) {
+                // Execute level in parallel
+                const levelResults = await this.executeParallel(plan, levelTasks, outputs, onProgress);
+                allResults.push(...levelResults);
+                // Update outputs
+                for (const result of levelResults) {
+                    if (result.success) {
+                        outputs.set(result.subtaskId, result.output);
+                    }
+                }
+            }
+            else {
+                // Execute sequentially
+                for (const taskId of levelTasks) {
+                    const result = await this.executeSubtask(plan, taskId, outputs);
+                    allResults.push(result);
+                    onProgress?.(result);
+                    if (result.success) {
+                        outputs.set(taskId, result.output);
+                    }
+                }
+            }
+        }
+        // Store results
+        this.results.set(plan.id, allResults);
+        return allResults;
+    }
+    /**
+     * Execute multiple subtasks in parallel
+     */
+    async executeParallel(plan, taskIds, inputs, onProgress) {
+        const maxParallel = this.options.maxParallel || 3;
+        const results = [];
+        // Process in batches
+        for (let i = 0; i < taskIds.length; i += maxParallel) {
+            const batch = taskIds.slice(i, i + maxParallel);
+            const batchResults = await Promise.all(batch.map(taskId => this.executeSubtask(plan, taskId, inputs)));
+            for (const result of batchResults) {
+                results.push(result);
+                onProgress?.(result);
+            }
+        }
+        return results;
+    }
+    /**
+     * Execute a single subtask with retry logic
+     */
+    async executeSubtask(plan, subtaskId, inputs) {
+        const subtask = plan.subtasks.find(s => s.id === subtaskId);
+        if (!subtask) {
+            return this.createErrorResult(plan.id, subtaskId, 'Subtask not found');
+        }
+        const modelId = plan.modelAssignments.get(subtaskId);
+        const model = modelId ? this.router.getModel(modelId) : undefined;
+        if (!model) {
+            return this.createErrorResult(plan.id, subtaskId, 'No model assigned');
+        }
+        const context = {
+            planId: plan.id,
+            subtaskId,
+            inputs,
+            constraints: subtask.constraints,
+            previousAttempts: [],
+        };
+        let lastError;
+        let retryCount = 0;
+        // Try with primary model
+        for (let attempt = 0; attempt <= (this.options.maxRetries || 0); attempt++) {
+            try {
+                const result = await this.attemptExecution(model, subtask, context);
+                result.retryCount = retryCount;
+                return result;
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error.message : String(error);
+                retryCount++;
+                if (attempt < (this.options.maxRetries || 0)) {
+                    await this.delay(this.options.retryDelayMs || 1000);
+                }
+            }
+        }
+        // Try fallback if enabled
+        if (this.options.enableFallback) {
+            const fallbackModel = this.router.getModelForRole('fallback');
+            if (fallbackModel && fallbackModel.id !== model.id) {
+                try {
+                    const result = await this.attemptExecution(fallbackModel, subtask, context);
+                    result.retryCount = retryCount;
+                    result.modelUsed = fallbackModel.id;
+                    return result;
+                }
+                catch (error) {
+                    lastError = error instanceof Error ? error.message : String(error);
+                }
+            }
+        }
+        return this.createErrorResult(plan.id, subtaskId, lastError || 'Execution failed', retryCount);
+    }
+    /**
+     * Attempt to execute a subtask with a specific model
+     */
+    async attemptExecution(model, subtask, context) {
+        const startTime = Date.now();
+        // Build prompt
+        const prompt = this.buildPrompt(subtask, context);
+        // Execute
+        const response = await this.client.complete(model, prompt, {
+            maxTokens: this.getMaxTokens(subtask),
+            timeout: this.options.stepTimeout,
+        });
+        const duration = Date.now() - startTime;
+        // Calculate cost
+        const cost = this.router.estimateCost(model, response.tokensUsed.input, response.tokensUsed.output);
+        return {
+            planId: context.planId,
+            subtaskId: context.subtaskId,
+            modelUsed: model.id,
+            success: true,
+            output: response.content,
+            tokensUsed: response.tokensUsed,
+            cost,
+            duration,
+            retryCount: 0,
+        };
+    }
+    /**
+     * Build the prompt for a subtask
+     */
+    buildPrompt(subtask, context) {
+        const parts = [
+            `## Task: ${subtask.title}`,
+            '',
+            subtask.description,
+            '',
+        ];
+        // Add inputs
+        if (context.inputs.size > 0) {
+            parts.push('## Available Context:');
+            for (const [key, value] of context.inputs) {
+                if (subtask.inputs.includes(key)) {
+                    parts.push(`### ${key}:`);
+                    parts.push('```');
+                    parts.push(value.slice(0, 2000)); // Limit input size
+                    parts.push('```');
+                    parts.push('');
+                }
+            }
+        }
+        // Add constraints
+        if (context.constraints.length > 0) {
+            parts.push('## Constraints:');
+            for (const constraint of context.constraints) {
+                parts.push(`- ${constraint}`);
+            }
+            parts.push('');
+        }
+        // Add expected outputs
+        parts.push('## Expected Outputs:');
+        for (const output of subtask.outputs) {
+            parts.push(`- ${output}`);
+        }
+        parts.push('');
+        // Add instructions based on type
+        parts.push('## Instructions:');
+        switch (subtask.type) {
+            case 'coding':
+                parts.push('Provide working code that satisfies the requirements.');
+                parts.push('Include proper error handling and types.');
+                break;
+            case 'planning':
+                parts.push('Provide a detailed plan with clear steps.');
+                parts.push('Identify risks and dependencies.');
+                break;
+            case 'review':
+                parts.push('Review the provided code/content critically.');
+                parts.push('Identify issues, security concerns, and improvements.');
+                break;
+            case 'documentation':
+                parts.push('Write clear, comprehensive documentation.');
+                parts.push('Include examples and usage instructions.');
+                break;
+            default:
+                parts.push('Complete the task as specified.');
+        }
+        // Add retry context if applicable
+        if (context.previousAttempts.length > 0) {
+            parts.push('');
+            parts.push('## Previous Attempt Failed:');
+            const lastAttempt = context.previousAttempts[context.previousAttempts.length - 1];
+            if (lastAttempt.error) {
+                parts.push(`Error: ${lastAttempt.error}`);
+            }
+            parts.push('Please address the issue and try again.');
+        }
+        return parts.join('\n');
+    }
+    /**
+     * Get max tokens based on subtask complexity
+     */
+    getMaxTokens(subtask) {
+        const baseTokens = {
+            low: 2000,
+            medium: 4000,
+            high: 8000,
+            critical: 12000,
+        };
+        return baseTokens[subtask.complexity] || 4000;
+    }
+    /**
+     * Create an error result
+     */
+    createErrorResult(planId, subtaskId, error, retryCount = 0) {
+        return {
+            planId,
+            subtaskId,
+            modelUsed: 'none',
+            success: false,
+            output: '',
+            error,
+            tokensUsed: { input: 0, output: 0 },
+            cost: 0,
+            duration: 0,
+            retryCount,
+        };
+    }
+    /**
+     * Helper to delay
+     */
+    delay(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    /**
+     * Get results for a plan
+     */
+    getResults(planId) {
+        return this.results.get(planId);
+    }
+    /**
+     * Get total cost for a plan
+     */
+    getTotalCost(planId) {
+        const results = this.results.get(planId);
+        if (!results)
+            return 0;
+        return results.reduce((sum, r) => sum + r.cost, 0);
+    }
+    /**
+     * Get success rate for a plan
+     */
+    getSuccessRate(planId) {
+        const results = this.results.get(planId);
+        if (!results || results.length === 0)
+            return 0;
+        const successful = results.filter(r => r.success).length;
+        return (successful / results.length) * 100;
+    }
+    /**
+     * Generate execution summary
+     */
+    generateSummary(planId) {
+        const results = this.results.get(planId);
+        if (!results)
+            return 'No results found for plan';
+        const successful = results.filter(r => r.success);
+        const failed = results.filter(r => !r.success);
+        const totalCost = this.getTotalCost(planId);
+        const totalDuration = results.reduce((sum, r) => sum + r.duration, 0);
+        const totalTokens = results.reduce((sum, r) => sum + r.tokensUsed.input + r.tokensUsed.output, 0);
+        const lines = [
+            `=== Execution Summary: ${planId.slice(0, 8)} ===`,
+            '',
+            `Total Subtasks: ${results.length}`,
+            `Successful: ${successful.length}`,
+            `Failed: ${failed.length}`,
+            `Success Rate: ${this.getSuccessRate(planId).toFixed(1)}%`,
+            '',
+            `Total Cost: $${totalCost.toFixed(4)}`,
+            `Total Duration: ${(totalDuration / 1000).toFixed(1)}s`,
+            `Total Tokens: ${totalTokens.toLocaleString()}`,
+            '',
+        ];
+        if (failed.length > 0) {
+            lines.push('Failed Subtasks:');
+            for (const result of failed) {
+                lines.push(`  - ${result.subtaskId}: ${result.error || 'Unknown error'}`);
+            }
+            lines.push('');
+        }
+        // Model usage breakdown
+        const modelUsage = new Map();
+        for (const result of results) {
+            const existing = modelUsage.get(result.modelUsed) || { count: 0, cost: 0, tokens: 0 };
+            existing.count++;
+            existing.cost += result.cost;
+            existing.tokens += result.tokensUsed.input + result.tokensUsed.output;
+            modelUsage.set(result.modelUsed, existing);
+        }
+        lines.push('Model Usage:');
+        for (const [model, usage] of modelUsage) {
+            lines.push(`  ${model}: ${usage.count} tasks, $${usage.cost.toFixed(4)}, ${usage.tokens.toLocaleString()} tokens`);
+        }
+        return lines.join('\n');
+    }
+}
+/**
+ * Create an executor instance
+ */
+export function createExecutor(router, config, client, options) {
+    return new TaskExecutor(router, config, client, options);
+}
+/**
+ * Mock client for testing
+ */
+export class MockModelClient {
+    responses;
+    latency;
+    constructor(responses, latency = 1000) {
+        this.responses = new Map(Object.entries(responses || {}));
+        this.latency = latency;
+    }
+    async complete(model, prompt) {
+        await new Promise(resolve => setTimeout(resolve, this.latency));
+        // Find matching response or generate default
+        let content = `Mock response from ${model.name}`;
+        for (const [key, value] of this.responses) {
+            if (prompt.toLowerCase().includes(key.toLowerCase())) {
+                content = value;
+                break;
+            }
+        }
+        return {
+            content,
+            tokensUsed: {
+                input: Math.ceil(prompt.length / 4),
+                output: Math.ceil(content.length / 4),
+            },
+            latencyMs: this.latency,
+        };
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/models/executor.js.map

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

package/dist/models/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Multi-Model Architecture
+ *
+ * Exports for the two-tier agentic architecture:
+ * - Router: Task classification and model selection
+ * - Planner: Task decomposition and execution planning
+ * - Executor: Subtask execution with retry/fallback
+ */
+export * from './types.js';
+export { ModelRouter, createRouter, createCostOptimizedRouter, createPerformanceRouter, } from './router.js';
+export { TaskPlanner, createPlanner, } from './planner.js';
+export type { PlannerOptions } from './planner.js';
+export { TaskExecutor, createExecutor, MockModelClient, } from './executor.js';
+export type { ModelClient, ExecutionContext, ExecutorOptions, } from './executor.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/models/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,cAAc,YAAY,CAAC;AAG3B,OAAO,EACL,WAAW,EACX,YAAY,EACZ,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,WAAW,EACX,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGnD,OAAO,EACL,YAAY,EACZ,cAAc,EACd,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,eAAe,GAChB,MAAM,eAAe,CAAC"}

package/dist/models/index.js

@@ -0,0 +1,17 @@
+/**
+ * Multi-Model Architecture
+ *
+ * Exports for the two-tier agentic architecture:
+ * - Router: Task classification and model selection
+ * - Planner: Task decomposition and execution planning
+ * - Executor: Subtask execution with retry/fallback
+ */
+// Types
+export * from './types.js';
+// Router
+export { ModelRouter, createRouter, createCostOptimizedRouter, createPerformanceRouter, } from './router.js';
+// Planner
+export { TaskPlanner, createPlanner, } from './planner.js';
+// Executor
+export { TaskExecutor, createExecutor, MockModelClient, } from './executor.js';
+//# sourceMappingURL=index.js.map

package/dist/models/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,QAAQ;AACR,cAAc,YAAY,CAAC;AAE3B,SAAS;AACT,OAAO,EACL,WAAW,EACX,YAAY,EACZ,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAErB,UAAU;AACV,OAAO,EACL,WAAW,EACX,aAAa,GACd,MAAM,cAAc,CAAC;AAGtB,WAAW;AACX,OAAO,EACL,YAAY,EACZ,cAAc,EACd,eAAe,GAChB,MAAM,eAAe,CAAC"}

package/dist/models/planner.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Task Planner
+ *
+ * Tier 1 of the Multi-Model Architecture.
+ * Responsible for:
+ * - Task decomposition into subtasks
+ * - Dependency analysis
+ * - Model assignment for each subtask
+ * - Quality assurance routing
+ */
+import { ExecutionPlan, MultiModelConfig } from './types.js';
+import { ModelRouter } from './router.js';
+/**
+ * Planner configuration options
+ */
+export interface PlannerOptions {
+    maxSubtasks?: number;
+    maxDepth?: number;
+    enableParallelization?: boolean;
+    estimateTokenBudget?: boolean;
+}
+/**
+ * Task Planner - decomposes tasks and creates execution plans
+ */
+export declare class TaskPlanner {
+    private router;
+    readonly config: MultiModelConfig;
+    private options;
+    constructor(router: ModelRouter, config: MultiModelConfig, options?: PlannerOptions);
+    /**
+     * Create an execution plan for a task
+     */
+    createPlan(taskDescription: string): ExecutionPlan;
+    /**
+     * Decompose a complex task into subtasks
+     */
+    private decomposeTask;
+    /**
+     * Create a single subtask for simple tasks
+     */
+    private createSingleSubtask;
+    /**
+     * Analyze dependencies between subtasks
+     */
+    private analyzeDependencies;
+    /**
+     * Assign models to subtasks based on routing
+     */
+    private assignModels;
+    /**
+     * Estimate total cost for the plan
+     */
+    private estimateTotalCost;
+    /**
+     * Estimate duration considering parallelization
+     */
+    private estimateDuration;
+    /**
+     * Get execution order respecting dependencies
+     */
+    getExecutionOrder(plan: ExecutionPlan): string[][];
+    /**
+     * Visualize the plan as text
+     */
+    visualizePlan(plan: ExecutionPlan): string;
+}
+/**
+ * Create a planner instance
+ */
+export declare function createPlanner(router: ModelRouter, config: MultiModelConfig, options?: PlannerOptions): TaskPlanner;
+//# sourceMappingURL=planner.d.ts.map

package/dist/models/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../src/models/planner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EACL,aAAa,EAGb,gBAAgB,EACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK1C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AASD;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAc;IAC5B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,OAAO,CAAC,OAAO,CAAiB;gBAG9B,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,gBAAgB,EACxB,OAAO,GAAE,cAAmB;IAO9B;;OAEG;IACH,UAAU,CAAC,eAAe,EAAE,MAAM,GAAG,aAAa;IAiClD;;OAEG;IACH,OAAO,CAAC,aAAa;IAyFrB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAgB3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA4B3B;;OAEG;IACH,OAAO,CAAC,YAAY;IAepB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA4BzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA0DxB;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,EAAE,EAAE;IAoClD;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM;CAgC3C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAEb"}