@tachu/extensions 1.0.0-beta.1

package/dist/tools/apply-patch/executor.d.ts

@@ -0,0 +1,19 @@
+import type { ToolExecutor } from "../shared";
+interface ApplyPatchInput {
+    patch: string;
+    basePath?: string;
+}
+interface ApplyPatchOutput {
+    applied: Array<{
+        file: string;
+        status: "ok" | "failed";
+        reason?: string;
+    }>;
+    success: boolean;
+}
+/**
+ * 应用 unified diff Tool 执行器。
+ */
+export declare const applyPatchExecutor: ToolExecutor<ApplyPatchInput, ApplyPatchOutput>;
+export {};
+//# sourceMappingURL=executor.d.ts.map

package/dist/tools/apply-patch/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/tools/apply-patch/executor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAI9C,UAAU,eAAe;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,gBAAgB;IACxB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,IAAI,GAAG,QAAQ,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3E,OAAO,EAAE,OAAO,CAAC;CAClB;AA2JD;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,YAAY,CAAC,eAAe,EAAE,gBAAgB,CA0E9E,CAAC"}

package/dist/tools/apply-patch/executor.js

@@ -0,0 +1,190 @@
+import { mkdir, readFile, writeFile, rm } from "node:fs/promises";
+import { dirname } from "node:path";
+import { ValidationError } from "@tachu/core";
+import { assertNotAborted } from "../shared";
+import { resolveWorkspacePath, toWorkspaceRelativePath } from "../../common/path";
+const normalizePatchPath = (value) => value.replace(/^[ab]\//, "").trim();
+const splitContent = (content) => {
+    if (content.length === 0) {
+        return { lines: [], trailingNewline: false };
+    }
+    const normalized = content.replaceAll("\r\n", "\n");
+    const trailingNewline = normalized.endsWith("\n");
+    const lines = normalized.split("\n");
+    if (trailingNewline) {
+        lines.pop();
+    }
+    return { lines, trailingNewline };
+};
+const parsePatch = (rawPatch) => {
+    const lines = rawPatch.replaceAll("\r\n", "\n").split("\n");
+    const files = [];
+    let index = 0;
+    while (index < lines.length) {
+        const line = lines[index] ?? "";
+        if (!line.startsWith("--- ")) {
+            index += 1;
+            continue;
+        }
+        const oldPath = normalizePatchPath(line.slice(4));
+        const newLine = lines[index + 1] ?? "";
+        if (!newLine.startsWith("+++ ")) {
+            throw new ValidationError("VALIDATION_PATCH_FORMAT", "patch 缺少 +++ 文件头");
+        }
+        const newPath = normalizePatchPath(newLine.slice(4));
+        index += 2;
+        const hunks = [];
+        while (index < lines.length) {
+            const hunkHeader = lines[index] ?? "";
+            if (hunkHeader.startsWith("--- ")) {
+                break;
+            }
+            if (!hunkHeader.startsWith("@@ ")) {
+                index += 1;
+                continue;
+            }
+            const match = /^@@ -(\d+)(?:,\d+)? \+(\d+)(?:,\d+)? @@/.exec(hunkHeader);
+            if (!match) {
+                throw new ValidationError("VALIDATION_PATCH_FORMAT", `无效 hunk 头: ${hunkHeader}`);
+            }
+            const oldStart = Number(match[1]);
+            const newStart = Number(match[2]);
+            index += 1;
+            const hunkLines = [];
+            while (index < lines.length) {
+                const hunkLine = lines[index] ?? "";
+                if (hunkLine.startsWith("@@ ") || hunkLine.startsWith("--- ")) {
+                    break;
+                }
+                if (hunkLine === "\") {
+                    index += 1;
+                    continue;
+                }
+                const marker = hunkLine[0];
+                if (marker !== " " && marker !== "+" && marker !== "-") {
+                    throw new ValidationError("VALIDATION_PATCH_FORMAT", `非法 hunk 行: ${hunkLine}`);
+                }
+                hunkLines.push({ type: marker, content: hunkLine.slice(1) });
+                index += 1;
+            }
+            hunks.push({ oldStart, newStart, lines: hunkLines });
+        }
+        files.push({ oldPath, newPath, hunks });
+    }
+    if (files.length === 0) {
+        throw new ValidationError("VALIDATION_PATCH_EMPTY", "patch 不包含任何文件");
+    }
+    return files;
+};
+const applyFilePatch = (original, patch) => {
+    const { lines: sourceLines, trailingNewline } = splitContent(original);
+    const result = [];
+    let cursor = 0;
+    for (const hunk of patch.hunks) {
+        const hunkStart = Math.max(0, hunk.oldStart - 1);
+        if (hunkStart < cursor) {
+            throw new ValidationError("VALIDATION_PATCH_CONFLICT", "patch hunk 重叠，无法应用");
+        }
+        result.push(...sourceLines.slice(cursor, hunkStart));
+        let sourceIndex = hunkStart;
+        for (const line of hunk.lines) {
+            if (line.type === " ") {
+                const actual = sourceLines[sourceIndex];
+                if (actual !== line.content) {
+                    throw new ValidationError("VALIDATION_PATCH_CONFLICT", `上下文不匹配: expected "${line.content}" got "${actual ?? "<eof>"}"`);
+                }
+                result.push(actual);
+                sourceIndex += 1;
+                continue;
+            }
+            if (line.type === "-") {
+                const actual = sourceLines[sourceIndex];
+                if (actual !== line.content) {
+                    throw new ValidationError("VALIDATION_PATCH_CONFLICT", `删除行不匹配: expected "${line.content}" got "${actual ?? "<eof>"}"`);
+                }
+                sourceIndex += 1;
+                continue;
+            }
+            result.push(line.content);
+        }
+        cursor = sourceIndex;
+    }
+    result.push(...sourceLines.slice(cursor));
+    return { content: result.join("\n"), trailingNewline };
+};
+/**
+ * 应用 unified diff Tool 执行器。
+ */
+export const applyPatchExecutor = async (input, context) => {
+    assertNotAborted(context.abortSignal);
+    const baseRoot = resolveWorkspacePath(context.workspaceRoot, input.basePath ?? ".");
+    const filePatches = parsePatch(input.patch);
+    const backups = new Map();
+    const applied = [];
+    const rollback = async () => {
+        for (const [path, snapshot] of backups.entries()) {
+            if (!snapshot.exists) {
+                await rm(path, { force: true }).catch(() => undefined);
+                continue;
+            }
+            await mkdir(dirname(path), { recursive: true });
+            const suffix = snapshot.trailingNewline ? "\n" : "";
+            await writeFile(path, `${snapshot.content}${suffix}`);
+        }
+    };
+    try {
+        for (const patch of filePatches) {
+            assertNotAborted(context.abortSignal);
+            const logicalTarget = patch.newPath === "/dev/null" ? patch.oldPath : patch.newPath;
+            const absoluteTarget = resolveWorkspacePath(baseRoot, logicalTarget);
+            if (!backups.has(absoluteTarget)) {
+                const existing = await readFile(absoluteTarget, "utf8").catch(() => null);
+                if (existing === null) {
+                    backups.set(absoluteTarget, { exists: false, content: "", trailingNewline: false });
+                }
+                else {
+                    const split = splitContent(existing);
+                    backups.set(absoluteTarget, {
+                        exists: true,
+                        content: split.lines.join("\n"),
+                        trailingNewline: split.trailingNewline,
+                    });
+                }
+            }
+            const original = backups.get(absoluteTarget)?.exists
+                ? (await readFile(absoluteTarget, "utf8").catch(() => "") ?? "")
+                : "";
+            const next = applyFilePatch(original, patch);
+            if (patch.newPath === "/dev/null") {
+                await rm(absoluteTarget, { force: true });
+            }
+            else {
+                await mkdir(dirname(absoluteTarget), { recursive: true });
+                const suffix = next.trailingNewline ? "\n" : "";
+                await writeFile(absoluteTarget, `${next.content}${suffix}`);
+            }
+            applied.push({
+                file: toWorkspaceRelativePath(context.workspaceRoot, absoluteTarget),
+                status: "ok",
+            });
+        }
+        return { applied, success: true };
+    }
+    catch (error) {
+        await rollback();
+        const reason = error instanceof Error ? error.message : String(error);
+        if (applied.length === 0) {
+            applied.push({ file: "<none>", status: "failed", reason });
+        }
+        else {
+            const previous = applied[applied.length - 1];
+            applied[applied.length - 1] = {
+                file: previous?.file ?? "<unknown>",
+                status: "failed",
+                reason,
+            };
+        }
+        return { applied, success: false };
+    }
+};
+//# sourceMappingURL=executor.js.map

package/dist/tools/apply-patch/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../src/tools/apply-patch/executor.ts"],"names":[],"mappings":"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"}

package/dist/tools/fetch-url/descriptor.md

@@ -0,0 +1,38 @@
+---
+kind: tool
+name: fetch-url
+description: 发送 HTTP 请求并返回响应内容
+sideEffect: readonly
+idempotent: false
+requiresApproval: false
+timeout: 15000
+inputSchema:
+  type: object
+  properties:
+    url:
+      type: string
+    method:
+      type: string
+      enum: [GET, POST]
+    headers:
+      type: object
+    body:
+      type: string
+    timeoutMs:
+      type: number
+  required: [url]
+outputSchema:
+  type: object
+  properties:
+    status:
+      type: number
+    headers:
+      type: object
+    body:
+      type: string
+    truncated:
+      type: boolean
+execute: fetch-url
+---
+
+执行受控网络请求，默认阻止私网地址并限制响应体大小。

package/dist/tools/fetch-url/executor.d.ts

@@ -0,0 +1,20 @@
+import type { ToolExecutor } from "../shared";
+interface FetchUrlInput {
+    url: string;
+    method?: "GET" | "POST";
+    headers?: Record<string, string>;
+    body?: string;
+    timeoutMs?: number;
+}
+interface FetchUrlOutput {
+    status: number;
+    headers: Record<string, string>;
+    body: string;
+    truncated: boolean;
+}
+/**
+ * URL 抓取 Tool 执行器。
+ */
+export declare const fetchUrlExecutor: ToolExecutor<FetchUrlInput, FetchUrlOutput>;
+export {};
+//# sourceMappingURL=executor.d.ts.map

package/dist/tools/fetch-url/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/tools/fetch-url/executor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAG9C,UAAU,aAAa;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,cAAc;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACpB;AAID;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,YAAY,CAAC,aAAa,EAAE,cAAc,CAgCxE,CAAC"}

package/dist/tools/fetch-url/executor.js

@@ -0,0 +1,34 @@
+import { assertPublicUrl, readResponseBodyWithLimit, withAbortTimeout } from "../../common/net";
+import { assertNotAborted } from "../shared";
+const MAX_BODY_BYTES = 5 * 1024 * 1024;
+/**
+ * URL 抓取 Tool 执行器。
+ */
+export const fetchUrlExecutor = async (input, context) => {
+    assertNotAborted(context.abortSignal);
+    const parsed = await assertPublicUrl(input.url);
+    const timeout = withAbortTimeout(context.abortSignal, input.timeoutMs ?? 15_000, "TIMEOUT_FETCH_URL");
+    try {
+        const response = await fetch(parsed, {
+            method: input.method ?? "GET",
+            headers: input.headers,
+            body: input.body,
+            signal: timeout.signal,
+        });
+        const bodyResult = await readResponseBodyWithLimit(response, MAX_BODY_BYTES);
+        const headers = {};
+        response.headers.forEach((value, key) => {
+            headers[key] = value;
+        });
+        return {
+            status: response.status,
+            headers,
+            body: bodyResult.body,
+            truncated: bodyResult.truncated,
+        };
+    }
+    finally {
+        timeout.cleanup();
+    }
+};
+//# sourceMappingURL=executor.js.map

package/dist/tools/fetch-url/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../src/tools/fetch-url/executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEhG,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAiB7C,MAAM,cAAc,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAEvC;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAgD,KAAK,EAChF,KAAK,EACL,OAAO,EACP,EAAE;IACF,gBAAgB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,gBAAgB,CAC9B,OAAO,CAAC,WAAW,EACnB,KAAK,CAAC,SAAS,IAAI,MAAM,EACzB,mBAAmB,CACpB,CAAC;IACF,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,EAAE;YACnC,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,KAAK;YAC7B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,yBAAyB,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;QAC7E,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YACtC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACvB,CAAC,CAAC,CAAC;QACH,OAAO;YACL,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,OAAO;YACP,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,SAAS,EAAE,UAAU,CAAC,SAAS;SAChC,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,OAAO,EAAE,CAAC;IACpB,CAAC;AACH,CAAC,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,12 @@
+import type { ToolDescriptor } from "@tachu/core";
+import type { ToolExecutor } from "./shared";
+/**
+ * 内置工具描述符列表。
+ */
+export declare const toolDescriptors: ToolDescriptor[];
+/**
+ * 工具执行函数注册表。
+ */
+export declare const toolExecutors: Record<string, ToolExecutor>;
+export type { ToolExecutor } from "./shared";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAS7C;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,cAAc,EAuK3C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAQtD,CAAC;AAEF,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,191 @@
+import { readFileExecutor } from "./read-file/executor";
+import { writeFileExecutor } from "./write-file/executor";
+import { listDirExecutor } from "./list-dir/executor";
+import { searchCodeExecutor } from "./search-code/executor";
+import { fetchUrlExecutor } from "./fetch-url/executor";
+import { runShellExecutor } from "./run-shell/executor";
+import { applyPatchExecutor } from "./apply-patch/executor";
+/**
+ * 内置工具描述符列表。
+ */
+export const toolDescriptors = [
+    {
+        kind: "tool",
+        name: "read-file",
+        description: "读取工作区内的文件内容",
+        sideEffect: "readonly",
+        idempotent: true,
+        requiresApproval: false,
+        timeout: 5000,
+        inputSchema: {
+            type: "object",
+            properties: {
+                path: { type: "string" },
+                encoding: { type: "string", enum: ["utf-8", "base64"] },
+            },
+            required: ["path"],
+        },
+        outputSchema: {
+            type: "object",
+            properties: { content: { type: "string" }, bytes: { type: "number" } },
+        },
+        execute: "read-file",
+    },
+    {
+        kind: "tool",
+        name: "write-file",
+        description: "写入工作区内文件内容",
+        sideEffect: "write",
+        idempotent: false,
+        requiresApproval: true,
+        timeout: 5000,
+        inputSchema: {
+            type: "object",
+            properties: {
+                path: { type: "string" },
+                content: { type: "string" },
+                encoding: { type: "string", enum: ["utf-8", "base64"] },
+                createDirs: { type: "boolean" },
+            },
+            required: ["path", "content"],
+        },
+        outputSchema: {
+            type: "object",
+            properties: { bytesWritten: { type: "number" } },
+        },
+        execute: "write-file",
+    },
+    {
+        kind: "tool",
+        name: "list-dir",
+        description: "列出工作区目录内容",
+        sideEffect: "readonly",
+        idempotent: true,
+        requiresApproval: false,
+        timeout: 3000,
+        inputSchema: {
+            type: "object",
+            properties: {
+                path: { type: "string" },
+                recursive: { type: "boolean" },
+                maxEntries: { type: "number" },
+                pattern: { type: "string" },
+            },
+            required: ["path"],
+        },
+        outputSchema: { type: "object", properties: { entries: { type: "array" } } },
+        execute: "list-dir",
+    },
+    {
+        kind: "tool",
+        name: "search-code",
+        description: "在工作区内按模式搜索代码",
+        sideEffect: "readonly",
+        idempotent: true,
+        requiresApproval: false,
+        timeout: 10000,
+        inputSchema: {
+            type: "object",
+            properties: {
+                pattern: { type: "string" },
+                path: { type: "string" },
+                fileGlob: { type: "string" },
+                maxResults: { type: "number" },
+                caseSensitive: { type: "boolean" },
+            },
+            required: ["pattern"],
+        },
+        outputSchema: { type: "object", properties: { matches: { type: "array" } } },
+        execute: "search-code",
+    },
+    {
+        kind: "tool",
+        name: "fetch-url",
+        description: "发送 HTTP 请求并返回响应内容",
+        sideEffect: "readonly",
+        idempotent: false,
+        requiresApproval: false,
+        timeout: 15000,
+        inputSchema: {
+            type: "object",
+            properties: {
+                url: { type: "string" },
+                method: { type: "string", enum: ["GET", "POST"] },
+                headers: { type: "object" },
+                body: { type: "string" },
+                timeoutMs: { type: "number" },
+            },
+            required: ["url"],
+        },
+        outputSchema: { type: "object", properties: { status: { type: "number" } } },
+        execute: "fetch-url",
+    },
+    {
+        kind: "tool",
+        name: "run-shell",
+        description: "在受控环境中执行 shell 命令",
+        sideEffect: "irreversible",
+        idempotent: false,
+        requiresApproval: true,
+        timeout: 30000,
+        inputSchema: {
+            type: "object",
+            properties: {
+                command: { type: "string" },
+                args: { type: "array", items: { type: "string" } },
+                cwd: { type: "string" },
+                env: { type: "object" },
+                timeoutMs: { type: "number" },
+            },
+            required: ["command"],
+        },
+        outputSchema: {
+            type: "object",
+            properties: {
+                stdout: { type: "string" },
+                stderr: { type: "string" },
+                exitCode: { type: "number" },
+                durationMs: { type: "number" },
+            },
+        },
+        execute: "run-shell",
+    },
+    {
+        kind: "tool",
+        name: "apply-patch",
+        description: "应用 unified diff 补丁并支持失败回滚",
+        sideEffect: "write",
+        idempotent: false,
+        requiresApproval: true,
+        timeout: 10000,
+        inputSchema: {
+            type: "object",
+            properties: {
+                patch: { type: "string" },
+                basePath: { type: "string" },
+            },
+            required: ["patch"],
+        },
+        outputSchema: {
+            type: "object",
+            properties: {
+                applied: { type: "array" },
+                success: { type: "boolean" },
+            },
+        },
+        execute: "apply-patch",
+    },
+];
+/**
+ * 工具执行函数注册表。
+ */
+export const toolExecutors = {
+    "read-file": readFileExecutor,
+    "write-file": writeFileExecutor,
+    "list-dir": listDirExecutor,
+    "search-code": searchCodeExecutor,
+    "fetch-url": fetchUrlExecutor,
+    "run-shell": runShellExecutor,
+    "apply-patch": applyPatchExecutor,
+};
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/list-dir/descriptor.md

@@ -0,0 +1,29 @@
+---
+kind: tool
+name: list-dir
+description: 列出工作区目录内容
+sideEffect: readonly
+idempotent: true
+requiresApproval: false
+timeout: 3000
+inputSchema:
+  type: object
+  properties:
+    path:
+      type: string
+    recursive:
+      type: boolean
+    maxEntries:
+      type: number
+    pattern:
+      type: string
+  required: [path]
+outputSchema:
+  type: object
+  properties:
+    entries:
+      type: array
+execute: list-dir
+---
+
+列出目录下文件和子目录，支持递归和结果数量限制。

package/dist/tools/list-dir/executor.d.ts

@@ -0,0 +1,22 @@
+import type { ToolExecutor } from "../shared";
+interface ListDirInput {
+    path: string;
+    recursive?: boolean;
+    maxEntries?: number;
+    pattern?: string;
+}
+interface ListDirEntry {
+    name: string;
+    type: "file" | "directory";
+    size?: number;
+}
+interface ListDirOutput {
+    entries: ListDirEntry[];
+    truncated: boolean;
+}
+/**
+ * 列目录 Tool 执行器。
+ */
+export declare const listDirExecutor: ToolExecutor<ListDirInput, ListDirOutput>;
+export {};
+//# sourceMappingURL=executor.d.ts.map

package/dist/tools/list-dir/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/tools/list-dir/executor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAG9C,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,UAAU,aAAa;IACrB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,YAAY,CAAC,YAAY,EAAE,aAAa,CAyCrE,CAAC"}

package/dist/tools/list-dir/executor.js

@@ -0,0 +1,46 @@
+import { readdir, stat } from "node:fs/promises";
+import { join } from "node:path";
+import { resolveWorkspacePath, toWorkspaceRelativePath } from "../../common/path";
+import { assertNotAborted } from "../shared";
+/**
+ * 列目录 Tool 执行器。
+ */
+export const listDirExecutor = async (input, context) => {
+    const recursive = input.recursive ?? false;
+    const maxEntries = input.maxEntries ?? 1000;
+    const matcher = input.pattern ? new RegExp(input.pattern) : undefined;
+    const root = resolveWorkspacePath(context.workspaceRoot, input.path);
+    const entries = [];
+    let truncated = false;
+    const walk = async (dir) => {
+        assertNotAborted(context.abortSignal);
+        const children = await readdir(dir, { withFileTypes: true });
+        for (const child of children) {
+            if (entries.length >= maxEntries) {
+                truncated = true;
+                return;
+            }
+            const absolute = join(dir, child.name);
+            const relative = toWorkspaceRelativePath(context.workspaceRoot, absolute);
+            if (matcher && !matcher.test(relative)) {
+                if (recursive && child.isDirectory()) {
+                    await walk(absolute);
+                }
+                continue;
+            }
+            if (child.isDirectory()) {
+                entries.push({ name: relative, type: "directory" });
+                if (recursive) {
+                    await walk(absolute);
+                }
+            }
+            else if (child.isFile()) {
+                const fileStat = await stat(absolute);
+                entries.push({ name: relative, type: "file", size: fileStat.size });
+            }
+        }
+    };
+    await walk(root);
+    return { entries, truncated };
+};
+//# sourceMappingURL=executor.js.map

package/dist/tools/list-dir/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../src/tools/list-dir/executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAElF,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAoB7C;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAA8C,KAAK,EAC7E,KAAK,EACL,OAAO,EACP,EAAE;IACF,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC;IAC3C,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,IAAI,CAAC;IAC5C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtE,MAAM,IAAI,GAAG,oBAAoB,CAAC,OAAO,CAAC,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACrE,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,MAAM,IAAI,GAAG,KAAK,EAAE,GAAW,EAAiB,EAAE;QAChD,gBAAgB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,IAAI,OAAO,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC;gBACjC,SAAS,GAAG,IAAI,CAAC;gBACjB,OAAO;YACT,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM,QAAQ,GAAG,uBAAuB,CAAC,OAAO,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;YAC1E,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACvC,IAAI,SAAS,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;oBACrC,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACvB,CAAC;gBACD,SAAS;YACX,CAAC;YACD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;gBACpD,IAAI,SAAS,EAAE,CAAC;oBACd,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC1B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACtC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;YACtE,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAChC,CAAC,CAAC"}