@mondaydotcomorg/agent-toolkit 0.1.6 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mondaydotcomorg/agent-toolkit",
3
- "version": "0.1.6",
3
+ "version": "1.0.0",
4
4
  "description": "monday.com agent toolkit",
5
5
  "type": "module",
6
6
  "exports": {
@@ -9,11 +9,6 @@
9
9
  "require": "./dist/cjs/mcp/index.js",
10
10
  "types": "./dist/esm/mcp/index.d.ts"
11
11
  },
12
- "./tools": {
13
- "import": "./dist/esm/tools/index.js",
14
- "require": "./dist/cjs/tools/index.js",
15
- "types": "./dist/esm/tools/index.d.ts"
16
- },
17
12
  "./core": {
18
13
  "import": "./dist/esm/core/index.js",
19
14
  "require": "./dist/cjs/core/index.js",
@@ -31,8 +26,8 @@
31
26
  ],
32
27
  "scripts": {
33
28
  "build": "rollup -c",
34
- "prettier": "prettier --write \"lib/**/*.ts\" --ignore-path \"../../.prettierignore\"",
35
- "lint": "eslint --fix \"lib/**/*.ts\" --ignore-path \"../../.eslintignore\"",
29
+ "prettier": "prettier --write \"src/**/*.ts\" --ignore-path \"../../.prettierignore\"",
30
+ "lint": "eslint --fix \"src/**/*.ts\" --ignore-path \"../../.eslintignore\"",
36
31
  "test": "jest -c",
37
32
  "watch": "rollup -c -w",
38
33
  "fetch:schema": "bash fetch-schema.sh",
@@ -42,7 +37,7 @@
42
37
  "engines": {
43
38
  "node": ">= 16.20.0"
44
39
  },
45
- "author": "monday.com Api Team",
40
+ "author": "monday.com AI Team",
46
41
  "license": "MIT",
47
42
  "keywords": [
48
43
  "monday",
@@ -51,17 +46,17 @@
51
46
  ],
52
47
  "repository": {
53
48
  "type": "git",
54
- "url": "https://github.com/mondaycom/monday-graphql-api/tree/main/packages/agent-toolkit"
49
+ "url": "https://github.com/mondaycom/monday-ai/tree/master/packages/agent-toolkit"
55
50
  },
56
51
  "dependencies": {
57
- "@mondaydotcomorg/api": "*",
52
+ "@mondaydotcomorg/api": "^9.0.1",
58
53
  "zod": "^3.24.2",
59
- "zod-to-json-schema": "^3.24.5",
60
- "@langchain/core": "^0.3.43",
61
- "@modelcontextprotocol/sdk": "^1.8.0",
62
- "openai": "^4.91.0"
54
+ "zod-to-json-schema": "^3.24.5"
63
55
  },
64
56
  "devDependencies": {
57
+ "@graphql-codegen/cli": "^5.0.5",
58
+ "@graphql-codegen/typescript": "^4.1.6",
59
+ "@graphql-codegen/typescript-operations": "^4.6.0",
65
60
  "@rollup/plugin-commonjs": "^25.0.7",
66
61
  "@rollup/plugin-json": "^6.1.0",
67
62
  "@rollup/plugin-node-resolve": "^15.2.3",
@@ -71,10 +66,15 @@
71
66
  "@types/node": "^20.11.18",
72
67
  "jest": "^29.7.0",
73
68
  "moment": "^2.30.1",
69
+ "openai": "^4.93.0",
74
70
  "rollup": "^2.79.1",
75
71
  "rollup-plugin-delete": "^2.0.0",
76
72
  "rollup-plugin-dts": "^4.2.3",
77
73
  "ts-jest": "^29.1.2",
78
74
  "typescript": "^4.9.5"
75
+ },
76
+ "peerDependencies": {
77
+ "@modelcontextprotocol/sdk": "^1.8.0",
78
+ "openai": "^4.93.0"
79
79
  }
80
80
  }
