FE-1664: Refine host-owned Voice sessions in Petrinaut

[kostandinang]

Note

Platform extraction: This PR isolates provider-independent, host-owned Voice presentation so it can be reviewed and shipped independently. It introduces no GPT-Live, transcription, Flue, or Brunch behavior and depends on #9671.

🌟 What is the purpose of this PR?

Extract the reusable Petrinaut Voice presentation from the GPT-Live experiment so the Petrinaut platform behavior can be reviewed and shipped independently of OpenAI, Flue, and Brunch integration code.

Hosts continue to own session and recovery behavior. Petrinaut only presents the reported Voice state and available actions.

🔗 Related links

• FE-1664 (internal)
• Parent Voice APIs: #9671
• Live experiment consumer: #9673

🚫 Blocked by

• Merge dependency: FE-1663: Experiment Live Full-Duplex Migration #9671.

🔍 What does this change?

• Lets host-owned Voice sessions show a neutral Connected state and omit controls the host does not support.
• Keeps compact Voice setup above a stationary dock without moving viewport controls or showing a premature Connecting state.
• Keeps Voice failures and explicit recovery warnings in one deduplicated, copyable, dismissible Voice issues popover attached to the dock, while temporary session notices remain in the dock status.
• Leaves ordinary AI assistant, stream, Stop, handoff, and interactive-tool failures on the existing global notification path.
• Adds focused stories, regression coverage, user documentation, and the @hashintel/petrinaut patch changeset.

Pre-Merge Checklist 🚀

🚢 Has this modified a publishable library?

This PR:

• modifies an npm-publishable library and I have added a changeset file(s)

@hashintel/petrinaut patch: .changeset/tidy-voice-dock.md.

📜 Does this require a change to the docs?

The changes in this PR:

• require changes to docs which are made as part of this PR

🕸️ Does this require a change to the Turbo Graph?

The changes in this PR:

• do not affect the execution graph

⚠️ Known issues

This PR does not alter capture, transcription, transport, admission, or provider recovery behavior. Those remain host responsibilities.

🐾 Next steps

#9673 is already restacked on this PR and can be reviewed as the downstream experimental consumer. The stack now targets main; merge in order #9671 → #9719 → #9673 → #9704.

🛡 What tests cover this?

• Full @hashintel/petrinaut unit suite: 1,129 passed.
• @hashintel/petrinaut build, typecheck, and ESLint: passed.
• Repository formatting and Markdown lint: passed.

❓ How to test this?

1. Run yarn workspace @hashintel/petrinaut dev.
2. Open the AI assistant content stories for compact setup, connected sessions, collapsed sessions, and multiple Voice issues.
3. Confirm the setup card does not move the dock, unsupported actions are absent, and Voice issue details remain available in expanded and collapsed layouts.
4. Trigger an ordinary assistant failure and confirm it remains a global notification rather than joining the Voice issues popover.

📹 Demo

No separate recording is included; the Storybook cases provide the review fixtures.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
hash	Ready	Preview	Sep 15, 2026 3:15pm UTC
petrinaut	Ready	Preview	Sep 15, 2026 3:15pm UTC
petrinaut-docs	Ready	Preview	Sep 15, 2026 3:15pm UTC

1 Skipped Deployment

Project	Deployment	Actions	Updated
hashdotdesign-tokens	Ignored	Preview	Sep 15, 2026 3:15pm UTC

[cursor]

PR Summary

Low Risk
UI-only changes to Voice presentation and error routing in the AI assistant panel; no changes to capture, transport, or host session logic.

Overview
Voice issues no longer surface as global toasts. Host-reported errorMessage and the new optional warningMessage are deduplicated into local state and shown via a dock warning control with tooltip preview, scrollable popover, copy, and Dismiss Voice issues. Ordinary AI assistant/stream errors still use the shared notification path.

Compact Voice setup keeps consent/permission in an overlay card above a fixed Voice setup dock (no premature Connecting, no layout shift for viewport controls). The issues icon stays anchored in the dock when collapsing or expanding a live session; dock layout reserves space so status text does not overlap the indicator.

Session notice remains a temporary dock status line only. Clearing chat also clears accumulated Voice issues.

^{Reviewed by Cursor Bugbot for commit aa77ecb. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cursor]

Stale Bugbot comment from a previous run.

[cursor]

Stale Bugbot comment from a previous run.

[lunelson]

Code review finding: MultipleVoiceIssues and CollapsedVoiceIssues put the second issue in notice, but the implementation collects durable issues only from errorMessage and warningMessage. As written, those fixtures contain one Voice issue, so the play assertion looking for Show 2 Voice issues cannot pass. Please change the second fixture value to warningMessage in both stories (or change the production classification if notice was intended to be durable).

[kostandinang]

@lunelson Addressed in 67e084f. Both MultipleVoiceIssues and CollapsedVoiceIssues now put the second durable issue in warningMessage, so the fixtures match the production classification and the Show 2 Voice issues assertion.

[lunelson]

Re-reviewed the current remote head after the restack. The durable Voice issue stories now use warningMessage, matching production classification, and I found no remaining child-specific code issue. The parent Live autoplay concern remains owned by #9671.

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit aa77ecb. Configure here.}

[cursor]

Dismiss drops keyboard focus

Low Severity

Dismiss Voice issues clears voiceAlerts and unmounts VoiceAlerts while focus is still in the portalled popover. That skips the popover onClose path and returnFocusRef, so the trigger is gone before focus can return to the dock.

Additional Locations (1)

• libs/@hashintel/petrinaut/src/ui/views/Editor/panels/ai-assistant-panel/ai-assistant-contents.tsx#L709-L710

 

^{Reviewed by Cursor Bugbot for commit aa77ecb. Configure here.}