dominds 1.25.1 → 1.25.3

package/README.md

@@ -103,7 +103,8 @@ Supported proxy variables:
 Practical guidance:
 
 - Set both `HTTP_PROXY` and `HTTPS_PROXY` when your network uses the same proxy for both schemes. Lowercase forms also work.
-- Use `NO_PROXY` for localhost, loopback, and internal domains that should bypass the proxy.
+- Use `NO_PROXY` for hosts that should bypass the proxy. Node's built-in support includes exact hosts, suffix matches like `.company.com`, wildcard hosts like `*.company.com`, exact IPs, IP ranges like `192.168.1.1-192.168.1.100`, and `host:port` entries.
+- `NO_PROXY` syntax is not standardized across languages and clients. Do not assume CIDR notation such as `192.168.0.0/16` is supported unless the specific runtime documents it.
 - Values should be standard proxy URLs, for example `http://proxy.company.com:8080`.
 - If your shell already exports proxy variables, Dominds will read them too; clear unrelated proxy vars if you want a clean test environment.
 
@@ -113,13 +114,13 @@ Examples:
 # Windows PowerShell
 $env:HTTP_PROXY = "http://proxy.company.com:8080"
 $env:HTTPS_PROXY = "http://proxy.company.com:8080"
-$env:NO_PROXY = "localhost,127.0.0.1,.corp.local"
+$env:NO_PROXY = "localhost,127.0.0.1,.corp.local,192.168.1.1-192.168.1.100"
 dominds
 
 # macOS / Linux shell
 export HTTP_PROXY="http://proxy.company.com:8080"
 export HTTPS_PROXY="http://proxy.company.com:8080"
-export NO_PROXY="localhost,127.0.0.1,.corp.local"
+export NO_PROXY="localhost,127.0.0.1,.corp.local,192.168.1.1-192.168.1.100"
 dominds
 
 # Disable Dominds env-proxy handling

package/README.zh.md

@@ -57,7 +57,8 @@ Dominds 在 Windows、macOS、Linux 上都可以使用 Node 内建的环境变
 实践建议：
 
 - 若同一网络对 HTTP/HTTPS 都走同一代理，建议 `HTTP_PROXY` 和 `HTTPS_PROXY` 一起设置。小写变量名同样有效。
-- `NO_PROXY` 用于排除 localhost、回环地址和内网域名。
+- `NO_PROXY` 用于排除不经过代理的主机。Node 内置支持包括精确主机名、后缀匹配（如 `.company.com`）、通配主机（如 `*.company.com`）、精确 IP、IP 范围（如 `192.168.1.1-192.168.1.100`）以及带端口的主机名。
+- `NO_PROXY` 的语法在不同语言和客户端里并没有统一标准。除非目标运行时明确支持，不要把 CIDR 写法如 `192.168.0.0/16` 当成默认可用。
 - 代理值应使用标准 URL 形式，例如 `http://proxy.company.com:8080`。
 - 如果你的 shell 已经导出了代理变量，Dominds 也会读取它们；想要干净的测试环境时，请清掉无关的代理变量。
 
@@ -67,13 +68,13 @@ Dominds 在 Windows、macOS、Linux 上都可以使用 Node 内建的环境变
 # Windows PowerShell
 $env:HTTP_PROXY = "http://proxy.company.com:8080"
 $env:HTTPS_PROXY = "http://proxy.company.com:8080"
-$env:NO_PROXY = "localhost,127.0.0.1,.corp.local"
+$env:NO_PROXY = "localhost,127.0.0.1,.corp.local,192.168.1.1-192.168.1.100"
 dominds
 
 # macOS / Linux shell
 export HTTP_PROXY="http://proxy.company.com:8080"
 export HTTPS_PROXY="http://proxy.company.com:8080"
-export NO_PROXY="localhost,127.0.0.1,.corp.local"
+export NO_PROXY="localhost,127.0.0.1,.corp.local,192.168.1.1-192.168.1.100"
 dominds
 
 # 关闭 Dominds 的环境代理支持

package/dist/cli/tui.js

