@zmzai/agent-framework 0.1.0 → 0.2.1

package/dist/core/mcp/http-client.js

@@ -0,0 +1,385 @@
+const UA = "zmzai-agent-framework/0.1";
+const DEFAULT_TIMEOUT = 30_000;
+function parseSseData(data) {
+    try {
+        const parsed = JSON.parse(data);
+        return typeof parsed === "object" && parsed !== null && !Array.isArray(parsed) ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** 增量 SSE 帧解析：data:/event:/id: 行、空行分帧、`:` 开头为注释心跳。 */
+export function createSseParser(onEvent) {
+    let buffer = "";
+    let dataLines = [];
+    let eventName = null;
+    const flush = () => {
+        if (dataLines.length || eventName !== null)
+            onEvent({ event: eventName, data: dataLines.join("\n") });
+        dataLines = [];
+        eventName = null;
+    };
+    return (chunk) => {
+        buffer += chunk;
+        let index;
+        while ((index = buffer.indexOf("\n")) >= 0) {
+            const rawLine = buffer.slice(0, index).replace(/\r$/, "");
+            buffer = buffer.slice(index + 1);
+            if (rawLine === "") {
+                flush();
+                continue;
+            }
+            if (rawLine.startsWith(":"))
+                continue;
+            const colonAt = rawLine.indexOf(":");
+            const field = colonAt === -1 ? rawLine : rawLine.slice(0, colonAt);
+            let value = colonAt === -1 ? "" : rawLine.slice(colonAt + 1);
+            if (value.startsWith(" "))
+                value = value.slice(1);
+            if (field === "event")
+                eventName = value;
+            else if (field === "data")
+                dataLines.push(value);
+        }
+    };
+}
+async function httpError(response) {
+    let detail = "";
+    try {
+        detail = (await response.text()).slice(0, 300);
+    }
+    catch {
+        /* ignore */
+    }
+    throw new Error(`MCP HTTP 错误 ${response.status} ${response.statusText}${detail ? `：${detail}` : ""}`);
+}
+class PendingRegistry {
+    #nextIdValue = 1;
+    #pending = new Map();
+    get nextId() {
+        return this.#nextIdValue++;
+    }
+    register(id, timeoutMs, label) {
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.#pending.delete(id);
+                reject(new Error(`MCP 请求超时：${label}（${timeoutMs}ms）`));
+            }, timeoutMs);
+            this.#pending.set(id, { resolve: resolve, reject, timer });
+        });
+    }
+    settle(frame) {
+        if (typeof frame.id !== "number")
+            return false;
+        const pending = this.#pending.get(frame.id);
+        if (!pending)
+            return false;
+        this.#pending.delete(frame.id);
+        clearTimeout(pending.timer);
+        if (frame.error)
+            pending.reject(new Error(`MCP 错误 ${String(frame.error.code ?? "-")}: ${frame.error.message ?? "未知错误"}`));
+        else
+            pending.resolve(frame.result);
+        return true;
+    }
+    failAll(error) {
+        for (const [, p] of this.#pending) {
+            clearTimeout(p.timer);
+            p.reject(error);
+        }
+        this.#pending.clear();
+    }
+}
+// ---- streamable-http --------------------------------------------------------
+export class McpStreamableHttpClient {
+    #url;
+    #headers;
+    #timeoutMs;
+    #sessionId = null;
+    #closed = false;
+    constructor(url, opts = {}) {
+        this.#url = url;
+        this.#headers = opts.headers ?? {};
+        this.#timeoutMs = opts.requestTimeoutMs ?? DEFAULT_TIMEOUT;
+    }
+    async start() {
+        await this.request("initialize", { protocolVersion: "2024-11-05", capabilities: {}, clientInfo: { name: "zmzai-agent-framework", version: "0.1.0" } });
+        await this.notify("notifications/initialized");
+    }
+    async postJsonRpc(payload) {
+        const targetId = typeof payload.id === "number" ? payload.id : null;
+        const headers = {
+            "content-type": "application/json",
+            accept: "application/json, text/event-stream",
+            "user-agent": UA,
+            ...this.#headers,
+        };
+        if (this.#sessionId)
+            headers["mcp-session-id"] = this.#sessionId;
+        const response = await fetch(this.#url, { method: "POST", headers, body: JSON.stringify(payload), signal: AbortSignal.timeout(this.#timeoutMs) });
+        const sid = response.headers.get("mcp-session-id");
+        if (sid)
+            this.#sessionId = sid;
+        if (response.status === 202)
+            return undefined;
+        if (!response.ok)
+            await httpError(response);
+        const contentType = response.headers.get("content-type") ?? "";
+        if (contentType.includes("text/event-stream") && response.body) {
+            // SSE 应答：逐帧扫描直到目标 id 的响应出现或流关闭
+            return new Promise((resolve, reject) => {
+                const timer = setTimeout(() => {
+                    void response.body.cancel().catch(() => undefined);
+                    reject(new Error(`MCP 请求超时（流式应答 ${this.#timeoutMs}ms 无 ${targetId} 帧）`));
+                }, this.#timeoutMs);
+                const reader = response.body.getReader();
+                const decoder = new TextDecoder();
+                const parser = createSseParser((event) => {
+                    const frame = parseSseData(event.data);
+                    if (!frame || frame.id !== targetId)
+                        return;
+                    clearTimeout(timer);
+                    void reader.cancel().catch(() => undefined);
+                    if (frame.error)
+                        reject(new Error(`MCP 错误 ${String(frame.error.code ?? "-")}: ${frame.error.message ?? "未知错误"}`));
+                    else
+                        resolve(frame.result);
+                });
+                void (async () => {
+                    try {
+                        for (;;) {
+                            const { done, value } = await reader.read();
+                            if (done)
+                                break;
+                            parser(decoder.decode(value, { stream: true }));
+                        }
+                        clearTimeout(timer);
+                        reject(new Error("MCP 流式应答在收到结果前关闭"));
+                    }
+                    catch (error) {
+                        clearTimeout(timer);
+                        reject(error instanceof Error ? error : new Error(String(error)));
+                    }
+                })();
+            });
+        }
+        const text = await response.text();
+        const frame = parseSseData(text);
+        if (!frame)
+            throw new Error("MCP 响应不是合法 JSON-RPC 帧");
+        if (frame.id !== targetId && Array.isArray(frame))
+            throw new Error("MCP 批量响应暂不支持");
+        if (frame.error)
+            throw new Error(`MCP 错误 ${String(frame.error.code ?? "-")}: ${frame.error.message ?? "未知错误"}`);
+        return frame.result;
+    }
+    async request(method, params) {
+        if (this.#closed)
+            throw new Error(`MCP 连接不可用（${method}）`);
+        const id = Math.floor(Math.random() * 2 ** 31);
+        return this.postJsonRpc({ jsonrpc: "2.0", id, method, ...(params !== undefined ? { params } : {}) });
+    }
+    async notify(method, params) {
+        if (this.#closed)
+            return;
+        try {
+            await this.postJsonRpc({ jsonrpc: "2.0", method, ...(params !== undefined ? { params } : {}) });
+        }
+        catch (error) {
+            console.warn("[zmzai-agent-framework] mcp notify 失败：", error);
+        }
+    }
+    async listTools() {
+        return toolsFromResult(await this.request("tools/list"));
+    }
+    async callTool(name, args) {
+        return callFromResult(await this.request("tools/call", { name, arguments: args }));
+    }
+    close() {
+        this.#closed = true;
+    }
+}
+export function toolsFromResult(result) {
+    const container = (typeof result === "object" && result !== null ? result : {});
+    const rawTools = Array.isArray(container.tools) ? container.tools : [];
+    return rawTools.flatMap((tool) => {
+        if (typeof tool !== "object" || tool === null)
+            return [];
+        const record = tool;
+        if (typeof record.name !== "string")
+            return [];
+        return [{
+                name: record.name,
+                ...(typeof record.description === "string" ? { description: record.description } : {}),
+                ...(typeof record.inputSchema === "object" && record.inputSchema !== null ? { inputSchema: record.inputSchema } : {}),
+            }];
+    });
+}
+export function callFromResult(result) {
+    const container = (typeof result === "object" && result !== null ? result : {});
+    const isError = container.isError === true;
+    const text = Array.isArray(container.content)
+        ? container.content
+            .map((block) => (block.type === "text" && typeof block.text === "string" ? block.text : ""))
+            .filter(Boolean)
+            .join("\n")
+        : "";
+    return { text, isError };
+}
+// ---- sse（遗留传输）----------------------------------------------------------
+export class McpSseClient {
+    #url;
+    #headers;
+    #timeoutMs;
+    #registry = new PendingRegistry();
+    #endpointUrl = null;
+    #abort = null;
+    #closed = false;
+    constructor(url, opts = {}) {
+        this.#url = url;
+        this.#headers = opts.headers ?? {};
+        this.#timeoutMs = opts.requestTimeoutMs ?? DEFAULT_TIMEOUT;
+    }
+    async start() {
+        this.#abort = new AbortController();
+        const endpointReady = new Promise((resolveEndpoint, failHandshake) => {
+            const timer = setTimeout(() => failHandshake(new Error("MCP sse 握手超时（未收到 endpoint 事件）")), this.#timeoutMs);
+            timer.unref?.();
+            this.#onEndpointResolved = () => {
+                clearTimeout(timer);
+                resolveEndpoint();
+            };
+            this.#onHandshakeFail = (e) => {
+                clearTimeout(timer);
+                failHandshake(e);
+            };
+        });
+        try {
+            const response = await fetch(this.#url, {
+                headers: { accept: "text/event-stream", "user-agent": UA, ...this.#headers },
+                signal: this.#abort.signal,
+            });
+            if (!response.ok)
+                await httpError(response);
+            if (!response.body)
+                throw new Error("MCP sse 无响应体");
+            const parser = createSseParser((event) => this.#handleEvent(event.event, event.data));
+            void this.#pump(response, parser);
+            await endpointReady;
+            // initialized 通知：POST 到端点，202 即可
+            const ack = await this.postToEndpoint({ jsonrpc: "2.0", method: "notifications/initialized" });
+            if (!ack.ok && ack.status !== 202)
+                await httpError(ack);
+        }
+        catch (error) {
+            this.close();
+            throw error instanceof Error ? error : new Error(String(error));
+        }
+    }
+    #onEndpointResolved = null;
+    #onHandshakeFail = null;
+    async #pump(response, parser) {
+        const reader = response.body.getReader();
+        const decoder = new TextDecoder();
+        try {
+            for (;;) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                parser(decoder.decode(value, { stream: true }));
+            }
+        }
+        catch {
+            /* aborted */
+        }
+        finally {
+            reader.releaseLock();
+            if (this.#onEndpointResolved === null)
+                this.#registry.failAll(new Error("MCP sse 事件流已断开"));
+            else {
+                const failStart = this.#onHandshakeFail;
+                failStart?.(new Error("MCP sse 流在握手前断开"));
+            }
+        }
+    }
+    #handleEvent(eventName, data) {
+        if (eventName === "endpoint") {
+            // 端点提示常见两种形态：裸相对路径 与 JSON 字符串（如 "\"/mcp\""）；都接受
+            let hint = data.trim();
+            try {
+                const parsed = JSON.parse(hint);
+                if (typeof parsed === "string")
+                    hint = parsed;
+            }
+            catch {
+                /* 非 JSON 即裸路径 */
+            }
+            try {
+                this.#endpointUrl = new URL(hint, this.#url).toString();
+            }
+            catch {
+                return;
+            }
+            const resolver = this.#onEndpointResolved;
+            this.#onEndpointResolved = null;
+            resolver?.();
+            return;
+        }
+        const frame = parseSseData(data);
+        if (frame)
+            this.#registry.settle(frame);
+    }
+    async postToEndpoint(payload) {
+        if (!this.#endpointUrl)
+            throw new Error("MCP sse 端点尚未建立");
+        return fetch(this.#endpointUrl, {
+            method: "POST",
+            headers: { "content-type": "application/json", "user-agent": UA, ...this.#headers },
+            body: JSON.stringify(payload),
+            signal: AbortSignal.timeout(this.#timeoutMs),
+        });
+    }
+    async postedRequest(payload, label, registryId) {
+        if (registryId === null)
+            return undefined;
+        const waitPromise = this.#registry.register(registryId, this.#timeoutMs, label);
+        const response = await this.postToEndpoint(payload);
+        if (!response.ok && response.status !== 202)
+            await httpError(response);
+        return waitPromise;
+    }
+    async listTools() {
+        const id = this.#registry.nextId;
+        return toolsFromResult(await this.postedRequest({ jsonrpc: "2.0", id, method: "tools/list" }, "tools/list", id));
+    }
+    async callTool(name, args) {
+        const id = this.#registry.nextId;
+        return callFromResult(await this.postedRequest({ jsonrpc: "2.0", id, method: "tools/call", params: { name, arguments: args } }, `tools/call:${name}`, id));
+    }
+    async notifyInitialized() {
+        const ack = await this.postToEndpoint({ jsonrpc: "2.0", method: "notifications/initialized" });
+        if (!ack.ok && ack.status !== 202)
+            await httpError(ack);
+    }
+    close() {
+        this.#closed = true;
+        this.#abort?.abort();
+        this.#registry.failAll(new Error("MCP 连接已由宿主关闭"));
+    }
+    get closed() {
+        return this.#closed;
+    }
+}
+// ---- 装配入口 ----------------------------------------------------------------
+export function createMcpHttpClient(spec, opts = {}) {
+    switch (spec.type) {
+        case "streamable-http":
+            return new McpStreamableHttpClient(spec.url, { headers: spec.headers, requestTimeoutMs: opts.requestTimeoutMs });
+        case "sse":
+            return new McpSseClient(spec.url, { headers: spec.headers, requestTimeoutMs: opts.requestTimeoutMs });
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=http-client.js.map

package/dist/core/mcp/http-client.js.map

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

package/dist/core/mcp/servers.d.ts

@@ -0,0 +1,30 @@
+import type { ExternalToolDef } from "../tools/def.js";
+import type { PluginMcpServer } from "../agent/plugin.js";
+/** 把已解析的插件 mcp.json server 配置接成可用的 MCP 工具集：逐个启动
+ *  （stdio 子进程），listTools 后生成命名空间化的 ExternalToolDef。
+ *  单个 server 连不上不影响其它——错误进 statuses，由宿主决定透出方式。 */
+export type McpServerStatus = {
+    name: string;
+    state: "connected" | "error";
+    transport: string;
+    tools: string[];
+    error?: string;
+};
+export type McpServerEntry = {
+    name: string;
+    spec: PluginMcpServer;
+};
+export type McpPoolResult = {
+    /** 成功连接的 server 提供的工具（id 形如 mcp__<server>__<tool>）。 */
+    defs: ExternalToolDef[];
+    statuses: McpServerStatus[];
+    /** 统一关停（宿主退出时调用）。 */
+    dispose: () => void;
+};
+export type McpPoolOptions = {
+    connectTimeoutMs?: number;
+    /** stdio 命令白名单（P0 隔离）：透传给 McpStdioClient，basename 匹配。 */
+    allowedCommands?: string[];
+};
+export declare function startMcpServers(entries: McpServerEntry[], opts?: McpPoolOptions): Promise<McpPoolResult>;
+//# sourceMappingURL=servers.d.ts.map

package/dist/core/mcp/servers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"servers.d.ts","sourceRoot":"","sources":["../../../src/core/mcp/servers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAI1D;;kDAEkD;AAElD,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC;AAErE,MAAM,MAAM,aAAa,GAAG;IAC1B,uDAAuD;IACvD,IAAI,EAAE,eAAe,EAAE,CAAC;IACxB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,qBAAqB;IACrB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAoBF,MAAM,MAAM,cAAc,GAAG;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yDAAyD;IACzD,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B,CAAC;AA+BF,wBAAsB,eAAe,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,CA+BlH"}

package/dist/core/mcp/servers.js

@@ -0,0 +1,104 @@
+import { McpStdioClient } from "./client.js";
+import { createMcpHttpClient } from "./http-client.js";
+const idSafe = (value) => value.replace(/[^A-Za-z0-9_-]/g, "_");
+function sanitizeInputSchema(schema) {
+    if (!schema || typeof schema !== "object")
+        return { type: "object", properties: {}, additionalProperties: true };
+    return schema;
+}
+function summarizeArgs(args) {
+    try {
+        const json = JSON.stringify(args);
+        return json.length <= 2000 ? json : json.slice(0, 2000) + "…";
+    }
+    catch {
+        return "";
+    }
+}
+async function connectOne(entry, opts) {
+    let client;
+    if (entry.spec.type === "stdio") {
+        const stdio = new McpStdioClient({ command: entry.spec.command, args: entry.spec.args, env: entry.spec.env, cwd: entry.spec.cwd }, { connectTimeoutMs: opts.connectTimeoutMs, allowedCommands: opts.allowedCommands });
+        client = stdio;
+    }
+    else {
+        const http = createMcpHttpClient(entry.spec, { requestTimeoutMs: opts.connectTimeoutMs });
+        if (!http)
+            return { kind: "error", message: `不支持的 transport：${entry.spec.type}` };
+        client = http;
+    }
+    try {
+        await startHandshake(entry.spec, client);
+        const tools = await client.listTools();
+        return { kind: "ok", client, tools };
+    }
+    catch (error) {
+        client.close();
+        return { kind: "error", message: error.message };
+    }
+}
+/** 三种传输的握手统一化：stdio 客户端自带 start()；HTTP 两种在各自的实现里。 */
+async function startHandshake(_spec, client) {
+    const withStart = client;
+    if (typeof withStart.start === "function")
+        await withStart.start();
+}
+export async function startMcpServers(entries, opts = {}) {
+    const clients = new Map();
+    const defs = [];
+    const settled = await Promise.allSettled(entries.map((entry) => connectOne(entry, opts)));
+    const statuses = entries.map((entry, index) => {
+        const outcome = settled[index];
+        if (outcome.status === "fulfilled" && outcome.value.kind === "ok") {
+            const { client, tools } = outcome.value;
+            clients.set(entry.name, client);
+            for (const tool of tools) {
+                defs.push(mcpToolDef(entry, tool, client));
+            }
+            return { name: entry.name, state: "connected", transport: entry.spec.type, tools: tools.map((t) => t.name) };
+        }
+        const message = outcome.status === "rejected"
+            ? String(outcome.reason?.message ?? outcome.reason)
+            : outcome.value.kind === "error"
+                ? outcome.value.message
+                : "未知错误";
+        return { name: entry.name, state: "error", transport: entry.spec.type, tools: [], error: message };
+    });
+    return {
+        defs,
+        statuses,
+        dispose: () => {
+            for (const client of clients.values())
+                client.close();
+            clients.clear();
+        },
+    };
+}
+function mcpToolDef(entry, tool, client) {
+    const label = `${entry.name}/${tool.name}`;
+    const id = `mcp__${idSafe(entry.name)}__${idSafe(tool.name)}`;
+    return {
+        id,
+        label,
+        description: tool.description ?? `MCP 工具 ${label}`,
+        parametersJsonSchema: sanitizeInputSchema(tool.inputSchema),
+        permission: (args) => ({
+            permission: "mcp",
+            patterns: [`${entry.name}/${tool.name}`],
+            always: [`${entry.name}/*`],
+            metadata: { server: entry.name, tool: tool.name, argsSummary: summarizeArgs(args) },
+        }),
+        executionMode: "sequential",
+        async execute(args) {
+            const result = await client.callTool(tool.name, args);
+            if (result.isError)
+                throw new Error(result.text || `MCP 工具 ${label} 返回 isError`);
+            return {
+                title: label,
+                output: result.text || "（无文本输出）",
+                metadata: { server: entry.name, tool: tool.name },
+            };
+        },
+    };
+}
+//# sourceMappingURL=servers.js.map

package/dist/core/mcp/servers.js.map

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

package/dist/core/permission/ruleset.d.ts

@@ -16,7 +16,7 @@ export type PermissionConfig = Action | Record<string, Action | Record<string, A
 /** Well-known permission keys (spec §5.1). Tools may introduce additional keys
  *  (e.g. future MCP `server_*`); the engine treats keys as opaque strings and
  *  matches them with wildcards. */
-export declare const PERMISSIONS: readonly ["read", "edit", "bash", "glob", "grep", "list", "webfetch", "connector", "task", "todo", "external_directory"];
+export declare const PERMISSIONS: readonly ["read", "edit", "bash", "glob", "grep", "list", "webfetch", "connector", "task", "todo", "external_directory", "mcp", "git_read", "git_write", "terminal"];
 /** Converts config syntax into a flat ruleset. Key order in the config object
  *  is preserved, so later keys override earlier ones for overlapping matches. */
 export declare function rulesetFromConfig(config: PermissionConfig): Ruleset;

package/dist/core/permission/ruleset.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ruleset.d.ts","sourceRoot":"","sources":["../../../src/core/permission/ruleset.ts"],"names":[],"mappings":"AAAA;;;;;2BAK2B;AAE3B,MAAM,MAAM,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;AAE9C,MAAM,MAAM,IAAI,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAC/F,MAAM,MAAM,OAAO,GAAG,IAAI,EAAE,CAAC;AAE7B,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAExF;;mCAEmC;AACnC,eAAO,MAAM,WAAW,0HAYd,CAAC;AAEX;iFACiF;AACjF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAanE;AAED;;wEAEwE;AACxE,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAqBrE;AAED;0EAC0E;AAC1E,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAW9F"}
+{"version":3,"file":"ruleset.d.ts","sourceRoot":"","sources":["../../../src/core/permission/ruleset.ts"],"names":[],"mappings":"AAAA;;;;;2BAK2B;AAE3B,MAAM,MAAM,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;AAE9C,MAAM,MAAM,IAAI,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAC/F,MAAM,MAAM,OAAO,GAAG,IAAI,EAAE,CAAC;AAE7B,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAExF;;mCAEmC;AACnC,eAAO,MAAM,WAAW,sKAgBd,CAAC;AAEX;iFACiF;AACjF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAanE;AAED;;wEAEwE;AACxE,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAqBrE;AAED;0EAC0E;AAC1E,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAW9F"}

package/dist/core/permission/ruleset.js

@@ -19,6 +19,10 @@ export const PERMISSIONS = [
     "task",
     "todo",
     "external_directory",
+    "mcp", // MCP server 工具（patterns 为 server/tool）
+    "git_read", // git status/diff/log（只读，builtinDefaults 默认放行）
+    "git_write", // git commit（走审批）
+    "terminal", // 本机交互式终端 terminal_start（宿主机直接起进程，走审批）
 ];
 /** Converts config syntax into a flat ruleset. Key order in the config object
  *  is preserved, so later keys override earlier ones for overlapping matches. */

package/dist/core/permission/ruleset.js.map

@@ -1 +1 @@
-{"version":3,"file":"ruleset.js","sourceRoot":"","sources":["../../../src/core/permission/ruleset.ts"],"names":[],"mappings":"AAAA;;;;;2BAK2B;AAS3B;;mCAEmC;AACnC,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,MAAM;IACN,MAAM,EAAE,gCAAgC;IACxC,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,UAAU;IACV,WAAW;IACX,MAAM;IACN,MAAM;IACN,oBAAoB;CACZ,CAAC;AAEX;iFACiF;AACjF,MAAM,UAAU,iBAAiB,CAAC,MAAwB;IACxD,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3F,MAAM,KAAK,GAAY,EAAE,CAAC;IAC1B,KAAK,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACzD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1D,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtD,KAAK,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;wEAEwE;AACxE,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,KAAa;IAC1D,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC;IACd,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QACxB,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1E,CAAC,EAAE,CAAC;YACJ,CAAC,EAAE,CAAC;QACN,CAAC;aAAM,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YACpD,IAAI,GAAG,CAAC,EAAE,CAAC;YACX,SAAS,GAAG,CAAC,CAAC;QAChB,CAAC;aAAM,IAAI,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC;YACvB,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;YACb,CAAC,GAAG,EAAE,SAAS,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG;QAAE,CAAC,EAAE,CAAC;IACrD,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC;AAC9B,CAAC;AAED;0EAC0E;AAC1E,MAAM,UAAU,aAAa,CAAC,QAAmB,EAAE,UAAkB,EAAE,OAAe;IACpF,IAAI,MAAM,GAAW,KAAK,CAAC;IAC3B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE;gBAAE,SAAS;YACzE,IAAI,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;gBACvF,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"ruleset.js","sourceRoot":"","sources":["../../../src/core/permission/ruleset.ts"],"names":[],"mappings":"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"}

package/dist/core/permission/write-path.d.ts

@@ -0,0 +1,27 @@
+/** 子代理写路径隔离（tutorial-advanced 07-subagent retrofit / WritePathSet）：
+ *
+ *  子代理默认继承父代理的全部写权限——信任边界与父级相同。声明式白名单
+ *  （AgentInfo.writePaths）让 preset 自己声明"这个代理只允许写哪里"，
+ *  未声明则行为完全不变（opt-in，不破坏既有 preset 与 e2e）。
+ *
+ *  双层防御：
+ *  1. 权限层（writePathGuardRules）：利用 LAST matching rule wins——白名单
+ *     allow 规则在前、全局 edit deny 兜底排在规则集末尾，越界写被规则拒绝。
+ *  2. 结构层（confineWorkspaceFiles）：包住 workspace 门面，越界 write/edit
+ *     直接抛错——权限层管的是"审批"，结构层管的是"不可达"：即使未来新增
+ *     工具绕过权限引擎直接调 workspace，也无法越界写。
+ *
+ *  读/list 不受限：探索型子代理需要全库视野，只圈写。路径是 workspace 相对
+ *  字符串（与 WorkspaceFiles 契约一致），匹配复用规则集同款通配符，保证
+ *  权限层与结构层对"越界"的判定逐字节一致。 */
+import type { WorkspaceFiles } from "../tools/context.js";
+import { type Rule } from "./ruleset.js";
+/** 路径是否落在写路径白名单内：等于白名单根，或位于其子树。 */
+export declare function pathInWritePaths(p: string, writePaths: string[]): boolean;
+/** 写路径守卫规则：白名单 allow 在前，全局 edit deny 兜底在后。
+ *  LAST matching rule wins——兜底必须排在规则集最后才生效。 */
+export declare function writePathGuardRules(writePaths: string[]): Rule[];
+/** 结构层圈禁：包住 workspace 门面，越界 write/edit 直接抛错（不可绕过）。
+ *  read/list 保持原样——探索型子代理需要全库视野，只圈写。 */
+export declare function confineWorkspaceFiles(workspace: WorkspaceFiles, writePaths: string[]): WorkspaceFiles;
+//# sourceMappingURL=write-path.d.ts.map

package/dist/core/permission/write-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-path.d.ts","sourceRoot":"","sources":["../../../src/core/permission/write-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;4BAe4B;AAE5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAiB,KAAK,IAAI,EAAE,MAAM,cAAc,CAAC;AAExD,mCAAmC;AACnC,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAEzE;AAED;+CAC+C;AAC/C,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,CAMhE;AAED;wCACwC;AACxC,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,cAAc,CAiBrG"}