mirror of
https://github.com/czlonkowski/n8n-mcp.git
synced 2026-02-06 05:23:08 +00:00
feat: add intelligent execution data filtering to n8n_get_execution tool
Implements comprehensive execution data filtering system to enable AI agents to inspect large workflow executions without exceeding token limits. Features: - Preview mode: Shows structure, counts, and size estimates (~500 tokens) - Summary mode: Returns 2 sample items per node (~2-5K tokens) - Filtered mode: Granular control with itemsLimit and nodeNames - Full mode: Complete data retrieval (explicit opt-in) - Smart recommendations based on data size analysis - Structure-only mode (itemsLimit: 0) for schema inspection - 100% backward compatibility with legacy includeData parameter Technical improvements: - New ExecutionProcessor service with intelligent filtering logic - Type-safe implementation with Record<string, unknown> over any - Comprehensive validation and error handling - 33 unit tests with 78% coverage - Constants-based thresholds for easy tuning Bug fixes: - Fixed preview mode API data fetching to enable structure analysis - Validates and caps itemsLimit to prevent abuse Impact: - Reduces token usage by 80-95% for large datasets (50+ items) - Prevents token overflow when inspecting workflow executions - Enables recommended workflow: preview → recommendation → targeted fetch 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
@@ -290,4 +290,84 @@ export interface McpToolResponse {
|
||||
message?: string;
|
||||
code?: string;
|
||||
details?: Record<string, unknown>;
|
||||
}
|
||||
|
||||
// Execution Filtering Types
|
||||
export type ExecutionMode = 'preview' | 'summary' | 'filtered' | 'full';
|
||||
|
||||
export interface ExecutionPreview {
|
||||
totalNodes: number;
|
||||
executedNodes: number;
|
||||
estimatedSizeKB: number;
|
||||
nodes: Record<string, NodePreview>;
|
||||
}
|
||||
|
||||
export interface NodePreview {
|
||||
status: 'success' | 'error';
|
||||
itemCounts: {
|
||||
input: number;
|
||||
output: number;
|
||||
};
|
||||
dataStructure: Record<string, any>;
|
||||
estimatedSizeKB: number;
|
||||
error?: string;
|
||||
}
|
||||
|
||||
export interface ExecutionRecommendation {
|
||||
canFetchFull: boolean;
|
||||
suggestedMode: ExecutionMode;
|
||||
suggestedItemsLimit?: number;
|
||||
reason: string;
|
||||
}
|
||||
|
||||
export interface ExecutionFilterOptions {
|
||||
mode?: ExecutionMode;
|
||||
nodeNames?: string[];
|
||||
itemsLimit?: number;
|
||||
includeInputData?: boolean;
|
||||
fieldsToInclude?: string[];
|
||||
}
|
||||
|
||||
export interface FilteredExecutionResponse {
|
||||
id: string;
|
||||
workflowId: string;
|
||||
status: ExecutionStatus;
|
||||
mode: ExecutionMode;
|
||||
startedAt: string;
|
||||
stoppedAt?: string;
|
||||
duration?: number;
|
||||
finished: boolean;
|
||||
|
||||
// Preview-specific data
|
||||
preview?: ExecutionPreview;
|
||||
recommendation?: ExecutionRecommendation;
|
||||
|
||||
// Summary/Filtered data
|
||||
summary?: {
|
||||
totalNodes: number;
|
||||
executedNodes: number;
|
||||
totalItems: number;
|
||||
hasMoreData: boolean;
|
||||
};
|
||||
nodes?: Record<string, FilteredNodeData>;
|
||||
|
||||
// Error information
|
||||
error?: Record<string, unknown>;
|
||||
}
|
||||
|
||||
export interface FilteredNodeData {
|
||||
executionTime?: number;
|
||||
itemsInput: number;
|
||||
itemsOutput: number;
|
||||
status: 'success' | 'error';
|
||||
error?: string;
|
||||
data?: {
|
||||
input?: any[][];
|
||||
output?: any[][];
|
||||
metadata: {
|
||||
totalItems: number;
|
||||
itemsShown: number;
|
||||
truncated: boolean;
|
||||
};
|
||||
};
|
||||
}
|
||||
Reference in New Issue
Block a user