@morlay/dsh-tool-guidance 0.0.6 → 0.0.8

package/README.md

@@ -1,10 +1,9 @@
 # @morlay/dsh-tool-guidance
 
 本部署的**工具说明运行时**：包根本身把工具描述换成一行中文、剥掉 schema 里的说明性字段，并把用法按组
-送达——`base` 组的正文由本行挂 `agent/pre-step` 常驻注入（按**这个会话装配结果里最终可见的工具目录**过滤），
-按需的 `flow` / `delegation` / `team` 三组注册进官方 `ctx.skills`（目录与按需加载由官方 `tool-skill` 那一行
-提供）；`rows` 出口只发布 **它那一行**（`tool-guidance`，host 平面）。取舍见
-[设计-工具说明与用法分组的送达](.agents/designs/20260929-工具说明与用法分组的送达.md)。
+送达——`base` 组常驻注入，`flow` / `delegation` / `team` 三组注册进官方 `ctx.skills` 按需加载（目录由官方
+`tool-skill` 那一行提供）；`rows` 出口只发布 **它那一行**（`tool-guidance`，host 平面）。形态、接缝与代价见
+[设计 工具说明与用法分组的送达](./.agents/designs/20260929-工具说明与用法分组的送达.md)。
 
 功能行清单（工具 / 命令 / 压缩 / 计划模式 / 委派）**不归本包**：它们住在会话挂着的 agent preset 里（官方 shipped
 preset 或部署自建的那份）。取舍见
@@ -23,11 +22,7 @@ preset 或部署自建的那份）。取舍见
 装配层把 `tool-guidance` 插在 **host 平面**（`toolGuidanceRow()` 给出行 id 与模块名），装的就是本包的包根
 （`@morlay/dsh-tool-guidance`）。`rows` 出口只有数据，没有装配动作。
 
-那一行只有一个开关 `config.groups`（部署级，默认开）：关掉它只剩工具预处理（短描述汉化 + schema 精简），
-`base` 常驻注入与按需三组一起不发生——它们是一件事的两半。
-
-模式的 `allowTools` 留空即"不设收窄，用 preset 的全部工具"；要收窄就列名单（见
-[dsh-session-mode](../dsh-session-mode/README.md)）。
+那一行只有一个开关 `config.groups`（部署级，默认开）：关掉它只剩工具预处理（短描述汉化 + schema 精简）。
 
 ## 边界
 

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import z from "@deepseek-ai/schemastery";
 import { Context } from "@deepseek-ai/cordis";
+import z from "@deepseek-ai/schemastery";
 //#region src/index.d.ts
 export declare const name = "tool-guidance";
 export declare const inject: string[];

package/dist/index.mjs

@@ -112,6 +112,10 @@ const FS_PACK = {
 			tool: "grep",
 			short: "按正则搜索文件内容"
 		},
