dominds 1.25.1 → 1.25.2

package/dist/tools/prompts/fs_read/en/errors.md

@@ -0,0 +1,6 @@
+# Errors
+
+- `PATH_REQUIRED`
+- `NOT_SYMLINK`
+- `NOT_FOUND`
+- `FAILED`

package/dist/tools/prompts/fs_read/en/index.md

@@ -0,0 +1,17 @@
+fs_read is Dominds' local-filesystem read-only toolset for reading and searching files outside rtws:
+
+- Directory listing
+- File reading
+- Symlink inspection
+- Content searching
+
+## Status
+
+- Status: Implemented
+- Main implementation files:
+  - Tool implementation: `dominds/main/tools/fs.ts`, `dominds/main/tools/txt.ts`, `dominds/main/tools/picture.ts`, `dominds/main/tools/ripgrep.ts`
+  - Toolset metadata: `dominds/main/tools/builtins.ts`, `dominds/main/tools/registry.ts`
+
+## Difference from ws_read
+
+`fs_read` exposes the same read-oriented capabilities as `ws_read`, but without the rtws path restriction.

package/dist/tools/prompts/fs_read/en/principles.md

@@ -0,0 +1,5 @@
+# Principles
+
+1. This toolset reads the local filesystem directly.
+2. It does not require paths to stay inside rtws.
+3. It remains read-only.

package/dist/tools/prompts/fs_read/en/scenarios.md

@@ -0,0 +1,3 @@
+# Scenarios
+
+Use `fs_read` when you need to inspect files outside the current rtws, such as a sibling checkout or a system path.

package/dist/tools/prompts/fs_read/en/tools.md

@@ -0,0 +1,11 @@
+# Tools
+
+- `fs_list_dir`
+- `fs_read_symlink`
+- `fs_read_file`
+- `fs_read_picture`
+- `fs_ripgrep_files`
+- `fs_ripgrep_snippets`
+- `fs_ripgrep_count`
+- `fs_ripgrep_fixed`
+- `fs_ripgrep_search`

package/dist/tools/prompts/fs_read/zh/errors.md

@@ -0,0 +1,6 @@
+# 错误
+
+- `PATH_REQUIRED`
+- `NOT_SYMLINK`
+- `NOT_FOUND`
+- `FAILED`

package/dist/tools/prompts/fs_read/zh/index.md

@@ -0,0 +1,17 @@
+fs_read 是 Dominds 的本机文件系统只读工具集，用于读取和搜索 rtws 之外的文件：
+
+- 目录查看
+- 文件读取
+- 符号链接检查
+- 内容搜索
+
+## 状态
+
+- 状态：已实现
+- 主要实现文件：
+  - 工具实现：`dominds/main/tools/fs.ts`、`dominds/main/tools/txt.ts`、`dominds/main/tools/picture.ts`、`dominds/main/tools/ripgrep.ts`
+  - toolset 元信息：`dominds/main/tools/builtins.ts`、`dominds/main/tools/registry.ts`
+
+## 与 ws_read 的区别
+
+`fs_read` 提供与 `ws_read` 相同的只读能力，但不要求路径必须位于 rtws 内。

package/dist/tools/prompts/fs_read/zh/principles.md

@@ -0,0 +1,5 @@
+# 原则
+
+1. 该工具集直接读取本机文件系统。
+2. 路径不必限制在 rtws 内。
+3. 仍然只读。

package/dist/tools/prompts/fs_read/zh/scenarios.md

@@ -0,0 +1,3 @@
+# 场景
+
+当你需要查看当前 rtws 之外的文件时，使用 `fs_read`，例如旁边的 checkout 或系统路径。

package/dist/tools/prompts/fs_read/zh/tools.md

@@ -0,0 +1,11 @@
+# 工具
+
+- `fs_list_dir`
+- `fs_read_symlink`
+- `fs_read_file`
+- `fs_read_picture`
+- `fs_ripgrep_files`
+- `fs_ripgrep_snippets`
+- `fs_ripgrep_count`
+- `fs_ripgrep_fixed`
+- `fs_ripgrep_search`

package/dist/tools/prompts/os/en/index.md

@@ -51,5 +51,5 @@ os is Dominds' **shell and process toolset** for executing system commands and m
 ⚠️ Shell command execution requires caution:
 
 - Avoid destructive commands (e.g., `rm -rf`)
-- Use absolute paths to avoid path injection
+- Use explicit paths to avoid path injection; on Windows, prefer forward-slash paths
 - Verify command output before executing follow-up operations

package/dist/tools/prompts/os/en/principles.md

@@ -71,7 +71,7 @@ Environment variables are system variables that affect process behavior.
 ### 1. Shell Command Security
 
 - **Validate input**: Use parameterized commands to avoid injection
-- **Use absolute paths**: Avoid relative path ambiguity
+- **Use explicit paths**: Avoid relative path ambiguity; on Windows, prefer forward-slash paths
 - **Check permissions**: Ensure sufficient permissions to execute commands
 
 ### 2. Process Management

package/dist/tools/prompts/os/en/scenarios.md

