@azure/ai-agents 1.1.0-beta.3 → 1.2.0-alpha.20250923.1

package/dist/react-native/utils/utils.js

@@ -1,5 +1,6 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
+import { OpenApiTool } from "./OpenApiTool.js";
 import { MCPTool } from "./MCPTool.js";
 /**
  * Determines if the given output is of the specified type.
@@ -54,28 +55,6 @@ export class ToolUtility {
             },
         };
     }
-    /**
-     * Creates a sharepoint grounding search tool
-     *
-     * @param connectionId - The ID of the sharepoint search connection.
-     *
-     * @returns An object containing the definition and resources for the sharepoint grounding search tool
-     *
-     */
-    static createSharepointGroundingTool(connectionId) {
-        return {
-            definition: {
-                type: "sharepoint_grounding",
-                sharepointGrounding: {
-                    connectionList: [
-                        {
-                            connectionId: connectionId,
-                        },
-                    ],
-                },
-            },
-        };
-    }
     /**
      * Creates a bing grounding search tool
      *
@@ -102,26 +81,6 @@ export class ToolUtility {
             },
         };
     }
-    /**
-     * Creates a bing custom search tool
-     *
-     * @param searchConfigurations - The ID of bing search connection and instanceName.
-     *
-     * @returns An object containing the definition and resources for the bing custom search tool
-     */
-    static createBingCustomSearchTool(searchConfigurations) {
-        return {
-            definition: {
-                type: "bing_custom_search",
-                bingCustomSearch: {
-                    searchConfigurations: searchConfigurations.map((searchConfiguration) => ({
-                        connectionId: searchConfiguration.connectionId,
-                        instanceName: searchConfiguration.instanceName,
-                    })),
-                },
-            },
-        };
-    }
     /**
      * Creates a file search tool
      *
@@ -197,22 +156,6 @@ export class ToolUtility {
             },
         };
     }
-    /**
-     * Creates a Microsoft Fabric tool
-     *
-     * @param connectionIds - A list of the IDs of the Fabric connections to use.
-     * @returns An object containing the definition for the Microsoft Fabric tool
-     */
-    static createFabricTool(connectionId) {
-        return {
-            definition: {
-                type: "fabric_dataagent",
-                fabricDataagent: {
-                    connectionList: [{ connectionId: connectionId }],
-                },
-            },
-        };
-    }
     /**
      * Creates a function tool
      *
@@ -237,16 +180,7 @@ export class ToolUtility {
      */
     static createOpenApiTool(openApiFunctionDefinition) {
         return {
-            definition: {
-                type: "openapi",
-                openapi: {
-                    name: openApiFunctionDefinition.name,
-                    spec: openApiFunctionDefinition.spec,
-                    description: openApiFunctionDefinition.description,
-                    auth: openApiFunctionDefinition.auth,
-                    defaultParams: openApiFunctionDefinition.defaultParams,
-                },
-            },
+            definition: OpenApiTool.createDefinition(openApiFunctionDefinition),
         };
     }
     /**
@@ -334,6 +268,17 @@ export class ToolSet {
         this.toolDefinitions.push(tool.definition);
         return tool;
     }
+    /**
+     * Adds a Model Context Protocol (MCP) tool to the tool set.
+     * @param options - The options for configuring the MCP tool.
+     * @returns An object containing the definition and resources for the MCP tool
+     */
+    addMCPTool(options) {
+        const tool = ToolUtility.createMCPTool(options);
+        this.toolDefinitions.push(tool.definition);
+        this.toolResources = { ...this.toolResources, ...tool.resources };
+        return tool;
+    }
     /**
      * Adds a bing grounding search tool to the tool set.
      *
@@ -359,28 +304,5 @@ export class ToolSet {
         this.toolDefinitions.push(tool.definition);
         return tool;
     }
-    /**
-     * Adds a Microsoft Fabric tool to the tool set.
-     *
-     * @param connectionId - The ID of the Fabric connection to use.
-     * @returns An object containing the definition for the Microsoft Fabric tool
-     */
-    addFabricTool(connectionId) {
-        const tool = ToolUtility.createFabricTool(connectionId);
-        this.toolDefinitions.push(tool.definition);
-        return tool;
-    }
-    /**
-     * Adds sharepoint grounding search tool to the tool set.
-     *
-     * @param connectionId - The ID of the sharepoint search connection.
-     *
-     * @returns An object containing the definition and resources for the sharepoint grounding search tool
-     */
-    addSharepointGroundingTool(connectionId) {
-        const tool = ToolUtility.createSharepointGroundingTool(connectionId);
-        this.toolDefinitions.push(tool.definition);
-        return tool;
-    }
 }
 //# sourceMappingURL=utils.js.map

