@deepseek-ai/dsh-tool-lsp 0.1.2-rc.1 → 0.1.5-alpha.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.i18n.yaml +2 -2
  2. package/README.md +3 -4
  3. package/README.zh.md +3 -4
  4. package/package.json +19 -19
package/README.i18n.yaml CHANGED
@@ -2,5 +2,5 @@
2
2
  # side as of the last confirmed-consistent state. Both languages carry equal authority;
3
3
  # after editing either side, bring the other along and re-record with:
4
4
  # pnpm run verify-translation-pairing --write packages/lsp/tool-lsp/README.md
5
- README.md: 437cd4a35ca58a43bcc0af7c0f81d7fcddb4812f
6
- README.zh.md: f67f1cdff8a55857dc63e994958191953d7d0158
5
+ README.md: 2a5483aabe75bbbf9ff39fa8263d97a1488d70b4
6
+ README.zh.md: d6f69953d3eb737f3c28283a9fb6b56ae312b7ea
package/README.md CHANGED
@@ -9,7 +9,7 @@ English | [中文](README.zh.md)
9
9
 
10
10
  ## Summary
11
11
 
12
- `dsh-tool-lsp` gives the model a single read-only `lsp` tool for precise code navigation over the LSP seam: go to a symbol's definition, find its references, jump to its implementations, or read hover documentation. The tool owns everything the model sees — name, schema, prompt guidance, result formatting, and UI presentation — and never depends on which language server backs a query. Positions are one-based UTF-16 cursor coordinates, which the tool converts to the seam's zero-based convention. Results are bounded location lists or normalized hover text with explicit no-result and truncation markers. Compose it with a provider such as `dsh-lsp-stdio` and the `dsh-lsp` seam to activate navigation.
12
+ `dsh-tool-lsp` lets a model navigate code through one read-only `lsp` tool: open a symbol's definition, find references and implementations, or read hover documentation. Requests use one-based UTF-16 line and character positions. Navigation results are bounded, grouped by file, and labeled when locations are omitted or text is truncated; hover results are normalized and distinguish missing information from errors. The package requires a configured LSP provider and a session workspace root. Choose it when textual search is ambiguous or a change needs precise symbol relationships; ordinary navigation should continue to use `search` and `read`.
13
13
 
14
14
  ## Table of Contents
15
15
 
@@ -84,10 +84,9 @@ This section explains the design decisions behind the tool and where the code re
84
84
  <a id="further-exploration"></a>
85
85
  ## Further Exploration
86
86
 
87
- Read these pages when the package-level contract is not enough. They move from the model-facing surface to the seam, the provider, and the decision evidence.
87
+ Read these pages when the package-level contract is not enough. They move from the model-facing surface to the seam and the provider.
88
88
 
89
89
  - [LSP navigation subsystem](../../../docs/subsystems/lsp.md) — operations, coordinates, requests and results, and `LspError` codes.
90
- - [LSP capability seam Agent Note](../../../.agents/notes/implemented/architecture/2026-07-15-lsp-capability-seam.md) — design rationale, alternatives, and deliberately deferred API.
91
90
  - [dsh-lsp](../lsp/README.md) — the seam this tool queries.
92
91
  - [dsh-lsp-stdio](../lsp-stdio/README.md) — the stdio provider that answers these queries.
93
92
  - [lsp group map](../README.md) — the three-package family and its related documentation.
@@ -166,7 +165,7 @@ None; UI presentation is outside the model request.
166
165
 
167
166
  These limits define when the tool is a poor fit. They are current package constraints, not a task backlog.
168
167
 
169
- - **UTF-16 cursor coordinates** — columns are exact for the protocol but hard for a model to count around non-BMP characters; an off-symbol position may return empty results, so the prompt explains the convention without encouraging broad LSP use ([seam Agent Note](../../../.agents/notes/implemented/architecture/2026-07-15-lsp-capability-seam.md)).
168
+ - **UTF-16 cursor coordinates** — columns are exact for the protocol but hard for a model to count around non-BMP characters; an off-symbol position may return empty results, so the prompt explains the convention without encouraging broad LSP use.
170
169
  - **No cross-server completeness promise** — supported servers may return empty or partial results depending on indexing readiness; the tool promises no completeness across languages or servers.
