mosaicstack/stack

Fork 0

Files

Jason Woltje fcb792a65d

ci/woodpecker/push/ci Pipeline failed

Details

ci/woodpecker/pr/ci Pipeline failed

Details

feat: add web search, file edit, MCP management, file refs, and /stop to CLI/TUI

1. Web search tools (multi-provider): web_search, web_search_news, web_search_providers
   - Brave, Tavily, SearXNG (env-var activated), DuckDuckGo (always available)
   - Auto mode tries providers in priority order

2. File edit tool (fs_edit_file): targeted text replacement with validation
   - Unique oldText matching, overlap detection, atomic application
   - Sandboxed with size limits

3. MCP management commands: /mcp status, /mcp servers, /mcp reconnect <name>
   - Shows connection status, tool counts, errors for all MCP servers
   - Reconnect disconnected servers from the TUI

4. File reference in chat: @path/to/file inline expansion + /attach command
   - Auto-detects @file patterns and inlines contents as fenced code blocks
   - 256KB per file limit, max 10 files per message
   - Language-aware syntax highlighting hints

5. /stop command: abort streaming via Pi SDK abort()
   - New AbortPayload type in @mosaic/types
   - Gateway abort handler calls piSession.abort()
   - TUI emits abort event on /stop

2026-04-02 13:06:44 -05:00

2.4 KiB

Raw Blame History

CLI/TUI Tools Enhancement Scratchpad

Objective

Add 5 capability areas to the Mosaic CLI/TUI + gateway agent:

Web search tools (multi-provider: Brave, DuckDuckGo, Tavily, SearXNG)
File edit tool (fs_edit_file with targeted text replacement)
MCP management TUI commands (/mcp status, /mcp reconnect, /mcp servers)
File reference in chat (@file syntax + /attach command)
Implement /stop to cancel streaming

Plan

1. Web Search Tools (gateway agent tools)

Create apps/gateway/src/agent/tools/search-tools.ts
Providers: Brave Search API, DuckDuckGo (HTML scraping), Tavily API, SearXNG (self-hosted)
Each provider activated by env var (BRAVE_API_KEY, TAVILY_API_KEY, SEARXNG_URL)
Tools: web_search (unified), web_search_news (news-specific)
Export from apps/gateway/src/agent/tools/index.ts
Wire into agent.service.ts buildToolsForSandbox

2. File Edit Tool (gateway agent tool)

Add fs_edit_file to apps/gateway/src/agent/tools/file-tools.ts
Parameters: path, edits[{oldText, newText}] — same semantics as pi's Edit tool
Validates uniqueness of each oldText, applies all edits atomically

3. MCP Management Commands (TUI + gateway)

Add gateway endpoints: GET /api/mcp/status, POST /api/mcp/:name/reconnect
Add TUI gateway-api.ts functions for MCP
Add gateway slash commands: /mcp (with subcommands status, reconnect, servers)
Register in command manifest from gateway
Handle in TUI via gateway command forwarding (already works)

4. File Reference in Chat (@file syntax)

TUI-side: detect @path/to/file in input, read file contents, inline into message
Add /attach <path> local command as alternative
gateway-api.ts helper not needed — this is purely client-side pre-processing
Modify InputBar or sendMessage to expand @file references before sending

5. Implement /stop

Add abort event to ClientToServerEvents in @mosaic/types
TUI sends abort event on /stop command
Gateway chat handler aborts the Pi session prompt
Update use-socket to support abort
Wire /stop in app.tsx

Progress

1. Web search tools
2. File edit tool
3. MCP management commands
4. File reference in chat
5. Implement /stop

Risks

DuckDuckGo has no official API — need HTML scraping or use lite endpoint
SearXNG needs self-hosted instance
@file expansion could be large — need size limits
/stop requires Pi SDK abort support — need to check API

2.4 KiB Raw Blame History