package/dist/react-native/utils/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/utils/utils.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type {\n  AzureAISearchToolDefinition,\n  CodeInterpreterToolDefinition,\n  FileSearchToolDefinition,\n  FileSearchToolDefinitionDetails,\n  FunctionDefinition,\n  FunctionToolDefinition,\n  OpenApiToolDefinition,\n  RequiredAction,\n  RequiredToolCall,\n  ToolDefinition,\n  ToolDefinitionUnion,\n  ToolResources,\n  VectorStoreConfigurations,\n  VectorStoreDataSource,\n  OpenApiFunctionDefinition,\n  AISearchIndexResource,\n  BingCustomSearchConfiguration,\n  BingCustomSearchToolDefinition,\n  BingGroundingToolDefinition,\n  BingGroundingSearchConfiguration,\n  ConnectedAgentToolDefinition,\n  MicrosoftFabricToolDefinition,\n  SharepointToolDefinition,\n} from \"../index.js\";\nimport { MCPTool } from \"./MCPTool.js\";\n\n/**\n * Determines if the given output is of the specified type.\n *\n * @typeParam T - The type to check against, which extends one of the possible output parent types.\n * @param output - The action to check, which can be of type `RequiredAction`, `RequiredToolCall`, or `ToolDefinitionUnion`.\n * @param type - The type to check the action against.\n * @returns A boolean indicating whether the action is of the specified type.\n */\nexport function isOutputOfType<T extends { type: string }>(\n  output: RequiredAction | RequiredToolCall | ToolDefinitionUnion,\n  type: string,\n): output is T {\n  return output.type === type;\n}\n\n/** Types of connection tools used to configure an agent */\nexport enum connectionToolType {\n  /** Bing grounding search tool */\n  BingGrounding = \"bing_grounding\",\n  /** Microsoft Fabric tool */\n  MicrosoftFabric = \"fabric_dataagent\",\n  /** Sharepoint tool */\n  SharepointGrounding = \"sharepoint_grounding\",\n  /** Azure Function tool */\n  AzureFunction = \"azure_function\",\n  /** Bing custom search tool */\n  BingCustomSearch = \"bing_custom_search\",\n}\n\nconst toolMap = {\n  bing_grounding: \"bingGrounding\",\n  fabric_dataagent: \"fabric_dataagent\",\n  sharepoint_grounding: \"sharepointGrounding\",\n  azure_function: \"azureFunction\",\n  bing_custom_search: \"bingCustomSearch\",\n};\n\n/**\n * Utility class for creating various tools.\n */\nexport class ToolUtility {\n  /**\n   * Creates a connection tool\n   *\n   * @param toolType - The type of the connection tool.\n   * @param connectionIds - A list of the IDs of the connections to use.\n   * @returns An object containing the definition for the connection tool\n   */\n  static createConnectionTool(\n    toolType: connectionToolType,\n    connectionIds: string[],\n  ): { definition: ToolDefinitionUnion } {\n    return {\n      definition: {\n        type: toolType,\n        [toolMap[toolType]]: {\n          connections: connectionIds.map((connectionId) => ({ connectionId: connectionId })),\n        },\n      },\n    };\n  }\n\n  /**\n   * Creates a sharepoint grounding search tool\n   *\n   * @param connectionId - The ID of the sharepoint search connection.\n   *\n   * @returns An object containing the definition and resources for the sharepoint grounding search tool\n   *\n   */\n  static createSharepointGroundingTool(connectionId: string): {\n    definition: SharepointToolDefinition;\n  } {\n    return {\n      definition: {\n        type: \"sharepoint_grounding\",\n        sharepointGrounding: {\n          connectionList: [\n            {\n              connectionId: connectionId,\n            },\n          ],\n        },\n      },\n    };\n  }\n\n  /**\n   * Creates a bing grounding search tool\n   *\n   * @param connectionId - The ID of the bing search connection.\n   *\n   * @returns An object containing the definition and resources for the bing grounding search tool\n   *\n   */\n  static createBingGroundingTool(searchConfigurations: BingGroundingSearchConfiguration[]): {\n    definition: BingGroundingToolDefinition;\n  } {\n    // Ensure searchConfigurations is an array even if it's undefined\n    const configs = searchConfigurations || [];\n    return {\n      definition: {\n        type: \"bing_grounding\",\n        bingGrounding: {\n          searchConfigurations: configs.map((searchConfiguration) => ({\n            connectionId: searchConfiguration.connectionId,\n            market: searchConfiguration?.market,\n            setLang: searchConfiguration?.setLang,\n            count: searchConfiguration?.count,\n            freshness: searchConfiguration?.freshness,\n          })),\n        },\n      },\n    };\n  }\n\n  /**\n   * Creates a bing custom search tool\n   *\n   * @param searchConfigurations - The ID of bing search connection and instanceName.\n   *\n   * @returns An object containing the definition and resources for the bing custom search tool\n   */\n\n  static createBingCustomSearchTool(searchConfigurations: BingCustomSearchConfiguration[]): {\n    definition: BingCustomSearchToolDefinition;\n  } {\n    return {\n      definition: {\n        type: \"bing_custom_search\",\n        bingCustomSearch: {\n          searchConfigurations: searchConfigurations.map((searchConfiguration) => ({\n            connectionId: searchConfiguration.connectionId,\n            instanceName: searchConfiguration.instanceName,\n          })),\n        },\n      },\n    };\n  }\n\n  /**\n   * Creates a file search tool\n   *\n   * @param vectorStoreIds - The ID of the vector store attached to this agent. There can be a maximum of 1 vector store attached to the agent.\n   * @param vectorStores - The list of vector store configuration objects from Azure. This list is limited to one element. The only element of this list contains the list of azure asset IDs used by the search tool.\n   * @param definitionDetails - The input definition information for a file search tool as used to configure an agent.\n   *\n   * @returns An object containing the definition and resources for the file search tool\n   */\n  static createFileSearchTool(\n    vectorStoreIds?: string[],\n    vectorStores?: Array<VectorStoreConfigurations>,\n    definitionDetails?: FileSearchToolDefinitionDetails,\n  ): { definition: FileSearchToolDefinition; resources: ToolResources } {\n    return {\n      definition: { type: \"file_search\", fileSearch: definitionDetails },\n      resources: { fileSearch: { vectorStoreIds: vectorStoreIds, vectorStores: vectorStores } },\n    };\n  }\n\n  /**\n   * Creates a code interpreter tool\n   *\n   * @param fileIds - A list of file IDs made available to the `code_interpreter` tool. There can be a maximum of 20 files associated with the tool.\n   * @param dataSources - The data sources to be used. This option is mutually exclusive with fileIds.\n   *\n   * @returns An object containing the definition and resources for the code interpreter tool.\n   */\n  static createCodeInterpreterTool(\n    fileIds?: string[],\n    dataSources?: Array<VectorStoreDataSource>,\n  ): { definition: CodeInterpreterToolDefinition; resources: ToolResources } {\n    if (fileIds && dataSources) {\n      throw new Error(\"Cannot specify both fileIds and dataSources\");\n    }\n\n    return {\n      definition: { type: \"code_interpreter\" },\n      resources: { codeInterpreter: { fileIds: fileIds, dataSources: dataSources } },\n    };\n  }\n\n  /**\n   * Creates an Azure AI search tool\n   *\n   * @param indexConnectionId - The connection ID of the Azure AI search index.\n   * @param indexName - The name of the Azure AI search index.\n   *\n   * @returns An object containing the definition and resources for the Azure AI search tool.\n   */\n  static createAzureAISearchTool(\n    indexConnectionId: string,\n    indexName: string,\n    options?: AISearchIndexResource,\n  ): { definition: AzureAISearchToolDefinition; resources: ToolResources } {\n    return {\n      definition: { type: \"azure_ai_search\" },\n      resources: {\n        azureAISearch: {\n          indexList: [\n            {\n              indexConnectionId: indexConnectionId,\n              indexName: indexName,\n              queryType: options?.queryType,\n              topK: options?.topK,\n              filter: options?.filter,\n            },\n          ],\n        },\n      },\n    };\n  }\n\n  /**\n   * Creates a connected agent tool\n   *\n   * @returns An object containing the definition for the connected agent tool.\n   */\n  static createConnectedAgentTool(\n    id: string,\n    name: string,\n    description: string,\n  ): { definition: ConnectedAgentToolDefinition } {\n    return {\n      definition: {\n        type: \"connected_agent\",\n        connectedAgent: {\n          id: id,\n          name: name,\n          description: description,\n        },\n      },\n    };\n  }\n\n  /**\n   * Creates a Microsoft Fabric tool\n   *\n   * @param connectionIds - A list of the IDs of the Fabric connections to use.\n   * @returns An object containing the definition for the Microsoft Fabric tool\n   */\n  static createFabricTool(connectionId: string): { definition: MicrosoftFabricToolDefinition } {\n    return {\n      definition: {\n        type: \"fabric_dataagent\",\n        fabricDataagent: {\n          connectionList: [{ connectionId: connectionId }],\n        },\n      },\n    };\n  }\n\n  /**\n   * Creates a function tool\n   *\n   * @param functionDefinition - The function definition to use.\n   *\n   * @returns An object containing the definition for the function tool.\n   */\n  static createFunctionTool(functionDefinition: FunctionDefinition): {\n    definition: FunctionToolDefinition;\n  } {\n    return {\n      definition: {\n        type: \"function\",\n        function: functionDefinition,\n      },\n    };\n  }\n\n  /**\n   * Creates an OpenApi tool\n   *\n   * @param openApiFunctionDefinition - The OpenApi function definition to use.\n   *\n   * @returns An object containing the definition for the OpenApi tool.\n   */\n  static createOpenApiTool(openApiFunctionDefinition: OpenApiFunctionDefinition): {\n    definition: OpenApiToolDefinition;\n  } {\n    return {\n      definition: {\n        type: \"openapi\",\n        openapi: {\n          name: openApiFunctionDefinition.name,\n          spec: openApiFunctionDefinition.spec,\n          description: openApiFunctionDefinition.description,\n          auth: openApiFunctionDefinition.auth,\n          defaultParams: openApiFunctionDefinition.defaultParams,\n        },\n      },\n    };\n  }\n  /**\n   * Creates an MCP tool with the provided configuration.\n   * @param options - Configuration options for the MCP tool\n   * @returns A new MCPTool instance\n   */\n  static createMCPTool(options: {\n    serverLabel: string;\n    serverUrl: string;\n    allowedTools?: string[];\n  }): MCPTool {\n    return new MCPTool(options.serverLabel, options.serverUrl, options.allowedTools);\n  }\n}\n\n/**\n * Represents a set of tools with their definitions and resources.\n */\nexport class ToolSet {\n  /** A list of tool definitions that have been added to the tool set. */\n  toolDefinitions: ToolDefinition[] = [];\n\n  /** A collection of resources associated with the tools in the tool set. */\n  toolResources: ToolResources = {};\n\n  /**\n   * Adds a connection tool to the tool set.\n   *\n   * @param toolType - The type of the connection tool.\n   * @param connectionIds - A list of the IDs of the connections to use.\n   *\n   * @returns An object containing the definition for the connection tool\n   */\n  addConnectionTool(\n    toolType: connectionToolType,\n    connectionIds: string[],\n  ): { definition: ToolDefinition } {\n    const tool = ToolUtility.createConnectionTool(toolType, connectionIds);\n    this.toolDefinitions.push(tool.definition);\n    return tool;\n  }\n\n  /**\n   * Adds a file search tool to the tool set.\n   *\n   * @param vectorStoreIds - The ID of the vector store attached to this agent. There can be a maximum of 1 vector store attached to the agent.\n   * @param vectorStores -  The list of vector store configuration objects from Azure. This list is limited to one element. The only element of this list contains the list of azure asset IDs used by the search tool.\n   * @param definitionDetails - The input definition information for a file search tool as used to configure an agent.\n   *\n   * @returns An object containing the definition and resources for the file search tool\n   */\n  addFileSearchTool(\n    vectorStoreIds?: string[],\n    vectorStores?: Array<VectorStoreConfigurations>,\n    definitionDetails?: FileSearchToolDefinitionDetails,\n  ): { definition: FileSearchToolDefinition; resources: ToolResources } {\n    const tool = ToolUtility.createFileSearchTool(vectorStoreIds, vectorStores, definitionDetails);\n    this.toolDefinitions.push(tool.definition);\n    this.toolResources = { ...this.toolResources, ...tool.resources };\n    return tool;\n  }\n\n  /**\n   * Adds a code interpreter tool to the tool set.\n   *\n   * @param fileIds - A list of file IDs made available to the `code_interpreter` tool. There can be a maximum of 20 files associated with the tool.\n   * @param dataSources - The data sources to be used. This option is mutually exclusive with fileIds.\n   *\n   * @returns An object containing the definition and resources for the code interpreter tool\n   */\n  addCodeInterpreterTool(\n    fileIds?: string[],\n    dataSources?: Array<VectorStoreDataSource>,\n  ): { definition: CodeInterpreterToolDefinition; resources: ToolResources } {\n    const tool = ToolUtility.createCodeInterpreterTool(fileIds, dataSources);\n    this.toolDefinitions.push(tool.definition);\n    this.toolResources = { ...this.toolResources, ...tool.resources };\n    return tool;\n  }\n\n  /**\n   * Adds an Azure AI search tool to the tool set.\n   *\n   * @param indexConnectionId - The connection ID of the Azure AI search index.\n   * @param indexName - The name of the Azure AI search index.\n   *\n   * @returns An object containing the definition and resources for the Azure AI search tool\n   */\n  addAzureAISearchTool(\n    indexConnectionId: string,\n    indexName: string,\n  ): { definition: AzureAISearchToolDefinition; resources: ToolResources } {\n    const tool = ToolUtility.createAzureAISearchTool(indexConnectionId, indexName);\n    this.toolDefinitions.push(tool.definition);\n    this.toolResources = { ...this.toolResources, ...tool.resources };\n    return tool;\n  }\n\n  /**\n   * Adds an OpenApi tool to the tool set.\n   *\n   * @param openApiFunctionDefinition - The OpenApi function definition to use.\n   *\n   * @returns An object containing the definition for the OpenApi tool\n   */\n  addOpenApiTool(openApiFunctionDefinition: OpenApiFunctionDefinition): {\n    definition: OpenApiToolDefinition;\n  } {\n    const tool = ToolUtility.createOpenApiTool(openApiFunctionDefinition);\n    this.toolDefinitions.push(tool.definition);\n    return tool;\n  }\n\n  /**\n   * Adds a bing grounding search tool to the tool set.\n   *\n   * @param connectionId - The ID of the bing search connection.\n   *\n   * @returns An object containing the definition and resources for the bing grounding search tool\n   */\n  addBingGroundingTool(searchConfigurations: BingGroundingSearchConfiguration[]): {\n    definition: BingGroundingToolDefinition;\n  } {\n    const tool = ToolUtility.createBingGroundingTool(searchConfigurations);\n    this.toolDefinitions.push(tool.definition);\n    return tool;\n  }\n\n  /**\n   * Adds a connected agent tool to the tool set.\n   *\n   * @param id - The ID of the connected agent.\n   * @param name - The name of the connected agent.\n   * @param description - The description of the connected agent.\n   * @returns An object containing the definition for the connected agent tool\n   */\n  addConnectedAgentTool(\n    id: string,\n    name: string,\n    description: string,\n  ): { definition: ConnectedAgentToolDefinition } {\n    const tool = ToolUtility.createConnectedAgentTool(id, name, description);\n    this.toolDefinitions.push(tool.definition);\n    return tool;\n  }\n\n  /**\n   * Adds a Microsoft Fabric tool to the tool set.\n   *\n   * @param connectionId - The ID of the Fabric connection to use.\n   * @returns An object containing the definition for the Microsoft Fabric tool\n   */\n  addFabricTool(connectionId: string): { definition: MicrosoftFabricToolDefinition } {\n    const tool = ToolUtility.createFabricTool(connectionId);\n    this.toolDefinitions.push(tool.definition);\n    return tool;\n  }\n\n  /**\n   * Adds sharepoint grounding search tool to the tool set.\n   *\n   * @param connectionId - The ID of the sharepoint search connection.\n   *\n   * @returns An object containing the definition and resources for the sharepoint grounding search tool\n   */\n  addSharepointGroundingTool(connectionId: string): { definition: SharepointToolDefinition } {\n    const tool = ToolUtility.createSharepointGroundingTool(connectionId);\n    this.toolDefinitions.push(tool.definition);\n    return tool;\n  }\n}\n"]}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/utils/utils.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type {\n  AzureAISearchToolDefinition,\n  CodeInterpreterToolDefinition,\n  FileSearchToolDefinition,\n  FileSearchToolDefinitionDetails,\n  FunctionDefinition,\n  FunctionToolDefinition,\n  OpenApiToolDefinition,\n  RequiredAction,\n  RequiredToolCall,\n  ToolDefinition,\n  ToolDefinitionUnion,\n  ToolResources,\n  VectorStoreConfigurations,\n  VectorStoreDataSource,\n  OpenApiFunctionDefinition,\n  AISearchIndexResource,\n  BingGroundingToolDefinition,\n  BingGroundingSearchConfiguration,\n  ConnectedAgentToolDefinition,\n  MCPToolDefinition,\n} from \"../index.js\";\nimport { OpenApiTool } from \"./OpenApiTool.js\";\nimport { MCPTool } from \"./MCPTool.js\";\n/**\n * Determines if the given output is of the specified type.\n *\n * @typeParam T - The type to check against, which extends one of the possible output parent types.\n * @param output - The action to check, which can be of type `RequiredAction`, `RequiredToolCall`, or `ToolDefinitionUnion`.\n * @param type - The type to check the action against.\n * @returns A boolean indicating whether the action is of the specified type.\n */\nexport function isOutputOfType<T extends { type: string }>(\n  output: RequiredAction | RequiredToolCall | ToolDefinitionUnion,\n  type: string,\n): output is T {\n  return output.type === type;\n}\n\n/** Types of connection tools used to configure an agent */\nexport enum connectionToolType {\n  /** Bing grounding search tool */\n  BingGrounding = \"bing_grounding\",\n  /** Microsoft Fabric tool */\n  MicrosoftFabric = \"fabric_dataagent\",\n  /** Sharepoint tool */\n  SharepointGrounding = \"sharepoint_grounding\",\n  /** Azure Function tool */\n  AzureFunction = \"azure_function\",\n  /** Bing custom search tool */\n  BingCustomSearch = \"bing_custom_search\",\n}\n\nconst toolMap = {\n  bing_grounding: \"bingGrounding\",\n  fabric_dataagent: \"fabric_dataagent\",\n  sharepoint_grounding: \"sharepointGrounding\",\n  azure_function: \"azureFunction\",\n  bing_custom_search: \"bingCustomSearch\",\n};\n\n/**\n * Utility class for creating various tools.\n */\nexport class ToolUtility {\n  /**\n   * Creates a connection tool\n   *\n   * @param toolType - The type of the connection tool.\n   * @param connectionIds - A list of the IDs of the connections to use.\n   * @returns An object containing the definition for the connection tool\n   */\n  static createConnectionTool(\n    toolType: connectionToolType,\n    connectionIds: string[],\n  ): { definition: ToolDefinitionUnion } {\n    return {\n      definition: {\n        type: toolType,\n        [toolMap[toolType]]: {\n          connections: connectionIds.map((connectionId) => ({ connectionId: connectionId })),\n        },\n      },\n    };\n  }\n\n  /**\n   * Creates a bing grounding search tool\n   *\n   * @param connectionId - The ID of the bing search connection.\n   *\n   * @returns An object containing the definition and resources for the bing grounding search tool\n   *\n   */\n  static createBingGroundingTool(searchConfigurations: BingGroundingSearchConfiguration[]): {\n    definition: BingGroundingToolDefinition;\n  } {\n    // Ensure searchConfigurations is an array even if it's undefined\n    const configs = searchConfigurations || [];\n    return {\n      definition: {\n        type: \"bing_grounding\",\n        bingGrounding: {\n          searchConfigurations: configs.map((searchConfiguration) => ({\n            connectionId: searchConfiguration.connectionId,\n            market: searchConfiguration?.market,\n            setLang: searchConfiguration?.setLang,\n            count: searchConfiguration?.count,\n            freshness: searchConfiguration?.freshness,\n          })),\n        },\n      },\n    };\n  }\n\n  /**\n   * Creates a file search tool\n   *\n   * @param vectorStoreIds - The ID of the vector store attached to this agent. There can be a maximum of 1 vector store attached to the agent.\n   * @param vectorStores - The list of vector store configuration objects from Azure. This list is limited to one element. The only element of this list contains the list of azure asset IDs used by the search tool.\n   * @param definitionDetails - The input definition information for a file search tool as used to configure an agent.\n   *\n   * @returns An object containing the definition and resources for the file search tool\n   */\n  static createFileSearchTool(\n    vectorStoreIds?: string[],\n    vectorStores?: Array<VectorStoreConfigurations>,\n    definitionDetails?: FileSearchToolDefinitionDetails,\n  ): { definition: FileSearchToolDefinition; resources: ToolResources } {\n    return {\n      definition: { type: \"file_search\", fileSearch: definitionDetails },\n      resources: { fileSearch: { vectorStoreIds: vectorStoreIds, vectorStores: vectorStores } },\n    };\n  }\n\n  /**\n   * Creates a code interpreter tool\n   *\n   * @param fileIds - A list of file IDs made available to the `code_interpreter` tool. There can be a maximum of 20 files associated with the tool.\n   * @param dataSources - The data sources to be used. This option is mutually exclusive with fileIds.\n   *\n   * @returns An object containing the definition and resources for the code interpreter tool.\n   */\n  static createCodeInterpreterTool(\n    fileIds?: string[],\n    dataSources?: Array<VectorStoreDataSource>,\n  ): { definition: CodeInterpreterToolDefinition; resources: ToolResources } {\n    if (fileIds && dataSources) {\n      throw new Error(\"Cannot specify both fileIds and dataSources\");\n    }\n\n    return {\n      definition: { type: \"code_interpreter\" },\n      resources: { codeInterpreter: { fileIds: fileIds, dataSources: dataSources } },\n    };\n  }\n\n  /**\n   * Creates an Azure AI search tool\n   *\n   * @param indexConnectionId - The connection ID of the Azure AI search index.\n   * @param indexName - The name of the Azure AI search index.\n   *\n   * @returns An object containing the definition and resources for the Azure AI search tool.\n   */\n  static createAzureAISearchTool(\n    indexConnectionId: string,\n    indexName: string,\n    options?: AISearchIndexResource,\n  ): { definition: AzureAISearchToolDefinition; resources: ToolResources } {\n    return {\n      definition: { type: \"azure_ai_search\" },\n      resources: {\n        azureAISearch: {\n          indexList: [\n            {\n              indexConnectionId: indexConnectionId,\n              indexName: indexName,\n              queryType: options?.queryType,\n              topK: options?.topK,\n              filter: options?.filter,\n            },\n          ],\n        },\n      },\n    };\n  }\n\n  /**\n   * Creates a connected agent tool\n   *\n   * @returns An object containing the definition for the connected agent tool.\n   */\n  static createConnectedAgentTool(\n    id: string,\n    name: string,\n    description: string,\n  ): { definition: ConnectedAgentToolDefinition } {\n    return {\n      definition: {\n        type: \"connected_agent\",\n        connectedAgent: {\n          id: id,\n          name: name,\n          description: description,\n        },\n      },\n    };\n  }\n\n  /**\n   * Creates a function tool\n   *\n   * @param functionDefinition - The function definition to use.\n   *\n   * @returns An object containing the definition for the function tool.\n   */\n  static createFunctionTool(functionDefinition: FunctionDefinition): {\n    definition: FunctionToolDefinition;\n  } {\n    return {\n      definition: {\n        type: \"function\",\n        function: functionDefinition,\n      },\n    };\n  }\n\n  /**\n   * Creates an OpenApi tool\n   *\n   * @param openApiFunctionDefinition - The OpenApi function definition to use.\n   *\n   * @returns An object containing the definition for the OpenApi tool.\n   */\n  static createOpenApiTool(openApiFunctionDefinition: OpenApiFunctionDefinition): {\n    definition: OpenApiToolDefinition;\n  } {\n    return {\n      definition: OpenApiTool.createDefinition(openApiFunctionDefinition),\n    };\n  }\n\n  /**\n   * Creates an MCP tool with the provided configuration.\n   * @param options - Configuration options for the MCP tool\n   * @returns A new MCPTool instance\n   */\n  static createMCPTool(options: {\n    serverLabel: string;\n    serverUrl: string;\n    allowedTools?: string[];\n  }): MCPTool {\n    return new MCPTool(options.serverLabel, options.serverUrl, options.allowedTools);\n  }\n}\n\n/**\n * Represents a set of tools with their definitions and resources.\n */\nexport class ToolSet {\n  /** A list of tool definitions that have been added to the tool set. */\n  toolDefinitions: ToolDefinition[] = [];\n\n  /** A collection of resources associated with the tools in the tool set. */\n  toolResources: ToolResources = {};\n\n  /**\n   * Adds a connection tool to the tool set.\n   *\n   * @param toolType - The type of the connection tool.\n   * @param connectionIds - A list of the IDs of the connections to use.\n   *\n   * @returns An object containing the definition for the connection tool\n   */\n  addConnectionTool(\n    toolType: connectionToolType,\n    connectionIds: string[],\n  ): { definition: ToolDefinition } {\n    const tool = ToolUtility.createConnectionTool(toolType, connectionIds);\n    this.toolDefinitions.push(tool.definition);\n    return tool;\n  }\n\n  /**\n   * Adds a file search tool to the tool set.\n   *\n   * @param vectorStoreIds - The ID of the vector store attached to this agent. There can be a maximum of 1 vector store attached to the agent.\n   * @param vectorStores -  The list of vector store configuration objects from Azure. This list is limited to one element. The only element of this list contains the list of azure asset IDs used by the search tool.\n   * @param definitionDetails - The input definition information for a file search tool as used to configure an agent.\n   *\n   * @returns An object containing the definition and resources for the file search tool\n   */\n  addFileSearchTool(\n    vectorStoreIds?: string[],\n    vectorStores?: Array<VectorStoreConfigurations>,\n    definitionDetails?: FileSearchToolDefinitionDetails,\n  ): { definition: FileSearchToolDefinition; resources: ToolResources } {\n    const tool = ToolUtility.createFileSearchTool(vectorStoreIds, vectorStores, definitionDetails);\n    this.toolDefinitions.push(tool.definition);\n    this.toolResources = { ...this.toolResources, ...tool.resources };\n    return tool;\n  }\n\n  /**\n   * Adds a code interpreter tool to the tool set.\n   *\n   * @param fileIds - A list of file IDs made available to the `code_interpreter` tool. There can be a maximum of 20 files associated with the tool.\n   * @param dataSources - The data sources to be used. This option is mutually exclusive with fileIds.\n   *\n   * @returns An object containing the definition and resources for the code interpreter tool\n   */\n  addCodeInterpreterTool(\n    fileIds?: string[],\n    dataSources?: Array<VectorStoreDataSource>,\n  ): { definition: CodeInterpreterToolDefinition; resources: ToolResources } {\n    const tool = ToolUtility.createCodeInterpreterTool(fileIds, dataSources);\n    this.toolDefinitions.push(tool.definition);\n    this.toolResources = { ...this.toolResources, ...tool.resources };\n    return tool;\n  }\n\n  /**\n   * Adds an Azure AI search tool to the tool set.\n   *\n   * @param indexConnectionId - The connection ID of the Azure AI search index.\n   * @param indexName - The name of the Azure AI search index.\n   *\n   * @returns An object containing the definition and resources for the Azure AI search tool\n   */\n  addAzureAISearchTool(\n    indexConnectionId: string,\n    indexName: string,\n  ): { definition: AzureAISearchToolDefinition; resources: ToolResources } {\n    const tool = ToolUtility.createAzureAISearchTool(indexConnectionId, indexName);\n    this.toolDefinitions.push(tool.definition);\n    this.toolResources = { ...this.toolResources, ...tool.resources };\n    return tool;\n  }\n\n  /**\n   * Adds an OpenApi tool to the tool set.\n   *\n   * @param openApiFunctionDefinition - The OpenApi function definition to use.\n   *\n   * @returns An object containing the definition for the OpenApi tool\n   */\n  addOpenApiTool(openApiFunctionDefinition: OpenApiFunctionDefinition): {\n    definition: OpenApiToolDefinition;\n  } {\n    const tool = ToolUtility.createOpenApiTool(openApiFunctionDefinition);\n    this.toolDefinitions.push(tool.definition);\n    return tool;\n  }\n\n  /**\n   * Adds a Model Context Protocol (MCP) tool to the tool set.\n   * @param options - The options for configuring the MCP tool.\n   * @returns An object containing the definition and resources for the MCP tool\n   */\n  addMCPTool(options: { serverLabel: string; serverUrl: string; allowedTools?: string[] }): {\n    definition: MCPToolDefinition;\n    resources: ToolResources;\n  } {\n    const tool = ToolUtility.createMCPTool(options);\n    this.toolDefinitions.push(tool.definition);\n    this.toolResources = { ...this.toolResources, ...tool.resources };\n    return tool;\n  }\n\n  /**\n   * Adds a bing grounding search tool to the tool set.\n   *\n   * @param connectionId - The ID of the bing search connection.\n   *\n   * @returns An object containing the definition and resources for the bing grounding search tool\n   */\n  addBingGroundingTool(searchConfigurations: BingGroundingSearchConfiguration[]): {\n    definition: BingGroundingToolDefinition;\n  } {\n    const tool = ToolUtility.createBingGroundingTool(searchConfigurations);\n    this.toolDefinitions.push(tool.definition);\n    return tool;\n  }\n\n  /**\n   * Adds a connected agent tool to the tool set.\n   *\n   * @param id - The ID of the connected agent.\n   * @param name - The name of the connected agent.\n   * @param description - The description of the connected agent.\n   * @returns An object containing the definition for the connected agent tool\n   */\n  addConnectedAgentTool(\n    id: string,\n    name: string,\n    description: string,\n  ): { definition: ConnectedAgentToolDefinition } {\n    const tool = ToolUtility.createConnectedAgentTool(id, name, description);\n    this.toolDefinitions.push(tool.definition);\n    return tool;\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure/ai-agents",
-  "version": "1.1.0-beta.3",
+  "version": "1.2.0-alpha.20250923.1",
   "description": "Azure AI Agents client library.",
   "engines": {
     "node": ">=20.0.0"
@@ -71,48 +71,27 @@
     "@azure/core-tracing": "^1.2.0"
   },
   "devDependencies": {
-    "@azure/dev-tool": "^1.0.0",
-    "@azure/eslint-plugin-azure-sdk": "^3.0.0",
-    "@azure/identity": "^4.3.0",
+    "@azure/identity": "4.11.1",
     "@azure/opentelemetry-instrumentation-azure-sdk": "^1.0.0-beta.7",
     "@azure/monitor-opentelemetry": "^1.11.1",
     "@azure/monitor-opentelemetry-exporter": "^1.0.0-beta.31",
-    "@azure-tools/test-credential": "^2.0.0",
-    "@azure-tools/test-recorder": "^4.1.0",
-    "@azure-tools/test-utils-vitest": "^1.0.0",
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/instrumentation": "0.57.0",
     "@opentelemetry/sdk-trace-node": "^1.30.0",
-    "@vitest/browser": "^3.0.9",
-    "@vitest/coverage-istanbul": "^3.0.9",
-    "@types/node": "^20.0.0",
+    "@vitest/browser": "^3.2.3",
+    "@vitest/coverage-istanbul": "^3.2.3",
+    "@types/node": "^20.19.0",
     "dotenv": "^16.0.0",
-    "eslint": "^9.9.0",
+    "eslint": "^9.33.0",
     "prettier": "^3.2.5",
-    "playwright": "^1.41.2",
-    "typescript": "~5.8.2",
-    "vitest": "^3.0.9"
-  },
-  "scripts": {
-    "build": "npm run clean && dev-tool run build-package && dev-tool run vendored mkdirp ./review && dev-tool run extract-api",
-    "build:samples": "echo skipped",
-    "check-format": "dev-tool run vendored prettier --list-different --config ../../../.prettierrc.json --ignore-path ../../../.prettierignore \"src/**/*.{ts,cts,mts}\" \"test/**/*.{ts,cts,mts}\" \"samples-dev/**/*.{ts,cts,mts}\" \"*.{js,cjs,mjs,json}\" ",
-    "clean": "dev-tool run vendored rimraf --glob dist dist-* test-dist temp types *.tgz *.log",
-    "copy:yaml": "copy tsp-location.yaml .\\src\\generated\\tsp-location.yaml",
-    "execute:samples": "dev-tool samples run samples-dev",
-    "extract-api": "dev-tool run vendored rimraf review && dev-tool run vendored mkdirp ./review && dev-tool run extract-api",
-    "format": "dev-tool run vendored prettier --write --config ../../../.prettierrc.json --ignore-path ../../../.prettierignore \"src/**/*.{ts,cts,mts}\" \"test/**/*.{ts,cts,mts}\" \"samples-dev/**/*.{ts,cts,mts}\" \"*.{js,cjs,mjs,json}\" ",
-    "generate": "dev-tool run vendored rimraf ./src/generated && dev-tool run vendored mkdirp ./src/generated && npm run copy:yaml && npm run tsp:update && dev-tool run vendored rimraf ./src/generated/test && dev-tool run vendored rimraf ./src/generated/tsp-location.yaml",
-    "generate-samples": "dev-tool samples publish -f",
-    "lint": "eslint package.json src test",
-    "lint:fix": "eslint package.json src test --fix --fix-type [problem,suggestion]",
-    "pack": "npm pack 2>&1",
-    "test": "npm run test:node && npm run test:browser",
-    "test:browser": "dev-tool run build-test && dev-tool run test:vitest --browser",
-    "test:node": "dev-tool run test:vitest",
-    "test:node:esm": "dev-tool run test:vitest --esm --no-test-proxy",
-    "tsp:update": "tsp-client update -o ./src/generated",
-    "update-snippets": "dev-tool run update-snippets"
+    "playwright": "^1.50.1",
+    "typescript": "~5.8.3",
+    "vitest": "^3.2.3",
+    "@azure/dev-tool": "^1.0.0",
+    "@azure/eslint-plugin-azure-sdk": "^3.0.0",
+    "@azure-tools/test-recorder": "^4.1.1",
+    "@azure-tools/test-utils-vitest": "^2.0.1",
+    "@azure-tools/test-credential": "^2.1.2"
   },
   "exports": {
     "./package.json": "./package.json",
@@ -150,5 +129,25 @@
   },
   "main": "./dist/commonjs/index.js",
   "types": "./dist/commonjs/index.d.ts",
