@deepseek-ai/dsh-tool-lsp 0.2.0-rc.2 → 0.2.1-alpha.2

package/README.i18n.yaml

@@ -15,8 +15,8 @@
   en: d152484eb41ac6b4
   zh: 09388d293f9be9cb
 /deepseek-ai-dsh-tool-lsp/use-this-package:
-  en: 755832ede150d487
-  zh: 5f5058b7f6b41f8e
+  en: 9cc52be87b57e19a
+  zh: 9fa78b6fe3027c1f
 /deepseek-ai-dsh-tool-lsp/use-this-package/the-tool:
   en: 46cbff3bda30f0bc
   zh: 66e209ae78fb4683
@@ -27,8 +27,8 @@
   en: c6ca5869a35edefa
   zh: 65378aff80dfc93c
 /deepseek-ai-dsh-tool-lsp/use-this-package/failures-and-recovery:
-  en: 0a18aa55ff17c31c
-  zh: f7c1b9f34404d27e
+  en: b1f8b3bb52434cc6
+  zh: a8c9643a754c4768
 /deepseek-ai-dsh-tool-lsp/understand-the-implementation:
   en: 6574e484bce0e60b
   zh: 75688d1f9dde8f48
@@ -36,8 +36,8 @@
   en: 9e9f50894b853946
   zh: 7137a1894339ad5f
 /deepseek-ai-dsh-tool-lsp/understand-the-implementation/source-map:
-  en: 6b14444729010597
-  zh: de5b7453bb7fd3be
+  en: ae801d20c57b1ffb
+  zh: 65aa6d9c0e0488fb
 /deepseek-ai-dsh-tool-lsp/further-exploration:
   en: f4965ba5ea4f8ee3
   zh: b85ee14edf9fdef0

package/README.md

@@ -25,6 +25,8 @@ English | [中文](README.zh.md)
 <a id="use-this-package"></a>
 ## Use this package
 
+Queries use the Session's current working directory as their workspace root. Changing directory affects subsequent queries without changing an already running server's root.
+
 An agent uses `lsp` when textual matches are ambiguous or before a change that needs precise definitions, implementations, or references; the tool's prompt guidance tells it to prefer `search`/`read` for ordinary navigation.
 
 ### The tool
