@tachu/extensions 1.0.0-alpha.1

package/dist/common/path.js

@@ -0,0 +1,76 @@
+import { resolve, relative, isAbsolute } from "node:path";
+import { ValidationError } from "@tachu/core";
+const PARENT_DIR_PREFIX = `..${"/"}`;
+/**
+ * 把用户输入路径规范化到允许的根目录集合之一。
+ *
+ * 沙箱层级自上而下：
+ *   1. `sandboxWaived === true` → 本次调用豁免，直接返回 `resolve(...)` 后的绝对路径；
+ *   2. 否则检查候选路径是否落在任意 `allowedRoots` 之下；全部不满足时抛出
+ *      `ValidationError(VALIDATION_PATH_ESCAPE)`。
+ *
+ * 该函数对"同时传入了相对路径与绝对路径"的语义：相对路径基于
+ * `allowedRoots[0]` 展开（通常就是 workspaceRoot），因为模型给出相对路径时
+ * 默认意图"相对工作区"；绝对路径则直接 resolve 后再做白名单判定。
+ *
+ * @throws ValidationError 当沙箱未豁免且候选路径不在任何允许的根下
+ */
+export const resolveAllowedPath = (targetPath, options) => {
+    const { allowedRoots, sandboxWaived } = options;
+    if (allowedRoots.length === 0) {
+        throw new ValidationError("VALIDATION_PATH_ESCAPE", "未配置任何允许的根目录：请检查宿主是否正确注入 allowedRoots。", { context: { targetPath } });
+    }
+    const primaryRoot = allowedRoots[0];
+    const candidate = isAbsolute(targetPath)
+        ? resolve(targetPath)
+        : resolve(primaryRoot, targetPath);
+    if (sandboxWaived === true) {
+        return candidate;
+    }
+    for (const root of allowedRoots) {
+        if (isInsideRoot(root, candidate)) {
+            return candidate;
+        }
+    }
+    throw new ValidationError("VALIDATION_PATH_ESCAPE", [
+        `路径越界：${targetPath} 不在任何允许的根目录内。`,
+        `允许的根：${allowedRoots.join(", ")}。`,
+        "可按以下任一方式放开该路径：",
+        "  1) 把目标改为相对路径（如 ./cat.txt）或上述根下的绝对路径；",
+        "  2) 在 tachu.config.ts 的 safety.allowedWriteRoots 追加该位置（静态白名单）；",
+        "  3) 如果该工具本身需要用户确认（requiresApproval），审批通过会一次性放行本次调用。",
+    ].join("\n"), {
+        context: { allowedRoots: [...allowedRoots], targetPath, candidate },
+    });
+};
+const isInsideRoot = (root, candidate) => {
+    const rel = relative(root, candidate);
+    if (rel.length === 0)
+        return true; // candidate === root
+    if (rel.startsWith(".."))
+        return false;
+    if (rel.includes(PARENT_DIR_PREFIX))
+        return false;
+    return true;
+};
+/**
+ * 旧签名兼容层：仅允许 `workspaceRoot` 一个根，不走审批豁免。
+ *
+ * @deprecated 新代码请改用 {@link resolveAllowedPath}，通过 `ToolExecutionContext.allowedRoots`
+ * 和 `ToolExecutionContext.sandboxWaived` 传递完整的白名单/审批状态。
+ */
+export const resolveWorkspacePath = (workspaceRoot, targetPath) => {
+    return resolveAllowedPath(targetPath, { allowedRoots: [workspaceRoot] });
+};
+/**
+ * 将绝对路径转换为相对工作区路径。
+ *
+ * @param workspaceRoot 工作区根目录
+ * @param absPath 绝对路径
+ * @returns 相对路径（POSIX 风格）
+ */
+export const toWorkspaceRelativePath = (workspaceRoot, absPath) => {
+    const rel = relative(workspaceRoot, absPath).replaceAll("\\", "/");
+    return rel.length === 0 ? "." : rel;
+};
+//# sourceMappingURL=path.js.map

