[BREAKING] Python: add Responses conversation ID helper

[eavanvalkenburg]

Motivation & Context

App-owned Responses hosting needs a supported way to mint conversation IDs and distinguish stable conversation continuations from previous-response continuations without re-inspecting the request body.

Description & Review Guide

• What are the major changes? Adds the public create_conversation_id() helper, returning conv_ plus a UUID hex value; changes responses_session_id() to return (session_id, is_conversation_id); and renames the optional session_id keyword on both response converters to the clearer conversation_id. The session flag is True for a conversation ID, False for a previous response ID, and None when no session ID is present. Updates package documentation, tests, and affected samples.
• What is the impact of these changes? Hosting applications can generate Responses-shaped conversation IDs and branch directly on the returned flag. Existing callers of responses_session_id() must unpack the new tuple return value, and callers supplying a conversation to either response converter must use the renamed keyword.
• What do you want reviewers to focus on? The tuple semantics, including preserving previous_response_id precedence when both request fields are present, and the narrower conversation-only parameters on the response converters.

Related Issue

No issue was created for this small change, as requested. No duplicate open PR was found.

Contribution Checklist

• The code builds clean without any errors or warnings
• All unit tests pass, and I have added new tests where possible
• The PR follows the Contribution Guidelines
• This PR is linked to an issue and there is no other open PR for this issue (see Related Issue above).
• This is not a breaking change. If it is a breaking change, add the breaking change label (or add "[BREAKING]" to the title prefix, before or after any language prefix) — a workflow keeps the label and title prefix in sync automatically.

[Copilot]

Pull request overview

This PR updates the Python agent-framework-hosting-responses helpers to provide a supported way for hosting apps to mint Responses-shaped conversation IDs and to reliably distinguish conversation_id continuation from previous_response_id continuation without re-parsing the request body.

Changes:

• Added public create_conversation_id() helper (conv_ + UUID hex).
• Changed responses_session_id() to return (session_id, is_conversation_id) and updated tests, docs, and samples accordingly.
• Updated sample route logic to use the new tuple semantics.

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
python/samples/04-hosting/af-hosting/local_responses/app.py	Updates sample route to unpack responses_session_id() and branch using is_conversation_id.
python/samples/04-hosting/af-hosting/local_responses_workflow/app.py	Updates workflow sample to unpack the tuple and reject conversation_id continuations.
python/packages/hosting-responses/tests/hosting_responses/test_parsing.py	Adds tests for create_conversation_id() and updates responses_session_id() assertions to the tuple return.
python/packages/hosting-responses/tests/hosting_responses/test_http_round_trip.py	Updates test server route to unpack the tuple and compute conversation_id via the flag.
python/packages/hosting-responses/README.md	Updates documentation and example code to reflect tuple return and new helper.
python/packages/hosting-responses/agent_framework_hosting_responses/_parsing.py	Implements create_conversation_id() and updates responses_session_id() signature/behavior to return (id, flag).
python/packages/hosting-responses/agent_framework_hosting_responses/init.py	Re-exports create_conversation_id as part of the public package surface.

[github-actions]

Automated Code Review

Reviewers: 5 | Confidence: 90% | Result: All clear

Reviewed: Correctness, Security Reliability, Test Coverage, Failure Modes, Design Approach

---

Automated review by eavanvalkenburg's agents

[github-actions]

Python Test Coverage Report •

File	Stmts	Miss	Cover	Missing
packages/hosting-responses/agent_framework_hosting_responses
_parsing.py	483	206	57%	97, 120, 250, 254, 269–272, 274–279, 281–284, 288–298, 307–311, 342–344, 346–350, 354–357, 359–362, 364–367, 381–412, 476, 490, 510, 513–516, 518, 537–544, 546, 562–564, 578, 590, 602, 617–624, 626, 637–638, 652, 661–663, 673, 678, 687, 691, 695–696, 701–704, 711, 715–723, 727–732, 736–743, 747–751, 755–757, 761–763, 767–769, 774, 776, 781–787, 793–796, 804–808, 814, 816–818, 823–829, 833–836, 916
TOTAL	44844	5103	88%

Python Unit Test Overview

Tests	Skipped	Failures	Errors	Time
9141	33 💤	0 ❌	0 🔥	2m 28s ⏱️