@zmzai/agent-framework 0.1.0 → 0.2.1

package/dist/adapters/terminal-backend.js

@@ -0,0 +1,153 @@
+import { spawn } from "node:child_process";
+import { isAbsolute, resolve } from "node:path";
+import { createRequire } from "node:module";
+let cachedBackend = null;
+/** 同步探测：node-pty 是 CJS 包，用 createRequire 从本模块位置解析——
+ *  异步 import().then(...) 会造成首启动时 backend.kind 尚未确定的竞态。 */
+function tryLoadNodePty() {
+    try {
+        // 变量名解析：框架不硬依赖 node-pty（可选原生依赖），缺失/ABI 不匹配时静默降级
+        const specifier = ["node", "pty"].join("-");
+        const mod = requireFromModuleContext(specifier);
+        return mod.default ?? mod;
+    }
+    catch {
+        return null;
+    }
+}
+const requireFromModuleContext = typeof import.meta?.url === "string" && import.meta.url !== "file://"
+    ? createRequire(
+    // 运行在编译后的 ESM/CJS 均可：从自身位置出发向上找最近 node_modules
+    (() => {
+        try {
+            return new URL("../adapters/", import.meta.url).href;
+        }
+        catch {
+            return process.cwd();
+        }
+    })())
+    : createRequire(process.cwd());
+/** 宿主终端后端单例：优先真 PTY，node-pty 不可用或 spawn 探测失败时降级管道模式。
+ *  首次调用即锁定后端种类（同步），session 标签从此不存在竞态。 */
+export function createHostTerminalBackend() {
+    if (!cachedBackend) {
+        const mod = tryLoadNodePty();
+        // 加载成功 ≠ 能用：新 Node 运行时与旧 node-pty 的 posix_spawnp 不兼容这类问题
+        // 只有真正 spawn 时才暴露，探测一次，失败永久降级 pipe（功能等价）。
+        cachedBackend = mod && probePtySpawn(mod) ? createNodePtyBackend(mod) : createPipeBackend();
+    }
+    return cachedBackend;
+}
+/** 同步 spawn 探测：能 fork /bin/sh -c true 即认为 pty 可用。 */
+function probePtySpawn(mod) {
+    try {
+        const term = mod.spawn("/bin/sh", ["-c", "true"], {
+            name: "xterm-256color",
+            cols: 20,
+            rows: 5,
+            cwd: process.cwd(),
+        });
+        term.kill();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** 统一 POSIX sh 执行（不用 $SHELL）：agent 语义需要可预测的语法方言，
+ *  fish/zsh 差异会造成同一条命令两种结果。 */
+function shell() {
+    if (process.platform === "win32")
+        return { file: "cmd.exe", prefixArgs: ["/d", "/s", "/c"] };
+    return { file: "/bin/sh", prefixArgs: ["-c"] };
+}
+/** 管道模式：detached 进程组 + 负值 pid 组杀，保证 npm run dev 这类带子进程的树能整树回收。 */
+function createPipeBackend() {
+    return {
+        kind: "pipe",
+        async start(input, hooks) {
+            const { file, prefixArgs } = shell();
+            const child = spawn(file, [...prefixArgs, input.command], {
+                cwd: input.cwd,
+                env: input.env ? { ...process.env, ...input.env } : undefined,
+                stdio: ["pipe", "pipe", "pipe"],
+                detached: process.platform !== "win32",
+            });
+            let exited = false;
+            const forward = (buf) => {
+                if (!exited)
+                    hooks.onData(buf.toString("utf8"));
+            };
+            child.stdout.on("data", forward);
+            child.stderr.on("data", forward);
+            child.on("error", (error) => {
+                if (!exited)
+                    hooks.onData(`\n[pipe] 进程启动失败：${error.message}\n`);
+            });
+            child.on("close", (code, signal) => {
+                exited = true;
+                hooks.onData(child.exitCode == null && signal ? `\n[终端被 ${signal} 终止]\n` : "");
+                hooks.onExit({ exitCode: code ?? child.exitCode ?? null, signal: signal ?? null });
+            });
+            const pid = child.pid;
+            return {
+                pid,
+                write(data) {
+                    if (!child.stdin?.destroyed)
+                        child.stdin.write(data);
+                },
+                kill(signal = "SIGTERM") {
+                    if (exited)
+                        return;
+                    try {
+                        if (pid != null && process.platform !== "win32")
+                            process.kill(-pid, signal);
+                        else
+                            child.kill(signal);
+                    }
+                    catch {
+                        child.kill("SIGKILL");
+                    }
+                },
+            };
+        },
+    };
+}
+function createNodePtyBackend(moduleRef) {
+    return {
+        kind: "pty",
+        async start(input, hooks) {
+            const cwdAbs = isAbsolute(input.cwd) ? input.cwd : resolve(input.cwd);
+            const { file, prefixArgs } = shell();
+            // 整条命令交给用户的 shell 执行（sh -c "<command>"）
+            const term = moduleRef.spawn(file, [...prefixArgs, input.command], {
+                name: "xterm-256color",
+                cols: input.cols ?? 120,
+                rows: input.rows ?? 30,
+                cwd: cwdAbs,
+                env: { ...process.env, ...(input.env ?? {}) },
+            });
+            wirePty(term, hooks);
+            return {
+                pid: term.pid,
+                write: (data) => term.write(data),
+                kill: (signal) => term.kill(signal),
+                resize: (cols, rows) => term.resize(cols, rows),
+            };
+        },
+    };
+}
+function wirePty(term, hooks) {
+    let exitSeen = false;
+    term.onData((chunk) => {
+        if (!exitSeen)
+            hooks.onData(chunk);
+    });
+    term.onExit(({ exitCode, signal }) => {
+        exitSeen = true;
+        // node-pty 正常退出时可能给 signal=0（数字），不是真的收到信号
+        const normalizedSignal = signal == null || Number(signal) === 0 || String(signal).trim() === "" ? null : String(signal);
+        hooks.onExit({ exitCode, signal: normalizedSignal });
+    });
+}
+//# sourceMappingURL=terminal-backend.js.map

package/dist/adapters/terminal-backend.js.map

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

package/dist/core/agent/registry.d.ts

@@ -15,6 +15,9 @@ export type AgentInfo = {
     prompt?: string;
     steps?: number;
     permission: Ruleset;
+    /** 写路径白名单（WritePathSet，07-subagent retrofit）：声明后该代理的
+     *  write/edit 被圈禁在白名单内；未声明则不限制（opt-in）。 */
+    writePaths?: string[];
 };
 export type AgentDefinition = Omit<AgentInfo, "permission"> & {
     permission: PermissionConfig;

package/dist/core/agent/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/core/agent/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,gBAAgB,EAAE,KAAK,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAClG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;oDAGoD;AAEpD,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,KAAK,CAAC;IACrC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG;IAAE,UAAU,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAmB/F,eAAO,MAAM,aAAa,EAAE,SAAS,EAiCpC,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,eAAe,EAAE,OAS5B,CAAC;AAEH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;gBAE3C,YAAY,GAAE,SAAS,EAAO;IAK1C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAInC,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,EAAE;IAQtF;;0CAEsC;IACtC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE;IAKpC;;;+EAG2E;IAC3E,MAAM,CAAC,WAAW,EAAE,SAAS,EAAE,GAAG,aAAa;IAM/C,mEAAmE;IACnE,IAAI,YAAY,IAAI,SAAS,EAAE,CAE9B;CACF"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/core/agent/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,gBAAgB,EAAE,KAAK,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAClG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;oDAGoD;AAEpD,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,KAAK,CAAC;IACrC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB;+CAC2C;IAC3C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG;IAAE,UAAU,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAoB/F,eAAO,MAAM,aAAa,EAAE,SAAS,EAiCpC,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,eAAe,EAAE,OAe5B,CAAC;AAEH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;gBAE3C,YAAY,GAAE,SAAS,EAAO;IAK1C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAInC,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,EAAE;IAQtF;;0CAEsC;IACtC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE;IAKpC;;;+EAG2E;IAC3E,MAAM,CAAC,WAAW,EAAE,SAAS,EAAE,GAAG,aAAa;IAM/C,mEAAmE;IACnE,IAAI,YAAY,IAAI,SAAS,EAAE,CAE9B;CACF"}

package/dist/core/agent/registry.js

@@ -3,10 +3,11 @@ function define(def) {
     return { ...def, permission: rulesetFromConfig(def.permission) };
 }
 const DEFAULT_PROMPT = "你是 ZMZAI Agent，一个会主动完成任务的 Coding Agent。可使用工具读取当前 Workspace，通过 write/edit 直接修改文件（每次修改生成可审查、可回滚的不可变版本），用 bash 在隔离沙箱中运行命令（stdout/stderr 会返回，生成的产物文件可下载）。\n" +
-    "工作方式：先 glob/read/grep 掌握 Workspace 现状，并用 todo 工具把任务拆成清单、边做边更新，再动手。对生成型任务（PPT、文档、脚本、报告等），不要只反问用户需求——基于已有信息自行决定合理的默认（主题、篇幅、风格、结构），直接写出生成脚本或内容 → 执行 → 校验产物 → 交付。只有信息确实无法推断、且追问明显比先交付默认方案更省事时，才问一两个关键问题，并同时给出你的默认方案。\n" +
+    "修复与重试原则：当质量检查或上一步失败时，只修复明确失败的项，不要重写或改动已通过的部分；修完只重新验证受影响的部分。避免全量重做——那会破坏已完成的成果并浪费步骤。\n" +
+    "工作方式：先用 repo_map 获取仓库结构地图（带 focus 可按任务相关性排序），再用 glob/read/grep 精准深入；用 todo 工具把任务拆成清单、边做边更新，再动手。对生成型任务（PPT、文档、脚本、报告等），不要只反问用户需求——基于已有信息自行决定合理的默认（主题、篇幅、风格、结构），直接写出生成脚本或内容 → 执行 → 校验产物 → 交付。只有信息确实无法推断、且追问明显比先交付默认方案更省事时，才问一两个关键问题，并同时给出你的默认方案。\n" +
     "不能声称执行了未调用的操作。用中文给出简洁、可核实的结果。";
 const READONLY_PROMPT = "你是 ZMZAI Agent 的只读分析模式。仅使用 read/glob/grep 工具读取当前 Workspace 并给出可核实的中文方案；你没有写入和执行权限，不能声称执行了任何修改。任务结束后用户可以在同一会话继续追问，或切换到 default 代理执行你的方案。";
-const EXPLORE_PROMPT = "你是代码库探索子代理。快速定位与任务相关的文件、符号与数据流，返回精确的 path:line 引用和简洁结论。你只读，不做任何修改。按要求的彻底程度（quick/medium/thorough）控制搜索范围。";
+const EXPLORE_PROMPT = "你是代码库探索子代理。先调用 repo_map（focus 传入任务关键词）获取结构地图，再按图索骡用 read/glob/grep 深入，快速定位与任务相关的文件、符号与数据流，返回精确的 path:line 引用和简洁结论。你只读，不做任何修改。按要求的彻底程度（quick/medium/thorough）控制搜索范围。";
 const GENERAL_PROMPT = "你是通用子任务代理。完成父代理交代的独立子任务，返回简洁、可核实的结果。不要反问父代理；信息不足时基于合理默认推进并说明假设。";
 export const builtinAgents = [
     define({
@@ -52,6 +53,12 @@ export const builtinDefaults = rulesetFromConfig({
     // cross a trust boundary and must be approved unless a user grants it.
     connector: "ask",
     edit: "allow",
+    git_read: "allow",
+    // commit 真实写仓库历史，默认问一次；用户可「总是允许」沉淀成规则
+    git_write: "ask",
+    mcp: "ask",
+    // 终端在用户本机直接起进程（无沙箱），至少问一次；always 允许按命令前缀沉淀
+    terminal: "ask",
 });
 export class AgentRegistry {
     agents = new Map();

package/dist/core/agent/registry.js.map

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

package/dist/core/events/manifest.d.ts

@@ -12,9 +12,9 @@ declare const todoItemSchema: z.ZodObject<{
         cancelled: "cancelled";
     }>;
     priority: z.ZodOptional<z.ZodEnum<{
-        high: "high";
-        medium: "medium";
         low: "low";
+        medium: "medium";
+        high: "high";
     }>>;
 }, z.core.$strip>;
 export declare const frameworkEventSchemas: {
@@ -77,9 +77,9 @@ export declare const frameworkEventSchemas: {
                 cancelled: "cancelled";
             }>;
             priority: z.ZodOptional<z.ZodEnum<{
-                high: "high";
-                medium: "medium";
                 low: "low";
+                medium: "medium";
+                high: "high";
             }>>;
         }, z.core.$strip>>;
     }, z.core.$strip>;
@@ -96,6 +96,31 @@ export declare const frameworkEventSchemas: {
         downloadUrl: z.ZodString;
         previewUrl: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
+    readonly "subagent.started": z.ZodObject<{
+        id: z.ZodString;
+        agent: z.ZodString;
+        task: z.ZodString;
+        parentSessionId: z.ZodString;
+    }, z.core.$strip>;
+    readonly "subagent.step": z.ZodObject<{
+        id: z.ZodString;
+        tool: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        state: z.ZodOptional<z.ZodEnum<{
+            running: "running";
+            completed: "completed";
+            error: "error";
+        }>>;
+    }, z.core.$strip>;
+    readonly "subagent.finished": z.ZodObject<{
+        id: z.ZodString;
+        state: z.ZodEnum<{
+            completed: "completed";
+            error: "error";
+        }>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        toolCalls: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
 };
 export type FrameworkEventType = keyof typeof frameworkEventSchemas;
 export type FrameworkEvent = {

package/dist/core/events/manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/core/events/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAU1E,eAAO,MAAM,iBAAiB,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAWzB,CAAC;AAE7B,eAAO,MAAM,iBAAiB,uCAO7B,CAAC;AAEF,eAAO,MAAM,UAAU,yBAGtB,CAAC;AAYF,QAAA,MAAM,cAAc;;;;;;;;;;;;;iBAIlB,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmBxB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,qBAAqB,CAAC;AAEpE,MAAM,MAAM,cAAc,GAAG;KAC1B,CAAC,IAAI,kBAAkB,GAAG;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;KAAE;CACzF,CAAC,kBAAkB,CAAC,CAAC;AAEtB,MAAM,MAAM,uBAAuB,GAAG,cAAc,GAAG;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAOzE"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/core/events/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAU1E,eAAO,MAAM,iBAAiB,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAWzB,CAAC;AAE7B,eAAO,MAAM,iBAAiB,uCAO7B,CAAC;AAEF,eAAO,MAAM,UAAU,yBAGtB,CAAC;AAYF,QAAA,MAAM,cAAc;;;;;;;;;;;;;iBAIlB,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCxB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,qBAAqB,CAAC;AAEpE,MAAM,MAAM,cAAc,GAAG;KAC1B,CAAC,IAAI,kBAAkB,GAAG;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;KAAE;CACzF,CAAC,kBAAkB,CAAC,CAAC;AAEtB,MAAM,MAAM,uBAAuB,GAAG,cAAc,GAAG;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAOzE"}

package/dist/core/events/manifest.js

@@ -54,6 +54,27 @@ export const frameworkEventSchemas = {
         downloadUrl: z.string(),
         previewUrl: z.string().optional(),
     }),
+    // 子代理生命周期（R3 页面联动）：started/step 以子会话为作用域发布到父会话
+    // 事件流（runner 桥接），UI 投影成可展开的子代理卡片。step 只带工具调用
+    // 摘要，不含全量输出——子代理工具结果绝不进父消息流。
+    "subagent.started": z.object({
+        id: z.string(), // childSessionId
+        agent: z.string(),
+        task: z.string(),
+        parentSessionId: z.string(),
+    }),
+    "subagent.step": z.object({
+        id: z.string(),
+        tool: z.string(),
+        title: z.string().optional(),
+        state: z.enum(["running", "completed", "error"]).optional(),
+    }),
+    "subagent.finished": z.object({
+        id: z.string(),
+        state: z.enum(["completed", "error"]),
+        durationMs: z.number().optional(),
+        toolCalls: z.number().optional(),
+    }),
 };
 /** Narrows an unknown payload (e.g. from an SSE frame) to a FrameworkEvent. */
 export function parseFrameworkEvent(value) {

package/dist/core/events/manifest.js.map

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

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

@@ -0,0 +1,46 @@
+export type McpToolInfo = {
+    name: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+};
+export type McpCallResult = {
+    /** Concatenated text content blocks; empty when the server returned none. */
+    text: string;
+    isError: boolean;
+};
+export type McpClientOptions = {
+    /** Per-request timeout (default 30s). */
+    requestTimeoutMs?: number;
+    /** initialize 握手超时（default 15s）——含进程启动与首条响应。 */
+    connectTimeoutMs?: number;
+    /** 子进程工作目录（默认继承当前进程）。 */
+    cwd?: string;
+    /** 追加到子进程环境的基础变量（在 server env 之前合并，可被覆盖）。 */
+    baseEnv?: Record<string, string>;
+    /** stdio 命令白名单（P0 隔离）：配置后仅允许白名单内的可执行名启动。
+     *  undefined/空数组 = 不限制。匹配对象是 spec.command 的 basename。 */
+    allowedCommands?: string[];
+};
+/** 与 PluginMcpServer 的 stdio 形态解耦的最小入参，方便宿主直接构造。 */
+export type StdioServerSpec = {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+};
+export declare class McpStdioClient {
+    #private;
+    constructor(spec: StdioServerSpec, opts?: McpClientOptions);
+    get connected(): boolean;
+    /** 启动子进程并完成 initialize 握手。失败时保证子进程被回收后抛错。 */
+    start(): Promise<void>;
+    /** tools/list 自动翻页聚合全量工具。 */
+    listTools(): Promise<McpToolInfo[]>;
+    callTool(name: string, args: Record<string, unknown>): Promise<McpCallResult>;
+    request<T = unknown>(method: string, params?: unknown, timerOverride?: NodeJS.Timeout): Promise<T>;
+    notify(method: string, params?: unknown): void;
+    /** 注册服务器请求回调；返回 false 表示框架不提供该能力（客户端回 -32601）。 */
+    onRequest(handler: ((method: string, params: unknown) => unknown | undefined | Promise<unknown | undefined>) | undefined): void;
+    close(): void;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/core/mcp/client.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAiBF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,yCAAyC;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gDAAgD;IAChD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yBAAyB;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;6DACyD;IACzD,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B,CAAC;AAEF,oDAAoD;AACpD,MAAM,MAAM,eAAe,GAAG;IAC5B,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;CACd,CAAC;AAMF,qBAAa,cAAc;;gBAYb,IAAI,EAAE,eAAe,EAAE,IAAI,GAAE,gBAAqB;IAW9D,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,6CAA6C;IACvC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA8E5B,6BAA6B;IACvB,SAAS,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAoBnC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IAYnF,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAgBlG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI;IAM9C,kDAAkD;IAClD,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI;IAI/H,KAAK,IAAI,IAAI;CAgGd"}