package/dist/common/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../src/common/path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAuB9C,MAAM,iBAAiB,GAAG,KAAK,GAAG,EAAE,CAAC;AAErC;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,UAAkB,EAClB,OAAkC,EAC1B,EAAE;IACV,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;IAChD,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,eAAe,CACvB,wBAAwB,EACxB,uCAAuC,EACvC,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,EAAE,CAC5B,CAAC;IACJ,CAAC;IACD,MAAM,WAAW,GAAG,YAAY,CAAC,CAAC,CAAE,CAAC;IACrC,MAAM,SAAS,GAAG,UAAU,CAAC,UAAU,CAAC;QACtC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;QACrB,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IAErC,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,IAAI,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;YAClC,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,MAAM,IAAI,eAAe,CACvB,wBAAwB,EACxB;QACE,QAAQ,UAAU,eAAe;QACjC,QAAQ,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QAClC,gBAAgB;QAChB,wCAAwC;QACxC,iEAAiE;QACjE,sDAAsD;KACvD,CAAC,IAAI,CAAC,IAAI,CAAC,EACZ;QACE,OAAO,EAAE,EAAE,YAAY,EAAE,CAAC,GAAG,YAAY,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE;KACpE,CACF,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,SAAiB,EAAW,EAAE;IAChE,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACtC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,qBAAqB;IACxD,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,IAAI,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAAE,OAAO,KAAK,CAAC;IAClD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,aAAqB,EAAE,UAAkB,EAAU,EAAE;IACxF,OAAO,kBAAkB,CAAC,UAAU,EAAE,EAAE,YAAY,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;AAC3E,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,aAAqB,EAAE,OAAe,EAAU,EAAE;IACxF,MAAM,GAAG,GAAG,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACnE,OAAO,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;AACtC,CAAC,CAAC"}

package/dist/common/process.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 将流内容读取为字符串并限制最大字节数。
+ *
+ * @param stream 可读流
+ * @param maxBytes 最大字节数
+ * @returns 文本与截断标识
+ */
+export declare const readStreamWithLimit: (stream: ReadableStream<Uint8Array> | null | undefined, maxBytes: number) => Promise<{
+    text: string;
+    truncated: boolean;
+}>;
+/**
+ * 尝试优雅结束子进程，必要时强制杀死。
+ *
+ * @param pid 进程 PID
+ * @param graceMs SIGTERM 后等待时长
+ */
+export declare const terminateProcess: (pid: number, graceMs?: number) => Promise<void>;
+//# sourceMappingURL=process.d.ts.map

package/dist/common/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/common/process.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,SAAS,EACrD,UAAU,MAAM,KACf,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAwC9C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAU,KAAK,MAAM,EAAE,gBAAc,KAAG,OAAO,CAAC,IAAI,CAYhF,CAAC"}

package/dist/common/process.js

@@ -0,0 +1,67 @@
+/**
+ * 将流内容读取为字符串并限制最大字节数。
+ *
+ * @param stream 可读流
+ * @param maxBytes 最大字节数
+ * @returns 文本与截断标识
+ */
+export const readStreamWithLimit = async (stream, maxBytes) => {
+    if (!stream) {
+        return { text: "", truncated: false };
+    }
+    const reader = stream.getReader();
+    const chunks = [];
+    let total = 0;
+    let truncated = false;
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done) {
+            break;
+        }
+        if (!value) {
+            continue;
+        }
+        const room = maxBytes - total;
+        if (room <= 0) {
+            truncated = true;
+            break;
+        }
+        if (value.byteLength > room) {
+            chunks.push(value.subarray(0, room));
+            total += room;
+            truncated = true;
+            break;
+        }
+        chunks.push(value);
+        total += value.byteLength;
+    }
+    const merged = new Uint8Array(total);
+    let offset = 0;
+    for (const chunk of chunks) {
+        merged.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return { text: new TextDecoder().decode(merged), truncated };
+};
+/**
+ * 尝试优雅结束子进程，必要时强制杀死。
+ *
+ * @param pid 进程 PID
+ * @param graceMs SIGTERM 后等待时长
+ */
+export const terminateProcess = async (pid, graceMs = 3000) => {
+    try {
+        process.kill(pid, "SIGTERM");
+    }
+    catch {
+        return;
+    }
+    await new Promise((resolve) => setTimeout(resolve, graceMs));
+    try {
+        process.kill(pid, "SIGKILL");
+    }
+    catch {
+        // 进程已结束
+    }
+};
+//# sourceMappingURL=process.js.map

