@mondaydotcomorg/agent-toolkit 0.1.0

package/README.md

@@ -0,0 +1,170 @@
+# @mondaydotcomorg/agent-toolkit
+
+A powerful toolkit for building AI agents that interact with the Monday.com API. This package provides a set of tools and utilities to help you create AI-powered integrations with Monday.com, supporting both OpenAI and Model Context Protocol (MCP) implementations.
+
+## Installation
+
+```bash
+npm install @mondaydotcomorg/agent-toolkit
+```
+
+## Features
+
+- OpenAI integration support
+- Model Context Protocol (MCP) support
+- Pre-built Monday.com API tools
+- TypeScript support with full type definitions
+- Modular architecture with subpath exports
+
+## Subpath Exports
+
+The package provides several modular components that can be imported separately:
+
+- `@mondaydotcomorg/agent-toolkit/mcp` - MCP server implementation
+- `@mondaydotcomorg/agent-toolkit/tools` - Monday.com API tools
+- `@mondaydotcomorg/agent-toolkit/core` - Core utilities and base classes
+- `@mondaydotcomorg/agent-toolkit/openai` - OpenAI integration
+
+## Available Tools
+
+The toolkit includes several pre-built tools for common Monday.com operations:
+
+- Delete Item Tool
+- Get Board Items Tool
+- Create Item Tool
+- Create Update Tool
+- Get Board Schema Tool
+
+## Usage
+
+### OpenAI Integration
+
+```typescript
+import { MondayAgentToolkit } from '@mondaydotcomorg/agent-toolkit/openai';
+import OpenAI from 'openai';
+
+// Initialize the Monday.com Agent Toolkit
+const mondayToolkit = new MondayAgentToolkit({
+  mondayApiToken: 'your-monday-api-token',
+  mondayApiVersion: '2025-01',
+  mondayApiRequestConfig: {},
+  toolsConfiguration: {
+    // Optional: Configure available tools
+    include: ['deleteItem', 'getBoardItems'],
+    // OR exclude specific tools
+    // exclude: ['createItem'],
+    // Disable all mutation operations
+    // disableMutations: true,
+  }
+});
+
+
+### MCP Integration
+
+```typescript
+import { MondayAgentToolkit } from '@mondaydotcomorg/agent-toolkit/mcp';
+
+// Initialize with all tools
+const toolkit = new MondayAgentToolkit({
+  mondayApiToken: 'your-monday-api-token',
+  mondayApiVersion: 'your-api-version',
+  mondayApiRequestConfig: {} // Optional request config
+});
+
+// Or initialize with specific tools / disable mutations
+const toolkitWithSpecificTools = new MondayAgentToolkit({
+  mondayApiToken: 'your-monday-api-token',
+  mondayApiVersion: 'your-api-version',
+  mondayApiRequestConfig: {},
+  tools: {
+    include: ['mcp_monday_api_mcp_delete_item', 'create monday item'], // Only include these tools
+    readOnlyMode: true, // Disable all mutation tools (create, update, delete operations)
+    // OR
+    // exclude: ['tool_name_to_exclude'] // Include all tools except these
+  }
+});
+
+// The toolkit extends McpServer and automatically registers all available tools
+```
+
+### Types
+
+The toolkit categorizes tools into two types:
+
+- **Query Tools**: Read-only operations that fetch data (e.g., get board items, get board schema)
+- **Mutation Tools**: Write operations that modify data (e.g., create item, delete item, create update)
+
+You can disable all mutation tools using the `readOnlyMode` option in the configuration. This is useful when you want to ensure that your agent can only read data and cannot make any modifications.
+
+### Using Individual Tools
+
+```typescript
+import { CreateItemTool } from '@mondaydotcomorg/agent-toolkit/tools';
+import { ApiClient } from '@mondaydotcomorg/api';
+
+const apiClient = new ApiClient({
+  token: 'your-monday-api-token',
+  apiVersion: 'your-api-version'
+});
+
+const createItemTool = new CreateItemTool(apiClient);
+await createItemTool.execute(/* tool input */);
+```
+
+## Requirements
+
+- Node.js >= 16.20.0
+- Monday.com API token
+- OpenAI API key (if using OpenAI integration)
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build the package
+npm run build
+
+# Run tests
+npm test
+
+# Format code
+npm run prettier
+
+# Lint code
+npm run lint
+
+# Watch mode during development
+npm run watch
+
+# Update Monday.com GraphQL schema
+npm run fetch:schema
+
+# Generate types from schema
+npm run codegen
+
+# Fetch schema and generate types
+npm run fetch:generate
+```
+
+## License
+
+MIT
+
+## Author
+
+monday.com API Team
+
+## Repository
+
+[GitHub Repository](https://github.com/mondaycom/monday-graphql-api/tree/main/packages/agent-toolkit)
+
+## Keywords
+
+- monday
+- api
+- agent-toolkit
+- openai
+- mcp
+- ai-agents

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@mondaydotcomorg/agent-toolkit",
+  "version": "0.1.0",
+  "description": "monday.com agent toolkit",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/esm/index.d.ts",
+  "type": "module",
+  "exports": {
+    "./mcp": {
+      "import": "./dist/esm/mcp/index.js",
+      "require": "./dist/cjs/mcp/index.js",
+      "types": "./dist/esm/mcp/index.d.ts"
+    },
+    "./tools": {
+      "import": "./dist/esm/tools/index.js",
+      "require": "./dist/cjs/tools/index.js",
+      "types": "./dist/esm/tools/index.d.ts"
+    },
+    "./core": {
+      "import": "./dist/esm/core/index.js",
+      "require": "./dist/cjs/core/index.js",
+      "types": "./dist/esm/core/index.d.ts"
+    },
+    "./openai": {
+      "import": "./dist/esm/openai/index.js",
+      "require": "./dist/cjs/openai/index.js",
+      "types": "./dist/esm/openai/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "prettier": "prettier --write \"lib/**/*.ts\"",
+    "lint": "eslint --fix \"lib/**/*.ts\"",
+    "test": "jest -c",
+    "watch": "rollup -c -w",
+    "fetch:schema": "bash fetch-schema.sh",
+    "codegen": "graphql-codegen",
+    "fetch:generate": "npm run fetch:schema && npm run codegen"
+  },
+  "engines": {
+    "node": ">= 16.20.0"
+  },
+  "author": "monday.com Api Team",
+  "license": "MIT",
+  "keywords": [
+    "monday",
+    "api",
+    "agent-toolkit"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mondaycom/monday-graphql-api/tree/main/packages/agent-toolkit"
+  },
+  "dependencies": {
+    "@mondaydotcomorg/api": "^9.0.1",
+    "zod": "^3.24.2",
+    "zod-to-json-schema": "^3.24.5"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^25.0.7",
+    "@rollup/plugin-json": "^6.1.0",
+    "@rollup/plugin-node-resolve": "^15.2.3",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^11.1.6",
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.11.18",
+    "jest": "^29.7.0",
+    "moment": "^2.30.1",
+    "rollup": "^2.79.1",
+    "rollup-plugin-delete": "^2.0.0",
+    "rollup-plugin-dts": "^4.2.3",
+    "ts-jest": "^29.1.2",
+    "typescript": "^4.9.5"
+  },
+  "peerDependencies": {
+    "@langchain/core": "^0.3.43",
+    "@modelcontextprotocol/sdk": "^1.8.0",
+    "openai": "^4.91.0"
+  }
+}