@web-ppt/agent-mcp 0.8.0-beta.2 → 0.8.0-beta.3

package/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 本文件记录对使用者可见的变化。版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## 0.8.0-beta.3 - 2026-11-04
+
+- MCP 初始化的 `serverInfo.version` 唯一读取自身公开包清单，源码、独立构建和隔离安装均报告实际软件版本。
+- MCP 源码与发布产物回归均验证真实 stdio 握手版本，避免后续发版遗漏手写常量。
+
+`@web-ppt/collab` 发布入口为 12.20KB gzip；排除 peer 的完整测试薄包为 14,333B gzip。
+
+Windows PowerPoint 真机验收继续延后，未记为通过。
+
 ## 0.8.0-beta.2 - 2026-11-04
 
 - 新增仓库 Agent 配对评测工具：复用生产 MCP 比较自动 lint 反馈，保存全部尝试和真实产物；`npm run eval:agent` 可离线重判已提交证据，真实模型调用使用独立显式命令。评测结果不作为发布门禁，不增加 SDK 运行时依赖。
@@ -9,7 +18,7 @@
 - 模板二进制边界改为审计 npm 实际发布文件清单，覆盖全部发布包；仓库私有评测文稿可保留，SDK 包夹带二进制模板仍会被拒绝。
 - 官网语言回归隔离后台字体完成回调，保留视图、页码、内容和下载断言；触屏回归使用实际设备能力仿真，并在场景结束恢复原输入状态与原生字体方法。
 
-九包继续使用同一 beta 版本，SDK 编辑行为与 `0.8.0-beta.1` 保持一致。GitHub 发布链路以 MCP 包的真实 OIDC 新版本发布作为首次激活验收。
+九包已通过 GitHub OIDC 发布，MCP Trusted Publisher 已完成首次成功发布激活。隔离安装发现此版 MCP 握手仍报告 `beta.1`，修正在 `beta.3`；SDK 编辑行为与 `0.8.0-beta.1` 一致。
 
 `@web-ppt/collab` 发布入口为 12.20KB gzip；排除 peer 的完整测试薄包为 14,333B gzip。
 

package/dist/agent-mcp.js