package/dist/common/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../src/common/process.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EACtC,MAAqD,EACrD,QAAgB,EAC+B,EAAE;IACjD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACxC,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;IAClC,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,IAAI,EAAE,CAAC;YACT,MAAM;QACR,CAAC;QACD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,QAAQ,GAAG,KAAK,CAAC;QAC9B,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;YACd,SAAS,GAAG,IAAI,CAAC;YACjB,MAAM;QACR,CAAC;QACD,IAAI,KAAK,CAAC,UAAU,GAAG,IAAI,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;YACrC,KAAK,IAAI,IAAI,CAAC;YACd,SAAS,GAAG,IAAI,CAAC;YACjB,MAAM;QACR,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnB,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC;IAC5B,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC;IAC7B,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;AAC/D,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EAAE,GAAW,EAAE,OAAO,GAAG,IAAI,EAAiB,EAAE;IACnF,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IACD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACnE,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,QAAQ;IACV,CAAC;AACH,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export { OpenAIProviderAdapter, AnthropicProviderAdapter, MockProviderAdapter, QwenProviderAdapter, type QwenChatRequest, type QwenImageParameters, } from "./providers";
+export { toolDescriptors, toolExecutors, type ToolExecutor, type ToolExecutionContext, } from "./tools";
+export { TerminalBackend, FileBackend, WebBackend } from "./backends";
+export { LocalFsVectorStore, QdrantVectorStore } from "./vector";
+export { ImageToTextTransformer, DocumentToTextTransformer } from "./transformers";
+export { McpStdioAdapter, McpSseAdapter } from "./mcp";
+export { OtelEmitter, JsonlEmitter } from "./observability";
+export { BUILTIN_RULE_DESCRIPTOR_PATHS } from "./rules";
+export { FsMemorySystem, sanitizeSessionId, type FsMemorySystemOptions } from "./memory";
+export { DEFAULT_SHELL_COMMAND_DENYLIST, matchesShellDenylist, withDefaultGate, type ApprovalProvider, type DefaultGatePolicies, type GateViolation, type GateViolationReason, type ShellCommandCheckInput, } from "./safety";
+export { configureNetSafety } from "./common/net";
+export { resolveAllowedPath, resolveWorkspacePath, toWorkspaceRelativePath, type ResolveAllowedPathOptions, } from "./common/path";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,eAAe,EACpB,KAAK,mBAAmB,GACzB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,eAAe,EACf,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,oBAAoB,GAC1B,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,6BAA6B,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,KAAK,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACzF,OAAO,EACL,8BAA8B,EAC9B,oBAAoB,EACpB,eAAe,EACf,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,GAC5B,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,EACvB,KAAK,yBAAyB,GAC/B,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+export { OpenAIProviderAdapter, AnthropicProviderAdapter, MockProviderAdapter, QwenProviderAdapter, } from "./providers";
+export { toolDescriptors, toolExecutors, } from "./tools";
+export { TerminalBackend, FileBackend, WebBackend } from "./backends";
+export { LocalFsVectorStore, QdrantVectorStore } from "./vector";
+export { ImageToTextTransformer, DocumentToTextTransformer } from "./transformers";
+export { McpStdioAdapter, McpSseAdapter } from "./mcp";
+export { OtelEmitter, JsonlEmitter } from "./observability";
+export { BUILTIN_RULE_DESCRIPTOR_PATHS } from "./rules";
+export { FsMemorySystem, sanitizeSessionId } from "./memory";
+export { DEFAULT_SHELL_COMMAND_DENYLIST, matchesShellDenylist, withDefaultGate, } from "./safety";
+export { configureNetSafety } from "./common/net";
+export { resolveAllowedPath, resolveWorkspacePath, toWorkspaceRelativePath, } from "./common/path";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,GAGpB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,eAAe,EACf,aAAa,GAGd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,6BAA6B,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAA8B,MAAM,UAAU,CAAC;AACzF,OAAO,EACL,8BAA8B,EAC9B,oBAAoB,EACpB,eAAe,GAMhB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,GAExB,MAAM,eAAe,CAAC"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,3 @@
+export { McpStdioAdapter } from "./stdio-adapter";
+export { McpSseAdapter } from "./sse-adapter";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/mcp/index.js

