Searchat — Multi-Agent Connector Architecture

Layer 1: AgentConnector Protocol & Registry

AgentConnector Protocol

Defines interface for all connectors:

name: str
supported_extensions: tuple[str, ...]
discover_files(config) → list[Path]
can_parse(path: Path) → bool
parse(path, embedding_id) → ConversationRecord

PROTOCOL

Registry Pattern

Connector management & auto-discovery:

register_connector(connector)
get_connectors() → list[AgentConnector]
detect_connector(path) → AgentConnector | None
discover_entrypoint_connectors()

AUTO-DISCOVERY

Protocol → Connectors

Layer 2: Agent Connector Implementations (8 Total)

Claude

.jsonl

~/.claude/projects/
%APPDATA%/Claude/projects/

Vibe

.json

~/.vibe/sessions/
%APPDATA%/Vibe/sessions/

OpenCode

.json

~/.opencode/history/
%APPDATA%/OpenCode/

Cursor

.db (SQLite)

~/.cursor/history.db
%APPDATA%/Cursor/

Continue

.json

~/.continue/sessions/
%APPDATA%/Continue/

Aider

.md

.aider.chat.history.md
Project root directory

Codex

.json

~/.codex/logs/
%APPDATA%/Codex/

Gemini CLI

.json

~/.gemini-cli/history/
%APPDATA%/GeminiCLI/

Connectors → Filesystem

Layer 3: File System & Path Resolution

Platform Detection

WSL Detection: /proc/version contains "microsoft"
/mnt/c/Users/ → C:\Users\ Platform-specific paths: • Windows: %APPDATA%, %USERPROFILE%
• Linux/macOS: ~/.config, ~/.local
• WSL: Hybrid with /mnt/ translation

Format Detection

Extension-based routing: • .jsonl → Claude (iterate lines)
• .json → Vibe/OpenCode/Continue/Codex/Gemini
• .db → Cursor (SQLite queries)
• .md → Aider (markdown structure) Validation: File signature + structure checks

Connectors

File Formats

Platforms

Auto

Discovery

Color Key

Protocol/Registry

Claude (.jsonl)

Vibe (.json)

OpenCode (.json)

Cursor (.db)

Continue (.json)

Aider (.md)

Codex (.json)

Source Files:
• src/searchat/core/connectors/protocols.py (AgentConnector protocol, 45 LOC)
• src/searchat/core/connectors/registry.py (Registry pattern, 120 LOC)
• src/searchat/core/connectors/__init__.py (8 connector registrations, 35 LOC)
• src/searchat/core/connectors/claude.py (ClaudeConnector implementation, 150 LOC)
• 7 additional connector implementations (Vibe, OpenCode, Cursor, Continue, Aider, Codex, Gemini)

Extensibility: Add new connectors by implementing AgentConnector protocol + calling register_connector()
Auto-discovery: Connectors loaded via entry points in setup.py/pyproject.toml