171
170
 
172
171
  <a id="dev-note"></a>
package/README.zh.md CHANGED
@@ -9,7 +9,7 @@ kind: "package-reference"
9
9
 
10
10
  ## 概述
11
11
 
12
- `dsh-tool-lsp` 通过 LSP seam 为模型提供单一的只读 `lsp` 工具，用于精确代码导航：转到符号的定义、查找其引用、跳转到其实现，或阅读悬停文档。该工具拥有模型看到的一切——名称、schema、提示词指引、结果格式化与 UI 呈现——并且绝不依赖哪个语言服务器应答查询。位置是从 1 开始的 UTF-16 光标坐标，工具会将其转换为 seam 从零开始的约定。结果是有边界的位置列表或规范化悬停文本，带有明确的空结果与截断标记。与 `dsh-lsp-stdio` 之类的提供方及 `dsh-lsp` seam 组合，即可启用导航。
12
+ `dsh-tool-lsp` 让模型通过单个只读 `lsp` 工具导航代码：打开符号定义、查找引用与实现，或阅读悬停文档。请求使用从 1 开始的 UTF-16 行列位置。导航结果数量有上限、按文件分组，并在省略位置或截断文本时显示标记；悬停结果经过规范化，且会区分信息缺失与错误。该包要求配置 LSP 提供方，并要求会话具有工作区根目录。当文本搜索有歧义，或修改需要精确的符号关系时选择它；普通导航应继续使用 `search` 与 `read`。
13
13
 
14
14
  ## 目录
15
15
 
@@ -84,10 +84,9 @@ kind: "package-reference"
84
84
  <a id="further-exploration"></a>
85
85
  ## 进一步探索
86
86
 
87
- 当包级约定不够用时阅读以下页面。它们从面向模型的表层逐步进入 seam、提供方与决策证据。
87
+ 当包级约定不够用时阅读以下页面。它们从面向模型的表层逐步进入 seam 与提供方。
88
88
 
89
89
  - [LSP 导航子系统](../../../docs/subsystems/lsp.zh.md)——操作、坐标、请求与结果，以及 `LspError` code。
90
- - [LSP 能力 seam Agent Note](../../../.agents/notes/implemented/architecture/2026-07-15-lsp-capability-seam.zh.md)——设计原理、备选方案与刻意推迟的 API。
91
90
  - [dsh-lsp](../lsp/README.zh.md)——本工具查询的 seam。
92
91
  - [dsh-lsp-stdio](../lsp-stdio/README.zh.md)——应答这些查询的 stdio 提供方。
93
92
  - [lsp 组地图](../README.zh.md)——三个包的家族及其相关文档。
@@ -166,7 +165,7 @@ Use search/read for ordinary navigation. Use lsp when textual matches are ambigu
166
165
 
167
166
  这些限制说明该工具何时不太合适。它们是当前包约束，不是任务积压。
168
167
 
169
- - **UTF-16 光标坐标**——列坐标与协议精确一致，但模型难以在非 BMP 字符周围计数；未落在符号上的位置可能返回空结果，因此提示词解释了该约定，但不鼓励广泛使用 LSP（见 [seam Agent Note](../../../.agents/notes/implemented/architecture/2026-07-15-lsp-capability-seam.zh.md)）。
168
+ - **UTF-16 光标坐标**——列坐标与协议精确一致，但模型难以在非 BMP 字符周围计数；未落在符号上的位置可能返回空结果，因此提示词解释了该约定，但不鼓励广泛使用 LSP。
170
169
  - **不承诺跨服务器完整性**——受支持的服务器仍可能根据索引就绪情况返回空或部分结果；该工具不承诺跨语言或服务器的完整性。
171
170
 