@@ -0,0 +1,3 @@
+export { McpStdioAdapter } from "./stdio-adapter";
+export { McpSseAdapter } from "./sse-adapter";
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/mcp/sse-adapter.d.ts

@@ -0,0 +1,82 @@
+import type { McpToolAdapter, ToolDescriptor } from "@tachu/core";
+interface McpSseAdapterOptions {
+    url: string;
+    headers?: Record<string, string>;
+    serverId?: string;
+    /**
+     * 单次 `callTool` 的默认超时（毫秒）。到期后会在 adapter 层 abort 下游请求
+     * 并抛出 "MCP sse request timed out" 错误。宿主显式传入 `0` 可关闭默认超时，
+     * 此时仅依赖调用方传入的 `AbortSignal`。详见 D1-LOW-08。
+     *
+     * @default 30_000
+     */
+    defaultTimeoutMs?: number;
+}
+/**
+ * MCP SSE 传输适配器。
+ */
+export declare class McpSseAdapter implements McpToolAdapter {
+    readonly transport: "sse";
+    private readonly options;
+    private readonly maxReconnectAttempts;
+    private readonly defaultTimeoutMs;
+    private client;
+    private transportImpl;
+    private reconnecting;
+    private closedManually;
+    private serverUri;
+    private readonly pendingRequests;
+    /**
+     * 创建 SSE MCP 适配器。
+     *
+     * @param options 连接配置
+     */
+    constructor(options: McpSseAdapterOptions);
+    /**
+     * 建立 SSE MCP 连接。
+     *
+     * @param serverUri 服务端地址（可覆盖构造参数）
+     */
+    connect(serverUri: string): Promise<void>;
+    /**
+     * 断开连接。
+     */
+    disconnect(): Promise<void>;
+    /**
+     * 列出远端工具并转换为 ToolDescriptor。
+     *
+     * @returns 工具描述符列表
+     */
+    listTools(): Promise<ToolDescriptor[]>;
+    /**
+     * 调用远端工具（core 协议方法）。
+     *
+     * @param name 工具名
+     * @param input 入参
+     * @returns 工具执行结果
+     */
+    executeTool(name: string, input: unknown, options?: {
+        signal?: AbortSignal;
+        requestId?: string;
+    }): Promise<unknown>;
+    /**
+     * 调用远端工具（支持 AbortSignal）。
+     *
+     * @param name 工具名
+     * @param input 入参
+     * @param signal 取消信号
+     * @param requestId 请求 ID（可选；用于后续 cancel 显式取消）
+     * @returns 执行结果
+     */
+    callTool(name: string, input: unknown, signal?: AbortSignal, requestId?: string): Promise<unknown>;
+    /**
+     * 取消请求（由调用方通过 signal 传播）。
+     *
+     * @param _requestId 请求 ID
+     */
+    cancel(requestId: string): Promise<void>;
+    private connectInternal;
+    private reconnectWithBackoff;
+}
+export {};
+//# sourceMappingURL=sse-adapter.d.ts.map

