Fixes Foundry Hosted Agents HTTP endpoints

[tommasodotNET]

Description

Closes #16115. Overwrites existing http/https endpoints on resource to allow the creation of dedicated hosted agent endpoint. Does not hard code http port (letting aspire handle port assignment). PublishAsHostedAgent accepts generic resource with endpoint (e.g. ProjectResource) allowing hosted agents in dotnet (see also #15968).
Allows for custom targetPorts to allow locally run multiple hosted agents

Adds a playground sample for hosted agents in python

Fixes # (issue)

Checklist

• Is this feature complete?
  • Yes. Ready to ship.
  • No. Follow-up changes expected.
• Are you including unit tests for the changes and scenario tests if relevant?
  • Yes
  • No
• Did you add public API?
  • Yes
    • If yes, did you have an API Review for it?
      • Yes
      • No
    • Did you add <remarks /> and <code /> elements on your triple slash comments?
      • Yes
      • No
  • No
• Does the change make any security assumptions or guarantees?
  • Yes
    • If yes, have you done a threat model and had a security review?
      • Yes
      • No
  • No
• Does the change require an update in our Aspire docs?
  • Yes
    • Link to aspire.dev issue:
      • New issue
  • No

[github-actions]

🚀 Dogfood this PR with:

⚠️ WARNING: Do not do this without first carefully reviewing the code of this PR to satisfy yourself it is safe.

curl -fsSL https://raw.githubusercontent.com/microsoft/aspire/main/eng/scripts/get-aspire-cli-pr.sh | bash -s -- 16130

Or

• Run remotely in PowerShell:

iex "& { $(irm https://raw.githubusercontent.com/microsoft/aspire/main/eng/scripts/get-aspire-cli-pr.ps1) } 16130"

[Copilot]

Pull request overview

Updates the Foundry hosted-agent run-mode behavior to avoid endpoint conflicts when PublishAsHostedAgent is applied to resources that already define HTTP endpoints, and adds a new playground sample for hosted agents.

Changes:

• In run mode, removes existing HTTP/HTTPS endpoint annotations before adding the hosted-agent HTTP endpoint.
• Refactors publish-mode containerization to explicitly handle ProjectResource vs ExecutableResource.
• Adds a playground/FoundryHostedAgents sample (AppHost + Python agent app scaffolding).

Reviewed changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
tests/Aspire.Hosting.Foundry.Tests/HostedAgentExtensionTests.cs	Adds tests asserting hosted-agent run-mode endpoint overwrite behavior and non-hardcoded port behavior.
src/Aspire.Hosting.Foundry/HostedAgent/HostedAgentBuilderExtension.cs	Implements endpoint removal in run mode and adjusts publish-mode containerization logic.
playground/FoundryHostedAgents/aspire.config.json	Adds Aspire config pointing to the new playground AppHost.
playground/FoundryHostedAgents/app/pyproject.toml	Adds Python agent sample dependencies/config.
playground/FoundryHostedAgents/app/main.py	Adds Python agent sample implementation.
playground/FoundryHostedAgents/app/.dockerignore	Adds Docker ignore rules for the Python sample.
playground/FoundryHostedAgents/FoundryHostedAgents.AppHost/appsettings.json	Adds logging configuration for the new AppHost sample.
playground/FoundryHostedAgents/FoundryHostedAgents.AppHost/appsettings.Development.json	Adds development Azure settings for the sample (currently includes specific identifiers).
playground/FoundryHostedAgents/FoundryHostedAgents.AppHost/Properties/launchSettings.json	Adds launch profiles for the new AppHost sample.
playground/FoundryHostedAgents/FoundryHostedAgents.AppHost/FoundryHostedAgents.AppHost.csproj	Adds a new AppHost project file for the playground sample.
playground/FoundryHostedAgents/FoundryHostedAgents.AppHost/AppHost.cs	Adds the new playground AppHost wiring for Foundry + Python hosted agent.

[tommasodotNET]

UPDATE: instead of removing the existing endpoints, we can overwrite them. looks like a better solution. The fix still enables use with dotnet hosted agents (sample added).
We also allow custom targetPorts to handle multiple local hosted agents

[tommasodotNET]

UPDATE: i've realized there are internal dependency issue when working with Foundry Hosted Agents on Microsoft Agent Framework packages. Looks like I found a sweet spot, so you may see strange MAF pckgs versions in the playground.
@sebastienros because of this, I yet again need help to fix internal feeds