YeonGyu-Kim
73453a7191
- Update root AGENTS.md: hook count 44→46, commit fcb90d92, generated 2026-02-24
- Update src/AGENTS.md: core hooks 35→37, session hooks 21→23
- Update src/hooks/AGENTS.md: 46 hooks total, add modelFallback/noSisyphusGpt/noHephaestusNonGpt/runtimeFallback, jsonErrorRecovery moved to tool-guard (tier 2)
- Create src/tools/hashline-edit/AGENTS.md (93 lines): documents three-op model, LINE#ID format, execution pipeline
- Refresh timestamps: 2026-02-21→2026-02-24 on 28 files
- Update plugin/AGENTS.md hook composition counts
🤖 Generated with assistance of [OhMyOpenCode](https://github.com/code-yeongyu/oh-my-opencode)
71 lines
3.1 KiB
Markdown
71 lines
3.1 KiB
Markdown
# src/tools/lsp/ — LSP Tool Implementations
|
|
|
|
**Generated:** 2026-02-24
|
|
|
|
## OVERVIEW
|
|
|
|
32 files. Full LSP (Language Server Protocol) client stack exposed as 6 tools. Custom implementation that manages server processes, opens files, and forwards requests — does NOT delegate to OpenCode's built-in LSP.
|
|
|
|
## TOOL EXPOSURE
|
|
|
|
| Tool | File | What It Does |
|
|
|------|------|--------------|
|
|
| `lsp_goto_definition` | `goto-definition-tool.ts` | Jump to symbol definition |
|
|
| `lsp_find_references` | `find-references-tool.ts` | All usages of a symbol |
|
|
| `lsp_symbols` | `symbols-tool.ts` | Document outline or workspace symbol search |
|
|
| `lsp_diagnostics` | `diagnostics-tool.ts` | Errors/warnings from language server |
|
|
| `lsp_prepare_rename` | `rename-tools.ts` | Validate rename before applying |
|
|
| `lsp_rename` | `rename-tools.ts` | Apply safe rename across workspace |
|
|
|
|
All 6 are direct `ToolDefinition` objects (not factory functions) — registered directly in `tool-registry.ts`.
|
|
|
|
## ARCHITECTURE
|
|
|
|
```
|
|
tools.ts (6 ToolDefinition exports)
|
|
↓ uses
|
|
LspClientWrapper (lsp-client-wrapper.ts)
|
|
↓ wraps
|
|
LSPClient (lsp-client.ts) extends LSPClientConnection (lsp-client-connection.ts)
|
|
↓ communicates via
|
|
LSPClientTransport (lsp-client-transport.ts)
|
|
↓ talks to
|
|
LSPProcess (lsp-process.ts) — spawns server binary
|
|
```
|
|
|
|
## KEY FILES
|
|
|
|
| File | Purpose |
|
|
|------|---------|
|
|
| `lsp-client-wrapper.ts` | High-level entry: resolves server, opens file, runs request |
|
|
| `lsp-client.ts` | `LSPClient` — file tracking, document sync (`didOpen`/`didChange`) |
|
|
| `lsp-client-connection.ts` | JSON-RPC request/response/notification layer |
|
|
| `lsp-client-transport.ts` | stdin/stdout byte-stream framing |
|
|
| `lsp-process.ts` | Spawn + cleanup of LSP server process |
|
|
| `lsp-manager-process-cleanup.ts` | Reap orphan LSP processes on exit |
|
|
| `lsp-manager-temp-directory-cleanup.ts` | Clean temp dirs used by some servers |
|
|
| `server-definitions.ts` | 40+ builtin servers synced from OpenCode's `server.ts` |
|
|
| `server-config-loader.ts` | Load custom server config from `.opencode/lsp.json` |
|
|
| `server-resolution.ts` | Resolve which server handles a file extension |
|
|
| `server-installation.ts` | Detect missing binaries, surface install hints |
|
|
| `language-mappings.ts` | Extension → language ID mapping |
|
|
| `lsp-formatters.ts` | Format LSP responses into human-readable strings |
|
|
| `workspace-edit.ts` | Apply `WorkspaceEdit` results to disk (for rename) |
|
|
| `types.ts` | `LSPServerConfig`, `Position`, `Range`, `Location`, `Diagnostic` etc. |
|
|
|
|
## SERVER RESOLUTION
|
|
|
|
```
|
|
file.ts → extension (.ts) → language-mappings → server ID (typescript)
|
|
→ server-resolution: check user config (.opencode/lsp.json) → fall back to server-definitions.ts
|
|
→ server-installation: verify binary exists (warn with install hint if not)
|
|
→ LSPProcess.spawn(command[])
|
|
```
|
|
|
|
## NOTES
|
|
|
|
- File must be opened via `didOpen` before any LSP request — `LSPClient.openFile()` handles this
|
|
- 1s delay after `didOpen` for server initialization before sending requests
|
|
- `lsp_servers` tool was removed — duplicates OpenCode's built-in `LspServers` tool
|
|
- Synced with OpenCode's `server.ts` — when adding servers, check upstream first
|