[azure-ai-agentserver-agentframework] Dependency conflict with agent-framework-core 1.0.1 GA

[leestott]

Description

The azure-ai-agentserver-agentframework package (v1.0.0b17, released 2026-03-16) pins its dependencies to pre-release versions of agent-framework, making it incompatible with the GA 1.0.1 release (published 2026-04-10).

Cross-reference: microsoft/agent-framework#5273

Dependency Conflict

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

The GA release changed:

• agent-framework-core → 1.0.1 (outside the <=1.0.0rc3 upper bound)
• agent-framework-azure-ai → renamed to agent-framework-foundry==1.0.1

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

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

Anyone deploying hosted agents to Microsoft Foundry Agent Service (via azd up / azd deploy or the from_agent_framework(agent).run() pattern) cannot upgrade to the Agent Framework GA release. This blocks:

• Adoption of agent-framework-foundry (FoundryChatClient, the replacement for AzureAIAgentClient)
• agent-framework-core>=1.0.1 GA features
• Updated env var conventions (FOUNDRY_PROJECT_ENDPOINT, FOUNDRY_MODEL)

Expected Fix

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

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

The same changes likely apply to azure-ai-agentserver-core if it has similar pinned constraints.

Workaround

Stay on pre-release versions:

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

Environment

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

[ShivamGoyal03]

Thanks for raising it @leestott

[ashishmundra4001]

I have raised this 2 weeks ago - #46136

[mhmtkcm]

It seems that the 'azure-ai-agentserver-agentframework' package is no longer included in the latest agentserver packages. Does anyone know what the latest developments are regarding this?

Even if the “core” package is to be used from now on, there is still no guide on how to use it with the Agent Framework.