@@ -53,6 +53,7 @@ exports.main = main;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const log_1 = require("../log");
+const process_title_1 = require("../process-title");
 // Helper function to get package version
 function getPackageVersion() {
     try {
@@ -167,6 +168,7 @@ function parseArgs(argv) {
 }
 async function main() {
     try {
+        (0, process_title_1.setRtwsProcessTitle)();
         const args = parseArgs(process.argv.slice(2));
         // Handle version flag
         if (args.version) {

package/dist/cli/webui.js

@@ -16,6 +16,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.main = main;
 const child_process_1 = require("child_process");
 const log_1 = require("../log");
+const process_title_1 = require("../process-title");
 const work_language_1 = require("../runtime/work-language");
 const server_1 = require("../server");
 const auth_1 = require("../server/auth");
@@ -63,6 +64,7 @@ function openInBrowser(url) {
     (0, child_process_1.spawn)('xdg-open', [url], { stdio: 'ignore', detached: true }).unref();
 }
 async function main() {
+    (0, process_title_1.setRtwsProcessTitle)();
     const args = process.argv.slice(2);
     let port;
     let host = 'localhost';

package/dist/cli.js

@@ -82,6 +82,7 @@ const uninstall_1 = require("./cli/uninstall");
 const update_1 = require("./cli/update");
 const validate_team_def_1 = require("./cli/validate-team-def");
 const webui_1 = require("./cli/webui");
+const process_title_1 = require("./process-title");
 require("./tools/builtins");
 function configureEnvProxySupport() {
     const domindsUseEnvProxy = process.env.DOMINDS_USE_ENV_PROXY?.trim();
@@ -315,6 +316,7 @@ async function main() {
 }
 async function runSubcommand(subcommand, args) {
     try {
+        (0, process_title_1.setRtwsProcessTitle)();
         // Save original argv
         const originalArgv = process.argv;
         // Set argv to simulate direct execution of the subcommand

package/dist/process-title.d.ts

@@ -0,0 +1,2 @@
+export declare function setProcessTitle(title: string): void;
+export declare function setRtwsProcessTitle(rtwsRootAbs?: string): void;

package/dist/process-title.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setProcessTitle = setProcessTitle;
+exports.setRtwsProcessTitle = setRtwsProcessTitle;
+function setProcessTitle(title) {
+    const normalizedTitle = title.trim();
+    if (normalizedTitle === '')
+        return;
+    process.title = normalizedTitle;
+}
+function setRtwsProcessTitle(rtwsRootAbs = process.cwd()) {
+    setProcessTitle(`Dominds: ${rtwsRootAbs}`);
+}

package/dist/server/api-routes.js

@@ -1099,6 +1099,20 @@ async function handleApiRoute(req, res, pathname, context) {
                 return true;
             }
         }
+        if (pathname === '/api/dominds/self-update/check' && req.method === 'POST') {
+            try {
+                const status = await (0, dominds_self_update_1.checkLatestDomindsVersionNow)();
+                respondJson(res, 200, { success: true, update: status });
+                return true;
+            }
+            catch (error) {
+                respondJson(res, 409, {
+                    success: false,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+                return true;
+            }
+        }
         // Team configuration endpoint (renamed)
         if (pathname === '/api/team/config' && req.method === 'GET') {
             return await handleGetTeamConfig(res);

package/dist/server/dominds-self-update.d.ts

@@ -1,5 +1,6 @@
 import type { DomindsSelfUpdateStatus } from '@longrun-ai/kernel/types';
 type ServerMode = 'development' | 'production';
+export declare function checkLatestDomindsVersionNow(): Promise<DomindsSelfUpdateStatus>;
 export declare function configureDomindsSelfUpdate(params: {
     host: string;
     port: number;

package/dist/server/dominds-self-update.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkLatestDomindsVersionNow = checkLatestDomindsVersionNow;
 exports.configureDomindsSelfUpdate = configureDomindsSelfUpdate;
 exports.setDomindsSelfUpdateBroadcaster = setDomindsSelfUpdateBroadcaster;
 exports.getDomindsSelfUpdateStatus = getDomindsSelfUpdateStatus;
@@ -179,6 +180,22 @@ async function runBackgroundCheck() {
         scheduleBackgroundCheck(BACKGROUND_CHECK_INTERVAL_MS);
     }
 }
+async function checkLatestDomindsVersionNow() {
+    const cfg = assertRuntimeConfig();
+    if (cfg.mode !== 'production') {
+        return await getDomindsSelfUpdateStatus();
+    }
+    if (installPromise !== null || restartPromise !== null) {
+        return await getDomindsSelfUpdateStatus();
+    }
+    if (restartState.kind === 'restart_required' || restartState.kind === 'restarting') {
+        return await getDomindsSelfUpdateStatus();
+    }
+    latestObservation = await queryLatestVersion();
+    publishStatusUpdateSoon();
+    scheduleBackgroundCheck(BACKGROUND_CHECK_INTERVAL_MS);
+    return await getDomindsSelfUpdateStatus();
+}
 function assertRuntimeConfig() {
     if (runtimeConfig === null) {
         throw new Error('Dominds self-update runtime is not configured');

package/dist/team.js

@@ -586,11 +586,14 @@ exports.Team = Team;
             const resolved = [];
             const seen = new Set();
             const isAssignableToolset = (name) => (0, registry_1.getToolsetMeta)(name)?.assignable !== false;
+            const isWildcardAssignableToolset = (name) => (0, registry_1.getToolsetMeta)(name)?.wildcardAssignable !== false;
             for (const toolsetName of [...staticToolsets, ...dynamicToolsetNames]) {
                 if (toolsetName.startsWith('!'))
                     continue;
                 const toolsetNames = toolsetName === '*'
-                    ? Object.keys((0, registry_1.listToolsets)()).filter((n) => !excludedToolsets.has(n) && isAssignableToolset(n))
+                    ? Object.keys((0, registry_1.listToolsets)()).filter((n) => !excludedToolsets.has(n) &&
+                        isAssignableToolset(n) &&
+                        isWildcardAssignableToolset(n))
                     : excludedToolsets.has(toolsetName)
                         ? []
                         : [toolsetName];

package/dist/tools/builtins.js

@@ -54,8 +54,12 @@ function manualSpecFor(toolsetId) {
 (0, registry_1.registerTool)(fs_1.moveDirTool);
 (0, registry_1.registerTool)(fs_1.readSymlinkTool);
 (0, registry_1.registerTool)(fs_1.createSymlinkTool);
+(0, registry_1.registerTool)(fs_1.fsListDirTool);
+(0, registry_1.registerTool)(fs_1.fsReadSymlinkTool);
 (0, registry_1.registerTool)(txt_1.readFileTool);
+(0, registry_1.registerTool)(txt_1.fsReadFileTool);
 (0, registry_1.registerTool)(picture_1.readPictureTool);
+(0, registry_1.registerTool)(picture_1.fsReadPictureTool);
 (0, registry_1.registerTool)(picture_1.writePictureTool);
 (0, registry_1.registerTool)(txt_1.createNewFileTool);
 (0, registry_1.registerTool)(txt_1.overwriteEntireFileTool);
@@ -71,6 +75,11 @@ function manualSpecFor(toolsetId) {
 (0, registry_1.registerTool)(ripgrep_1.ripgrepCountTool);
 (0, registry_1.registerTool)(ripgrep_1.ripgrepFixedTool);
 (0, registry_1.registerTool)(ripgrep_1.ripgrepSearchTool);
+(0, registry_1.registerTool)(ripgrep_1.fsRipgrepFilesTool);
+(0, registry_1.registerTool)(ripgrep_1.fsRipgrepSnippetsTool);
+(0, registry_1.registerTool)(ripgrep_1.fsRipgrepCountTool);
+(0, registry_1.registerTool)(ripgrep_1.fsRipgrepFixedTool);
+(0, registry_1.registerTool)(ripgrep_1.fsRipgrepSearchTool);
 // OS tools
 (0, registry_1.registerTool)(os_1.shellCmdTool);
 (0, registry_1.registerTool)(os_1.readonlyShellTool);
@@ -252,6 +261,27 @@ for (const tool of team_mgmt_1.teamMgmtTools) {
     promptFilesI18n: promptFilesFor('ws_read'),
     manualSpec: manualSpecFor('ws_read'),
 });
+(0, registry_1.registerToolset)('fs_read', [
+    fs_1.fsListDirTool,
+    fs_1.fsReadSymlinkTool,
+    txt_1.fsReadFileTool,
+    picture_1.fsReadPictureTool,
+    ripgrep_1.fsRipgrepFilesTool,
+    ripgrep_1.fsRipgrepSnippetsTool,
+    ripgrep_1.fsRipgrepCountTool,
+    ripgrep_1.fsRipgrepFixedTool,
+    ripgrep_1.fsRipgrepSearchTool,
+]);
+(0, registry_1.setToolsetMeta)('fs_read', {
+    source: 'dominds',
+    wildcardAssignable: false,
+    descriptionI18n: {
+        en: 'Local filesystem read-only access without rtws path restriction: list directories, read text/images, and search files.',
+        zh: '本机文件系统只读访问，不限制路径必须位于 rtws 内：列目录、读文本/图片、检索文件。',
+    },
+    promptFilesI18n: promptFilesFor('fs_read'),
+    manualSpec: manualSpecFor('fs_read'),
+});
 (0, registry_1.registerToolset)('ws_mod', [
     fs_1.listDirTool,
     fs_1.rmDirTool,

package/dist/tools/fs.d.ts

@@ -1,10 +1,12 @@
 import type { FuncTool } from '../tool';
 export declare const listDirTool: FuncTool;
+export declare const fsListDirTool: FuncTool;
 export declare const rmDirTool: FuncTool;
 export declare const rmFileTool: FuncTool;
 export declare const mkDirTool: FuncTool;
 export declare const moveFileTool: FuncTool;
 export declare const moveDirTool: FuncTool;
 export declare const readSymlinkTool: FuncTool;
+export declare const fsReadSymlinkTool: FuncTool;
 export declare const createSymlinkTool: FuncTool;
 export declare const rmSymlinkTool: FuncTool;

package/dist/tools/fs.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.rmSymlinkTool = exports.createSymlinkTool = exports.readSymlinkTool = exports.moveDirTool = exports.moveFileTool = exports.mkDirTool = exports.rmFileTool = exports.rmDirTool = exports.listDirTool = void 0;
+exports.rmSymlinkTool = exports.createSymlinkTool = exports.fsReadSymlinkTool = exports.readSymlinkTool = exports.moveDirTool = exports.moveFileTool = exports.mkDirTool = exports.rmFileTool = exports.rmDirTool = exports.fsListDirTool = exports.listDirTool = void 0;
 /**
  * Module: tools/fs
  *
@@ -337,7 +337,7 @@ exports.listDirTool = {
                             : entry.type === 'symlink'
                                 ? '🔗'
                                 : '❓';
-                    const sizeStr = entry.size ? formatSize(entry.size) : '-';
+                    const sizeStr = entry.size === undefined ? '-' : formatSize(entry.size);
                     const linesStr = entry.lines ? entry.lines.toString() : '-';
                     const targetTypeStr = entry.type === 'symlink' && entry.symlinkResolvedType
                         ? ` (${entry.symlinkResolvedType})`
@@ -369,6 +369,220 @@ exports.listDirTool = {
         }
     },
 };
+exports.fsListDirTool = {
+    type: 'func',
+    name: 'fs_list_dir',
+    description: 'List local filesystem directory contents without restricting paths to rtws (runtime workspace).',
+    descriptionI18n: {
+        en: 'List local filesystem directory contents without restricting paths to rtws (runtime workspace).',
+        zh: '列出本机文件系统目录内容，不限制路径必须位于 rtws（运行时工作区）内。',
+    },
+    parameters: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+            path: {
+                type: 'string',
+                description: "Directory path to read. Absolute paths are accepted; relative paths resolve from the current process cwd. Defaults to '.'.",
+            },
+        },
+    },
+    argsValidation: 'dominds',
+    call: async (_dlg, _caller, args) => {
+        const workLanguage = (0, work_language_1.getWorkLanguage)();
+        const labels = workLanguage === 'zh'
+            ? {
+                notFound: (p) => `❌ **未找到**\n\n目录 \`${p}\` 不存在。`,
+                notDir: (p) => `❌ **错误**\n\n路径 \`${p}\` 不是目录。`,
+                readDirFailed: (msg) => `❌ **错误**\n\n读取目录失败：${msg}`,
+                dirHeader: '📁 **目录：**',
+                symlinkPathNotice: (p, target) => target
+                    ? `🔗 **说明：** \`${p}\` 是符号链接（→ \`${target}\`），已按目录跟随读取。`
+                    : `🔗 **说明：** \`${p}\` 是符号链接，已按目录跟随读取。`,
+                emptyDir: '_此目录为空。_',
+                table: {
+                    name: '名称',
+                    type: '类型',
+                    size: '大小',
+                    lines: '行数',
+                    target: '目标',
+                },
+            }
+            : {
+                notFound: (p) => `❌ **Not Found**\n\nDirectory \`${p}\` does not exist.`,
+                notDir: (p) => `❌ **Error**\n\nPath \`${p}\` is not a directory.`,
+                readDirFailed: (msg) => `❌ **Error**\n\nFailed to read directory: ${msg}`,
+                dirHeader: '📁 **Directory:**',
+                symlinkPathNotice: (p, target) => target
+                    ? `🔗 **Note:** \`${p}\` is a symlink (→ \`${target}\`), and was followed as a directory.`
+                    : `🔗 **Note:** \`${p}\` is a symlink and was followed as a directory.`,
+                emptyDir: '_This directory is empty._',
+                table: {
+                    name: 'Name',
+                    type: 'Type',
+                    size: 'Size',
+                    lines: 'Lines',
+                    target: 'Target',
+                },
+            };
+        let requestedPath = '.';
+        const pathValue = args['path'];
+        if (typeof pathValue === 'string' && pathValue.trim() !== '') {
+            requestedPath = pathValue.trim();
+        }
+        const dir = path_1.default.resolve(process.cwd(), requestedPath);
+        const displayPath = path_1.default.isAbsolute(requestedPath) ? dir : requestedPath;
+        try {
+            let inputPathIsSymlink = false;
+            let inputPathSymlinkTarget;
+            try {
+                const statsInfo = await statWithSymlinkInfo(dir);
+                inputPathIsSymlink = statsInfo.isSymlink;
+                inputPathSymlinkTarget = statsInfo.symlinkTarget;
+                if (!statsInfo.followStat.isDirectory()) {
+                    return fail(labels.notDir(displayPath));
+                }
+            }
+            catch (error) {
+                if (typeof error === 'object' &&
+                    error !== null &&
+                    'code' in error &&
+                    error.code === 'ENOENT') {
+                    return fail(labels.notFound(displayPath));
+                }
+                const msg = error instanceof Error ? error.message : String(error);
+                return fail(labels.readDirFailed(msg));
+            }
+            const entries = await promises_1.default.readdir(dir, { withFileTypes: true });
+            const data = [];
+            for (const entry of entries) {
+                const entryPath = path_1.default.join(dir, entry.name);
+                const dirEntry = {
+                    name: entry.name,
+                    type: 'other',
+                };
+                try {
+                    const stats = await promises_1.default.lstat(entryPath);
+                    if (entry.isDirectory()) {
+                        dirEntry.type = 'dir';
+                        dirEntry.size = stats.size;
+                    }
+                    else if (entry.isFile()) {
+                        dirEntry.type = 'file';
+                        dirEntry.size = stats.size;
+                        if (isTextFile(entry.name)) {
+                            dirEntry.lines = await countLines(entryPath);
+                        }
+                    }
+                    else if (entry.isSymbolicLink()) {
+                        dirEntry.type = 'symlink';
+                        dirEntry.size = stats.size;
+                        try {
+                            const target = await promises_1.default.readlink(entryPath);
+                            dirEntry.target = target;
+                            try {
+                                const targetStats = await promises_1.default.stat(entryPath);
+                                if (targetStats.isDirectory()) {
+                                    dirEntry.symlinkResolvedType = 'dir';
+                                }
+                                else if (targetStats.isFile()) {
+                                    dirEntry.symlinkResolvedType = 'file';
+                                }
+                                else {
+                                    dirEntry.symlinkResolvedType = 'other';
+                                }
+                                if (targetStats.isFile() && (isTextFile(entry.name) || isTextFile(target))) {
+                                    dirEntry.lines = await countLines(entryPath);
+                                }
+                            }
+                            catch (err) {
+                                log_1.log.warn(`Failed to stat symlink target ${entryPath}:`, err);
+                                dirEntry.symlinkResolvedType = 'broken';
+                            }
+                        }
+                        catch (err) {
+                            log_1.log.warn(`Failed to read symlink ${entryPath}:`, err);
+                            dirEntry.target = '<unreadable>';
+                            dirEntry.symlinkResolvedType = 'other';
+                        }
+                    }
+                    else {
+                        dirEntry.type = 'other';
+                        dirEntry.size = stats.size;
+                    }
+                }
+                catch (_error) {
+                    if (entry.isDirectory()) {
+                        dirEntry.type = 'dir';
+                    }
+                    else if (entry.isFile()) {
+                        dirEntry.type = 'file';
+                    }
+                    else if (entry.isSymbolicLink()) {
+                        dirEntry.type = 'symlink';
+                        dirEntry.target = '<error>';
+                    }
+                }
+                data.push(dirEntry);
+            }
+            let markdown = `${labels.dirHeader} \`${displayPath}\`\n\n`;
+            if (inputPathIsSymlink) {
+                markdown += `${labels.symlinkPathNotice(displayPath, inputPathSymlinkTarget)}\n\n`;
+            }
+            if (data.length === 0) {
+                markdown += labels.emptyDir;
+            }
+            else {
+                const shownEntries = data.slice(0, LIST_DIR_MAX_RENDERED_ENTRIES);
+                const omittedEntries = Math.max(0, data.length - shownEntries.length);
+                if (omittedEntries > 0) {
+                    markdown +=
+                        workLanguage === 'zh'
+                            ? `⚠️ **说明：** 目录项过多；为避免输出过长，仅展示前 ${shownEntries.length} 项，省略 ${omittedEntries} 项。\n\n`
+                            : `⚠️ **Note:** Directory contains many entries; to keep the output bounded, showing the first ${shownEntries.length} entries and omitting ${omittedEntries}.\n\n`;
+                }
+                markdown += `| ${labels.table.name} | ${labels.table.type} | ${labels.table.size} | ${labels.table.lines} | ${labels.table.target} |\n`;
+                markdown += '|------|------|------|-------|--------|\n';
+                for (const entry of shownEntries) {
+                    const typeIcon = entry.type === 'dir'
+                        ? '📁'
+                        : entry.type === 'file'
+                            ? '📄'
+                            : entry.type === 'symlink'
+                                ? '🔗'
+                                : '❓';
+                    const sizeStr = entry.size === undefined ? '-' : formatSize(entry.size);
+                    const linesStr = entry.lines ? entry.lines.toString() : '-';
+                    const targetTypeStr = entry.type === 'symlink' && entry.symlinkResolvedType
+                        ? ` (${entry.symlinkResolvedType})`
+                        : '';
+                    const renderedName = (0, output_limit_1.truncateInlineText)(entry.name, LIST_DIR_NAME_CHAR_LIMIT);
+                    const targetStr = entry.target
+                        ? (0, output_limit_1.truncateInlineText)(`→ ${entry.target}${targetTypeStr}`, LIST_DIR_TARGET_CHAR_LIMIT)
+                        : '-';
+                    markdown += `| ${typeIcon} \`${renderedName}\` | ${entry.type} | ${sizeStr} | ${linesStr} | ${targetStr} |\n`;
+                }
+            }
+            return ok(markdown);
+        }
+        catch (error) {
+            if (typeof error === 'object' &&
+                error !== null &&
+                'code' in error &&
+                error.code === 'ENOENT') {
+                return fail(labels.notFound(displayPath));
+            }
+            if (typeof error === 'object' &&
+                error !== null &&
+                'code' in error &&
+                error.code === 'ENOTDIR') {
+                return fail(labels.notDir(displayPath));
+            }
+            const msg = error instanceof Error ? error.message : String(error);
+            return fail(labels.readDirFailed(msg));
+        }
+    },
+};
 exports.rmDirTool = {
     type: 'func',
     name: 'rm_dir',
@@ -1045,6 +1259,71 @@ exports.readSymlinkTool = {
         }
     },
 };
+exports.fsReadSymlinkTool = {
+    type: 'func',
+    name: 'fs_read_symlink',
+    description: 'Read a local filesystem symlink target without following it, without restricting paths to rtws.',
+    descriptionI18n: {
+        en: 'Read a local filesystem symlink target without following it, without restricting paths to rtws.',
+        zh: '读取本机文件系统符号链接目标（不跟随链接），不限制路径必须位于 rtws 内。',
+    },
+    parameters: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['path'],
+        properties: {
+            path: {
+                type: 'string',
+                description: 'Symlink path. Absolute paths are accepted; relative paths resolve from the current process cwd.',
+            },
+        },
+    },
+    argsValidation: 'dominds',
+    call: async (_dlg, _caller, args) => {
+        const pathValue = args['path'];
+        const requestedPath = typeof pathValue === 'string' ? pathValue.trim() : '';
+        if (!requestedPath) {
+            return failYaml([
+                `status: error`,
+                `mode: fs_read_symlink`,
+                `error: PATH_REQUIRED`,
+                `summary: ${yamlQuote('Fs-read-symlink failed: path required.')}`,
+            ].join('\n'));
+        }
+        const absPath = path_1.default.resolve(process.cwd(), requestedPath);
+        const displayPath = path_1.default.isAbsolute(requestedPath) ? absPath : requestedPath;
+        try {
+            const pathStat = await promises_1.default.lstat(absPath);
+            if (!pathStat.isSymbolicLink()) {
+                return failYaml([
+                    `status: error`,
+                    `mode: fs_read_symlink`,
+                    `path: ${yamlQuote(displayPath)}`,
+                    `error: NOT_SYMLINK`,
+                    `summary: ${yamlQuote('Fs-read-symlink failed: path is not a symlink.')}`,
+                ].join('\n'));
+            }
+            const target = await promises_1.default.readlink(absPath);
+            return okYaml([
+                `status: ok`,
+                `mode: fs_read_symlink`,
+                `path: ${yamlQuote(displayPath)}`,
+                `target: ${yamlQuote(target)}`,
+                `summary: ${yamlQuote(`Fs-read-symlink: ${displayPath} -> ${target}.`)}`,
+            ].join('\n'));
+        }
+        catch (error) {
+            const yaml = [
+                `status: error`,
+                `mode: fs_read_symlink`,
+                `path: ${yamlQuote(displayPath)}`,
+                `error: FAILED`,
+                `summary: ${yamlQuote(error instanceof Error ? error.message : String(error))}`,
+            ].join('\n');
+            return failYaml(yaml);
+        }
+    },
+};
 exports.createSymlinkTool = {
     type: 'func',
     name: 'create_symlink',

package/dist/tools/os.d.ts

@@ -6,8 +6,19 @@
  */
 import type { FuncTool, ReminderOwner } from '../tool';
 export declare function resetTrackedDaemonsForTests(): void;
+type ShellSpawnSpec = Readonly<{
+    command: string;
+    args: string[];
+    shellLabel: string;
+}>;
+export declare function resolveShellCmdSpawnSpecForTests(command: string, shell: string | undefined, platform: NodeJS.Platform): ShellSpawnSpec;
+export declare function resolveReadonlyShellSpawnSpecForTests(command: string, platform: NodeJS.Platform): Readonly<{
+    command: string;
+    args: string[];
+}>;
 export declare const shellCmdReminderOwner: ReminderOwner;
 export declare const shellCmdTool: FuncTool;
 export declare const readonlyShellTool: FuncTool;
 export declare const stopDaemonTool: FuncTool;
 export declare const getDaemonOutputTool: FuncTool;
+export {};