@deepseek-ai/dsh-tool-present 0.2.1-alpha.1 → 0.2.1-alpha.2

package/README.i18n.yaml

@@ -15,11 +15,11 @@
   en: d152484eb41ac6b4
   zh: 09388d293f9be9cb
 /deepseek-ai-dsh-tool-present/use-this-package:
-  en: f2726b49d9f4d5b3
-  zh: 10428317260e5cf1
+  en: 3bb0413b8aa3bd10
+  zh: ab753bb651a62209
 /deepseek-ai-dsh-tool-present/understand-the-implementation:
-  en: 3ae69eb991942c18
-  zh: 6824644dc0cee1ae
+  en: 6e73ca41dddc096e
+  zh: b59fdfa3f3cc47e1
 /deepseek-ai-dsh-tool-present/further-exploration:
   en: 66269384f8c0d0f7
   zh: b3d694d2f0ae588a

package/README.md

@@ -25,6 +25,8 @@ Use `present` to declare final files accessible through the Session filesystem,
 <a id="use-this-package"></a>
 ## Use this package
 
+`present` validates paths against the Session's current working directory and records absolute paths, so later directory changes do not redirect delivered files.
+
 The `standard`, `ptc`, and `cordis` agent presets mount this plugin. Call `present` with `files: [{ path, description? }]` after creating the files. Files must be regular files accessible through the Session filesystem. Relative paths resolve against the Session working directory; absolute paths may name files outside it, including `/tmp` or Downloads. Missing files, directories, final symbolic links, and provider-denied paths fail the call. Files in a shell sandbox’s private `/tmp` must first be written somewhere the Session filesystem can access.
 
 Mount it in an agent's Cordis composition with `tools`, `fs`, and the `turnBoundary` Session projection available:
@@ -51,7 +53,7 @@ The file-count limit is validated at mount. The tool requires an agent Session w
 
 The tool resolves paths through the configured filesystem provider and checks regular-file metadata without reading contents. Successful final `tools/result` notifications append `deliverables/presented`, including nested calls. A later enclosing program failure does not revoke an already completed declaration. Blocked results publish none. Each plugin instance records only calls it executed; scoped tools with the same name cannot publish through another instance.
 
-The pure `./types` entry declares `PresentedFile` and the Session event without importing Host runtime code. The Web consumer validates persisted declarations before displaying or opening them. The event stores no Session ID, so forked history resolves relative paths against the viewed Session's workspace.
+The pure `./types` entry declares `PresentedFile` and the Session event without importing Host runtime code. The Web consumer validates persisted declarations before displaying or opening them. New declarations store absolute paths. Legacy relative declarations retain the viewed Session's original workspace as their base.
 
 </details>
 

package/README.zh.md

@@ -25,6 +25,8 @@ kind: "package-reference"
 <a id="use-this-package"></a>
 ## 使用本包
 
+`present` 按 Session 的当前工作目录校验路径并记录绝对路径，因此后续目录切换不会让已交付文件指向其他位置。
+
 `standard`、`ptc` 与 `cordis` Agent preset 挂载本插件。创建文件后，以 `files: [{ path, description? }]` 调用 `present`。文件必须是 Session 文件系统可访问的普通文件。相对路径按 Session 工作目录解析；绝对路径可以指向工作区外的文件，包括 `/tmp` 或 Downloads。文件缺失、为目录、最终路径为符号链接或提供方拒绝访问时，调用失败。Shell 沙箱私有 `/tmp` 中的文件需要先写入 Session 文件系统可访问的位置。
 
 在 Agent 的 Cordis 组合中挂载，并提供 `tools`、`fs` 和 `turnBoundary` Session 投影：
@@ -51,7 +53,7 @@ kind: "package-reference"
 
 工具通过配置的文件系统提供方解析路径，检查普通文件元数据，不读取内容。成功的最终 `tools/result` 通知追加 `deliverables/presented`，嵌套调用也适用。外层程序随后失败不会撤销已完成的声明。被阻止的结果不发布声明。每个插件实例只记录其实际执行的调用；同名作用域工具不能通过其他实例发布交付。
 
-纯 `./types` 入口声明 `PresentedFile` 与 Session 事件，不导入 Host 运行时代码。Web 消费方在展示或打开文件前校验持久声明。事件不保存 Session ID，因此 fork 历史中的相对路径按当前查看的 Session 工作区解析。
+纯 `./types` 入口声明 `PresentedFile` 与 Session 事件，不导入 Host 运行时代码。Web 消费方在展示或打开文件前校验持久声明。新声明保存绝对路径。历史相对路径声明继续以当前查看的 Session 原始工作区作为基准。
 
 </details>
 

