feat(chat): semantic tool narration in blockquotes

[yanekyuk]

New Features

• LLM now groups related tools under one semantic blockquote instead of narrating each tool separately
• Context-specific labels encouraged ("Looking up Seren" instead of "Reading profiles")
• Prerequisite operations (membership checks, permissions) are hidden from user view

Documentation

• Added implementation plan for semantic tool narration

---

Status: Draft - not tested yet. Manual testing required via chat interface.

Test scenarios:

1. "Can you connect me with [name]?" - Should show one blockquote
2. "Introduce Alice and Bob" - Should show semantic steps, not individual tool narrations

Summary by CodeRabbit

• Documentation

  • Added planning documentation for reasoning UI enhancements focusing on tool presentation improvements.

• Chores

  • Enhanced system prompt with expanded onboarding flows, improved tool narration guidance, updated constraints, and refined formatting rules. These changes provide better context and decision-making instructions for the assistant system.

[coderabbitai]

Caution

Review failed

The pull request is closed.

📝 Walkthrough

Walkthrough

A planning document was introduced outlining semantic tool narration improvements for the reasoning UI, emphasizing grouped blockquotes and context-specific language. The chat system prompt was expanded with enhanced onboarding flows, narrative examples, updated tool-narration guidance, and revised formatting rules.

Changes

Cohort / File(s)	Summary
Planning Documentation .cursor/plans/reasoning_ui_blockquotes_95441394.plan.md	New planning document detailing prompt-only enhancements for reasoning UI, including semantic tool narration improvements, blockquote grouping strategies, and testing scenarios.
System Prompt Enhancement protocol/src/lib/protocol/agents/chat.prompt.ts	Refactored buildSystemContent function to construct system prompt in a local const variable. Expanded prompt content with new onboarding flows, narrative examples, updated narration style guidance, tool-narration instructions, and revised constraints and formatting rules.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

• feat(chat): style agent prompts with intro, voice constraints, and placeholder #417: Modifies the same system prompt construction in protocol/src/lib/protocol/agents/chat.prompt.ts, expanding and restyling assistant prompt text.

Poem

🐰 A prompt so grand, now neatly laid,
Tools grouped in blockquotes, wisdom made,
Reasoning flows with stories bright,
The rabbit hops—the UI's right! 📦✨

✨ Finishing Touches

• 📝 Generate docstrings (stacked PR)
• 📝 Generate docstrings (commit on current branch)

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}