@mondaydotcomorg/agent-toolkit 0.1.6 → 1.0.0

package/LICENSE.md

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2021, monday.com
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -1,6 +1,6 @@
 # @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.
+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 through Model Context Protocol (MCP) implementation.
 
 ## Installation
 
@@ -13,7 +13,6 @@ npm install @mondaydotcomorg/agent-toolkit
 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
 

package/dist/cjs/core/index.d.ts

@@ -36,4 +36,299 @@ declare abstract class BaseMondayApiTool<Input extends ZodRawShape | undefined,
     abstract execute(input?: ToolInputType<Input>): Promise<ToolOutputType<Output>>;
 }
 
-export { BaseMondayApiTool, Executable, MondayApiToolContext, Tool, ToolInputType, ToolOutputType, ToolType };
+declare const deleteItemToolSchema: {
+    itemId: z.ZodNumber;
+};
+declare class DeleteItemTool extends BaseMondayApiTool<typeof deleteItemToolSchema, never> {
+    name: string;
+    type: ToolType;
+    getDescription(): string;
+    getInputSchema(): typeof deleteItemToolSchema;
+    execute(input: ToolInputType<typeof deleteItemToolSchema>): Promise<ToolOutputType<never>>;
+}
+
+declare const getItemsToolSchema: {
+    term: z.ZodString;
+};
+declare const getItemsInBoardToolSchema: {
+    term: z.ZodString;
+    boardId: z.ZodNumber;
+};
+type GetItemsToolInput = typeof getItemsToolSchema | typeof getItemsInBoardToolSchema;
+declare class GetBoardItemsTool extends BaseMondayApiTool<GetItemsToolInput> {
+    name: string;
+    type: ToolType;
+    getDescription(): string;
+    getInputSchema(): GetItemsToolInput;
+    execute(input: ToolInputType<GetItemsToolInput>): Promise<ToolOutputType<never>>;
+}
+
+declare const createItemToolSchema: {
+    name: z.ZodString;
+    groupId: z.ZodOptional<z.ZodString>;
+    columnValues: z.ZodString;
+};
+declare const createItemInBoardToolSchema: {
+    name: z.ZodString;
+    groupId: z.ZodOptional<z.ZodString>;
+    columnValues: z.ZodString;
+    boardId: z.ZodNumber;
+};
+type CreateItemToolInput = typeof createItemToolSchema | typeof createItemInBoardToolSchema;
+declare class CreateItemTool extends BaseMondayApiTool<CreateItemToolInput> {
+    name: string;
+    type: ToolType;
+    getDescription(): string;
+    getInputSchema(): CreateItemToolInput;
+    execute(input: ToolInputType<CreateItemToolInput>): Promise<ToolOutputType<never>>;
+}
+
+declare const getBoardSchemaToolSchema: {
+    boardId: z.ZodNumber;
+};
+declare class GetBoardSchemaTool extends BaseMondayApiTool<typeof getBoardSchemaToolSchema | undefined> {
+    name: string;
+    type: ToolType;
+    getDescription(): string;
+    getInputSchema(): typeof getBoardSchemaToolSchema | undefined;
+    execute(input: ToolInputType<typeof getBoardSchemaToolSchema | undefined>): Promise<ToolOutputType<never>>;
+}
+
+declare const getUsersToolSchema: {
+    name: z.ZodOptional<z.ZodString>;
+};
+declare class GetUsersTool extends BaseMondayApiTool<typeof getUsersToolSchema> {
+    name: string;
+    type: ToolType;
+    getDescription(): string;
+    getInputSchema(): typeof getUsersToolSchema;
+    execute(input: ToolInputType<typeof getUsersToolSchema>): Promise<ToolOutputType<never>>;
+}
+
+/** The board kinds available. */
+declare enum BoardKind {
+    /** Private boards. */
+    Private = "private",
+    /** Public boards. */
+    Public = "public",
+    /** Shareable boards. */
+    Share = "share"
+}
+/** The columns to create. */
+declare enum ColumnType {
+    /** Number items according to their order in the group/board */
+    AutoNumber = "auto_number",
+    /** Connect data from other boards */
+    BoardRelation = "board_relation",
+    /** Perform actions on items by clicking a button */
+    Button = "button",
+    /** Check off items and see what's done at a glance */
+    Checkbox = "checkbox",
+    /** Manage a design system using a color palette */
+    ColorPicker = "color_picker",
+    /** Choose a country */
+    Country = "country",
+    /** Add the item's creator and creation date automatically */
+    CreationLog = "creation_log",
+    /** Add dates like deadlines to ensure you never drop the ball */
+    Date = "date",
+    /** Set up dependencies between items in the board */
+    Dependency = "dependency",
+    /** Document your work and increase collaboration */
+    DirectDoc = "direct_doc",
+    /** Document your work and increase collaboration */
+    Doc = "doc",
+    /** Create a dropdown list of options */
+    Dropdown = "dropdown",
+    /** Email team members and clients directly from your board */
+    Email = "email",
+    /** Add files & docs to your item */
+    File = "file",
+    /** Use functions to manipulate data across multiple columns */
+    Formula = "formula",
+    Group = "group",
+    /** Add times to manage and schedule tasks, shifts and more */
+    Hour = "hour",
+    /** Integration is really cool... */
+    Integration = "integration",
+    /** Show all item's assignees */
+    ItemAssignees = "item_assignees",
+    /** Show a unique ID for each item */
+    ItemId = "item_id",
+    /** Add the person that last updated the item and the date */
+    LastUpdated = "last_updated",
+    /** Simply hyperlink to any website */
+    Link = "link",
+    /** Place multiple locations on a geographic map */
+    Location = "location",
+    /** Add large amounts of text without changing column width */
+    LongText = "long_text",
+    /** Show and edit columns' data from connected boards */
+    Mirror = "mirror",
+    /** Name is really cool... */
+    Name = "name",
+    /** Add revenue, costs, time estimations and more */
+    Numbers = "numbers",
+    /** Assign people to improve team work */
+    People = "people",
+    /** Assign a person to increase ownership and accountability (deprecated) */
+    Person = "person",
+    /** Call your contacts directly from monday.com */
+    Phone = "phone",
+    /** Show progress by combining status columns in a battery */
+    Progress = "progress",
+    /** Rate or rank anything visually */
+    Rating = "rating",
+    /** Get an instant overview of where things stand */
+    Status = "status",
+    /** Use the subtasks column to create another level of tasks */
+    Subtasks = "subtasks",
+    /** Add tags to categorize items across multiple boards */
+    Tags = "tags",
+    /** Assign a full team to an item  */
+    Team = "team",
+    /** Add textual information e.g. addresses, names or keywords */
+    Text = "text",
+    /** Easily track time spent on each item, group, and board */
+    TimeTracking = "time_tracking",
+    /** Visualize your item’s duration, with a start and end date */
+    Timeline = "timeline",
+    /** Unsupported column type */
+    Unsupported = "unsupported",
+    /** Vote on an item e.g. pick a new feature or a favorite lunch place */
+    Vote = "vote",
+    /** Select the week on which each item should be completed */
+    Week = "week",
+    /** Keep track of the time anywhere in the world */
+    WorldClock = "world_clock"
+}
+
+declare const createBoardToolSchema: {
+    boardName: z.ZodString;
+    boardKind: z.ZodDefault<z.ZodNativeEnum<typeof BoardKind>>;
+    boardDescription: z.ZodOptional<z.ZodString>;
+    workspaceId: z.ZodOptional<z.ZodString>;
+};
+declare class CreateBoardTool extends BaseMondayApiTool<typeof createBoardToolSchema, never> {
+    name: string;
+    type: ToolType;
+    getDescription(): string;
+    getInputSchema(): typeof createBoardToolSchema;
+    execute(input: ToolInputType<typeof createBoardToolSchema>): Promise<ToolOutputType<never>>;
+}
+
+declare const createColumnToolSchema: {
+    columnType: z.ZodNativeEnum<typeof ColumnType>;
+    columnTitle: z.ZodString;
+    columnDescription: z.ZodOptional<z.ZodString>;
+    columnSettings: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+};
+declare const createColumnInBoardToolSchema: {
+    columnType: z.ZodNativeEnum<typeof ColumnType>;
+    columnTitle: z.ZodString;
+    columnDescription: z.ZodOptional<z.ZodString>;
+    columnSettings: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    boardId: z.ZodNumber;
+};
+type CreateColumnToolInput = typeof createColumnToolSchema | typeof createColumnInBoardToolSchema;
+declare class CreateColumnTool extends BaseMondayApiTool<CreateColumnToolInput> {
+    name: string;
+    type: ToolType;
+    getDescription(): string;
+    getInputSchema(): CreateColumnToolInput;
+    execute(input: ToolInputType<CreateColumnToolInput>): Promise<ToolOutputType<never>>;
+}
+
+declare const deleteColumnToolSchema: {
+    columnId: z.ZodString;
+};
+declare const deleteColumnInBoardToolSchema: {
+    columnId: z.ZodString;
+    boardId: z.ZodNumber;
+};
+type DeleteColumnToolInput = typeof deleteColumnToolSchema | typeof deleteColumnInBoardToolSchema;
+declare class DeleteColumnTool extends BaseMondayApiTool<DeleteColumnToolInput> {
+    name: string;
+    type: ToolType;
+    getDescription(): string;
+    getInputSchema(): DeleteColumnToolInput;
+    execute(input: ToolInputType<DeleteColumnToolInput>): Promise<ToolOutputType<never>>;
+}
+
+declare const allMondayApiToolSchema: {
+    query: z.ZodString;
+    variables: z.ZodString;
+};
+declare class AllMondayApiTool extends BaseMondayApiTool<typeof allMondayApiToolSchema> {
+    name: string;
+    type: ToolType;
+    constructor(mondayApi: ApiClient, context?: MondayApiToolContext);
+    getDescription(): string;
+    getInputSchema(): typeof allMondayApiToolSchema;
+    execute(input: ToolInputType<typeof allMondayApiToolSchema>): Promise<ToolOutputType<never>>;
+}
+
+declare const getTypeDetailsToolSchema: {
+    typeName: z.ZodString;
+};
+declare class GetTypeDetailsTool extends BaseMondayApiTool<typeof getTypeDetailsToolSchema> {
+    name: string;
+    type: ToolType;
+    getDescription(): string;
+    getInputSchema(): typeof getTypeDetailsToolSchema;
+    execute(input: ToolInputType<typeof getTypeDetailsToolSchema>): Promise<ToolOutputType<never>>;
+}
+
+declare const createUpdateToolSchema: {
+    itemId: z.ZodNumber;
+    body: z.ZodString;
+};
+declare class CreateUpdateTool extends BaseMondayApiTool<typeof createUpdateToolSchema> {
+    name: string;
+    type: ToolType;
+    getDescription(): string;
+    getInputSchema(): typeof createUpdateToolSchema;
+    execute(input: ToolInputType<typeof createUpdateToolSchema>): Promise<ToolOutputType<never>>;
+}
+
+declare const changeItemColumnValuesToolSchema: {
+    itemId: z.ZodNumber;
+    columnValues: z.ZodString;
+};
+declare const changeItemColumnValuesInBoardToolSchema: {
+    itemId: z.ZodNumber;
+    columnValues: z.ZodString;
+    boardId: z.ZodNumber;
+};
+type ChangeItemColumnValuesToolInput = typeof changeItemColumnValuesToolSchema | typeof changeItemColumnValuesInBoardToolSchema;
+declare class ChangeItemColumnValuesTool extends BaseMondayApiTool<ChangeItemColumnValuesToolInput> {
+    name: string;
+    type: ToolType;
+    getDescription(): string;
+    getInputSchema(): ChangeItemColumnValuesToolInput;
+    execute(input: ToolInputType<ChangeItemColumnValuesToolInput>): Promise<ToolOutputType<never>>;
+}
+
+declare const moveItemToGroupToolSchema: {
+    itemId: z.ZodNumber;
+    groupId: z.ZodString;
+};
+declare class MoveItemToGroupTool extends BaseMondayApiTool<typeof moveItemToGroupToolSchema> {
+    name: string;
+    type: ToolType;
+    getDescription(): string;
+    getInputSchema(): typeof moveItemToGroupToolSchema;
+    execute(input: ToolInputType<typeof moveItemToGroupToolSchema>): Promise<ToolOutputType<never>>;
+}
+
+declare class GetGraphQLSchemaTool extends BaseMondayApiTool<undefined> {
+    name: string;
+    type: ToolType;
+    getDescription(): string;
+    getInputSchema(): undefined;
+    execute(): Promise<ToolOutputType<never>>;
+}
+
+declare const allTools: (typeof DeleteItemTool | typeof GetBoardItemsTool | typeof CreateItemTool | typeof GetBoardSchemaTool | typeof GetUsersTool | typeof CreateBoardTool | typeof CreateColumnTool | typeof DeleteColumnTool | typeof AllMondayApiTool | typeof GetTypeDetailsTool)[];
+
+export { AllMondayApiTool, ChangeItemColumnValuesTool, ChangeItemColumnValuesToolInput, CreateBoardTool, CreateColumnTool, CreateColumnToolInput, CreateItemTool, CreateItemToolInput, CreateUpdateTool, DeleteColumnTool, DeleteColumnToolInput, DeleteItemTool, Executable, GetBoardItemsTool, GetBoardSchemaTool, GetGraphQLSchemaTool, GetItemsToolInput, GetTypeDetailsTool, GetUsersTool, MoveItemToGroupTool, Tool, ToolInputType, ToolOutputType, ToolType, allMondayApiToolSchema, allTools, changeItemColumnValuesInBoardToolSchema, changeItemColumnValuesToolSchema, createBoardToolSchema, createColumnInBoardToolSchema, createColumnToolSchema, createItemInBoardToolSchema, createItemToolSchema, createUpdateToolSchema, deleteColumnInBoardToolSchema, deleteColumnToolSchema, deleteItemToolSchema, getBoardSchemaToolSchema, getItemsInBoardToolSchema, getItemsToolSchema, getTypeDetailsToolSchema, getUsersToolSchema, moveItemToGroupToolSchema };