[yzt (Y-Sindo)]

Description

Update azure-messaging-webpubsubchatservice to 2026-08-01-preview, adding topic lifecycle APIs and room, user, and user-room collection APIs.

Compared with the previous preview (1.0.0b1), request models are now split by HTTP method instead of reusing resource response models:. See APIView Diff against previous preview.

• PUT: dedicated Chat*CreateOrReplace models exclude service-assigned fields. ChatTopicCreateOrReplace requires title and accepts optional state for replacement.
• PATCH: ChatMessageUpdate and ChatTopicUpdate have optional fields for partial updates.
• Responses: existing resource model names remain unchanged.

Why: generated shared models do not consistently reflect lifecycle visibility and PATCH requiredness. For example, the shared ChatTopic constructor requires both title and state, preventing typed title-only creation or state-only updates. See Azure/typespec-azure#5721.

This intentionally changes request input types from the previous preview; the customization lives in TypeSpec rather than handwritten generated Python code.

TypeSpec changes: Azure/azure-rest-api-specs#46545 (new APIs) and Azure/azure-rest-api-specs#47311 (lifecycle request models).

All SDK Contribution checklist:

• The pull request does not introduce [breaking changes]
• CHANGELOG is updated for new features, bug fixes or other significant changes.
• I have read the contribution guidelines.

General Guidelines and Best Practices

• Title of the pull request is clear and informative.
• There are a small number of commits, each of which have an informative message. This means that previously merged commits do not appear in the history of the PR. For more information on cleaning up the commits in your PR, see this page.

Testing Guidelines

• Pull request includes test coverage for the included changes.

[azure-pipelines]

Azure Pipelines:
Successfully started running 1 pipeline(s).
10 pipeline(s) were filtered out due to trigger conditions.
There may be pipelines that require an authorized user to comment /azp run to run.

[Copilot]

🟡 Changes recommended

Default-version rollout, paging and model contracts, documentation, and package-version metadata have unresolved issues.

5 open findings

• Bump package version and update changelog for public API changes · New
• New default API version breaks existing operations · New
• Paged collections lack public page size and continuation parameters · New
• Topic constructor incorrectly requires state · New
• Topic ID lifecycle documentation is contradictory · New

What changed in this PR

Updates the Web PubSub Chat SDK to the 2026-08-01-preview API, adding topic lifecycle and collection operations.

Changes:

• Adds sync/async topic and paged collection APIs with models and validation.
• Adds unit, live, generated tests, and samples.
• Refreshes README, APIView, recordings, and generation metadata.

Paths below are relative to sdk/webpubsub/azure-messaging-webpubsubchatservice/.

File	Description
tsp-location.yaml	Updates the TypeSpec source commit.
tests/​testcase.py	Allows client configuration overrides.
tests/​test_topics.py	Tests topic lifecycle and paging.
tests/​test_topics_live.py	Adds synchronous live scenarios.
tests/​test_topics_live_async.py	Adds asynchronous live scenarios.
tests/​test_client.py	Covers new collections and API version.
samples/​sample_roles_and_permissions.py	Simplifies the synchronous role sample.
samples/​sample_roles_and_permissions_async.py	Simplifies the asynchronous role sample.
samples/​sample_readme_snippets.py	Supplies README snippet sources.
samples/​sample_message_history.py	Removes the standalone sync sample.
samples/​sample_message_history_async.py	Removes the standalone async sample.
samples/​sample_logging.py	Adds a logging sample.
samples/​sample_errors.py	Adds error-handling guidance.
samples/​sample_client_access.py	Narrows the documented snippet.
samples/​sample_client_access_async.py	Adds an async snippet region.
README.md	Documents topics, collections, and samples.
pyproject.toml	Updates package-discovery exclusions.
generated_tests/​test_web_pub_sub_chat_service.py	Adds generated sync operation tests.
generated_tests/​test_web_pub_sub_chat_service_async.py	Adds generated async operation tests.
generated_samples/​update_topic.py	Adds a topic-update sample.
generated_samples/​update_message.py	Refreshes example provenance.
generated_samples/​list_users.py	Adds a user-list sample.
generated_samples/​list_topics.py	Adds a topic-list sample.
generated_samples/​list_rooms.py	Adds a room-list sample.
generated_samples/​list_rooms_for_user.py	Adds a user-room sample.
generated_samples/​list_room_members.py	Refreshes example provenance.
generated_samples/​list_roles.py	Refreshes example provenance.
generated_samples/​list_messages.py	Refreshes example provenance.
generated_samples/​get_user.py	Refreshes example provenance.
generated_samples/​get_topic.py	Adds a topic-get sample.
generated_samples/​get_room.py	Refreshes example provenance.
generated_samples/​get_role.py	Refreshes example provenance.
generated_samples/​get_conversation.py	Refreshes example provenance.
generated_samples/​delete_user.py	Refreshes example provenance.
generated_samples/​delete_topic.py	Adds a topic-delete sample.
generated_samples/​delete_room.py	Refreshes example provenance.
generated_samples/​delete_room_member.py	Refreshes example provenance.
generated_samples/​delete_role.py	Refreshes example provenance.
generated_samples/​delete_message.py	Refreshes example provenance.
generated_samples/​create_or_replace_user.py	Refreshes example provenance.
generated_samples/​create_or_replace_topic.py	Adds a topic-create sample.
generated_samples/​create_or_replace_room.py	Refreshes example provenance.
generated_samples/​create_or_replace_room_member.py	Refreshes example provenance.
generated_samples/​create_or_replace_role.py	Refreshes example provenance.
azure/​messaging/​webpubsubchatservice/​types.py	Adds the topic dictionary type.
azure/​messaging/​webpubsubchatservice/​models/​_models.py	Adds topic and user-room models.
azure/​messaging/​webpubsubchatservice/​models/​_enums.py	Adds topic lifecycle states.
azure/​messaging/​webpubsubchatservice/​models/​__init__.py	Exports the new models and enum.
azure/​messaging/​webpubsubchatservice/​_operations/​_operations.py	Adds generated synchronous operations.
azure/​messaging/​webpubsubchatservice/​aio/​_operations/​_operations.py	Adds generated asynchronous operations.
azure/​messaging/​webpubsubchatservice/​aio/​_configuration.py	Changes the async default API version.
azure/​messaging/​webpubsubchatservice/​aio/​_client.py	Updates async API-version documentation.
azure/​messaging/​webpubsubchatservice/​_validation.py	Adds API-version availability checks.
azure/​messaging/​webpubsubchatservice/​_configuration.py	Changes the sync default API version.
azure/​messaging/​webpubsubchatservice/​_client.py	Updates sync API-version documentation.
assets.json	Updates test recording assets.
apiview-properties.json	Maps the new public APIs.
api.metadata.yml	Refreshes API snapshot metadata.
api.md	Updates the public API snapshot.
_metadata.json	Records the new generated API version.

