packages/lsp/README.md

# lsp/ - LSP capability family

English | [中文](README.zh.md)

The language-server capability seam: an abstract LSP interface, a generic stdio provider, and the model-facing `lsp` tool. All **product** packages.

| Package | Role | ctx key |
|---|---|---|
| `lsp/` | Abstract LSP seam (provider registry by branded id + extension mapping, per-query selection, vocabulary, `LspError`) | `ctx.lsp` |
| `lsp-local/` | Generic multi-server stdio backend over `ctx.fs` and `ctx.subprocess` (JSON-RPC, transient-open queries) | (registers providers on `ctx.lsp`) |
| `tool-lsp/` | Model-facing `lsp` tool (four operations, one-based UTF-16 cursor coordinates) | (registers on `ctx.tools`) |

The interface lives at `lsp/lsp/`. The seam exposes exactly four semantic operations — `goToDefinition`, `findReferences`, `goToImplementation`, `hover` — and no generic JSON-RPC escape hatch, so a provider swap does not change how the model asks for navigation and no protocol payload or unreviewed mutation reaches the model contract. Providers register **capabilities**, not tools; `tool-lsp` is the only owner of the model-facing name, schema, prompt guidance, and presentation.

See the [LSP capability seam Agent Note](../../.agents/notes/implemented/architecture/2026-07-15-lsp-capability-seam.md) for the design rationale, including why documents open transiently per query, why the stdio host consumes the shared filesystem/subprocess execution world, and why extension ownership is exclusive within one runtime.

The subsystem reference — operations, coordinates, requests/results, `LspError` — is [docs/subsystems/lsp.md](../../docs/subsystems/lsp.md); design rationale in the [LSP capability seam Agent Note](../../.agents/notes/implemented/architecture/2026-07-15-lsp-capability-seam.md).
feat(lsp): LSP capability seam, generic stdio provider, and lsp tool 2026-07-16 12:05:35 +08:00			`# lsp/ - LSP capability family`

docs: translate remaining READMEs 2026-07-26 05:03:53 +08:00			`English \| [中文](README.zh.md)`

feat(lsp): LSP capability seam, generic stdio provider, and lsp tool 2026-07-16 12:05:35 +08:00			The language-server capability seam: an abstract LSP interface, a generic stdio provider, and the model-facing `lsp` tool. All product packages.

			`\| Package \| Role \| ctx key \|`
			`\|---\|---\|---\|`
refactor(runtime): compose consumers over fs and subprocess 2026-07-28 23:00:00 +08:00			\| `lsp/` \| Abstract LSP seam (provider registry by branded id + extension mapping, per-query selection, vocabulary, `LspError`) \| `ctx.lsp` \|
fix(rebase): migrate the replayed E2B branch onto the rebased parent 2026-08-07 21:04:33 +08:00			\| `lsp-local/` \| Generic multi-server stdio backend over `ctx.fs` and `ctx.subprocess` (JSON-RPC, transient-open queries) \| (registers providers on `ctx.lsp`) \|
refactor(runtime): compose consumers over fs and subprocess 2026-07-28 23:00:00 +08:00			\| `tool-lsp/` \| Model-facing `lsp` tool (four operations, one-based UTF-16 cursor coordinates) \| (registers on `ctx.tools`) \|
feat(lsp): LSP capability seam, generic stdio provider, and lsp tool 2026-07-16 12:05:35 +08:00
refactor(runtime): compose consumers over fs and subprocess 2026-07-28 23:00:00 +08:00			The interface lives at `lsp/lsp/`. The seam exposes exactly four semantic operations — `goToDefinition`, `findReferences`, `goToImplementation`, `hover` — and no generic JSON-RPC escape hatch, so a provider swap does not change how the model asks for navigation and no protocol payload or unreviewed mutation reaches the model contract. Providers register capabilities, not tools; `tool-lsp` is the only owner of the model-facing name, schema, prompt guidance, and presentation.

fix(rebase): migrate the replayed E2B branch onto the rebased parent 2026-08-07 21:04:33 +08:00			`See the [LSP capability seam Agent Note](../../.agents/notes/implemented/architecture/2026-07-15-lsp-capability-seam.md) for the design rationale, including why documents open transiently per query, why the stdio host consumes the shared filesystem/subprocess execution world, and why extension ownership is exclusive within one runtime.`
docs: anchor each subsystem page to its package group; make group READMEs thin tables 2026-08-02 05:54:15 +08:00
			The subsystem reference — operations, coordinates, requests/results, `LspError` — is [docs/subsystems/lsp.md](../../docs/subsystems/lsp.md); design rationale in the [LSP capability seam Agent Note](../../.agents/notes/implemented/architecture/2026-07-15-lsp-capability-seam.md).