Persist streaming state when chat sidebar closes

[ki-cooley]

Summary

• StreamStateManager: New plugin-level class that takes ownership of active streams when the sidebar closes mid-stream, accumulates response messages, and hands them back when the sidebar reopens — enabling seamless stream continuation
• Serialization fix: activities and contentBlocks are now included when saving assistant messages, so tool activity accordions and structured content blocks persist across sessions
• Debounce flush: Calls .flush() on the debounced save before React unmounts, preventing the last ~300ms-1s of data from being lost
• Auto-scroll on mount: Chat view scrolls to bottom when opening a conversation that already has messages

Test plan

• TypeScript type check passes (npx tsc --noEmit)
• Production build passes (npm run build)
• E2E: Send multi-tool prompt, close sidebar, reopen — activities and contentBlocks visible
• E2E: Close sidebar mid-stream, wait for completion, reopen — full response preserved (4,579 chars, 30 activities)
• E2E: Close sidebar mid-stream, reopen before completion — stream resumes live with Stop Generation button
• E2E: Close sidebar immediately after first response chunk — message saved (debounce flushed)

🤖 Generated with Claude Code

Summary by CodeRabbit

• New Features

  • Live activity tracking showing tool usage, file operations, and search results
  • Edit history with revert functionality for recent changes
  • Slash commands with skills integration for custom workflows
  • Backend agent support with streaming responses
  • Persistent memory system for context preservation

• Improvements

  • Better mobile experience with keyboard handling
  • Code block expansion/collapse for lengthy content
  • Interspersed content layout for cleaner message display
  • Enhanced activity visualization with real-time status

• Rebranding

  • Plugin rebranded from "Smart Composer" to "Claudsidian"

[coderabbitai]

Caution

Review failed

The pull request is closed.

📝 Walkthrough

Walkthrough

This pull request introduces a complete backend WebSocket service for the Claudsidian Obsidian plugin, enabling local Claude agent execution with vault file operations. It rebrands the plugin from "Smart Composer" to "Claudsidian," adds a Node.js backend with Docker/Railway deployment configs, implements activity tracking UI, and extends the type system to support streaming activities and interspersed content blocks.

Changes