🧠 Review effort: Balanced

[Copilot]

🟡 Changes recommended

The default API version breaks inherited operations, and the user-room collection omits its declared typed paging controls.

6 open findings

• New default API version breaks existing operations
• Bump package version and update changelog for public API changes
• Paged operation lacks typed pagination parameters · New
• Topic constructor incorrectly requires state
• Paged collections lack public page size and continuation parameters
• Topic ID lifecycle documentation is contradictory

🧠 Review effort: Balanced

[Copilot]

🟡 Changes recommended

New samples fail automated execution without credentials, and the new default API version remains blocked by unresolved runtime routing.

10 open findings

• Exit successfully when live sample credentials are unavailable · New
• Avoid failing sample execution without endpoint configuration · New
• Preserve successful sample skip when connection string is absent · New
• Avoid failing samples check when credentials are unavailable · New
• New default API version breaks existing operations
• Bump package version and update changelog for public API changes
• Paged operation lacks typed pagination parameters
• Paged collections lack public page size and continuation parameters
• Describe topic lifecycle operations without overstating message support · New
• Topic ID lifecycle documentation is contradictory

1 resolved since last review

• Topic constructor incorrectly requires state

🧠 Review effort: Balanced

[Copilot]

🟡 Changes recommended

The new default API version still lacks verified routing for inherited operations, and its release notes omit that behavioral change.

1 open finding

• Document default service API-version change in release notes · New

10 resolved since last review

• Avoid failing samples check when credentials are unavailable
• Preserve successful sample skip when connection string is absent
• Avoid failing sample execution without endpoint configuration
• Exit successfully when live sample credentials are unavailable
• New default API version breaks existing operations
• Bump package version and update changelog for public API changes
• Paged operation lacks typed pagination parameters
• Paged collections lack public page size and continuation parameters
• Describe topic lifecycle operations without overstating message support
• Topic ID lifecycle documentation is contradictory

🧠 Review effort: Balanced

[Copilot]

🔵 Needs a closer look

The default API version remains region-dependent, and the PR also introduces repository policy outside the canonical guidance file.

0 open findings

1 resolved since last review

• Document default service API-version change in release notes

Previously missed (1)

In code that hasn't changed since last review

Avoid duplicating repository policy in the adapter

.github/​copilot-instructions.md:26

This introduces repository-wide policy in a file that AGENTS.md:3-5,21 defines as a thin adapter to the canonical guidance. Keeping policy here creates a second source of truth that can drift; move this rule to AGENTS.md or the appropriate linked skill and leave this adapter unchanged.

🧠 Review effort: Balanced

[Copilot]

🟡 Changes recommended

Package discovery can include previous build output, producing duplicate or stale SDK artifacts on subsequent builds.

1 open finding

• Restore build* exclusion to prevent stale package discovery · New

🧠 Review effort: Balanced

[Copilot]

🔵 Needs a closer look

The default API-version change affects all Chat operations, but routing succeeded only in Central US EUAP and failed in East US 2 EUAP, requiring human confirmation of regional rollout and release readiness.

No open issues 🎉

_{Review effort: Balanced}