Python: [Python] azure-ai-agentserver-agentframework 1.0.0b17 incompatible with agent-framework-core 1.0.1 GA

[leestott]

Description

The azure-ai-agentserver-agentframework hosting adapter package (v1.0.0b17) pins its dependencies to pre-release versions of agent-framework, making it incompatible with the GA 1.0.1 release.

Dependency Conflict

agent-framework-core==1.0.1          (GA, released 2026-04-10)
agent-framework-foundry==1.0.1       (GA, released 2026-04-10)
azure-ai-agentserver-agentframework==1.0.0b17  (latest, released 2026-03-16)

azure-ai-agentserver-agentframework==1.0.0b17 requires:

• agent-framework-core<=1.0.0rc3,>=1.0.0rc2
• agent-framework-azure-ai<=1.0.0rc3,>=1.0.0rc2

This conflicts with the GA packages because:

1. agent-framework-core==1.0.1 is outside the <=1.0.0rc3 upper bound
2. agent-framework-azure-ai has been renamed to agent-framework-foundry in GA

Reproduction

# requirements.txt
agent-framework-core==1.0.1
agent-framework-foundry==1.0.1
azure-ai-agentserver-agentframework==1.0.0b17
azure-ai-agentserver-core==1.0.0b17
azure-identity>=1.19.0

pip install -r requirements.txt

Error output

ERROR: Cannot install agent-framework-core==1.0.1 and azure-ai-agentserver-agentframework==1.0.0b17 because these package versions have conflicting dependencies.

The conflict is caused by:
    The user requested agent-framework-core==1.0.1
    agent-framework-foundry 1.0.1 depends on agent-framework-core<2 and >=1.0.1
    azure-ai-agentserver-agentframework 1.0.0b17 depends on agent-framework-core<=1.0.0rc3 and >=1.0.0rc2

ERROR: ResolutionImpossible

Impact

Users deploying hosted agents to Microsoft Foundry Agent Service via azd up / azd deploy cannot upgrade to the Agent Framework GA release. The hosting adapter is a required dependency for the from_agent_framework(agent).run() pattern used to wrap agents as HTTP servers on Foundry.

This blocks adoption of:

• agent-framework-foundry (the renamed agent-framework-azure-ai with FoundryChatClient)
• agent-framework-core>=1.0.1 GA features
• Updated env var conventions (FOUNDRY_PROJECT_ENDPOINT, FOUNDRY_MODEL)

Expected Resolution

A new release of azure-ai-agentserver-agentframework that:

1. Relaxes the agent-framework-core version constraint to >=1.0.1,<2
2. Replaces the agent-framework-azure-ai dependency with agent-framework-foundry>=1.0.1,<2
3. Updates internal imports from agent_framework.azure to agent_framework_foundry

Environment

• OS: Windows 11
• Python: 3.13
• agent-framework-core: 1.0.1 (GA target)
• azure-ai-agentserver-agentframework: 1.0.0b17 (latest available)
• azd: latest with azure.ai.agents extension v0.1.22-preview

Workaround

Stay on pre-release versions until the hosting adapter is updated:

agent-framework-core==1.0.0rc3
agent-framework-azure-ai==1.0.0rc3
azure-ai-agentserver-agentframework==1.0.0b17
azure-ai-agentserver-core==1.0.0b17

Note: azure-ai-agentserver-agentframework is published under the Azure SDK for Python repo, so the fix may need to be coordinated there.

[leestott]

Also filed as Azure/azure-sdk-for-python#46324 since the azure-ai-agentserver-agentframework package is published from that repo. The fix will need to be coordinated there.

[ShivamGoyal03]

Thanks for raising it Lee Stott (@leestott)

[mitokic]

Seems like the agent server packages for deploying hosted foundry agents are getting re-written from the ground up. Not sure when the package rewrites will be connected to agent framework but I hope it will be soon 😊.

Here's the changelog for the agent server core package. With info on switching to new versions.
https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/agentserver/azure-ai-agentserver-core/CHANGELOG.md#200b1-2026-04-14

[moonbox3]

Will be fixed by #5379