package/lib/index.js

@@ -10,7 +10,8 @@ const Config = z.object({ maxFiles: z.number().default(8) });
 const inject = [
 	"tools",
 	"fs",
-	"sessionProjections"
+	"sessionProjections",
+	"workingDirectory"
 ];
 /**
 * Register present with durable file references in its tool result.
@@ -79,8 +80,7 @@ function apply(ctx, config) {
 			const boundary = ctx.sessionProjections.stateOf(exec.agent.session, "turnBoundary");
 			if (boundary === void 0 || boundary.openTurnStartSeq === null) throw new Error("present requires an open turn");
 			if (args.files.length === 0 || args.files.length > config.maxFiles) throw new Error(`present accepts 1 to ${config.maxFiles} files`);
-			const cwd = exec.agent.session.header.cwd;
-			if (cwd === void 0) throw new Error("present requires a workspace");
+			const cwd = await ctx.workingDirectory.ensure(exec.agent, exec.signal);
 			const options = {
 				cwd,
 				signal: exec.signal
@@ -94,7 +94,10 @@ function apply(ctx, config) {
 				const info = await ctx.fs.stat(target, exec.signal);
 				if (info === void 0) throw new FsError(`Cannot present ${file.path}: file not found. Check the path, create the file if needed, and retry.`, "FS_NOT_FOUND");
 				if (info.type !== "file") throw new Error(`Cannot present ${file.path}: not a regular file`);
-				files.push({ ...file });
+				files.push({
+					...file,
+					path: ctx.fs.processPath(target)
+				});
 			}
 			exec.signal.throwIfAborted();
 			pending.set(exec, {

package/lib/types/index.d.ts

@@ -1,4 +1,3 @@
-/** Scoped tool that declares filesystem deliveries in their owning Session. */
 import type { Context } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
 /** Stable Loader identity. */

package/lib/types/index.js

@@ -8,7 +8,7 @@ export const Config = z.object({
     maxFiles: z.number().default(8),
 });
 /** Services used by the scoped delivery tool. */
-export const inject = ['tools', 'fs', 'sessionProjections'];
+export const inject = ['tools', 'fs', 'sessionProjections', 'workingDirectory'];
 /**
  * Register present with durable file references in its tool result.
  * @param ctx - agent-scoped services.
@@ -65,9 +65,7 @@ export function apply(ctx, config) {
                 throw new Error('present requires an open turn');
             if (args.files.length === 0 || args.files.length > config.maxFiles)
                 throw new Error(`present accepts 1 to ${config.maxFiles} files`);
-            const cwd = exec.agent.session.header.cwd;
-            if (cwd === undefined)
-                throw new Error('present requires a workspace');
+            const cwd = await ctx.workingDirectory.ensure(exec.agent, exec.signal);
             const options = { cwd, signal: exec.signal };
             const files = [];
             for (const file of args.files) {
@@ -82,7 +80,7 @@ export function apply(ctx, config) {
                     throw new FsError(`Cannot present ${file.path}: file not found. Check the path, create the file if needed, and retry.`, 'FS_NOT_FOUND');
                 if (info.type !== 'file')
                     throw new Error(`Cannot present ${file.path}: not a regular file`);
-                files.push({ ...file });
+                files.push({ ...file, path: ctx.fs.processPath(target) });
             }
             exec.signal.throwIfAborted();
             pending.set(exec, { session: exec.agent.session, turn: boundary.lastTurn, files });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-tool-present",
   "description": "Explicit workspace file delivery declarations for the DeepSeek Harness",
-  "version": "0.2.1-alpha.1",
+  "version": "0.2.1-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -36,25 +36,27 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "~4.0.5-alpha.1",
-    "@deepseek-ai/dsh-fs": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-llm": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-session": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-session-projection": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-tools": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-agent": "0.2.1-alpha.1"
+    "@deepseek-ai/dsh-agent": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-fs": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-llm": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session-projection": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-tools": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-working-directory": "0.2.1-alpha.2"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-agent": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-fs": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-llm": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-session": "0.2.1-alpha.1",
     "@deepseek-ai/cordis": "~4.0.5-alpha.1",
-    "@deepseek-ai/dsh-session-projection": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-tools": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-agent-loop": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-agent-loop-testkit": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-system-prompt": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-scope": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-fs-local": "0.2.1-alpha.1"
+    "@deepseek-ai/dsh-agent": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-fs": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-llm": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session-projection": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-tools": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-agent-loop": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-agent-loop-testkit": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-fs-local": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-system-prompt": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-scope": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-working-directory": "0.2.1-alpha.2"
   }
 }