@@ -1,4 +1,4 @@
-import { A as a, a as c, c as n } from "./server-IR4Cfdfl.js";
+import { A as a, a as c, c as n } from "./server-B4X8aoUM.js";
 export {
   a as AgentMcpError,
   c as AgentMcpSessionManager,

package/dist/cli.js

@@ -3,7 +3,7 @@ import { readFile as c } from "node:fs/promises";
 import { dirname as a, resolve as p } from "node:path";
 import { pathToFileURL as f } from "node:url";
 import { StdioServerTransport as w } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { c as l, l as s } from "./server-IR4Cfdfl.js";
+import { c as l, l as s } from "./server-B4X8aoUM.js";
 async function i(r, e, o) {
   if (e === void 0) return;
   if (typeof e != "string" || !e) throw new Error(`${o} 模块路径必须是非空字符串`);

package/dist/server-B4X8aoUM.js

@@ -0,0 +1,225 @@
+import { createRequire as v } from "node:module";
+import { Server as b } from "@modelcontextprotocol/sdk/server/index.js";
+import { ListToolsRequestSchema as S, CallToolRequestSchema as k } from "@modelcontextprotocol/sdk/types.js";
+import { openAgentSession as $, listAgentTools as q } from "@web-ppt/edit-core/agent";
+import { open as E, rename as A, rm as I, readFile as x } from "node:fs/promises";
+import { disposeOpcPackage as P } from "@web-ppt/edit-core/opc";
+import { serializeEditDoc as _ } from "@web-ppt/edit-core/save";
+import { resolve as M, dirname as R, basename as j } from "node:path";
+class c extends Error {
+  constructor(e, t) {
+    super(t), this.reason = e, this.name = "AgentMcpError";
+  }
+}
+let N = 0;
+function w(s) {
+  if (typeof s != "string" || !s.trim())
+    throw new c("invalid-path", "文件路径必须是非空字符串");
+  if (/^[a-z][a-z0-9+.-]*:\/\//i.test(s))
+    throw new c("invalid-path", `只接受本地文件路径，收到 URL：${s}`);
+  return M(s);
+}
+async function g(s, e) {
+  const t = `${R(s)}/.${j(s)}.web-ppt-${process.pid}-${++N}.tmp`;
+  let r;
+  try {
+    r = await E(t, "wx"), await r.writeFile(e), await r.sync(), await r.close(), r = void 0, await A(t, s);
+  } catch (o) {
+    throw r && await r.close().catch(() => {
+    }), await I(t, { force: !0 }).catch(() => {
+    }), new c("save-failed", `写入 ${s} 失败：${o instanceof Error ? o.message : String(o)}`);
+  }
+}
+class O {
+  constructor(e = {}) {
+    this.options = e, this.sessions = /* @__PURE__ */ new Map(), this.sequence = 0, this.active = !0;
+  }
+  async open(e) {
+    this.assertActive();
+    const t = w(e);
+    let r;
+    try {
+      r = await x(t);
+    } catch (i) {
+      throw new c("open-failed", `读取 ${t} 失败：${i instanceof Error ? i.message : String(i)}`);
+    }
+    const o = `session-${++this.sequence}`, p = new AbortController();
+    let n;
+    try {
+      n = await $(r, {
+        ...this.options,
+        idPrefix: `mcp-${o}-`,
+        lint: { ...this.options.lint, signal: p.signal }
+      });
+    } catch (i) {
+      throw new c("open-failed", `打开 ${t} 失败：${i instanceof Error ? i.message : String(i)}`);
+    }
+    if (!this.active)
+      throw n.dispose(), new c("session-disposed", "会话管理器已经释放");
+    return this.sessions.set(o, { session: n, controller: p, queue: Promise.resolve(), closing: !1 }), { sessionId: o, path: t };
+  }
+  async call(e, t, r) {
+    return this.run(e, (o) => o.call(t, r));
+  }
+  async save(e, t) {
+    const r = w(t);
+    return this.run(e, async (o) => {
+      const { editor: p, doc: n } = o, i = p.captureSavepoint(), l = n.package && !n.package.disposed ? "patch" : "generated", a = await _(n);
+      return a.package !== n.package && P(a.package), await g(r, a.bytes), i(), { ok: !0, value: {
+        bytes: Buffer.from(a.bytes).toString("base64"),
+        path: r,
+        saveMode: l,
+        packageMode: a.mode,
+        fallbackReason: a.fallbackReason,
+        preservedEntries: a.preservedEntries,
+        rewrittenEntries: a.rewrittenEntries
+      } };
+    });
+  }
+  async render(e, t, r) {
+    const o = r === void 0 ? void 0 : w(r);
+    return this.run(e, async (p) => {
+      const n = await p.call("render", t);
+      if (!n.ok || o === void 0) return n;
+      const i = n.value.format === "svg" ? new TextEncoder().encode(n.value.data) : Buffer.from(n.value.data, "base64");
+      return await g(o, i), { ok: !0, value: { ...n.value, path: o } };
+    });
+  }
+  async close(e) {
+    const t = this.entry(e);
+    t.closing = !0, t.controller.abort();
+    const r = t.queue.then(() => (t.session.dispose(), this.sessions.delete(e), { closed: !0 }));
+    return t.queue = r.then(() => {
+    }, () => {
+    }), r;
+  }
+  async dispose() {
+    if (!this.active) return;
+    this.active = !1;
+    const e = [...this.sessions.values()];
+    for (const t of e)
+      t.closing = !0, t.controller.abort();
+    await Promise.allSettled(e.map((t) => t.queue));
+    for (const t of e) t.session.dispose();
+    this.sessions.clear();
+  }
+  entry(e) {
+    this.assertActive();
+    const t = this.sessions.get(e);
+    if (!t || t.closing) throw new c("target-not-found", `找不到打开的会话：${e}`);
+    return t;
+  }
+  run(e, t) {
+    const r = this.entry(e), o = r.queue.then(() => {
+      if (!this.active || r.closing) throw new c("session-disposed", `会话已经关闭：${e}`);
+      return t(r.session);
+    });
+    return r.queue = o.then(() => {
+    }, () => {
+    }), o;
+  }
+  assertActive() {
+    if (!this.active) throw new c("session-disposed", "会话管理器已经释放");
+  }
+}
+function y(s, e) {
+  let t = s;
+  for (; typeof t.$ref == "string"; )
+    t = t.$ref.split("/").slice(1).reduce((n, i) => n[i], s);
+  const r = { ...t.properties, sessionId: { type: "string" } };
+  (e === "save" || e === "render") && (r.path = { type: "string" });
+  const o = /* @__PURE__ */ new Set([...t.required ?? [], "sessionId"]);
+  return e === "save" && o.add("path"), {
+    ...t,
+    type: "object",
+    properties: r,
+    required: [...o],
+    ...s.definitions ? { definitions: s.definitions } : {}
+  };
+}
+function T() {
+  const s = [{
+    name: "ppt_open",
+    description: "打开本地 PPTX / PPT 并创建编辑会话",
+    inputSchema: {
+      type: "object",
+      properties: { path: { type: "string" } },
+      required: ["path"],
+      additionalProperties: !1
+    }
+  }];
+  for (const e of q()) {
+    const t = e.name === "save" ? "save" : e.name === "render" ? "render" : "call";
+    s.push({
+      name: `ppt_${e.name}`,
+      description: e.description,
+      inputSchema: y(e.inputSchema, t)
+    });
+  }
+  return s.push({
+    name: "ppt_close",
+    description: "关闭会话并释放文档资源",
+    inputSchema: y({ type: "object", additionalProperties: !1 }, "close")
+  }), s;
+}
+function f(s) {
+  const e = s;
+  return {
+    isError: !0,
+    content: [{ type: "text", text: JSON.stringify({
+      ok: !1,
+      error: {
+        reason: typeof e?.reason == "string" ? e.reason : "tool-failed",
+        message: typeof e?.message == "string" ? e.message : String(s),
+        commandIndex: typeof e?.commandIndex == "number" ? e.commandIndex : null,
+        elementId: typeof e?.elementId == "string" ? e.elementId : null,
+        slideNumber: typeof e?.slideNumber == "number" ? e.slideNumber : null
+      }
+    }) }]
+  };
+}
+function z(s) {
+  if (!s || typeof s != "object" || Array.isArray(s)) throw new c("invalid-input", "工具参数必须是对象");
+  return s;
+}
+function m(s) {
+  if (typeof s.sessionId != "string" || !s.sessionId) throw new c("invalid-input", "sessionId 必须是非空字符串");
+  return s.sessionId;
+}
+function U(s = {}) {
+  const e = v(import.meta.url)("@web-ppt/agent-mcp/package.json").version;
+  if (typeof e != "string" || !e)
+    throw new Error(`@web-ppt/agent-mcp/package.json version 必须为非空字符串，实际：${JSON.stringify(e)}`);
+  const t = new O(s), r = new b({ name: "web-ppt-agent", version: e }, { capabilities: { tools: {} } }), o = T();
+  return r.setRequestHandler(S, async () => ({ tools: o })), r.setRequestHandler(k, async (p) => {
+    try {
+      const n = p.params.name, i = z(p.params.arguments ?? {});
+      let l;
+      if (n === "ppt_open") l = await t.open(i.path);
+      else if (n === "ppt_close") l = await t.close(m(i));
+      else if (n === "ppt_save") {
+        const a = await t.save(m(i), i.path);
+        if (!a.ok) return f(a.error);
+        const { bytes: h, ...d } = a.value;
+        l = d;
+      } else if (n === "ppt_render") {
+        const { sessionId: a, path: h, ...d } = i, u = await t.render(m(i), d, h);
+        if (!u.ok) return f(u.error);
+        l = u.value;
+      } else if (n.startsWith("ppt_")) {
+        const a = n.slice(4), { sessionId: h, ...d } = i, u = await t.call(m(i), a, d);
+        if (!u.ok) return f(u.error);
+        l = u.value;
+      } else throw new c("target-not-found", `未知工具：${n}`);
+      return { content: [{ type: "text", text: JSON.stringify({ ok: !0, value: l }) }] };
+    } catch (n) {
+      return f(n);
+    }
+  }), { server: r, manager: t };
+}
+export {
+  c as A,
+  O as a,
+  U as c,
+  w as l
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@web-ppt/agent-mcp",
-  "version": "0.8.0-beta.2",
+  "version": "0.8.0-beta.3",
   "description": "Local-only MCP stdio server and Agent Skill for deterministic PPT reading, editing, rendering and saving.",
   "keywords": [
     "pptx",
@@ -48,8 +48,8 @@
     "prepack": "node ../../tooling/sync-package-docs.mjs"
   },
   "peerDependencies": {
-    "@web-ppt/core": "^0.8.0-beta.2",
-    "@web-ppt/edit-core": "^0.8.0-beta.2"
+    "@web-ppt/core": "^0.8.0-beta.3",
+    "@web-ppt/edit-core": "^0.8.0-beta.3"
   },
   "dependencies": {
     "@cfworker/json-schema": "^4.1.1",

package/dist/server-IR4Cfdfl.js

@@ -1,221 +0,0 @@
-import { Server as g } from "@modelcontextprotocol/sdk/server/index.js";
-import { ListToolsRequestSchema as v, CallToolRequestSchema as b } from "@modelcontextprotocol/sdk/types.js";
-import { openAgentSession as S, listAgentTools as $ } from "@web-ppt/edit-core/agent";
-import { open as k, rename as q, rm as A, readFile as E } from "node:fs/promises";
-import { disposeOpcPackage as I } from "@web-ppt/edit-core/opc";
-import { serializeEditDoc as x } from "@web-ppt/edit-core/save";
-import { resolve as P, dirname as _, basename as M } from "node:path";
-class l extends Error {
-  constructor(e, t) {
-    super(t), this.reason = e, this.name = "AgentMcpError";
-  }
-}
-let R = 0;
-function h(s) {
-  if (typeof s != "string" || !s.trim())
-    throw new l("invalid-path", "文件路径必须是非空字符串");
-  if (/^[a-z][a-z0-9+.-]*:\/\//i.test(s))
-    throw new l("invalid-path", `只接受本地文件路径，收到 URL：${s}`);
-  return P(s);
-}
-async function w(s, e) {
-  const t = `${_(s)}/.${M(s)}.web-ppt-${process.pid}-${++R}.tmp`;
-  let n;
-  try {
-    n = await k(t, "wx"), await n.writeFile(e), await n.sync(), await n.close(), n = void 0, await q(t, s);
-  } catch (o) {
-    throw n && await n.close().catch(() => {
-    }), await A(t, { force: !0 }).catch(() => {
-    }), new l("save-failed", `写入 ${s} 失败：${o instanceof Error ? o.message : String(o)}`);
-  }
-}
-class T {
-  constructor(e = {}) {
-    this.options = e, this.sessions = /* @__PURE__ */ new Map(), this.sequence = 0, this.active = !0;
-  }
-  async open(e) {
-    this.assertActive();
-    const t = h(e);
-    let n;
-    try {
-      n = await E(t);
-    } catch (i) {
-      throw new l("open-failed", `读取 ${t} 失败：${i instanceof Error ? i.message : String(i)}`);
-    }
-    const o = `session-${++this.sequence}`, a = new AbortController();
-    let r;
-    try {
-      r = await S(n, {
-        ...this.options,
-        idPrefix: `mcp-${o}-`,
-        lint: { ...this.options.lint, signal: a.signal }
-      });
-    } catch (i) {
-      throw new l("open-failed", `打开 ${t} 失败：${i instanceof Error ? i.message : String(i)}`);
-    }
-    if (!this.active)
-      throw r.dispose(), new l("session-disposed", "会话管理器已经释放");
-    return this.sessions.set(o, { session: r, controller: a, queue: Promise.resolve(), closing: !1 }), { sessionId: o, path: t };
-  }
-  async call(e, t, n) {
-    return this.run(e, (o) => o.call(t, n));
-  }
-  async save(e, t) {
-    const n = h(t);
-    return this.run(e, async (o) => {
-      const { editor: a, doc: r } = o, i = a.captureSavepoint(), p = r.package && !r.package.disposed ? "patch" : "generated", c = await x(r);
-      return c.package !== r.package && I(c.package), await w(n, c.bytes), i(), { ok: !0, value: {
-        bytes: Buffer.from(c.bytes).toString("base64"),
-        path: n,
-        saveMode: p,
-        packageMode: c.mode,
-        fallbackReason: c.fallbackReason,
-        preservedEntries: c.preservedEntries,
-        rewrittenEntries: c.rewrittenEntries
-      } };
-    });
-  }
-  async render(e, t, n) {
-    const o = n === void 0 ? void 0 : h(n);
-    return this.run(e, async (a) => {
-      const r = await a.call("render", t);
-      if (!r.ok || o === void 0) return r;
-      const i = r.value.format === "svg" ? new TextEncoder().encode(r.value.data) : Buffer.from(r.value.data, "base64");
-      return await w(o, i), { ok: !0, value: { ...r.value, path: o } };
-    });
-  }
-  async close(e) {
-    const t = this.entry(e);
-    t.closing = !0, t.controller.abort();
-    const n = t.queue.then(() => (t.session.dispose(), this.sessions.delete(e), { closed: !0 }));
-    return t.queue = n.then(() => {
-    }, () => {
-    }), n;
-  }
-  async dispose() {
-    if (!this.active) return;
-    this.active = !1;
-    const e = [...this.sessions.values()];
-    for (const t of e)
-      t.closing = !0, t.controller.abort();
-    await Promise.allSettled(e.map((t) => t.queue));
-    for (const t of e) t.session.dispose();
-    this.sessions.clear();
-  }
-  entry(e) {
-    this.assertActive();
-    const t = this.sessions.get(e);
-    if (!t || t.closing) throw new l("target-not-found", `找不到打开的会话：${e}`);
-    return t;
-  }
-  run(e, t) {
-    const n = this.entry(e), o = n.queue.then(() => {
-      if (!this.active || n.closing) throw new l("session-disposed", `会话已经关闭：${e}`);
-      return t(n.session);
-    });
-    return n.queue = o.then(() => {
-    }, () => {
-    }), o;
-  }
-  assertActive() {
-    if (!this.active) throw new l("session-disposed", "会话管理器已经释放");
-  }
-}
-function y(s, e) {
-  let t = s;
-  for (; typeof t.$ref == "string"; )
-    t = t.$ref.split("/").slice(1).reduce((r, i) => r[i], s);
-  const n = { ...t.properties, sessionId: { type: "string" } };
-  (e === "save" || e === "render") && (n.path = { type: "string" });
-  const o = /* @__PURE__ */ new Set([...t.required ?? [], "sessionId"]);
-  return e === "save" && o.add("path"), {
-    ...t,
-    type: "object",
-    properties: n,
-    required: [...o],
-    ...s.definitions ? { definitions: s.definitions } : {}
-  };
-}
-function N() {
-  const s = [{
-    name: "ppt_open",
-    description: "打开本地 PPTX / PPT 并创建编辑会话",
-    inputSchema: {
-      type: "object",
-      properties: { path: { type: "string" } },
-      required: ["path"],
-      additionalProperties: !1
-    }
-  }];
-  for (const e of $()) {
-    const t = e.name === "save" ? "save" : e.name === "render" ? "render" : "call";
-    s.push({
-      name: `ppt_${e.name}`,
-      description: e.description,
-      inputSchema: y(e.inputSchema, t)
-    });
-  }
-  return s.push({
-    name: "ppt_close",
-    description: "关闭会话并释放文档资源",
-    inputSchema: y({ type: "object", additionalProperties: !1 }, "close")
-  }), s;
-}
-function f(s) {
-  const e = s;
-  return {
-    isError: !0,
-    content: [{ type: "text", text: JSON.stringify({
-      ok: !1,
-      error: {
-        reason: typeof e?.reason == "string" ? e.reason : "tool-failed",
-        message: typeof e?.message == "string" ? e.message : String(s),
-        commandIndex: typeof e?.commandIndex == "number" ? e.commandIndex : null,
-        elementId: typeof e?.elementId == "string" ? e.elementId : null,
-        slideNumber: typeof e?.slideNumber == "number" ? e.slideNumber : null
-      }
-    }) }]
-  };
-}
-function O(s) {
-  if (!s || typeof s != "object" || Array.isArray(s)) throw new l("invalid-input", "工具参数必须是对象");
-  return s;
-}
-function m(s) {
-  if (typeof s.sessionId != "string" || !s.sessionId) throw new l("invalid-input", "sessionId 必须是非空字符串");
-  return s.sessionId;
-}
-function J(s = {}) {
-  const e = new T(s), t = new g({ name: "web-ppt-agent", version: "0.8.0-beta.1" }, { capabilities: { tools: {} } }), n = N();
-  return t.setRequestHandler(v, async () => ({ tools: n })), t.setRequestHandler(b, async (o) => {
-    try {
-      const a = o.params.name, r = O(o.params.arguments ?? {});
-      let i;
-      if (a === "ppt_open") i = await e.open(r.path);
-      else if (a === "ppt_close") i = await e.close(m(r));
-      else if (a === "ppt_save") {
-        const p = await e.save(m(r), r.path);
-        if (!p.ok) return f(p.error);
-        const { bytes: c, ...d } = p.value;
-        i = d;
-      } else if (a === "ppt_render") {
-        const { sessionId: p, path: c, ...d } = r, u = await e.render(m(r), d, c);
-        if (!u.ok) return f(u.error);
-        i = u.value;
-      } else if (a.startsWith("ppt_")) {
-        const p = a.slice(4), { sessionId: c, ...d } = r, u = await e.call(m(r), p, d);
-        if (!u.ok) return f(u.error);
-        i = u.value;
-      } else throw new l("target-not-found", `未知工具：${a}`);
-      return { content: [{ type: "text", text: JSON.stringify({ ok: !0, value: i }) }] };
-    } catch (a) {
-      return f(a);
-    }
-  }), { server: t, manager: e };
-}
-export {
-  l as A,
-  T as a,
-  J as c,
-  h as l
-};