[FF] mcp_tool_alias_resolution -- Resolve stored agent tool aliases to canonical names

Summary

Roll out Map stored agent tool aliases to canonical names currently behind the mcp_tool_alias_resolution feature flag.

  • DRI: @terrichu
  • Team Slack channel: #g_agent_execution

What could go wrong?

If resolve_alias incorrectly rewrites a tool name, an agent could receive the wrong tool or lose access to a tool it selected. The feature flag allows disabling alias resolution to fall back to the previous behavior (stored alias names are silently dropped during the intersection with available tools).

Rollout

Run all production /chatops in #production and cross-post the results to #g_agent_execution. Background: incremental rollout process, feature actors.

Non-production

/chatops gitlab run feature set mcp_tool_alias_resolution 50 --actors --dev --pre --staging --staging-ref
/chatops gitlab run feature set mcp_tool_alias_resolution true --dev --pre --staging --staging-ref

Production -- percentage rollout (wait >=15 min between steps, watch dashboards):

/chatops gitlab run feature set mcp_tool_alias_resolution <percentage> --actors

Before global rollout

Cleanup

Remove the flag once deemed stable -- see cleaning up. Track it here, or open a follow-up Feature Flag Cleanup issue. Remove the flag and its YAML definition from the codebase, then:

/chatops gitlab run release check <merge-request-url> <milestone>
/chatops gitlab run feature delete mcp_tool_alias_resolution --dev --pre --staging --staging-ref --production

Rollback

/chatops gitlab run feature set mcp_tool_alias_resolution false                                         # production
/chatops gitlab run feature set mcp_tool_alias_resolution false --dev --pre --staging --staging-ref     # non-production
/chatops gitlab run feature delete mcp_tool_alias_resolution --dev --pre --staging --staging-ref --production  # remove entirely