+		{
+			tool: "working_directory",
+			short: "查看当前工作目录，或用 cd 切换"
+		},
 		{
 			tool: "read_image",
 			short: "读取图片内容"
@@ -270,6 +274,10 @@ const BASE_GROUP = {
 				when: "grep",
 				text: "grep：按内容搜索（不要用 shell grep / rg）；需要上下文再 read 命中的文件。"
 			},
+			{
+				when: "working_directory",
+				text: "working_directory：查会话当前工作目录，或传 cd 切到某个已存在的目录——切完相对路径都按它解析；已开的 shell 与在跑进程留在自己的目录里，不受这次切换影响。"
+			},
 			{
 				when: "bash",
 				text: "bash：执行命令。使用参数 workdir，默认是你的工作目录，严禁使用 `cd`；非零退出会标 [exit code: N]，先查清失败原因再继续。"
@@ -344,6 +352,7 @@ const BASE_GROUP = {
 			"str_replace_editor",
 			"glob",
 			"grep",
+			"working_directory",
 			"bash",
 			"pwsh",
 			"ask_user_question",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morlay/dsh-tool-guidance",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "Tool guidance for dsh: localized short tool descriptions, trimmed schema and usage groups as one host-plane row. The agent row list lives in the agent presets themselves (shipped or deployment-owned).",
   "keywords": [
     "dsh",
@@ -22,32 +22,41 @@
   ],
   "type": "module",
   "exports": {
-    ".": "./dist/index.mjs",
-    "./rows": "./dist/rows.mjs",
+    ".": {
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    },
+    "./rows": {
+      "types": "./dist/rows.d.mts",
+      "default": "./dist/rows.mjs"
+    },
     "./package.json": "./package.json",
     "./locale/*.json": "./locale/*.json"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis-plugin-include": "1.0.9",
-    "@deepseek-ai/dsh-agent": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-agent-loop-testkit": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-llm": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-scope": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-session": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-skill": "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/schemastery": "3.18.4",
-    "@morlay/dsh-context-assembler": "0.0.6",
-    "@morlay/dsh-session-mode": "0.0.8",
+    "@deepseek-ai/cordis-plugin-include": "^1.0.10",
+    "@deepseek-ai/dsh-agent-loop-testkit": "^0.2.1-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.2.1-rc.1",
+    "@deepseek-ai/dsh-scope": "^0.2.1-rc.1",
+    "@deepseek-ai/dsh-session": "^0.2.1-rc.1",
+    "@deepseek-ai/dsh-system-prompt": "^0.2.1-rc.1",
+    "@deepseek-ai/schemastery": "^3.18.5",
+    "@morlay/dsh-context-assembler": "0.0.8",
+    "@morlay/dsh-session-mode": "0.0.11",
     "@types/js-yaml": "^4.0.9",
     "js-yaml": "^4.1.0"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.4",
-    "@deepseek-ai/dsh-llm": "^0.2.0-rc.2",
-    "@deepseek-ai/schemastery": "^3.18.4",
-    "@morlay/dsh-context-assembler": "0.0.6"
+    "@deepseek-ai/cordis": "^4.0.5",
+    "@deepseek-ai/dsh-agent": "^0.2.1-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.2.1-rc.1",
+    "@deepseek-ai/dsh-skill": "^0.2.1-rc.1",
+    "@deepseek-ai/dsh-tools": "^0.2.1-rc.1",
+    "@deepseek-ai/schemastery": "^3.18.5",
+    "@morlay/dsh-context-assembler": "0.0.8"
+  },
+  "engines": {
+    "dsh": ">= 0.2.1-rc.1 < 0.2.2"
   },
   "scripts": {
     "build": "pnpm exec tsdown"

package/src/guidance/packs/fs.ts

@@ -1,4 +1,4 @@
-// 文件与图片：读写搜。
+// 文件与目录：读写搜 + 工作目录。
 import type { ToolPack } from "../types.ts";
 
 export const FS_PACK: ToolPack = {
@@ -9,6 +9,7 @@ export const FS_PACK: ToolPack = {
     { tool: "edit", short: "按精确匹配替换文件片段" },
     { tool: "glob", short: "按模式查找文件路径" },
     { tool: "grep", short: "按正则搜索文件内容" },
+    { tool: "working_directory", short: "查看当前工作目录，或用 cd 切换" },
     { tool: "read_image", short: "读取图片内容" },
     { tool: "str_replace_editor", short: "查看 / 创建 / 精确替换文件" },
   ],

package/src/guidance/packs/group-base.ts

@@ -33,6 +33,10 @@ export const BASE_GROUP: GroupPack = {
         when: "grep",
         text: "grep：按内容搜索（不要用 shell grep / rg）；需要上下文再 read 命中的文件。",
       },
+      {
+        when: "working_directory",
+        text: "working_directory：查会话当前工作目录，或传 cd 切到某个已存在的目录——切完相对路径都按它解析；已开的 shell 与在跑进程留在自己的目录里，不受这次切换影响。",
+      },
       {
         when: "bash",
         text: "bash：执行命令。使用参数 workdir，默认是你的工作目录，严禁使用 `cd`；非零退出会标 [exit code: N]，先查清失败原因再继续。",
@@ -92,6 +96,7 @@ export const BASE_GROUP: GroupPack = {
       "str_replace_editor",
       "glob",
       "grep",
+      "working_directory",
       "bash",
       "pwsh",
       "ask_user_question",