Cohort / File(s)	Summary
Rebranding manifest.json, src/components/modals/*, src/components/settings/SettingsTabRoot.tsx, src/ChatView.tsx, CLAUDE.md	Updated all references from "Smart Composer" to "Claudsidian" including manifest id/name, UI text, GitHub links, and settings labels.
Backend Infrastructure (Node.js) backend/src/agent.ts, backend/src/server.ts, backend/src/protocol.ts, backend/src/index.ts, backend/src/mock-agent.ts, backend/src/vault-tools.ts, backend/src/utils.ts	New WebSocket server, Claude agent orchestration, RPC protocol for vault operations, mock agent for testing, and utility helpers (logging, retry, JSON parsing).
Backend Configuration & Deployment backend/Dockerfile, backend/railway.json, railway.toml, backend/.env.example, backend/.gitignore, backend/tsconfig.json, backend/package.json, backend/README.md	Docker containerization, Railway deployment configs with healthchecks, environment variable templates, build configuration, and documentation for backend setup and WebSocket protocol.
Backend Testing backend/test/automated-test.ts, backend/test/test-client.ts	Automated E2E test suite and interactive REPL test client for validating WebSocket communication, RPC handling, and vault operations.
Plugin Backend Integration src/core/backend/BackendProvider.ts, src/core/backend/WebSocketClient.ts, src/core/backend/VaultRpcHandler.ts, src/core/backend/ConflictManager.ts, src/core/backend/EditHistory.ts, src/core/backend/StreamStateManager.ts, src/core/backend/protocol.ts, src/core/backend/instance.ts, src/core/backend/tool-result-formatter.ts	Frontend WebSocket client, RPC handler for vault operations, conflict/edit history management, stream state persistence, protocol definitions, and tool result parsing and formatting.
Activity & Streaming UI src/components/chat-view/ActivityAccordion.tsx, src/components/chat-view/ActivityItem.tsx, src/components/chat-view/EditDiffBlock.tsx, src/components/chat-view/InterspersedContent.tsx, src/components/chat-view/ToolMessage.tsx	New Cursor-style activity display system with live streaming indicators, diff/edit visualization, collapsible activity groups, and interspersed content block rendering. Filters backend tool calls from UI.
Chat & Input Components src/components/chat-view/Chat.tsx, src/components/chat-view/AssistantToolMessageGroupItem.tsx, src/components/chat-view/MarkdownCodeComponent.tsx, src/components/chat-view/chat-input/ChatUserInput.tsx, src/components/chat-view/chat-input/LexicalContentEditable.tsx, src/components/chat-view/useAutoScroll.ts, src/components/chat-view/useChatStreamManager.ts	Extended Chat with stream state management and flushSave lifecycle; added activity/contentBlock support to assistant messages; added code folding to markdown blocks; improved mobile keyboard handling; refined auto-scroll logic to track user interactions; added stream detachment capability.
Template/Skill System src/components/chat-view/chat-input/plugins/template/TemplatePlugin.tsx, src/hooks/useSkills.ts	Unified slash-command menu combining templates, skills, and commands; new hook to load and search skills/commands from .claude directories with frontmatter parsing.
Settings & Provider Management src/components/settings/modals/AddChatModelModal.tsx, src/components/settings/modals/AddEmbeddingModelModal.tsx, src/components/settings/modals/ProviderFormModal.tsx, src/components/settings/sections/ProvidersSection.tsx, src/components/settings/sections/ChatSection.tsx, src/constants.ts, src/types/provider.types.ts	Added backend provider type with URL/auth token fields; updated provider filtering for model selection; separated edit/delete actions in provider list; added external resource directory setting; set backend-agent as default model; updated recommended model lists.
Type System Extensions src/types/chat.ts, src/types/chat-model.types.ts, src/types/llm/response.ts, src/hooks/useChatHistory.ts	Added ActivityEvent, ActivityType, ContentBlock types for streaming activities and interspersed layouts; extended assistant messages with contentBlocks and activities fields; updated chat history serialization; extended LLM response delta with activity/contentBlock fields.
Prompt & Response Generation src/utils/chat/promptGenerator.ts, src/utils/chat/responseGenerator.ts	Added backend-specific prompt path (no RAG/file reading), persistent memory support (.claude/memory.md), text file classification; extended response merging to handle activities and content blocks with deduplication and coalescing.
Core Integration src/core/llm/manager.ts, src/core/mcp/mcpManager.ts, src/main.ts	Wired BackendProvider into LLM manager; made MCP resilient to mobile environment failures; integrated VaultRpcHandler, ConflictManager, EditHistory, and StreamStateManager into plugin lifecycle; added RPC webhook, memory file initialization, and backend connection logic.
Settings Migrations src/settings/schema/migrations/12_to_13.ts, src/settings/schema/migrations/index.ts, src/settings/schema/setting.types.ts, src/settings/schema/settings.ts	Added v12→v13 migration for externalResourceDir field; updated schema and settings parsing.
Documentation & Configuration docs/interspersed-layout-spec.md, .claude/settings.json, styles.css, package.json	Added interspersed layout design spec; added Claude settings with bash permissions; expanded styles for activity accordion, edit diffs, slash commands, and code folding; minor package.json formatting.

Sequence Diagram(s)

sequenceDiagram
    actor User
    participant Plugin as Obsidian Plugin
    participant WS as WebSocket Client
    participant Backend as Backend Server
    participant Agent as Claude Agent
    participant Vault as Vault Bridge
    
    User->>Plugin: Send prompt + context
    Plugin->>WS: sendPrompt(prompt, handlers)
    WS->>Backend: PromptMessage (via WebSocket)
    
    Backend->>Agent: runAgent(prompt, context)
    
    loop Agent Processing
        Agent->>Agent: Load skills, system prompt
        Agent->>Agent: Call Claude with streaming
        
        alt Tool Invoked
            Agent->>Backend: Emit tool_start event
            Backend->>WS: ToolStartMessage
            WS->>Plugin: onToolStart handler
            
            Backend->>Vault: RPC vault_read/write/etc
            Vault->>Backend: RPC response
            
            Agent->>Backend: Emit tool_end event
            Backend->>WS: ToolEndMessage
            WS->>Plugin: onToolEnd handler
        else Text Generated
            Agent->>Backend: Emit text_delta event
            Backend->>WS: TextDeltaMessage
            WS->>Plugin: onTextDelta handler
        end
    end
    
    Agent->>Backend: Emit complete event
    Backend->>WS: CompleteMessage
    WS->>Plugin: onComplete handler
    Plugin->>User: Display response + activities

Loading

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~75 minutes

Possibly related PRs

• Add plan-based Claude/OpenAI connections with OAuth #509: Modifies LLM provider/manager infrastructure and adds new provider variants alongside this PR's backend provider integration.
• Claude 3.7 Sonnet Thinking Integration #320: Updates chat/LLM response type surface (adding reasoning fields) while this PR adds activity/contentBlock fields—may have type-level interactions.
• feat: Implement MCP (Model Context Protocol) integration #372: Implements MCP/tooling integration and related protocol/tool handling that overlaps with this PR's vault-tools and protocol definitions.

Poem

🐰 A rabbit hops through server gates,
WebSockets open, agents activate,
Vault tools dance, diffs unfold—
Claude's wisdom, now to behold!
From Smart Composer's chrysalis, Claudsidian takes flight.

✨ Finishing touches

• 📝 Generate docstrings

🧪 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.}