README.md 2.2 KB
description: "The lsp group map: language-server code navigation through the LSP seam, its stdio provider, and the model-facing lsp tool, for users and maintainers navigating the group."
kind: "package-group"
lsp/ — Language-server code navigation
English | 中文
Summary
The lsp group lets agents navigate code through configured language servers: go to definitions, find references and implementations, and read hover documentation. Use lsp-stdio to connect local stdio language-server commands and extension mappings, and tool-lsp to make those operations available to the model. The shared lsp package keeps provider choice and normalized results consistent, so changing servers does not change model requests. Deployments must supply and configure their language servers; this group ships none.
Table of Contents
Packages
| Package | Role | ctx key |
|---|---|---|
lsp/ |
Defines the code-navigation service: provider selection by file extension, four normalized read-only operations, and structured errors | ctx.lsp |
lsp-stdio/ |
Drives configured stdio language-server commands as providers over ctx.fs and ctx.subprocess |
registers on ctx.lsp |
tool-lsp/ |
Exposes precise code navigation to the model through the lsp tool |
registers on ctx.tools |
Providers register capabilities, not tools: tool-lsp is the only owner of the model-facing name, schema, prompt guidance, and presentation, so swapping a provider never changes how the model asks for navigation.
Related documentation
- LSP navigation subsystem — operations, coordinates, requests and results, and
LspErrorcodes. - Generated tool catalog — the
lspschema the model receives.