@mondaydotcomorg/agent-toolkit 2.2.0 → 2.4.0

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

@@ -1,4 +1,5 @@
 import { ZodRawShape, z, ZodTypeAny } from 'zod';
+import { ToolAnnotations } from '@modelcontextprotocol/sdk/types';
 import { ApiClient, ApiClientConfig } from '@mondaydotcomorg/api';
 
 interface Executable<Input, Output> {
@@ -18,6 +19,9 @@ declare enum ToolType {
 interface Tool<Input extends ZodRawShape | undefined, Output extends Record<string, unknown> = never> extends Executable<ToolInputType<Input>, ToolOutputType<Output>> {
     name: string;
     type: ToolType;
+    annotations: ToolAnnotations;
+    /** Whether the tool is enabled by default. Defaults to true if not specified. */
+    enabledByDefault?: boolean;
     getDescription(): string;
     getInputSchema(): Input;
 }
@@ -25,16 +29,34 @@ interface Tool<Input extends ZodRawShape | undefined, Output extends Record<stri
 type MondayApiToolContext = {
     boardId?: number;
 };
-type BaseMondayApiToolConstructor = new (api: ApiClient) => BaseMondayApiTool<any>;
+type BaseMondayApiToolConstructor = new (api: ApiClient, token?: string) => BaseMondayApiTool<any>;
 declare abstract class BaseMondayApiTool<Input extends ZodRawShape | undefined, Output extends Record<string, unknown> = never> implements Tool<Input, Output> {
     protected readonly mondayApi: ApiClient;
+    protected readonly apiToken?: string | undefined;
     protected readonly context?: MondayApiToolContext | undefined;
     abstract name: string;
     abstract type: ToolType;
-    constructor(mondayApi: ApiClient, context?: MondayApiToolContext | undefined);
+    abstract annotations: ToolAnnotations;
+    enabledByDefault?: boolean;
+    constructor(mondayApi: ApiClient, apiToken?: string | undefined, context?: MondayApiToolContext | undefined);
     abstract getDescription(): string;
     abstract getInputSchema(): Input;
-    abstract execute(input?: ToolInputType<Input>): Promise<ToolOutputType<Output>>;
+    /**
+     * Public execute method that automatically tracks execution
+     */
+    execute(input?: ToolInputType<Input>): Promise<ToolOutputType<Output>>;
+    /**
+     * Abstract method that subclasses should implement for their actual logic
+     */
+    protected abstract executeInternal(input?: ToolInputType<Input>): Promise<ToolOutputType<Output>>;
+    /**
+     * Tracks tool execution with timing and error information
+     * @param toolName - The name of the tool being executed
+     * @param executionTimeInMs - The time taken to execute the tool in milliseconds
+     * @param isError - Whether the execution resulted in an error
+     * @param params - The parameters passed to the tool
+     */
+    private trackToolExecution;
 }
 
 declare const allMondayAppsTools: (new (...args: any[]) => Tool<any, any>)[];
@@ -53,6 +75,7 @@ type ToolsConfiguration = {
     readOnlyMode?: boolean;
     mode?: ToolMode;
     enableDynamicApiTools?: boolean | 'only';
+    enableToolManager?: boolean;
 };
 type MondayAgentToolkitConfig = {
     mondayApiToken: ApiClientConfig['token'];