.NET: Python: [Bug]: Azure AI Search citations missing `additional_properties.get_url` in Foundry streaming

[Harsh-Microsoft]

Description

url_citation annotations from Azure AI Search in FoundryAgent streaming responses no longer expose the per-document REST URL under additional_properties.get_url. Only the search-service root URL and a generic doc_N title are surfaced, making it impossible to identify or dereference the specific document referenced by each citation.

This worked on agent-framework-azure-ai==1.0.0rc2 and is broken on GA release.

Steps to Reproduce

1. Configure FoundryAgent with AzureAISearchTool.
2. Stream a query that triggers Azure AI Search.
3. Inspect chunk.contents[].annotations for type='citation'.

Expected Behaviour

{
    'type': 'citation',
    'title': 'doc_4',
    'url': 'https://srch-example.search.windows.net/',
    'additional_properties': {
        'annotation_index': 1,
        'get_url': 'https://srch-example.search.windows.net/indexes/<index>/docs/<doc-id>_01?api-version=2024-07-01&$select=...',
    },
    ...
}

Actual Behaviour

{
    'type': 'citation',
    'title': 'doc_4',
    'url': 'https://srch-example.search.windows.net/',
    'additional_properties': None,
    ...
}

Debug log shows the source event is dropped:

DEBUG agent_framework.openai: Unparsed event of type: response.azure_ai_search_call_output.done: ...

Code Sample

Error Messages / Stack Traces

Package Versions

agent-framework-core==1.3.0 agent-framework-foundry==1.3.0 azure-ai-projects==2.1.0

Python Version

Python 3.11

Additional Context

Related: #4418 (same scenario, generic doc_N titles).

[github-actions]

🤖 Automated triage reproduction notes (agent-authored — trust but verify)

Agent analysis

Repro: OpenAIChatClient._parse_chunk_from_openai() in python/packages/openai/agent_framework_openai/_chat_client.py lines 2878-2900 handles url_citation streaming annotations but only stores annotation_index in additional_properties — it never reads the get_url field from the annotation dict/object. Additionally, response.azure_ai_search_call_output.done events hit the catch-all case at line 2921 and are silently dropped. The fix requires (a) extracting get_url from the annotation and adding it to additional_properties, and (b) optionally handling azure_ai_search_call_output.done events to correlate per-document URLs with citations. Minimal repro: mock a streaming event with type=response.output_text.annotation.added carrying a url_citation annotation dict that includes a get_url key, and assert get_url appears in the parsed Annotation's additional_properties.

• Failing test: python/packages/openai/tests/openai/test_issue_5995_citation_get_url.py
• Files examined: python/packages/openai/agent_framework_openai/_chat_client.py, python/packages/openai/tests/openai/test_openai_chat_client.py, python/packages/foundry/pyproject.toml, python/packages/openai/pyproject.toml, python/packages/core/pyproject.toml
• Tests run: python/packages/openai/tests/openai/test_issue_5995_citation_get_url.py::TestIssue5995AzureAISearchCitationGetUrl::test_url_citation_streaming_missing_get_url (FAILED), python/packages/openai/tests/openai/test_issue_5995_citation_get_url.py::TestIssue5995AzureAISearchCitationGetUrl::test_azure_ai_search_call_output_event_is_dropped (PASSED)
• Reported version: agent-framework-foundry==1.3.0
• Current version: 1.5.0