@@ -179,3 +179,24 @@ shell_cmd({
   command: 'free -m',
 });
 ```
+
+## Scenario 8: Windows Paths and PowerShell
+
+### Scenario Description
+
+Check files or run PowerShell commands on Windows.
+
+### Example
+
+```typescript
+// Default cmd.exe path: prefer forward slashes for no-space paths to avoid backslash and quote ambiguity
+shell_cmd({
+  command: 'if exist D:/AiWorks/chatgpt-workstation/dist/app.exe echo exists',
+});
+
+// Complex PowerShell command: choose PowerShell explicitly; Dominds encodes the command automatically
+shell_cmd({
+  command: 'Test-Path D:/AiWorks/chatgpt-workstation/dist/app.exe',
+  shell: 'powershell.exe',
+});
+```

package/dist/tools/prompts/os/en/tools.md

@@ -30,6 +30,12 @@ Execute Shell command.
 - `scrollbackLines` (optional): Number of recent output lines to retain in scrollback
 - `timeoutSeconds` (optional): Timeout in seconds before switching to daemon tracking
 
+**Windows notes:**
+
+- With the default `cmd.exe` path, prefer no-space forward-slash paths such as `D:/path/to/file`
+- For complex PowerShell commands, pass `shell: 'powershell.exe'` or `shell: 'pwsh'`; the command is encoded automatically to avoid quote and backslash ambiguity
+- Do not rely on nested `cmd /c "..."`
+
 **Returns:**
 
 ```yaml

package/dist/tools/prompts/os/zh/index.md

@@ -51,5 +51,5 @@ os 是 Dominds 的**命令行与进程工具集**，用于执行系统命令和
 ⚠️ Shell 命令执行需要谨慎操作：
 
 - 避免执行破坏性命令（如 `rm -rf`）
-- 使用绝对路径避免路径注入
+- 使用明确路径避免路径注入；Windows 下优先用正斜杠路径
 - 验证命令输出后再执行后续操作

package/dist/tools/prompts/os/zh/principles.md

@@ -71,7 +71,7 @@ Shell 命令执行允许智能体运行系统命令来完成各种任务。
 ### 1. Shell 命令安全
 
 - **验证输入**：使用参数化命令避免注入
-- **使用绝对路径**：避免相对路径歧义
+- **使用明确路径**：避免相对路径歧义；Windows 下优先用正斜杠路径
 - **检查权限**：确保有足够权限执行命令
 
 ### 2. 进程管理

package/dist/tools/prompts/os/zh/scenarios.md

@@ -179,3 +179,24 @@ shell_cmd({
   command: 'free -m',
 });
 ```
+
+## 场景 8：Windows 路径与 PowerShell
+
+### 场景描述
+
+在 Windows 上检查文件或运行 PowerShell 命令。
+
+### 示例
+
+```typescript
+// cmd.exe 默认路径：路径无空格时优先用正斜杠，避免反斜杠和引号歧义
+shell_cmd({
+  command: 'if exist D:/AiWorks/chatgpt-workstation/dist/app.exe echo exists',
+});
+
+// 复杂 PowerShell 命令：显式选择 PowerShell，系统会自动编码传递命令
+shell_cmd({
+  command: 'Test-Path D:/AiWorks/chatgpt-workstation/dist/app.exe',
+  shell: 'powershell.exe',
+});
+```

package/dist/tools/prompts/os/zh/tools.md

@@ -30,6 +30,12 @@
 - `scrollbackLines`（可选）：滚动回看里保留的最近输出行数
 - `timeoutSeconds`（可选）：超时秒数；超时后转为守护进程追踪
 
+**Windows 提示：**
+
+- 默认 `cmd.exe` 路径下，优先使用不带空格的正斜杠路径，如 `D:/path/to/file`
+- 复杂 PowerShell 命令建议显式传 `shell: 'powershell.exe'` 或 `shell: 'pwsh'`；系统会自动用编码方式传递命令，避免引号和反斜杠歧义
+- 不要依赖 `cmd /c "..."`
+
 **返回：**
 
 ```yaml

package/dist/tools/registry.d.ts

@@ -17,6 +17,12 @@ export type ToolsetMeta = {
      * system according to dialog scope rather than granted by team config.
      */
     assignable?: boolean;
+    /**
+     * Whether wildcard toolset expansion (`toolsets: ['*']`) may include this
+     * toolset. Defaults to true. Use false for explicitly grantable toolsets that
+     * should not be mass-assigned by wildcard baselines.
+     */
+    wildcardAssignable?: boolean;
     descriptionI18n?: I18nText;
     /**
      * Toolset-level prompt injected into the agent system prompt when the member

package/dist/tools/ripgrep.d.ts

@@ -1,6 +1,11 @@
 import type { FuncTool } from '../tool';
 export declare const ripgrepFilesTool: FuncTool;
+export declare const fsRipgrepFilesTool: FuncTool;
 export declare const ripgrepCountTool: FuncTool;
+export declare const fsRipgrepCountTool: FuncTool;
 export declare const ripgrepSnippetsTool: FuncTool;
+export declare const fsRipgrepSnippetsTool: FuncTool;
 export declare const ripgrepFixedTool: FuncTool;
+export declare const fsRipgrepFixedTool: FuncTool;
 export declare const ripgrepSearchTool: FuncTool;
+export declare const fsRipgrepSearchTool: FuncTool;