Add board insights tool (#115)

* Add board stats tool and related utilities for aggregating board statistics

- Introduced `BoardStatsTool` for retrieving aggregated statistics of boards.
- Added utility functions for handling input and constructing GraphQL queries.
- Created constants for managing complex and transformative aggregation functions.
- Defined GraphQL queries for fetching board statistics.
- Updated GraphQL schema to include new types and queries related to bulk import functionality.

* updated descriptions

* name

* desc

* update

* fix

* fix bugs

* tests

* fix + test

* order by

* added comments

* added count items sup

* Implement Board Insights Tool with utility functions and tests

- Introduced the BoardInsightsTool for aggregating insights from boards, including support for filters, grouping, and ordering.
- Added utility functions for handling input schema, filters, and select/group by elements.
- Created comprehensive tests for the BoardInsightsTool, covering various scenarios including filtering, grouping, and handling different value types.
- Updated GraphQL queries to support the new insights functionality.
- Replaced BoardStatsTool with BoardInsightsTool in the API tools index.

* Refactor Board Insights Tool filters structure and update schema

- Changed the filters structure from an object with rules to an array format for better consistency and usability.
- Introduced a new `filtersOperator` field to specify the logical operator for filters.
- Updated the handling of filters in the utility function to accommodate the new structure.
- Adjusted tests to reflect the changes in the filters format and ensure correct functionality.

* Refactor Board Insights Tool to use new aggregation function constants

- Replaced the deprecated `AggregateSelectFunctionName` with `BoardInsightsAggregationFunction` in the schema for better clarity and maintainability.
- Removed unused `complexFunctions` import and related error handling for unsupported functions.
- Updated the constants file to programmatically define allowed aggregation functions, excluding complex ones.
- Adjusted utility functions to align with the new aggregation structure.

* added default limit

* Enhance Board Insights Tool with stringified input support and improved descriptions

- Added support for stringified fields: `aggregationsStringified`, `filtersStringified`, and `orderByStringified` to accommodate Microsoft Copilot compatibility.
- Updated the tool's description to clarify usage and preconditions for effective operation.
- Enhanced input validation to ensure either non-stringified or stringified fields are provided.
- Adjusted utility functions to handle the new stringified input formats.
- Expanded test coverage to validate the new functionality and ensure correct behavior with stringified inputs.

* Bump version

* Remove validations already covered by helper method

---------

Co-authored-by: Damian Rakus <[email protected]>

Author: Alexjitk

packages/agent-toolkit/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mondaydotcomorg/agent-toolkit",
-  "version": "2.20.3",
+  "version": "2.21.0",
   "description": "monday.com agent toolkit",
   "exports": {
     "./mcp": {