@@ -47,7 +49,7 @@ The generated [configuration catalog](../../../docs/config-catalog.md#deepseek-a
 
 ### Failures and recovery
 
-The tool requires a session workspace root (`header.cwd`) with no fallback; absence fails with `LSP_WORKSPACE_REQUIRED` before any query. When no provider handles the file's extension, the query fails with `LSP_UNAVAILABLE`; malformed provider payloads remain structured `LSP_MALFORMED_RESPONSE` errors. These surface to the model as error tool results it can read and route on.
+The tool requires an Agent Session; a non-agent call fails with `LSP_WORKSPACE_REQUIRED` before any query. The working-directory service supplies and validates its current root. When no provider handles the file's extension, the query fails with `LSP_UNAVAILABLE`; malformed provider payloads remain structured `LSP_MALFORMED_RESPONSE` errors. These surface to the model as error tool results it can read and route on.
 
 -----
 
@@ -74,8 +76,6 @@ This section explains the design decisions behind the tool and where the code re
 |---|---|
 | [`src/index.ts`](src/index.ts) | Plugin entry: config schema, tool registration, system-prompt section, execution |
 | [`src/render.ts`](src/render.ts) | Pure formatting, coordinate conversion, URI resolution, result caps, UI presentation |
-| [`src/session-cwd.ts`](src/session-cwd.ts) | Workspace root from the session `header.cwd` |
-| — | No runtime invariant companion is published; this stateless adapter contributes one tool and prompt section, while query lifecycle and result relations remain owned by the tool and LSP seams it composes. |
 
 </details>
 

package/README.zh.md

@@ -25,6 +25,8 @@ kind: "package-reference"
 <a id="use-this-package"></a>
 ## 使用本包
 
+查询使用 Session 的当前工作目录作为工作区根目录。切换目录会影响后续查询，但不会改变已运行服务器的根目录。
+
 当文本匹配有歧义，或修改前需要精确的定义、实现或引用时，agent（智能体）使用 `lsp`；该工具的提示词指引会告诉它，普通导航应优先使用 `search`／`read`。
 
 ### 工具
@@ -47,7 +49,7 @@ kind: "package-reference"
 
 ### 失败与恢复
 
-该工具要求会话工作区根目录（`header.cwd`），没有回退值；缺失时会在任何查询前以 `LSP_WORKSPACE_REQUIRED` 失败。当没有提供方处理该文件扩展名时，查询以 `LSP_UNAVAILABLE` 失败；格式错误的提供方载荷仍保持为结构化 `LSP_MALFORMED_RESPONSE` 错误。这些会呈现为模型可读、可路由的错误工具结果。
+该工具要求 Agent Session；非 Agent 调用会在任何查询前以 `LSP_WORKSPACE_REQUIRED` 失败。工作目录服务提供并校验当前根目录。当没有提供方处理该文件扩展名时，查询以 `LSP_UNAVAILABLE` 失败；格式错误的提供方载荷仍保持为结构化 `LSP_MALFORMED_RESPONSE` 错误。这些会呈现为模型可读、可路由的错误工具结果。
 
 -----
 
@@ -74,8 +76,6 @@ kind: "package-reference"
 |---|---|
 | [`src/index.ts`](src/index.ts) | 插件入口：配置 schema、工具注册、系统提示词区段、执行 |
 | [`src/render.ts`](src/render.ts) | 纯格式化、坐标转换、URI 解析、结果上限、UI 呈现 |
-| [`src/session-cwd.ts`](src/session-cwd.ts) | 从会话 `header.cwd` 取得工作区根目录 |
-| — | 不发布运行时不变式伴生入口；该无状态适配器提供一个工具和一个提示词区段，而查询生命周期与结果关系仍由它所组合的工具 seam 和 LSP seam 负责。 |
 
 </details>
 

package/lib/index.js

@@ -159,22 +159,6 @@ function presentLspCall(args) {
 	};
 }
 //#endregion
-//#region lib/types/session-cwd.js
-/**
-* Derive the workspace root an `lsp` call resolves against from the calling
-* agent's session. A missing cwd fails as `LSP_WORKSPACE_REQUIRED` because the
-* local provider must canonicalize a real workspace before starting a server.
-* @module @deepseek-ai/dsh-tool-lsp/session-cwd
-*/
-/**
-* The session workspace cwd for this call, or `undefined` when none applies.
-* @param exec - the tool-execution context; only its optional `agent` is read.
-* @returns the calling agent's session cwd, or undefined for a non-agent caller.
-*/
-function sessionCwd(exec) {
-	return exec.agent?.session.header.cwd;
-}
-//#endregion
 //#region lib/types/index.js
 /**
 * Model-facing `lsp` tool over `ctx.lsp`. One read-only tool with four operations
@@ -193,7 +177,8 @@ const name = "tool-lsp";
 const inject = [
 	"tools",
 	"lsp",
-	"systemPrompt"
+	"systemPrompt",
+	"workingDirectory"
 ];
 /** Default tool-call timeout budget (ms), covering the queued open/query/close lifecycle. */
 const DEFAULT_LSP_TOOL_TIMEOUT_MS = 6e4;
