ruvnet/ruflo · error · Error

Parameter '${name}' exceeds maximum of ${maxItems} items

Error message

Parameter '${name}' exceeds maximum of ${maxItems} items

What it means

MCP input-validation helper: validateArrayParam() received an array with more than maxItems (default MAX_ARRAY_ITEMS) entries. The size cap bounds untrusted tool-argument payloads before they reach team/teammate logic.

Source

Thrown at v3/plugins/teammate-plugin/src/mcp-tools.ts:52

function validateStringParam(value: unknown, name: string, maxLength: number = MAX_PARAM_LENGTH): string {
  if (typeof value !== 'string') {
    throw new Error(`Parameter '${name}' must be a string`);
  }
  if (value.length > maxLength) {
    throw new Error(`Parameter '${name}' exceeds maximum length of ${maxLength}`);
  }
  return value;
}

/**
 * Validate array parameter
 */
function validateArrayParam<T>(value: unknown, name: string, maxItems: number = MAX_ARRAY_ITEMS): T[] {
  if (!Array.isArray(value)) {
    throw new Error(`Parameter '${name}' must be an array`);
  }
  if (value.length > maxItems) {
    throw new Error(`Parameter '${name}' exceeds maximum of ${maxItems} items`);
  }
  return value as T[];
}

// ============================================================================
// Tool Definitions
// ============================================================================

export interface MCPTool {
  name: string;
  description: string;
  inputSchema: {
    type: 'object';
    properties: Record<string, unknown>;
    required?: string[];
  };
}

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Reduce the input size/depth below the documented limit, or batch the input into smaller chunks.
2. Validate the limit before processing and report the measured versus allowed value to the caller.

When it happens

Trigger: Thrown at v3/plugins/teammate-plugin/src/mcp-tools.ts:52 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of ruvnet/ruflo@fa13ee4ad6 (2026-08-18). Data as JSON: /api/errors/9438488f80cfa9e3. Report an issue: GitHub.