package/dist/mcp/sse-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-adapter.d.ts","sourceRoot":"","sources":["../../src/mcp/sse-adapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElE,UAAU,oBAAoB;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAQD;;GAEG;AACH,qBAAa,aAAc,YAAW,cAAc;IAClD,QAAQ,CAAC,SAAS,EAAG,KAAK,CAAU;IAEpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAK;IAC1C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,aAAa,CAAmC;IACxD,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsC;IAEtE;;;;OAIG;gBACS,OAAO,EAAE,oBAAoB;IAQzC;;;;OAIG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAWjC;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAuB5C;;;;;;OAMG;IACG,WAAW,CACf,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GACrD,OAAO,CAAC,OAAO,CAAC;IAInB;;;;;;;;OAQG;IACG,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,WAAW,EACpB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC;IA0DnB;;;;OAIG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAQhC,eAAe;YAoBf,oBAAoB;CAoBnC"}

package/dist/mcp/sse-adapter.js

@@ -0,0 +1,201 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";
+/** D1-LOW-08：默认 30s 的工具调用超时窗口。 */
+const DEFAULT_CALL_TIMEOUT_MS = 30_000;
+const createRequestId = () => `mcp-sse-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
+/**
+ * MCP SSE 传输适配器。
+ */
+export class McpSseAdapter {
+    transport = "sse";
+    options;
+    maxReconnectAttempts = 3;
+    defaultTimeoutMs;
+    client = null;
+    transportImpl = null;
+    reconnecting = false;
+    closedManually = false;
+    serverUri = "";
+    pendingRequests = new Map();
+    /**
+     * 创建 SSE MCP 适配器。
+     *
+     * @param options 连接配置
+     */
+    constructor(options) {
+        this.options = options;
+        this.defaultTimeoutMs =
+            options.defaultTimeoutMs === undefined
+                ? DEFAULT_CALL_TIMEOUT_MS
+                : Math.max(0, options.defaultTimeoutMs);
+    }
+    /**
+     * 建立 SSE MCP 连接。
+     *
+     * @param serverUri 服务端地址（可覆盖构造参数）
+     */
+    async connect(serverUri) {
+        this.serverUri = serverUri || this.options.url;
+        this.closedManually = false;
+        await this.connectInternal();
+    }
+    /**
+     * 断开连接。
+     */
+    async disconnect() {
+        this.closedManually = true;
+        for (const controller of this.pendingRequests.values()) {
+            controller.abort(new Error("MCP sse adapter disconnected"));
+        }
+        this.pendingRequests.clear();
+        await this.transportImpl?.close().catch(() => undefined);
+        this.transportImpl = null;
+        this.client = null;
+    }
+    /**
+     * 列出远端工具并转换为 ToolDescriptor。
+     *
+     * @returns 工具描述符列表
+     */
+    async listTools() {
+        if (!this.client) {
+            throw new Error("MCP sse adapter not connected");
+        }
+        const response = await this.client.listTools();
+        return response.tools.map((tool) => ({
+            kind: "tool",
+            name: tool.name,
+            description: tool.description ?? `mcp tool: ${tool.name}`,
+            sideEffect: tool.annotations?.readOnlyHint
+                ? "readonly"
+                : tool.annotations?.destructiveHint
+                    ? "irreversible"
+                    : "write",
+            idempotent: tool.annotations?.idempotentHint ?? false,
+            requiresApproval: tool.annotations?.destructiveHint ?? false,
+            timeout: 30_000,
+            inputSchema: tool.inputSchema,
+            outputSchema: tool.outputSchema,
+            execute: `mcp:${this.options.serverId ?? "sse"}:${tool.name}`,
+        }));
+    }
+    /**
+     * 调用远端工具（core 协议方法）。
+     *
+     * @param name 工具名
+     * @param input 入参
+     * @returns 工具执行结果
+     */
+    async executeTool(name, input, options) {
+        return this.callTool(name, input, options?.signal, options?.requestId);
+    }
+    /**
+     * 调用远端工具（支持 AbortSignal）。
+     *
+     * @param name 工具名
+     * @param input 入参
+     * @param signal 取消信号
+     * @param requestId 请求 ID（可选；用于后续 cancel 显式取消）
+     * @returns 执行结果
+     */
+    async callTool(name, input, signal, requestId) {
+        if (!this.client) {
+            throw new Error("MCP sse adapter not connected");
+        }
+        const mappedRequestId = requestId?.trim() ? requestId : createRequestId();
+        if (this.pendingRequests.has(mappedRequestId)) {
+            throw new Error(`MCP sse request already in progress: ${mappedRequestId}`);
+        }
+        const controller = new AbortController();
+        const onAbort = () => {
+            controller.abort(signal?.reason ?? new Error(`MCP sse request aborted: ${mappedRequestId}`));
+        };
+        if (signal?.aborted) {
+            onAbort();
+        }
+        else {
+            signal?.addEventListener("abort", onAbort, { once: true });
+        }
+        // D1-LOW-08：为 callTool 套上 adapter 层默认超时，避免远端挂起拖垮引擎。
+        let timeoutHandle = null;
+        let timedOut = false;
+        if (this.defaultTimeoutMs > 0) {
+            timeoutHandle = setTimeout(() => {
+                timedOut = true;
+                controller.abort(new Error(`MCP sse request timed out after ${this.defaultTimeoutMs}ms: ${mappedRequestId}`));
+            }, this.defaultTimeoutMs);
+        }
+        this.pendingRequests.set(mappedRequestId, controller);
+        try {
+            const result = await this.client.callTool({ name, arguments: (input ?? {}) }, undefined, { signal: controller.signal });
+            return result;
+        }
+        catch (error) {
+            if (timedOut) {
+                throw new Error(`MCP sse request timed out after ${this.defaultTimeoutMs}ms: ${mappedRequestId}`);
+            }
+            throw error;
+        }
+        finally {
+            if (timeoutHandle !== null) {
+                clearTimeout(timeoutHandle);
+            }
+            signal?.removeEventListener("abort", onAbort);
+            this.pendingRequests.delete(mappedRequestId);
+        }
+    }
+    /**
+     * 取消请求（由调用方通过 signal 传播）。
+     *
+     * @param _requestId 请求 ID
+     */
+    async cancel(requestId) {
+        const controller = this.pendingRequests.get(requestId);
+        if (!controller) {
+            return;
+        }
+        controller.abort(new Error(`MCP sse request cancelled: ${requestId}`));
+    }
+    async connectInternal() {
+        const target = this.serverUri || this.options.url;
+        this.client = new Client({ name: "tachu-mcp-sse", version: "1.0.0" });
+        this.transportImpl = new SSEClientTransport(new URL(target), {
+            ...(this.options.headers
+                ? {
+                    requestInit: {
+                        headers: this.options.headers,
+                    },
+                }
+                : {}),
+        });
+        this.transportImpl.onclose = () => {
+            if (!this.closedManually) {
+                void this.reconnectWithBackoff();
+            }
+        };
+        await this.client.connect(this.transportImpl);
+    }
+    async reconnectWithBackoff() {
+        if (this.reconnecting || this.closedManually) {
+            return;
+        }
+        this.reconnecting = true;
+        try {
+            for (let attempt = 0; attempt < this.maxReconnectAttempts; attempt += 1) {
+                const delay = 200 * 2 ** attempt;
+                await new Promise((resolve) => setTimeout(resolve, delay));
+                try {
+                    await this.connectInternal();
+                    return;
+                }
+                catch {
+                    // retry
+                }
+            }
+        }
+        finally {
+            this.reconnecting = false;
+        }
+    }
+}
+//# sourceMappingURL=sse-adapter.js.map

package/dist/mcp/sse-adapter.js.map

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

package/dist/mcp/stdio-adapter.d.ts

@@ -0,0 +1,85 @@
+import type { McpToolAdapter, ToolDescriptor } from "@tachu/core";
+interface McpStdioAdapterOptions {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+    serverId?: string;
+    /**
+     * 单次 `callTool` 的默认超时（毫秒）。到期后会在 adapter 层 abort 下游请求
+     * 并抛出 "MCP stdio request timed out" 错误。宿主显式传入 `0` 可关闭默认超时，
+     * 此时仅依赖调用方传入的 `AbortSignal`。详见 D1-LOW-08。
+     *
+     * @default 30_000
+     */
+    defaultTimeoutMs?: number;
+}
+/**
+ * MCP stdio 传输适配器。
+ */
+export declare class McpStdioAdapter implements McpToolAdapter {
+    readonly transport: "stdio";
+    private readonly options;
+    private readonly maxReconnectAttempts;
+    private readonly defaultTimeoutMs;
+    private client;
+    private transportImpl;
+    private reconnecting;
+    private closedManually;
+    private connected;
+    private serverUri;
+    private readonly pendingRequests;
+    /**
+     * 创建 stdio MCP 适配器。
+     *
+     * @param options stdio 启动参数
+     */
+    constructor(options: McpStdioAdapterOptions);
+    /**
+     * 建立 MCP 连接。
+     *
+     * @param serverUri 服务端 URI（可留空）
+     */
+    connect(serverUri: string): Promise<void>;
+    /**
+     * 断开连接。
+     */
+    disconnect(): Promise<void>;
+    /**
+     * 列出远端工具并映射为引擎 ToolDescriptor。
+     *
+     * @returns 工具描述符数组
+     */
+    listTools(): Promise<ToolDescriptor[]>;
+    /**
+     * 调用远端工具（core 协议方法）。
+     *
+     * @param name 工具名
+     * @param input 入参
+     * @returns 工具执行结果
+     */
+    executeTool(name: string, input: unknown, options?: {
+        signal?: AbortSignal;
+        requestId?: string;
+    }): Promise<unknown>;
+    /**
+     * 调用远端工具（支持 AbortSignal）。
+     *
+     * @param name 工具名
+     * @param input 入参
+     * @param signal 取消信号
+     * @param requestId 请求 ID（可选；用于后续 cancel 显式取消）
+     * @returns 工具执行结果
+     */
+    callTool(name: string, input: unknown, signal?: AbortSignal, requestId?: string): Promise<unknown>;
+    /**
+     * 按 requestId 取消请求（通过信号机制由调用方透传）。
+     *
+     * @param _requestId 请求 ID
+     */
+    cancel(requestId: string): Promise<void>;
+    private connectInternal;
+    private reconnectWithBackoff;
+}
+export {};
+//# sourceMappingURL=stdio-adapter.d.ts.map

package/dist/mcp/stdio-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio-adapter.d.ts","sourceRoot":"","sources":["../../src/mcp/stdio-adapter.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElE,UAAU,sBAAsB;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAQD;;GAEG;AACH,qBAAa,eAAgB,YAAW,cAAc;IACpD,QAAQ,CAAC,SAAS,EAAG,OAAO,CAAU;IAEtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAK;IAC1C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,aAAa,CAAqC;IAC1D,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsC;IAEtE;;;;OAIG;gBACS,OAAO,EAAE,sBAAsB;IAQ3C;;;;OAIG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAYjC;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAuB5C;;;;;;OAMG;IACG,WAAW,CACf,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GACrD,OAAO,CAAC,OAAO,CAAC;IAInB;;;;;;;;OAQG;IACG,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,WAAW,EACpB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC;IA0DnB;;;;OAIG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAQhC,eAAe;YAqBf,oBAAoB;CAoBnC"}