Extend ExecuteResourceQueryAsync to return a model type with more information

[alzimmermsft]

What does this PR do?

Extends BaseAzureResouceService.ExecuteResourceQueryAsync to return a model type that can be extended with additional information in the future.

In this PR, TruncatedResults is added to the results returned by ExecuteResourceQueryAsync to indicate if the query limit prevented results from being returned, or in other words indicating if results were truncated and additional queries are needed to get all the results. At this time this is nothing more than information for the LLM and user as acting on truncation won't be available until paging is implemented.

GitHub issue number?

[Link to the GitHub issue this PR addresses]

Pre-merge Checklist

• Required for All PRs
  • Read contribution guidelines
  • PR title clearly describes the change
  • Commit history is clean with descriptive messages (cleanup guide)
  • Added comprehensive tests for new/modified functionality
  • Updated servers/Azure.Mcp.Server/CHANGELOG.md and/or servers/Fabric.Mcp.Server/CHANGELOG.md for product changes (features, bug fixes, UI/UX, updated dependencies)
• For MCP tool changes:
  • One tool per PR: This PR adds or modifies only one MCP tool for faster review cycles
  • Updated servers/Azure.Mcp.Server/README.md and/or servers/Fabric.Mcp.Server/README.md documentation
  • Validate README.md changes using script at eng/scripts/Process-PackageReadMe.ps1. See Package README
  • Updated command list in /servers/Azure.Mcp.Server/docs/azmcp-commands.md and/or /docs/fabric-commands.md
  • Run .\eng\scripts\Update-AzCommandsMetadata.ps1 to update tool metadata in azmcp-commands.md (required for CI)
  • For new or modified tool descriptions, ran ToolDescriptionEvaluator and obtained a score of 0.4 or more and a top 3 ranking for all related test prompts
  • For tools with new names, including new tools or renamed tools, update consolidated-tools.json
  • For new tools associated with Azure services or publicly available tools/APIs/products, add URL to documentation in the PR description
• Extra steps for Azure MCP Server tool changes:
  • Updated test prompts in /servers/Azure.Mcp.Server/docs/e2eTestPrompts.md
  • 👉 For Community (non-Microsoft team member) PRs:
    • Security review: Reviewed code for security vulnerabilities, malicious code, or suspicious activities before running tests (crypto mining, spam, data exfiltration, etc.)
    • Manual tests run: added comment /azp run mcp - pullrequest - live to run Live Test Pipeline

[Copilot]

Pull request overview

This PR extends the BaseAzureResourceService.ExecuteResourceQueryAsync method to return a ResourceQueryResults<T> wrapper type that includes both the query results and a TruncatedResults boolean flag. This flag indicates whether the Azure Resource Graph query limit prevented all matching resources from being returned.

Changes:

• Introduces a new ResourceQueryResults<T> record type with Results and TruncatedResults properties
• Updates ExecuteResourceQueryAsync in BaseAzureResourceService to return the new wrapper type
• Updates service interfaces and implementations across 7 tool packages (ACR, AppConfig, Authorization, Grafana, Kusto, SQL, Storage)
• Updates command result records to include the TruncatedResults field
• Updates all unit tests to work with the new return type
• Improves test patterns by replacing Task.FromException with ThrowsAsync for NSubstitute mocks

Reviewed changes

Copilot reviewed 33 out of 33 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
core/Azure.Mcp.Core/src/Services/Azure/BaseAzureResourceService.cs	Adds ResourceQueryResults<T> record and updates ExecuteResourceQueryAsync return type to include truncation information
tools/Azure.Mcp.Tools.Storage/src/Services/IStorageService.cs	Updates GetAccountDetails signature to return ResourceQueryResults<StorageAccountInfo>
tools/Azure.Mcp.Tools.Storage/src/Services/StorageService.cs	Implements new return type for GetAccountDetails, returns wrapper with truncation flag
tools/Azure.Mcp.Tools.Sql/src/Services/ISqlService.cs	Updates ListDatabasesAsync and GetElasticPoolsAsync signatures to return ResourceQueryResults
tools/Azure.Mcp.Tools.Sql/src/Services/SqlService.cs	Implements new return types for database and elastic pool listing methods
tools/Azure.Mcp.Tools.Sql/src/Commands/Database/DatabaseListCommand.cs	Updates result record to include TruncatedResults and extracts both properties from service response
tools/Azure.Mcp.Tools.Sql/src/Commands/ElasticPool/ElasticPoolListCommand.cs	Updates result record to include TruncatedResults and extracts both properties from service response
tools/Azure.Mcp.Tools.Kusto/src/Services/IKustoService.cs	Updates ListClustersAsync signature to return ResourceQueryResults<string>
tools/Azure.Mcp.Tools.Kusto/src/Services/KustoService.cs	Implements new return type for cluster listing
tools/Azure.Mcp.Tools.Kusto/src/Commands/ClusterListCommand.cs	Updates result record and extracts truncation information
tools/Azure.Mcp.Tools.Grafana/src/Services/IGrafanaService.cs	Updates ListWorkspacesAsync signature to return ResourceQueryResults<GrafanaWorkspace>
tools/Azure.Mcp.Tools.Grafana/src/Services/GrafanaService.cs	Implements new return type for workspace listing
tools/Azure.Mcp.Tools.Grafana/src/Commands/Workspace/WorkspaceListCommand.cs	Updates result record and extracts truncation information
tools/Azure.Mcp.Tools.Authorization/src/Services/IAuthorizationService.cs	Updates ListRoleAssignmentsAsync signature to return ResourceQueryResults<RoleAssignment>
tools/Azure.Mcp.Tools.Authorization/src/Services/AuthorizationService.cs	Implements new return type for role assignment listing
tools/Azure.Mcp.Tools.Authorization/src/Commands/RoleAssignmentListCommand.cs	Updates result record and extracts truncation information
tools/Azure.Mcp.Tools.AppConfig/src/Services/IAppConfigService.cs	Updates GetAppConfigAccounts signature to return ResourceQueryResults<AppConfigurationAccount>
tools/Azure.Mcp.Tools.AppConfig/src/Services/AppConfigService.cs	Implements new return type for account listing
tools/Azure.Mcp.Tools.AppConfig/src/Commands/Account/AccountListCommand.cs	Updates result record and extracts truncation information
tools/Azure.Mcp.Tools.Acr/src/Services/IAcrService.cs	Updates ListRegistries signature to return ResourceQueryResults<AcrRegistryInfo>
tools/Azure.Mcp.Tools.Acr/src/Services/AcrService.cs	Implements new return type for registry listing
tools/Azure.Mcp.Tools.Acr/src/Commands/Registry/RegistryListCommand.cs	Updates result record and extracts truncation information
Various test files	Updates mocks and expectations to use ResourceQueryResults wrapper, improves test patterns with ThrowsAsync
servers/Azure.Mcp.Server/docs/new-command.md	Updates documentation example to show new return type
AGENTS.md	Updates service implementation example to show new return type
core/Azure.Mcp.Core/tests/.../SubscriptionCommandTests.cs	Updates tests to work with new return type