172
171
  <a id="dev-note"></a>
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@deepseek-ai/dsh-tool-lsp",
3
3
  "description": "Model-facing lsp tool over the DeepSeek Harness LSP capability seam (ctx.lsp) — one read-only tool with goToDefinition/findReferences/goToImplementation/hover operations, one-based UTF-16 cursor coordinates, bounded location rendering, and hover normalization",
4
- "version": "0.1.2-rc.1",
4
+ "version": "0.1.5-alpha.1",
5
5
  "publishConfig": {
6
6
  "access": "public"
7
7
  },
@@ -28,28 +28,28 @@
28
28
  "license": "MIT",
29
29
  "peerDependencies": {
30
30
  "@deepseek-ai/cordis": "^4.0.2",
31
- "@deepseek-ai/dsh-llm": "^0.1.2-rc.1",
32
- "@deepseek-ai/dsh-lsp": "^0.1.2-rc.1",
33
- "@deepseek-ai/dsh-system-prompt": "^0.1.2-rc.1",
34
- "@deepseek-ai/dsh-timeout": "^0.1.2-rc.1",
35
- "@deepseek-ai/dsh-tools": "^0.1.2-rc.1"
31
+ "@deepseek-ai/dsh-llm": "^0.1.5-alpha.1",
32
+ "@deepseek-ai/dsh-lsp": "^0.1.5-alpha.1",
33
+ "@deepseek-ai/dsh-system-prompt": "^0.1.5-alpha.1",
34
+ "@deepseek-ai/dsh-timeout": "^0.1.5-alpha.1",
35
+ "@deepseek-ai/dsh-tools": "^0.1.5-alpha.1"
36
36
  },
37
37
  "dependencies": {
38
- "@deepseek-ai/schemastery": "^3.18.2",
39
- "@deepseek-ai/dsh-util-values": "^0.1.2-rc.1"
38
+ "@deepseek-ai/dsh-util-values": "^0.1.5-alpha.1",
39
+ "@deepseek-ai/schemastery": "^3.18.2"
40
40
  },
41
41
  "devDependencies": {
42
42
  "@deepseek-ai/cordis": "^4.0.2",
43
- "@deepseek-ai/dsh-agent": "^0.1.2-rc.1",
44
- "@deepseek-ai/dsh-fs-local": "^0.1.2-rc.1",
45
- "@deepseek-ai/dsh-lsp": "^0.1.2-rc.1",
46
- "@deepseek-ai/dsh-lsp-stdio": "^0.1.2-rc.1",
47
- "@deepseek-ai/dsh-session": "^0.1.2-rc.1",
48
- "@deepseek-ai/dsh-subprocess-local": "^0.1.2-rc.1",
49
- "@deepseek-ai/dsh-system-prompt": "^0.1.2-rc.1",
50
- "@deepseek-ai/dsh-timeout": "^0.1.2-rc.1",
51
- "@deepseek-ai/dsh-llm": "^0.1.2-rc.1",
52
- "@deepseek-ai/dsh-tool-call-timeout-policy": "^0.1.2-rc.1",
53
- "@deepseek-ai/dsh-tools": "^0.1.2-rc.1"
43
+ "@deepseek-ai/dsh-agent": "^0.1.5-alpha.1",
44
+ "@deepseek-ai/dsh-fs-local": "^0.1.5-alpha.1",
45
+ "@deepseek-ai/dsh-llm": "^0.1.5-alpha.1",
46
+ "@deepseek-ai/dsh-lsp-stdio": "^0.1.5-alpha.1",
47
+ "@deepseek-ai/dsh-subprocess-local": "^0.1.5-alpha.1",
48
+ "@deepseek-ai/dsh-system-prompt": "^0.1.5-alpha.1",
49
+ "@deepseek-ai/dsh-timeout": "^0.1.5-alpha.1",
50
+ "@deepseek-ai/dsh-tool-call-timeout-policy": "^0.1.5-alpha.1",
51
+ "@deepseek-ai/dsh-tools": "^0.1.5-alpha.1",
52
+ "@deepseek-ai/dsh-session": "^0.1.5-alpha.1",
53
+ "@deepseek-ai/dsh-lsp": "^0.1.5-alpha.1"
54
54
  }
55
55
  }