@deepseek-ai/dsh-file-reference-local 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-file-reference-local/use-this-package:
-  en: bb3ce050657f834a
-  zh: 2e1afa3efb7a5702
+  en: 1fd922f09d15163f
+  zh: e1d68a27a676256d
 /deepseek-ai-dsh-file-reference-local/use-this-package/enabling-the-provider:
   en: 62b9ce096fa4a94e
   zh: 53081797c34d64eb
@@ -33,8 +33,8 @@
   en: f0023b9c833747b5
   zh: 42aef0c0fce9ce8c
 /deepseek-ai-dsh-file-reference-local/understand-the-implementation/source-map:
-  en: a04bc6a11619cae7
-  zh: 4fb1a0d04398260b
+  en: 50b4cb9acee6e4a7
+  zh: a1455ea70c837ebc
 /deepseek-ai-dsh-file-reference-local/understand-the-implementation/main-flow:
   en: bb338cacc1ef8c01
   zh: d7ad96a5646f5444

package/README.md

@@ -25,7 +25,9 @@ Agents and host UIs can complete `@file` mentions with ranked paths from each ag
 <a id="use-this-package"></a>
 ## Use this package
 
-Mount this provider when `@file` completion should discover the Harness host's own filesystem — the namespace the shipped `read` tool operates on. Each agent's workspace is indexed from its session working directory, falling back to the host process directory when the session has none.
+Changing the Session's working directory discards the previous directory's search index; the next completion searches the new directory.
+
+Mount this provider when `@file` completion should discover the Harness host's own filesystem — the namespace the shipped `read` tool operates on. Each agent's workspace is indexed from its Session's current working directory.
 
 ### Enabling the provider
 
@@ -71,7 +73,6 @@ The provider maintains one reusable `WorkspaceFileSearch` per agent, rooted at t
 |---|---|
 | [`src/index.ts`](src/index.ts) | `LocalFileReferenceService`: config validation, per-agent searches, prompt install |
 | [`src/search.ts`](src/search.ts) | `WorkspaceFileSearch`: traversal, ranking, exclusion, staleness and background rebuild |
-| — | No runtime invariant companion is published; per-agent indexes are private advisory caches whose invalidation and disposal are observed directly through service tests. |
 
 ### Main flow
 

package/README.zh.md

@@ -25,7 +25,9 @@ agent（智能体）及宿主 UI 可以用各 agent 本地工作区中经过排
 <a id="use-this-package"></a>
 ## 使用本包
 
-当 `@file` 补全应发现 Harness 宿主自身的文件系统——即随附 `read` 工具所操作的命名空间——时，挂载此提供方。每个 agent 的工作区从该会话的工作目录开始建立索引；会话没有工作目录时回退到宿主进程目录。
+切换 Session 工作目录后，旧目录的搜索索引会被丢弃；下一次补全会搜索新目录。
+
+当 `@file` 补全应发现 Harness 宿主自身的文件系统——即随附 `read` 工具所操作的命名空间——时，挂载此提供方。每个 agent 的工作区从其 Session 当前工作目录开始建立索引。
 
 ### 启用提供方
 
@@ -71,7 +73,6 @@ agent（智能体）及宿主 UI 可以用各 agent 本地工作区中经过排
 |---|---|
 | [`src/index.ts`](src/index.ts) | `LocalFileReferenceService`：配置校验、按 agent 搜索、提示词安装 |
 | [`src/search.ts`](src/search.ts) | `WorkspaceFileSearch`：遍历、排序、排除、陈旧标记与后台重建 |
-| — | 不发布运行时不变式伴生入口；按 agent 的 index 是私有 advisory cache，其失效与 dispose 行为通过服务测试直接观察。 |
 
 ### 主要流程
 

package/lib/index.js

