Intent

Ship Slice 1 only: a low-risk toggle to control whether Talk Mode includes the ElevenLabs voice directive hint in the prompt.

Changes

• add includeVoiceDirectiveHint parameter to TalkPromptBuilder.build(...) (default: true)
• wire iOS Talk prompt builder call to read talk.voiceDirectiveHint.enabled
• preserve existing behavior by defaulting missing preference to true
• add Settings > Device > Features toggle: Voice Directive Hint
• add unit tests for default-on and disabled behavior

Scope Guardrails

• no background-audio lifecycle changes
• no Talk/TTS pipeline refactor
• no chat.push behavior changes

Validation

• swift test --package-path apps/shared/OpenClawKit

Greptile Summary

Added an iOS-only feature toggle (talk.voiceDirectiveHint.enabled) to control whether the ElevenLabs voice directive hint is included in Talk Mode prompts. The implementation adds a new parameter to TalkPromptBuilder.build(...) with a safe default (true) that preserves existing behavior, wires it to iOS Settings UI, and includes comprehensive unit tests.

Key changes:

• Added includeVoiceDirectiveHint parameter to TalkPromptBuilder.build(...) (defaults to true)
• iOS TalkModeManager reads talk.voiceDirectiveHint.enabled preference (defaults to true if missing)
• New Settings toggle: "Voice Directive Hint" under Device > Features
• Unit tests verify both default-on and disabled behavior

Observations:

• macOS TalkModeRuntime.swift:397 still calls TalkPromptBuilder.build(...) without the new parameter (relies on default). Consider whether macOS should also have this preference or if iOS-only is intentional per the PR scope.

Confidence Score: 5/5

• This PR is safe to merge with minimal risk
• The changes are well-isolated, preserve backward compatibility via safe defaults, include comprehensive unit tests, and follow established patterns. The implementation correctly handles the missing preference case by defaulting to true, ensuring existing behavior is maintained. No logical errors, security issues, or breaking changes detected.
• No files require special attention

_{Last reviewed commit: 93bf0cf}

Attribution

• extracted from the voice prompt intent in feat(ios): background voice mode with improved TTS handling #17319
• Thanks @zeulewan