-  "module": "./dist/esm/index.js"
-}
+  "module": "./dist/esm/index.js",
+  "scripts": {
+    "build": "npm run clean && dev-tool run build-package && dev-tool run vendored mkdirp ./review && dev-tool run extract-api",
+    "build:samples": "tsc -p tsconfig.samples.json",
+    "check-format": "dev-tool run vendored prettier --list-different --config ../../../.prettierrc.json --ignore-path ../../../.prettierignore \"src/**/*.{ts,cts,mts}\" \"test/**/*.{ts,cts,mts}\" \"samples-dev/**/*.{ts,cts,mts}\" \"*.{js,cjs,mjs,json}\" ",
+    "clean": "dev-tool run vendored rimraf --glob dist dist-* test-dist temp types *.tgz *.log",
+    "copy:yaml": "copy tsp-location.yaml .\\src\\generated\\tsp-location.yaml",
+    "execute:samples": "dev-tool samples run samples-dev",
+    "extract-api": "dev-tool run vendored rimraf review && dev-tool run vendored mkdirp ./review && dev-tool run extract-api",
+    "format": "dev-tool run vendored prettier --write --config ../../../.prettierrc.json --ignore-path ../../../.prettierignore \"src/**/*.{ts,cts,mts}\" \"test/**/*.{ts,cts,mts}\" \"samples-dev/**/*.{ts,cts,mts}\" \"*.{js,cjs,mjs,json}\" ",
+    "generate": "dev-tool run vendored rimraf ./src/generated && dev-tool run vendored mkdirp ./src/generated && npm run copy:yaml && npm run tsp:update && dev-tool run vendored rimraf ./src/generated/test && dev-tool run vendored rimraf ./src/generated/tsp-location.yaml",
+    "generate-samples": "dev-tool samples publish -f",
+    "lint": "eslint package.json src test",
+    "lint:fix": "eslint package.json src test --fix --fix-type [problem,suggestion]",
+    "pack": "pnpm pack 2>&1",
+    "test": "npm run test:node && npm run test:browser",
+    "test:browser": "dev-tool run build-test && dev-tool run test:vitest --browser",
+    "test:node": "dev-tool run build-test --no-browser-test && dev-tool run test:vitest",
+    "tsp:update": "tsp-client update -o ./src/generated",
+    "update-snippets": "dev-tool run update-snippets"
+  }
+}