@@ -318,7 +318,7 @@ function errorReason(reason, fallback) {
 */
 /** Local-filesystem owner of the file-reference discovery service. */
 var LocalFileReferenceService = class extends FileReferenceService {
-	static inject = ["agents"];
+	static inject = ["agents", "workingDirectory"];
 	static Config = z.object({
 		maxResults: z.number().step(1).min(1).default(20),
 		maxEntries: z.number().step(1).min(1).default(DEFAULT_FILE_SEARCH_MAX_ENTRIES),
@@ -366,30 +366,35 @@ var LocalFileReferenceService = class extends FileReferenceService {
 			await installPrompt(agent);
 		});
 		ctx.on("agent/disposed", ({ agent }) => {
-			this.searches.get(agent)?.dispose();
+			this.searches.get(agent)?.search.dispose();
 			this.searches.delete(agent);
 			disposePrompt(agent);
 		});
 		ctx.on("session/event", (session, event) => {
 			if (event.type !== "tool/result") return;
 			const agent = ctx.agents.get(session.id);
-			if (agent !== void 0) this.searches.get(agent)?.invalidate();
+			if (agent !== void 0) this.searches.get(agent)?.search.invalidate();
 		});
 		ctx.effect(() => async () => {
-			for (const search of this.searches.values()) search.dispose();
+			for (const { search } of this.searches.values()) search.dispose();
 			this.searches.clear();
 			const promptFibers = [...this.promptFibers.values()];
 			this.promptFibers.clear();
 			await Promise.all([...promptFibers.map((fiber) => fiber.dispose()), ...this.promptDisposals]);
 		}, "file-reference-local: search cache");
 	}
-	list(agent, query, signal) {
-		let search = this.searches.get(agent);
-		if (search === void 0) {
-			search = new WorkspaceFileSearch(agent.session.header.cwd ?? process.cwd(), this.config);
-			this.searches.set(agent, search);
+	async list(agent, query, signal) {
+		const cwd = await this.ctx.workingDirectory.ensure(agent, signal);
+		let cached = this.searches.get(agent);
+		if (cached?.cwd !== cwd) {
+			cached?.search.dispose();
+			cached = {
+				cwd,
+				search: new WorkspaceFileSearch(cwd, this.config)
+			};
+			this.searches.set(agent, cached);
 		}
-		return search.list(query, signal);
+		return cached.search.list(query, signal);
 	}
 };
 function validateConfig(config) {

package/lib/types/index.js

@@ -11,7 +11,7 @@ export { FILE_REFERENCE_PROMPT } from '@deepseek-ai/dsh-file-reference';
 export { activeAtToken, formatFileMention } from '@deepseek-ai/dsh-file-reference/grammar';
 /** Local-filesystem owner of the file-reference discovery service. */
 export class LocalFileReferenceService extends FileReferenceService {
-    static inject = ['agents'];
+    static inject = ['agents', 'workingDirectory'];
     static Config = z.object({
         maxResults: z.number().step(1).min(1).default(DEFAULT_FILE_SEARCH_MAX_RESULTS),
         maxEntries: z.number().step(1).min(1).default(DEFAULT_FILE_SEARCH_MAX_ENTRIES),
@@ -60,7 +60,7 @@ export class LocalFileReferenceService extends FileReferenceService {
             installPrompt(agent);
         ctx.on('agent/created', async ({ agent }) => { await installPrompt(agent); });
         ctx.on('agent/disposed', ({ agent }) => {
-            this.searches.get(agent)?.dispose();
+            this.searches.get(agent)?.search.dispose();
             this.searches.delete(agent);
             disposePrompt(agent);
         });
@@ -69,10 +69,10 @@ export class LocalFileReferenceService extends FileReferenceService {
                 return;
             const agent = ctx.agents.get(session.id);
             if (agent !== undefined)
-                this.searches.get(agent)?.invalidate();
+                this.searches.get(agent)?.search.invalidate();
         });
         ctx.effect(() => async () => {
-            for (const search of this.searches.values())
+            for (const { search } of this.searches.values())
                 search.dispose();
             this.searches.clear();
             const promptFibers = [...this.promptFibers.values()];
@@ -83,13 +83,15 @@ export class LocalFileReferenceService extends FileReferenceService {
             ]);
         }, 'file-reference-local: search cache');
     }
-    list(agent, query, signal) {
-        let search = this.searches.get(agent);
-        if (search === undefined) {
-            search = new WorkspaceFileSearch(agent.session.header.cwd ?? process.cwd(), this.config);
-            this.searches.set(agent, search);
+    async list(agent, query, signal) {
+        const cwd = await this.ctx.workingDirectory.ensure(agent, signal);
+        let cached = this.searches.get(agent);
+        if (cached?.cwd !== cwd) {
+            cached?.search.dispose();
+            cached = { cwd, search: new WorkspaceFileSearch(cwd, this.config) };
+            this.searches.set(agent, cached);
         }
-        return search.list(query, signal);
+        return cached.search.list(query, signal);
     }
 }
 function validateConfig(config) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-file-reference-local",
   "description": "Local-filesystem ctx.fileReferences provider with bounded fuzzy indexes",
-  "version": "0.2.0-rc.2",
+  "version": "0.2.1-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -32,20 +32,24 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@deepseek-ai/schemastery": "~3.18.4"
+    "@deepseek-ai/schemastery": "~3.18.5-alpha.1"
   },
   "peerDependencies": {
-    "@deepseek-ai/dsh-file-reference": "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/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-agent": "0.2.0-rc.2"
+    "@deepseek-ai/dsh-agent": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-file-reference": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-system-prompt": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-tools": "0.2.1-alpha.2",
+    "@deepseek-ai/cordis": "~4.0.5-alpha.1",
+    "@deepseek-ai/dsh-working-directory": "0.2.1-alpha.2"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-agent": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-file-reference": "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/cordis": "~4.0.4"
+    "@deepseek-ai/dsh-agent": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-file-reference": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-system-prompt": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-tools": "0.2.1-alpha.2",
+    "@deepseek-ai/cordis": "~4.0.5-alpha.1",
+    "@deepseek-ai/dsh-working-directory": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-fs-local": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session-projection": "0.2.1-alpha.2"
   }
 }