@@ -1,334 +0,0 @@
1
- import { ZodRawShape, z, ZodTypeAny } from 'zod';
2
- import { ApiClient } from '@mondaydotcomorg/api';
3
-
4
- interface Executable<Input, Output> {
5
- execute: (input?: Input) => Promise<Output>;
6
- }
7
-
8
- type ToolInputType<Input extends ZodRawShape | undefined> = Input extends ZodRawShape ? z.objectOutputType<Input, ZodTypeAny> : undefined;
9
- type ToolOutputType<T extends Record<string, unknown>> = {
10
- content: string;
11
- metadata?: T;
12
- };
13
- declare enum ToolType {
14
- QUERY = "query",
15
- MUTATION = "mutation",
16
- ALL_API = "all_api"
17
- }
18
- interface Tool<Input extends ZodRawShape | undefined, Output extends Record<string, unknown> = never> extends Executable<ToolInputType<Input>, ToolOutputType<Output>> {
19
- name: string;
20
- type: ToolType;
21
- getDescription(): string;
22
- getInputSchema(): Input;
23
- }
24
-
25
- type MondayApiToolContext = {
26
- boardId?: number;
27
- };
28
- declare abstract class BaseMondayApiTool<Input extends ZodRawShape | undefined, Output extends Record<string, unknown> = never> implements Tool<Input, Output> {
29
- protected readonly mondayApi: ApiClient;
30
- protected readonly context?: MondayApiToolContext | undefined;
31
- abstract name: string;
32
- abstract type: ToolType;
33
- constructor(mondayApi: ApiClient, context?: MondayApiToolContext | undefined);
34
- abstract getDescription(): string;
35
- abstract getInputSchema(): Input;
36
- abstract execute(input?: ToolInputType<Input>): Promise<ToolOutputType<Output>>;
37
- }
38
-
39
- declare const deleteItemToolSchema: {
40
- itemId: z.ZodNumber;
41
- };
42
- declare class DeleteItemTool extends BaseMondayApiTool<typeof deleteItemToolSchema, never> {
43
- name: string;
44
- type: ToolType;
45
- getDescription(): string;
46
- getInputSchema(): typeof deleteItemToolSchema;
47
- execute(input: ToolInputType<typeof deleteItemToolSchema>): Promise<ToolOutputType<never>>;
48
- }
49
-
50
- declare const getItemsToolSchema: {
51
- term: z.ZodString;
52
- };
53
- declare const getItemsInBoardToolSchema: {
54
- term: z.ZodString;
55
- boardId: z.ZodNumber;
56
- };
57
- type GetItemsToolInput = typeof getItemsToolSchema | typeof getItemsInBoardToolSchema;
58
- declare class GetBoardItemsTool extends BaseMondayApiTool<GetItemsToolInput> {
59
- name: string;
60
- type: ToolType;
61
- getDescription(): string;
62
- getInputSchema(): GetItemsToolInput;
63
- execute(input: ToolInputType<GetItemsToolInput>): Promise<ToolOutputType<never>>;
64
- }
65
-
66
- declare const createItemToolSchema: {
67
- name: z.ZodString;
68
- groupId: z.ZodOptional<z.ZodString>;
69
- columnValues: z.ZodString;
70
- };
71
- declare const createItemInBoardToolSchema: {
72
- name: z.ZodString;
73
- groupId: z.ZodOptional<z.ZodString>;
74
- columnValues: z.ZodString;
75
- boardId: z.ZodNumber;
76
- };
77
- type CreateItemToolInput = typeof createItemToolSchema | typeof createItemInBoardToolSchema;
78
- declare class CreateItemTool extends BaseMondayApiTool<CreateItemToolInput> {
79
- name: string;
80
- type: ToolType;
81
- getDescription(): string;
82
- getInputSchema(): CreateItemToolInput;
83
- execute(input: ToolInputType<CreateItemToolInput>): Promise<ToolOutputType<never>>;
84
- }
85
-
86
- declare const getBoardSchemaToolSchema: {
87
- boardId: z.ZodNumber;
88
- };
89
- declare class GetBoardSchemaTool extends BaseMondayApiTool<typeof getBoardSchemaToolSchema | undefined> {
90
- name: string;
91
- type: ToolType;
92
- getDescription(): string;
93
- getInputSchema(): typeof getBoardSchemaToolSchema | undefined;
94
- execute(input: ToolInputType<typeof getBoardSchemaToolSchema | undefined>): Promise<ToolOutputType<never>>;
95
- }
96
-
97
- declare const getUsersToolSchema: {
98
- name: z.ZodOptional<z.ZodString>;
99
- };
100
- declare class GetUsersTool extends BaseMondayApiTool<typeof getUsersToolSchema> {
101
- name: string;
102
- type: ToolType;
103
- getDescription(): string;
104
- getInputSchema(): typeof getUsersToolSchema;
105
- execute(input: ToolInputType<typeof getUsersToolSchema>): Promise<ToolOutputType<never>>;
106
- }
107
-
108
- /** The board kinds available. */
109
- declare enum BoardKind {
110
- /** Private boards. */
111
- Private = "private",
112
- /** Public boards. */
113
- Public = "public",
114
- /** Shareable boards. */
115
- Share = "share"
116
- }
117
- /** The columns to create. */
118
- declare enum ColumnType {
119
- /** Number items according to their order in the group/board */
120
- AutoNumber = "auto_number",
121
- /** Connect data from other boards */
122
- BoardRelation = "board_relation",
123
- /** Perform actions on items by clicking a button */
124
- Button = "button",
125
- /** Check off items and see what's done at a glance */
126
- Checkbox = "checkbox",
127
- /** Manage a design system using a color palette */
128
- ColorPicker = "color_picker",
129
- /** Choose a country */
130
- Country = "country",
131
- /** Add the item's creator and creation date automatically */
132
- CreationLog = "creation_log",
133
- /** Add dates like deadlines to ensure you never drop the ball */
134
- Date = "date",
135
- /** Set up dependencies between items in the board */
136
- Dependency = "dependency",
137
- /** Document your work and increase collaboration */
138
- DirectDoc = "direct_doc",
139
- /** Document your work and increase collaboration */
140
- Doc = "doc",
141
- /** Create a dropdown list of options */
142
- Dropdown = "dropdown",
143
- /** Email team members and clients directly from your board */
144
- Email = "email",
145
- /** Add files & docs to your item */
146
- File = "file",
147
- /** Use functions to manipulate data across multiple columns */
148
- Formula = "formula",
149
- Group = "group",
150
- /** Add times to manage and schedule tasks, shifts and more */
151
- Hour = "hour",
152
- /** Integration is really cool... */
153
- Integration = "integration",
154
- /** Show all item's assignees */
155
- ItemAssignees = "item_assignees",
156
- /** Show a unique ID for each item */
157
- ItemId = "item_id",
158
- /** Add the person that last updated the item and the date */
159
- LastUpdated = "last_updated",
160
- /** Simply hyperlink to any website */
161
- Link = "link",
162
- /** Place multiple locations on a geographic map */
163
- Location = "location",
164
- /** Add large amounts of text without changing column width */
165
- LongText = "long_text",
166
- /** Show and edit columns' data from connected boards */
167
- Mirror = "mirror",
168
- /** Name is really cool... */
169
- Name = "name",
170
- /** Add revenue, costs, time estimations and more */
171
- Numbers = "numbers",
172
- /** Assign people to improve team work */
173
- People = "people",
174
- /** Assign a person to increase ownership and accountability (deprecated) */
175
- Person = "person",
176
- /** Call your contacts directly from monday.com */
177
- Phone = "phone",
178
- /** Show progress by combining status columns in a battery */
179
- Progress = "progress",
180
- /** Rate or rank anything visually */
181
- Rating = "rating",
182
- /** Get an instant overview of where things stand */
183
- Status = "status",
184
- /** Use the subtasks column to create another level of tasks */
185
- Subtasks = "subtasks",
186
- /** Add tags to categorize items across multiple boards */
187
- Tags = "tags",
188
- /** Assign a full team to an item */
189
- Team = "team",
190
- /** Add textual information e.g. addresses, names or keywords */
191
- Text = "text",
192
- /** Easily track time spent on each item, group, and board */
193
- TimeTracking = "time_tracking",
194
- /** Visualize your item’s duration, with a start and end date */
195
- Timeline = "timeline",
196
- /** Unsupported column type */
197
- Unsupported = "unsupported",
198
- /** Vote on an item e.g. pick a new feature or a favorite lunch place */
199
- Vote = "vote",
200
- /** Select the week on which each item should be completed */
201
- Week = "week",
202
- /** Keep track of the time anywhere in the world */
203
- WorldClock = "world_clock"
204
- }
205
-
206
- declare const createBoardToolSchema: {
207
- boardName: z.ZodString;
208
- boardKind: z.ZodDefault<z.ZodNativeEnum<typeof BoardKind>>;
209
- boardDescription: z.ZodOptional<z.ZodString>;
210
- workspaceId: z.ZodOptional<z.ZodString>;
211
- };
212
- declare class CreateBoardTool extends BaseMondayApiTool<typeof createBoardToolSchema, never> {
213
- name: string;
214
- type: ToolType;
215
- getDescription(): string;
216
- getInputSchema(): typeof createBoardToolSchema;
217
- execute(input: ToolInputType<typeof createBoardToolSchema>): Promise<ToolOutputType<never>>;
218
- }
219
-
220
- declare const createColumnToolSchema: {
221
- columnType: z.ZodNativeEnum<typeof ColumnType>;
222
- columnTitle: z.ZodString;
223
- columnDescription: z.ZodOptional<z.ZodString>;
224
- columnSettings: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
225
- };
226
- declare const createColumnInBoardToolSchema: {
227
- columnType: z.ZodNativeEnum<typeof ColumnType>;
228
- columnTitle: z.ZodString;
229
- columnDescription: z.ZodOptional<z.ZodString>;
230
- columnSettings: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
231
- boardId: z.ZodNumber;
232
- };
233
- type CreateColumnToolInput = typeof createColumnToolSchema | typeof createColumnInBoardToolSchema;
234
- declare class CreateColumnTool extends BaseMondayApiTool<CreateColumnToolInput> {
235
- name: string;
236
- type: ToolType;
237
- getDescription(): string;
238
- getInputSchema(): CreateColumnToolInput;
239
- execute(input: ToolInputType<CreateColumnToolInput>): Promise<ToolOutputType<never>>;
240
- }
241
-
242
- declare const deleteColumnToolSchema: {
243
- columnId: z.ZodString;
244
- };
245
- declare const deleteColumnInBoardToolSchema: {
246
- columnId: z.ZodString;
247
- boardId: z.ZodNumber;
248
- };
249
- type DeleteColumnToolInput = typeof deleteColumnToolSchema | typeof deleteColumnInBoardToolSchema;
250
- declare class DeleteColumnTool extends BaseMondayApiTool<DeleteColumnToolInput> {
251
- name: string;
252
- type: ToolType;
253
- getDescription(): string;
254
- getInputSchema(): DeleteColumnToolInput;
255
- execute(input: ToolInputType<DeleteColumnToolInput>): Promise<ToolOutputType<never>>;
256
- }
257
-
258
- declare const allMondayApiToolSchema: {
259
- query: z.ZodString;
260
- variables: z.ZodString;
261
- };
262
- declare class AllMondayApiTool extends BaseMondayApiTool<typeof allMondayApiToolSchema> {
263
- name: string;
264
- type: ToolType;
265
- constructor(mondayApi: ApiClient, context?: MondayApiToolContext);
266
- getDescription(): string;
267
- getInputSchema(): typeof allMondayApiToolSchema;
268
- execute(input: ToolInputType<typeof allMondayApiToolSchema>): Promise<ToolOutputType<never>>;
269
- }
270
-
271
- declare const getTypeDetailsToolSchema: {
272
- typeName: z.ZodString;
273
- };
274
- declare class GetTypeDetailsTool extends BaseMondayApiTool<typeof getTypeDetailsToolSchema> {
275
- name: string;
276
- type: ToolType;
277
- getDescription(): string;
278
- getInputSchema(): typeof getTypeDetailsToolSchema;
279
- execute(input: ToolInputType<typeof getTypeDetailsToolSchema>): Promise<ToolOutputType<never>>;
280
- }
281
-
282
- declare const createUpdateToolSchema: {
283
- itemId: z.ZodNumber;
284
- body: z.ZodString;
285
- };
286
- declare class CreateUpdateTool extends BaseMondayApiTool<typeof createUpdateToolSchema> {
287
- name: string;
288
- type: ToolType;
289
- getDescription(): string;
290
- getInputSchema(): typeof createUpdateToolSchema;
291
- execute(input: ToolInputType<typeof createUpdateToolSchema>): Promise<ToolOutputType<never>>;
292
- }
293
-
294
- declare const changeItemColumnValuesToolSchema: {
295
- itemId: z.ZodNumber;
296
- columnValues: z.ZodString;
297
- };
298
- declare const changeItemColumnValuesInBoardToolSchema: {
299
- itemId: z.ZodNumber;
300
- columnValues: z.ZodString;
301
- boardId: z.ZodNumber;
302
- };
303
- type ChangeItemColumnValuesToolInput = typeof changeItemColumnValuesToolSchema | typeof changeItemColumnValuesInBoardToolSchema;
304
- declare class ChangeItemColumnValuesTool extends BaseMondayApiTool<ChangeItemColumnValuesToolInput> {
305
- name: string;
306
- type: ToolType;
307
- getDescription(): string;
308
- getInputSchema(): ChangeItemColumnValuesToolInput;
309
- execute(input: ToolInputType<ChangeItemColumnValuesToolInput>): Promise<ToolOutputType<never>>;
310
- }
311
-
312
- declare const moveItemToGroupToolSchema: {
313
- itemId: z.ZodNumber;
314
- groupId: z.ZodString;
315
- };
316
- declare class MoveItemToGroupTool extends BaseMondayApiTool<typeof moveItemToGroupToolSchema> {
317
- name: string;
318
- type: ToolType;
319
- getDescription(): string;
320
- getInputSchema(): typeof moveItemToGroupToolSchema;
321
- execute(input: ToolInputType<typeof moveItemToGroupToolSchema>): Promise<ToolOutputType<never>>;
322
- }
323
-
324
- declare class GetGraphQLSchemaTool extends BaseMondayApiTool<undefined> {
325
- name: string;
326
- type: ToolType;
327
- getDescription(): string;
328
- getInputSchema(): undefined;
329
- execute(): Promise<ToolOutputType<never>>;
330
- }
331
-
332
- declare const allTools: (typeof DeleteItemTool | typeof GetBoardItemsTool | typeof CreateItemTool | typeof GetBoardSchemaTool | typeof GetUsersTool | typeof CreateBoardTool | typeof CreateColumnTool | typeof DeleteColumnTool | typeof AllMondayApiTool | typeof GetTypeDetailsTool)[];
333
-
334
- export { AllMondayApiTool, ChangeItemColumnValuesTool, ChangeItemColumnValuesToolInput, CreateBoardTool, CreateColumnTool, CreateColumnToolInput, CreateItemTool, CreateItemToolInput, CreateUpdateTool, DeleteColumnTool, DeleteColumnToolInput, DeleteItemTool, GetBoardItemsTool, GetBoardSchemaTool, GetGraphQLSchemaTool, GetItemsToolInput, GetTypeDetailsTool, GetUsersTool, MoveItemToGroupTool, allMondayApiToolSchema, allTools, changeItemColumnValuesInBoardToolSchema, changeItemColumnValuesToolSchema, createBoardToolSchema, createColumnInBoardToolSchema, createColumnToolSchema, createItemInBoardToolSchema, createItemToolSchema, createUpdateToolSchema, deleteColumnInBoardToolSchema, deleteColumnToolSchema, deleteItemToolSchema, getBoardSchemaToolSchema, getItemsInBoardToolSchema, getItemsToolSchema, getTypeDetailsToolSchema, getUsersToolSchema, moveItemToGroupToolSchema };