Add comprehensive documentation for Slack/Linear interrupt system

[codegen-sh]

This PR adds comprehensive documentation for Codegen's real-time interrupt system that allows users to send follow-up messages while the agent is actively working.

What's Added

New Documentation Page: /docs/capabilities/interrupts.mdx

Key sections covered:

• Overview: How interrupts enable real-time, conversational interactions
• Technical Implementation: Detailed explanation of the interrupt flow using BaseRunner, TaskTimeline, and LangGraph
• Supported Channels: Specific guidance for Slack and Linear interrupts
• Message Format: Technical details of interrupt message structure
• Best Practices: User guidance and common use cases
• Examples: Real-world Slack and Linear interrupt scenarios
• Troubleshooting: Common issues and solutions

Updated Navigation

• Added capabilities/interrupts to the docs.json navigation structure

Technical Background

Based on analysis of the cloud repo implementation:

1. BaseRunner (app/agent_runners/base_runner.py): Handles interrupt detection and routing
2. TaskTimeline (app/agents/agent_run/task_timeline.py): Stores interrupt messages in the interrupt_messages queue
3. LangGraph (app/agents/langgraph_utils/graph.py): Processes interrupts as [INTERRUPT] prefixed messages
4. Memory Store (app/agents/langgraph_utils/memory_store.py): Manages interrupt message processing and indexing

User Impact

This documentation will help users understand:

• How to effectively use interrupts to provide real-time feedback
• Why their follow-up messages are immediately acknowledged
• Best practices for interrupt timing and content
• Troubleshooting when interrupts don't work as expected

The documentation is positioned in the "Capabilities" section alongside existing wake-up and general capabilities docs.

---

💻 View my work • 👤 Initiated by Jay Hack • 💬 Initiated in #ext-notion-codegen • About Codegen

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

✅ All tests successful. No failed tests found.

[jayhack]

Let's remove the technical implementation since htese are user-facing docs!

[codegen-sh]

Got it! I'll remove the technical implementation section since these are user-facing docs and update the Linear section with the mention requirements. Making those changes now! 📝

💻 View my work

[codegen-sh]

✅ Updated the documentation with your feedback!

Changes made:

• Added clear warning that @codegen mentions are required in Slack channels (but not in DMs)
• Added note that Linear responds automatically unless other users are tagged
• Removed technical implementation section to keep it user-focused
• Updated best practices and troubleshooting to emphasize mention requirements

The docs now clearly explain when mentions are needed vs. when Codegen responds automatically. Much more user-friendly! 🎯

💻 View my work