@@ -349,7 +334,7 @@ function apply(ctx, config) {
 		timeoutMs: resolved.timeoutMs,
 		async execute(args, exec) {
 			const input = parseLspArgs(args);
-			const workspaceRoot = sessionCwd(exec);
+			const workspaceRoot = exec.agent === void 0 ? void 0 : await ctx.workingDirectory.ensure(exec.agent, exec.signal);
 			if (workspaceRoot === void 0) throw new LspError("the lsp tool requires a session workspace cwd", "LSP_WORKSPACE_REQUIRED");
 			const result = await ctx.lsp.query({
 				operation: input.operation,
@@ -407,4 +392,4 @@ function assertTimer(name, value) {
 	if (!Number.isInteger(value) || value < 1 || value > MAX_TIMER_DELAY_MS) throw new Error(`tool-lsp: ${name} must be a positive integer no greater than ${MAX_TIMER_DELAY_MS}`);
 }
 //#endregion
-export { Config, DEFAULT_LSP_TOOL_TIMEOUT_MS, DEFAULT_MAX_LOCATIONS, DEFAULT_MAX_RESULT_CHARS, LSP_OPERATIONS, LSP_PROMPT_TEXT, apply, formatHover, formatLocations, inject, name, parseLspArgs, presentLspCall, renderUri, sessionCwd };
+export { Config, DEFAULT_LSP_TOOL_TIMEOUT_MS, DEFAULT_MAX_LOCATIONS, DEFAULT_MAX_RESULT_CHARS, LSP_OPERATIONS, LSP_PROMPT_TEXT, apply, formatHover, formatLocations, inject, name, parseLspArgs, presentLspCall, renderUri };

package/lib/types/index.d.ts

@@ -12,7 +12,6 @@
 import type { Context } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
 export { DEFAULT_MAX_LOCATIONS, DEFAULT_MAX_RESULT_CHARS, formatHover, formatLocations, LSP_OPERATIONS, parseLspArgs, presentLspCall, renderUri, } from './render.ts';
-export { sessionCwd } from './session-cwd.ts';
 /** Cordis plugin name for loader diagnostics. */
 export declare const name = "tool-lsp";
 /** Services required by this plugin. */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-tool-lsp",
   "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",
-  "version": "0.2.0-rc.2",
+  "version": "0.2.1-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -27,29 +27,32 @@
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-llm": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-lsp": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-system-prompt": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-tools": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-timeout": "0.2.0-rc.2"
+    "@deepseek-ai/cordis": "~4.0.5-alpha.1",
+    "@deepseek-ai/dsh-llm": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-lsp": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-system-prompt": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-timeout": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-tools": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-working-directory": "0.2.1-alpha.2"
   },
   "dependencies": {
-    "@deepseek-ai/dsh-util-values": "0.2.0-rc.2",
-    "@deepseek-ai/schemastery": "~3.18.4"
+    "@deepseek-ai/dsh-util-values": "0.2.1-alpha.2",
+    "@deepseek-ai/schemastery": "~3.18.5-alpha.1"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-agent": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-fs-local": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-llm": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-lsp": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-lsp-stdio": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-subprocess-local": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-system-prompt": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-session": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-timeout": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-tool-call-timeout-policy": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-tools": "0.2.0-rc.2"
+    "@deepseek-ai/cordis": "~4.0.5-alpha.1",
+    "@deepseek-ai/dsh-agent": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-fs-local": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-llm": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-lsp": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-lsp-stdio": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-subprocess-local": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-system-prompt": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-timeout": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-tool-call-timeout-policy": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-tools": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-working-directory": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-agent-loop-testkit": "0.2.1-alpha.2"
   }
 }

package/lib/types/session-cwd.d.ts

@@ -1,14 +0,0 @@
-/**
- * Derive the workspace root an `lsp` call resolves against from the calling
- * agent's session. A missing cwd fails as `LSP_WORKSPACE_REQUIRED` because the
- * local provider must canonicalize a real workspace before starting a server.
- * @module @deepseek-ai/dsh-tool-lsp/session-cwd
- */
-import type { ToolExecution } from '@deepseek-ai/dsh-tools';
-/**
- * The session workspace cwd for this call, or `undefined` when none applies.
- * @param exec - the tool-execution context; only its optional `agent` is read.
- * @returns the calling agent's session cwd, or undefined for a non-agent caller.
- */
-export declare function sessionCwd(exec: ToolExecution): string | undefined;
-//# sourceMappingURL=session-cwd.d.ts.map