wps-multitool-mcp 0.0.0-stage → 1.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (300) hide show
  1. package/README.md +3 -3
  2. package/dist/bridge/cancellable.d.ts +36 -0
  3. package/dist/bridge/cancellable.d.ts.map +1 -0
  4. package/dist/bridge/cancellable.js +155 -0
  5. package/dist/bridge/cancellable.js.map +1 -0
  6. package/dist/bridge/index.d.ts +37 -0
  7. package/dist/bridge/index.d.ts.map +1 -0
  8. package/dist/bridge/index.js +383 -0
  9. package/dist/bridge/index.js.map +1 -0
  10. package/dist/bridge/ps-child.d.ts +155 -0
  11. package/dist/bridge/ps-child.d.ts.map +1 -0
  12. package/dist/bridge/ps-child.js +578 -0
  13. package/dist/bridge/ps-child.js.map +1 -0
  14. package/dist/cli/install.d.ts +58 -0
  15. package/dist/cli/install.d.ts.map +1 -0
  16. package/dist/cli/install.js +301 -0
  17. package/dist/cli/install.js.map +1 -0
  18. package/dist/client/action-routes.d.ts +32 -0
  19. package/dist/client/action-routes.d.ts.map +1 -0
  20. package/dist/client/action-routes.generated.d.ts +10 -0
  21. package/dist/client/action-routes.generated.d.ts.map +1 -0
  22. package/dist/client/action-routes.generated.js +327 -0
  23. package/dist/client/action-routes.generated.js.map +1 -0
  24. package/dist/client/action-routes.js +57 -0
  25. package/dist/client/action-routes.js.map +1 -0
  26. package/dist/client/ps-daemon.d.ts +95 -0
  27. package/dist/client/ps-daemon.d.ts.map +1 -0
  28. package/dist/client/ps-daemon.js +424 -0
  29. package/dist/client/ps-daemon.js.map +1 -0
  30. package/dist/client/wps-client.d.ts +69 -0
  31. package/dist/client/wps-client.d.ts.map +1 -0
  32. package/dist/client/wps-client.js +442 -0
  33. package/dist/client/wps-client.js.map +1 -0
  34. package/dist/index.d.ts +29 -0
  35. package/dist/index.d.ts.map +1 -0
  36. package/dist/index.js +173 -0
  37. package/dist/index.js.map +1 -0
  38. package/dist/runtime-identity.d.ts +23 -0
  39. package/dist/runtime-identity.d.ts.map +1 -0
  40. package/dist/runtime-identity.js +26 -0
  41. package/dist/runtime-identity.js.map +1 -0
  42. package/dist/server/auto-snapshot.d.ts +58 -0
  43. package/dist/server/auto-snapshot.d.ts.map +1 -0
  44. package/dist/server/auto-snapshot.js +150 -0
  45. package/dist/server/auto-snapshot.js.map +1 -0
  46. package/dist/server/cancel-context.d.ts +30 -0
  47. package/dist/server/cancel-context.d.ts.map +1 -0
  48. package/dist/server/cancel-context.js +38 -0
  49. package/dist/server/cancel-context.js.map +1 -0
  50. package/dist/server/mcp-server.d.ts +74 -0
  51. package/dist/server/mcp-server.d.ts.map +1 -0
  52. package/dist/server/mcp-server.js +592 -0
  53. package/dist/server/mcp-server.js.map +1 -0
  54. package/dist/server/server-info.d.ts +21 -0
  55. package/dist/server/server-info.d.ts.map +1 -0
  56. package/dist/server/server-info.js +56 -0
  57. package/dist/server/server-info.js.map +1 -0
  58. package/dist/server/tool-aliases.generated.d.ts +41 -0
  59. package/dist/server/tool-aliases.generated.d.ts.map +1 -0
  60. package/dist/server/tool-aliases.generated.js +88 -0
  61. package/dist/server/tool-aliases.generated.js.map +1 -0
  62. package/dist/server/tool-annotations.d.ts +55 -0
  63. package/dist/server/tool-annotations.d.ts.map +1 -0
  64. package/dist/server/tool-annotations.generated.d.ts +14 -0
  65. package/dist/server/tool-annotations.generated.d.ts.map +1 -0
  66. package/dist/server/tool-annotations.generated.js +302 -0
  67. package/dist/server/tool-annotations.generated.js.map +1 -0
  68. package/dist/server/tool-annotations.js +192 -0
  69. package/dist/server/tool-annotations.js.map +1 -0
  70. package/dist/server/tool-group-events.d.ts +23 -0
  71. package/dist/server/tool-group-events.d.ts.map +1 -0
  72. package/dist/server/tool-group-events.js +44 -0
  73. package/dist/server/tool-group-events.js.map +1 -0
  74. package/dist/server/tool-metadata.d.ts +68 -0
  75. package/dist/server/tool-metadata.d.ts.map +1 -0
  76. package/dist/server/tool-metadata.js +834 -0
  77. package/dist/server/tool-metadata.js.map +1 -0
  78. package/dist/server/tool-registry.d.ts +186 -0
  79. package/dist/server/tool-registry.d.ts.map +1 -0
  80. package/dist/server/tool-registry.js +615 -0
  81. package/dist/server/tool-registry.js.map +1 -0
  82. package/dist/server/tool-tiers.d.ts +58 -0
  83. package/dist/server/tool-tiers.d.ts.map +1 -0
  84. package/dist/server/tool-tiers.js +128 -0
  85. package/dist/server/tool-tiers.js.map +1 -0
  86. package/dist/server/tool-verification.d.ts +35 -0
  87. package/dist/server/tool-verification.d.ts.map +1 -0
  88. package/dist/server/tool-verification.generated.d.ts +17 -0
  89. package/dist/server/tool-verification.generated.d.ts.map +1 -0
  90. package/dist/server/tool-verification.generated.js +293 -0
  91. package/dist/server/tool-verification.generated.js.map +1 -0
  92. package/dist/server/tool-verification.js +43 -0
  93. package/dist/server/tool-verification.js.map +1 -0
  94. package/dist/tools/common/batch.d.ts +33 -0
  95. package/dist/tools/common/batch.d.ts.map +1 -0
  96. package/dist/tools/common/batch.js +273 -0
  97. package/dist/tools/common/batch.js.map +1 -0
  98. package/dist/tools/common/convert.d.ts +41 -0
  99. package/dist/tools/common/convert.d.ts.map +1 -0
  100. package/dist/tools/common/convert.js +299 -0
  101. package/dist/tools/common/convert.js.map +1 -0
  102. package/dist/tools/common/general.d.ts +36 -0
  103. package/dist/tools/common/general.d.ts.map +1 -0
  104. package/dist/tools/common/general.js +582 -0
  105. package/dist/tools/common/general.js.map +1 -0
  106. package/dist/tools/common/index.d.ts +38 -0
  107. package/dist/tools/common/index.d.ts.map +1 -0
  108. package/dist/tools/common/index.js +116 -0
  109. package/dist/tools/common/index.js.map +1 -0
  110. package/dist/tools/common/intent.d.ts +48 -0
  111. package/dist/tools/common/intent.d.ts.map +1 -0
  112. package/dist/tools/common/intent.js +221 -0
  113. package/dist/tools/common/intent.js.map +1 -0
  114. package/dist/tools/common/repair.d.ts +29 -0
  115. package/dist/tools/common/repair.d.ts.map +1 -0
  116. package/dist/tools/common/repair.js +140 -0
  117. package/dist/tools/common/repair.js.map +1 -0
  118. package/dist/tools/common/snapshot.d.ts +77 -0
  119. package/dist/tools/common/snapshot.d.ts.map +1 -0
  120. package/dist/tools/common/snapshot.js +497 -0
  121. package/dist/tools/common/snapshot.js.map +1 -0
  122. package/dist/tools/common/status.d.ts +27 -0
  123. package/dist/tools/common/status.d.ts.map +1 -0
  124. package/dist/tools/common/status.js +139 -0
  125. package/dist/tools/common/status.js.map +1 -0
  126. package/dist/tools/common/toolgroups.d.ts +38 -0
  127. package/dist/tools/common/toolgroups.d.ts.map +1 -0
  128. package/dist/tools/common/toolgroups.js +254 -0
  129. package/dist/tools/common/toolgroups.js.map +1 -0
  130. package/dist/tools/excel/chart.d.ts +86 -0
  131. package/dist/tools/excel/chart.d.ts.map +1 -0
  132. package/dist/tools/excel/chart.js +659 -0
  133. package/dist/tools/excel/chart.js.map +1 -0
  134. package/dist/tools/excel/comment-protect.d.ts +58 -0
  135. package/dist/tools/excel/comment-protect.d.ts.map +1 -0
  136. package/dist/tools/excel/comment-protect.js +274 -0
  137. package/dist/tools/excel/comment-protect.js.map +1 -0
  138. package/dist/tools/excel/data-advanced.d.ts +47 -0
  139. package/dist/tools/excel/data-advanced.d.ts.map +1 -0
  140. package/dist/tools/excel/data-advanced.js +263 -0
  141. package/dist/tools/excel/data-advanced.js.map +1 -0
  142. package/dist/tools/excel/data.d.ts +86 -0
  143. package/dist/tools/excel/data.d.ts.map +1 -0
  144. package/dist/tools/excel/data.js +606 -0
  145. package/dist/tools/excel/data.js.map +1 -0
  146. package/dist/tools/excel/format.d.ts +42 -0
  147. package/dist/tools/excel/format.d.ts.map +1 -0
  148. package/dist/tools/excel/format.js +717 -0
  149. package/dist/tools/excel/format.js.map +1 -0
  150. package/dist/tools/excel/formula.d.ts +55 -0
  151. package/dist/tools/excel/formula.d.ts.map +1 -0
  152. package/dist/tools/excel/formula.js +316 -0
  153. package/dist/tools/excel/formula.js.map +1 -0
  154. package/dist/tools/excel/index.d.ts +44 -0
  155. package/dist/tools/excel/index.d.ts.map +1 -0
  156. package/dist/tools/excel/index.js +241 -0
  157. package/dist/tools/excel/index.js.map +1 -0
  158. package/dist/tools/excel/pivot.d.ts +39 -0
  159. package/dist/tools/excel/pivot.d.ts.map +1 -0
  160. package/dist/tools/excel/pivot.js +455 -0
  161. package/dist/tools/excel/pivot.js.map +1 -0
  162. package/dist/tools/excel/row-column.d.ts +64 -0
  163. package/dist/tools/excel/row-column.d.ts.map +1 -0
  164. package/dist/tools/excel/row-column.js +299 -0
  165. package/dist/tools/excel/row-column.js.map +1 -0
  166. package/dist/tools/excel/sheet-gaps.d.ts +50 -0
  167. package/dist/tools/excel/sheet-gaps.d.ts.map +1 -0
  168. package/dist/tools/excel/sheet-gaps.js +373 -0
  169. package/dist/tools/excel/sheet-gaps.js.map +1 -0
  170. package/dist/tools/excel/sheet.d.ts +102 -0
  171. package/dist/tools/excel/sheet.d.ts.map +1 -0
  172. package/dist/tools/excel/sheet.js +827 -0
  173. package/dist/tools/excel/sheet.js.map +1 -0
  174. package/dist/tools/excel/workbook.d.ts +62 -0
  175. package/dist/tools/excel/workbook.d.ts.map +1 -0
  176. package/dist/tools/excel/workbook.js +371 -0
  177. package/dist/tools/excel/workbook.js.map +1 -0
  178. package/dist/tools/index.d.ts +48 -0
  179. package/dist/tools/index.d.ts.map +1 -0
  180. package/dist/tools/index.js +113 -0
  181. package/dist/tools/index.js.map +1 -0
  182. package/dist/tools/ppt/animation.d.ts +36 -0
  183. package/dist/tools/ppt/animation.d.ts.map +1 -0
  184. package/dist/tools/ppt/animation.js +190 -0
  185. package/dist/tools/ppt/animation.js.map +1 -0
  186. package/dist/tools/ppt/background.d.ts +54 -0
  187. package/dist/tools/ppt/background.d.ts.map +1 -0
  188. package/dist/tools/ppt/background.js +389 -0
  189. package/dist/tools/ppt/background.js.map +1 -0
  190. package/dist/tools/ppt/beautify-advanced.d.ts +66 -0
  191. package/dist/tools/ppt/beautify-advanced.d.ts.map +1 -0
  192. package/dist/tools/ppt/beautify-advanced.js +600 -0
  193. package/dist/tools/ppt/beautify-advanced.js.map +1 -0
  194. package/dist/tools/ppt/chart-flow.d.ts +58 -0
  195. package/dist/tools/ppt/chart-flow.d.ts.map +1 -0
  196. package/dist/tools/ppt/chart-flow.js +523 -0
  197. package/dist/tools/ppt/chart-flow.js.map +1 -0
  198. package/dist/tools/ppt/data-viz.d.ts +64 -0
  199. package/dist/tools/ppt/data-viz.d.ts.map +1 -0
  200. package/dist/tools/ppt/data-viz.js +514 -0
  201. package/dist/tools/ppt/data-viz.js.map +1 -0
  202. package/dist/tools/ppt/image.d.ts +30 -0
  203. package/dist/tools/ppt/image.d.ts.map +1 -0
  204. package/dist/tools/ppt/image.js +447 -0
  205. package/dist/tools/ppt/image.js.map +1 -0
  206. package/dist/tools/ppt/index.d.ts +72 -0
  207. package/dist/tools/ppt/index.d.ts.map +1 -0
  208. package/dist/tools/ppt/index.js +320 -0
  209. package/dist/tools/ppt/index.js.map +1 -0
  210. package/dist/tools/ppt/misc.d.ts +93 -0
  211. package/dist/tools/ppt/misc.d.ts.map +1 -0
  212. package/dist/tools/ppt/misc.js +817 -0
  213. package/dist/tools/ppt/misc.js.map +1 -0
  214. package/dist/tools/ppt/presentation.d.ts +72 -0
  215. package/dist/tools/ppt/presentation.d.ts.map +1 -0
  216. package/dist/tools/ppt/presentation.js +694 -0
  217. package/dist/tools/ppt/presentation.js.map +1 -0
  218. package/dist/tools/ppt/shape-basic.d.ts +46 -0
  219. package/dist/tools/ppt/shape-basic.d.ts.map +1 -0
  220. package/dist/tools/ppt/shape-basic.js +756 -0
  221. package/dist/tools/ppt/shape-basic.js.map +1 -0
  222. package/dist/tools/ppt/slide-ops.d.ts +73 -0
  223. package/dist/tools/ppt/slide-ops.d.ts.map +1 -0
  224. package/dist/tools/ppt/slide-ops.js +1740 -0
  225. package/dist/tools/ppt/slide-ops.js.map +1 -0
  226. package/dist/tools/ppt/slide.d.ts +51 -0
  227. package/dist/tools/ppt/slide.d.ts.map +1 -0
  228. package/dist/tools/ppt/slide.js +484 -0
  229. package/dist/tools/ppt/slide.js.map +1 -0
  230. package/dist/tools/ppt/table.d.ts +58 -0
  231. package/dist/tools/ppt/table.d.ts.map +1 -0
  232. package/dist/tools/ppt/table.js +514 -0
  233. package/dist/tools/ppt/table.js.map +1 -0
  234. package/dist/tools/ppt/textbox.d.ts +47 -0
  235. package/dist/tools/ppt/textbox.d.ts.map +1 -0
  236. package/dist/tools/ppt/textbox.js +249 -0
  237. package/dist/tools/ppt/textbox.js.map +1 -0
  238. package/dist/tools/word/academic.d.ts +50 -0
  239. package/dist/tools/word/academic.d.ts.map +1 -0
  240. package/dist/tools/word/academic.js +500 -0
  241. package/dist/tools/word/academic.js.map +1 -0
  242. package/dist/tools/word/content.d.ts +97 -0
  243. package/dist/tools/word/content.d.ts.map +1 -0
  244. package/dist/tools/word/content.js +843 -0
  245. package/dist/tools/word/content.js.map +1 -0
  246. package/dist/tools/word/document.d.ts +65 -0
  247. package/dist/tools/word/document.d.ts.map +1 -0
  248. package/dist/tools/word/document.js +576 -0
  249. package/dist/tools/word/document.js.map +1 -0
  250. package/dist/tools/word/format.d.ts +50 -0
  251. package/dist/tools/word/format.d.ts.map +1 -0
  252. package/dist/tools/word/format.js +462 -0
  253. package/dist/tools/word/format.js.map +1 -0
  254. package/dist/tools/word/gaps.d.ts +58 -0
  255. package/dist/tools/word/gaps.d.ts.map +1 -0
  256. package/dist/tools/word/gaps.js +431 -0
  257. package/dist/tools/word/gaps.js.map +1 -0
  258. package/dist/tools/word/index.d.ts +34 -0
  259. package/dist/tools/word/index.d.ts.map +1 -0
  260. package/dist/tools/word/index.js +122 -0
  261. package/dist/tools/word/index.js.map +1 -0
  262. package/dist/tools/word/professional.d.ts +48 -0
  263. package/dist/tools/word/professional.d.ts.map +1 -0
  264. package/dist/tools/word/professional.js +657 -0
  265. package/dist/tools/word/professional.js.map +1 -0
  266. package/dist/tools/word/proofread.d.ts +25 -0
  267. package/dist/tools/word/proofread.d.ts.map +1 -0
  268. package/dist/tools/word/proofread.js +718 -0
  269. package/dist/tools/word/proofread.js.map +1 -0
  270. package/dist/types/index.d.ts +9 -0
  271. package/dist/types/index.d.ts.map +1 -0
  272. package/dist/types/index.js +25 -0
  273. package/dist/types/index.js.map +1 -0
  274. package/dist/types/tools.d.ts +174 -0
  275. package/dist/types/tools.d.ts.map +1 -0
  276. package/dist/types/tools.js +45 -0
  277. package/dist/types/tools.js.map +1 -0
  278. package/dist/types/wps.d.ts +190 -0
  279. package/dist/types/wps.d.ts.map +1 -0
  280. package/dist/types/wps.js +23 -0
  281. package/dist/types/wps.js.map +1 -0
  282. package/dist/utils/error.d.ts +147 -0
  283. package/dist/utils/error.d.ts.map +1 -0
  284. package/dist/utils/error.js +417 -0
  285. package/dist/utils/error.js.map +1 -0
  286. package/dist/utils/logger.d.ts +56 -0
  287. package/dist/utils/logger.d.ts.map +1 -0
  288. package/dist/utils/logger.js +155 -0
  289. package/dist/utils/logger.js.map +1 -0
  290. package/dist/version.d.ts +22 -0
  291. package/dist/version.d.ts.map +1 -0
  292. package/dist/version.js +101 -0
  293. package/dist/version.js.map +1 -0
  294. package/package.json +66 -6
  295. package/scripts/wps-com.ps1 +8255 -0
  296. package/scripts/wps-comd.ps1 +123 -0
  297. package/skills/wps-multitool/SKILL.md +129 -0
  298. package/skills/wps-multitool/references/errors.md +62 -0
  299. package/skills/wps-multitool/references/recipes.md +83 -0
  300. package/skills/wps-multitool/references/routing.md +88 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,23 @@
1
+ /**
2
+ * Input: 无(本模块就是源头)
3
+ * Output: 运行时标识 RUNTIME_ID —— 命名管道前缀与日志目录名的唯一真相源
4
+ * Pos: 跨进程约定的单一出处。一旦我被修改,请更新我的头部注释,以及所属目录的md。
5
+ *
6
+ * 为什么单开一个文件
7
+ * ------------------
8
+ * 这个名字出现在三个必须一致的地方,任何一处对不上就是【静默故障】:
9
+ * 1) MCP Server 侧(src/client/ps-daemon.ts)连的管道名
10
+ * 2) 桥进程侧(src/bridge/index.ts)监听的管道名 + 日志目录
11
+ * 3) 日志目录(src/utils/logger.ts)
12
+ * 管道名两边各写一遍是以前的做法(都硬编码 'wps-multitool-mcp')——
13
+ * 改名的那次就漏了第三处(日志目录),两边不一致的后果是桥起不来却只报"连接失败",
14
+ * 极难排查。所以收口到这一个常量。
15
+ *
16
+ * 与包名的关系:刻意【不】从 package.json 推导。管道名是长寿命跨进程契约,
17
+ * 不该跟着包名/版本变动;要改就改这里,一次改全。
18
+ *
19
+ * 取值纪律:这个值就是 MCP 自己的名字(wps-multitool-mcp,多面手)。
20
+ * 曾经被擅自改成 'wps-office',那是一次错误演示 —— 没有明确指示不动这里。
21
+ */
22
+ export declare const RUNTIME_ID = "wps-multitool-mcp";
23
+ //# sourceMappingURL=runtime-identity.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime-identity.d.ts","sourceRoot":"","sources":["../src/runtime-identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,eAAO,MAAM,UAAU,sBAAsB,CAAC"}
@@ -0,0 +1,26 @@
1
+ "use strict";
2
+ /**
3
+ * Input: 无(本模块就是源头)
4
+ * Output: 运行时标识 RUNTIME_ID —— 命名管道前缀与日志目录名的唯一真相源
5
+ * Pos: 跨进程约定的单一出处。一旦我被修改,请更新我的头部注释,以及所属目录的md。
6
+ *
7
+ * 为什么单开一个文件
8
+ * ------------------
9
+ * 这个名字出现在三个必须一致的地方,任何一处对不上就是【静默故障】:
10
+ * 1) MCP Server 侧(src/client/ps-daemon.ts)连的管道名
11
+ * 2) 桥进程侧(src/bridge/index.ts)监听的管道名 + 日志目录
12
+ * 3) 日志目录(src/utils/logger.ts)
13
+ * 管道名两边各写一遍是以前的做法(都硬编码 'wps-multitool-mcp')——
14
+ * 改名的那次就漏了第三处(日志目录),两边不一致的后果是桥起不来却只报"连接失败",
15
+ * 极难排查。所以收口到这一个常量。
16
+ *
17
+ * 与包名的关系:刻意【不】从 package.json 推导。管道名是长寿命跨进程契约,
18
+ * 不该跟着包名/版本变动;要改就改这里,一次改全。
19
+ *
20
+ * 取值纪律:这个值就是 MCP 自己的名字(wps-multitool-mcp,多面手)。
21
+ * 曾经被擅自改成 'wps-office',那是一次错误演示 —— 没有明确指示不动这里。
22
+ */
23
+ Object.defineProperty(exports, "__esModule", { value: true });
24
+ exports.RUNTIME_ID = void 0;
25
+ exports.RUNTIME_ID = 'wps-multitool-mcp';
26
+ //# sourceMappingURL=runtime-identity.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime-identity.js","sourceRoot":"","sources":["../src/runtime-identity.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEU,QAAA,UAAU,GAAG,mBAAmB,CAAC"}
@@ -0,0 +1,58 @@
1
+ /**
2
+ * Input: 工具名(规范名)+ 一次执行体
3
+ * Output: 执行结果(可能在前面自动建了一份快照,失败时附 warnings)
4
+ * Pos: 单工具写入的"可退"保险 —— 挂在 toolRegistry.callTool 这个唯一入口上。
5
+ * 一旦我被修改,请更新我的头部注释,以及所属目录的md。
6
+ *
7
+ * 为什么要有这一层
8
+ * --------------
9
+ * 以前只有 wps_common_batch 会在执行前存快照。用户直接调一个破坏性工具
10
+ * (删页、覆盖样式、原地转格式)时没有任何保险 —— 而 COM 没有撤销,
11
+ * 删掉就是删掉了。快照是唯一的补偿手段,它不该只在"批量"这条路上存在。
12
+ *
13
+ * 为什么挂在注册表而不是每个 handler 里
14
+ * ----------------------------------
15
+ * 296 个工具逐个加一遍,等于 296 个地方都可能漏。注册表是所有工具调用的唯一入口
16
+ * (batch 的子调用也走它),挂在这里是唯一不会漏的位置。
17
+ *
18
+ * 判据(沿用 batch 的口径,别另发明)
19
+ * ------------------------------
20
+ * 只读(readOnlyHint) → 不建。快照是保险,不是每次调用的仪式。
21
+ * 破坏性(destructiveHint) → 建。
22
+ * 非幂等(idempotentHint === false)→ 建。
23
+ * 其余写入(幂等的普通写入) → 不建。重复执行结果一致,改坏了再写一次就行。
24
+ * 每个写入都建会让用户一天攒几百份快照,最后等于没存(还会触发保留策略把有用的挤掉)。
25
+ *
26
+ * 为什么用 AsyncLocalStorage 防重,而不是一个深度计数器
27
+ * ------------------------------------------------
28
+ * MCP server 里 callTool 是**并发可达**的(stdio 上多个请求可以交错),batch 内部还会
29
+ * 嵌套调子工具。全局 depth 计数会把两条独立调用链的层级算到一起 ——
30
+ * A 链的 batch 跑着的时候,B 链的一次删除会以为自己也是子调用,于是**该保命时没保**。
31
+ * ALS 跟着各自的调用链走,天然隔离;同一个理由在 gen-tool-annotations.js 里也用过。
32
+ * 防重是必须的:batch 3 步会各自走一遍注册表,不防重就是 4 份快照(batch 1 + 3 步)。
33
+ */
34
+ import { ToolWarning } from '../types/tools';
35
+ /**
36
+ * 从工具名推出它作用在哪个应用。
37
+ *
38
+ * 为什么要推而不是"让 PS 猜":三个应用可以同时开着,而 ActiveDocument 是弱引用。
39
+ * PS 兜底规则只能按"未保存优先"猜,一旦猜错,快照会把另一个应用里残留的文档复制下来 ——
40
+ * 名义上有回滚保险,实际保的是别人的文件。工具名是现成的、确定的,不用白不用。
41
+ */
42
+ export declare function appHintOf(toolName: string): 'word' | 'excel' | 'ppt' | undefined;
43
+ /**
44
+ * 这个工具值不值得存快照。返回空串 = 不必建;非空串 = 风险描述(写进快照 label 与日志)。
45
+ * 判据与 batch 的 riskOf 一致 —— 两处口径必须一样,否则"批量有保险、单调用没有"这种不一致
46
+ * 会让人以为单调用是安全的。
47
+ */
48
+ export declare function snapshotRiskOf(toolName: string): string;
49
+ /**
50
+ * 在调用链最外层、且工具够危险时,先建一份快照,再执行。
51
+ *
52
+ * 失败语义:建不了快照【绝不阻断】执行(用户可能就是要改一份还没保存的新文档),
53
+ * 但必须把"这次没有回滚保险"塞进 warnings —— 不吭声地少一层保险,比没有更坏。
54
+ */
55
+ export declare function withAutoSnapshot<T extends {
56
+ warnings?: ToolWarning[];
57
+ }>(toolName: string, run: () => Promise<T>): Promise<T>;
58
+ //# sourceMappingURL=auto-snapshot.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"auto-snapshot.d.ts","sourceRoot":"","sources":["../../src/server/auto-snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAM7C;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,SAAS,CAKhF;AAuBD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOvD;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,SAAS;IAAE,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAA;CAAE,EAC3E,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACpB,OAAO,CAAC,CAAC,CAAC,CAkDZ"}
@@ -0,0 +1,150 @@
1
+ "use strict";
2
+ /**
3
+ * Input: 工具名(规范名)+ 一次执行体
4
+ * Output: 执行结果(可能在前面自动建了一份快照,失败时附 warnings)
5
+ * Pos: 单工具写入的"可退"保险 —— 挂在 toolRegistry.callTool 这个唯一入口上。
6
+ * 一旦我被修改,请更新我的头部注释,以及所属目录的md。
7
+ *
8
+ * 为什么要有这一层
9
+ * --------------
10
+ * 以前只有 wps_common_batch 会在执行前存快照。用户直接调一个破坏性工具
11
+ * (删页、覆盖样式、原地转格式)时没有任何保险 —— 而 COM 没有撤销,
12
+ * 删掉就是删掉了。快照是唯一的补偿手段,它不该只在"批量"这条路上存在。
13
+ *
14
+ * 为什么挂在注册表而不是每个 handler 里
15
+ * ----------------------------------
16
+ * 296 个工具逐个加一遍,等于 296 个地方都可能漏。注册表是所有工具调用的唯一入口
17
+ * (batch 的子调用也走它),挂在这里是唯一不会漏的位置。
18
+ *
19
+ * 判据(沿用 batch 的口径,别另发明)
20
+ * ------------------------------
21
+ * 只读(readOnlyHint) → 不建。快照是保险,不是每次调用的仪式。
22
+ * 破坏性(destructiveHint) → 建。
23
+ * 非幂等(idempotentHint === false)→ 建。
24
+ * 其余写入(幂等的普通写入) → 不建。重复执行结果一致,改坏了再写一次就行。
25
+ * 每个写入都建会让用户一天攒几百份快照,最后等于没存(还会触发保留策略把有用的挤掉)。
26
+ *
27
+ * 为什么用 AsyncLocalStorage 防重,而不是一个深度计数器
28
+ * ------------------------------------------------
29
+ * MCP server 里 callTool 是**并发可达**的(stdio 上多个请求可以交错),batch 内部还会
30
+ * 嵌套调子工具。全局 depth 计数会把两条独立调用链的层级算到一起 ——
31
+ * A 链的 batch 跑着的时候,B 链的一次删除会以为自己也是子调用,于是**该保命时没保**。
32
+ * ALS 跟着各自的调用链走,天然隔离;同一个理由在 gen-tool-annotations.js 里也用过。
33
+ * 防重是必须的:batch 3 步会各自走一遍注册表,不防重就是 4 份快照(batch 1 + 3 步)。
34
+ */
35
+ Object.defineProperty(exports, "__esModule", { value: true });
36
+ exports.appHintOf = appHintOf;
37
+ exports.snapshotRiskOf = snapshotRiskOf;
38
+ exports.withAutoSnapshot = withAutoSnapshot;
39
+ const async_hooks_1 = require("async_hooks");
40
+ const tool_annotations_1 = require("./tool-annotations");
41
+ const snapshot_1 = require("../tools/common/snapshot");
42
+ const logger_1 = require("../utils/logger");
43
+ const logger = (0, logger_1.createChildLogger)('AutoSnapshot');
44
+ /**
45
+ * 从工具名推出它作用在哪个应用。
46
+ *
47
+ * 为什么要推而不是"让 PS 猜":三个应用可以同时开着,而 ActiveDocument 是弱引用。
48
+ * PS 兜底规则只能按"未保存优先"猜,一旦猜错,快照会把另一个应用里残留的文档复制下来 ——
49
+ * 名义上有回滚保险,实际保的是别人的文件。工具名是现成的、确定的,不用白不用。
50
+ */
51
+ function appHintOf(toolName) {
52
+ if (toolName.startsWith('wps_word_'))
53
+ return 'word';
54
+ if (toolName.startsWith('wps_excel_'))
55
+ return 'excel';
56
+ if (toolName.startsWith('wps_ppt_'))
57
+ return 'ppt';
58
+ return undefined;
59
+ }
60
+ /** 当前调用链的嵌套深度。只有最外层(depth 0)建快照。 */
61
+ const chain = new async_hooks_1.AsyncLocalStorage();
62
+ /**
63
+ * 自己管快照、或被本层管理会很荒谬的工具。
64
+ * wps_common_batch —— 它按【每个步骤】判风险,比按工具判更准;入口再建一次是重复。
65
+ * wps_common_snapshot_* —— 快照/恢复工具本身:给"建快照"再建一份快照没有意义。
66
+ */
67
+ const SELF_MANAGED = new Set([
68
+ 'wps_common_batch',
69
+ 'wps_common_snapshot_create',
70
+ 'wps_common_snapshot_restore',
71
+ 'wps_common_snapshot_list',
72
+ ]);
73
+ /** 环境变量兜底开关:不想被自动快照的人可以整机关掉(不给 296 个工具加参数位) */
74
+ function disabledByEnv() {
75
+ const v = (process.env.WPS_NO_AUTO_SNAPSHOT || '').toLowerCase();
76
+ return ['1', 'true', 'yes', 'on'].includes(v);
77
+ }
78
+ /**
79
+ * 这个工具值不值得存快照。返回空串 = 不必建;非空串 = 风险描述(写进快照 label 与日志)。
80
+ * 判据与 batch 的 riskOf 一致 —— 两处口径必须一样,否则"批量有保险、单调用没有"这种不一致
81
+ * 会让人以为单调用是安全的。
82
+ */
83
+ function snapshotRiskOf(toolName) {
84
+ if (SELF_MANAGED.has(toolName))
85
+ return '';
86
+ const a = (0, tool_annotations_1.getToolAnnotations)(toolName);
87
+ if (!a || a.readOnlyHint)
88
+ return '';
89
+ if (a.destructiveHint)
90
+ return `${toolName} 破坏性`;
91
+ if (a.idempotentHint === false)
92
+ return `${toolName} 非幂等`;
93
+ return '';
94
+ }
95
+ /**
96
+ * 在调用链最外层、且工具够危险时,先建一份快照,再执行。
97
+ *
98
+ * 失败语义:建不了快照【绝不阻断】执行(用户可能就是要改一份还没保存的新文档),
99
+ * 但必须把"这次没有回滚保险"塞进 warnings —— 不吭声地少一层保险,比没有更坏。
100
+ */
101
+ async function withAutoSnapshot(toolName, run) {
102
+ const outer = chain.getStore();
103
+ const depth = outer ? outer.depth + 1 : 0;
104
+ if (depth > 0) {
105
+ // 嵌套调用(batch 的子步骤):直接跑,绝不再建快照
106
+ return chain.run({ depth }, run);
107
+ }
108
+ const why = disabledByEnv() ? '' : snapshotRiskOf(toolName);
109
+ if (!why)
110
+ return chain.run({ depth }, run);
111
+ let snapWarnings = [];
112
+ try {
113
+ const snap = await (0, snapshot_1.createSnapshot)(`auto: ${why}`, appHintOf(toolName));
114
+ if (snap.ok) {
115
+ logger.info('auto snapshot created', { tool: toolName, path: snap.record.snapshotPath });
116
+ if (snap.dirty) {
117
+ snapWarnings = [
118
+ {
119
+ step: 'snapshot.dirty',
120
+ message: '这次改动前已自动存快照,但快照取自磁盘、不含未保存改动;要连未保存内容一起保命,先 wps_common_save 再重做',
121
+ },
122
+ ];
123
+ }
124
+ }
125
+ else {
126
+ snapWarnings = [
127
+ {
128
+ step: 'snapshot',
129
+ message: `改动前没能自动建快照:${snap.error}。这次执行没有回滚保险。`,
130
+ },
131
+ ];
132
+ logger.warn('auto snapshot failed', { tool: toolName, error: snap.error, code: snap.code });
133
+ }
134
+ }
135
+ catch (e) {
136
+ // createSnapshot 自己已经兜了大部分异常,这里防的是更外层(比如 fs 模块本身炸了)
137
+ snapWarnings = [
138
+ {
139
+ step: 'snapshot',
140
+ message: `改动前没能自动建快照:${e instanceof Error ? e.message : String(e)}。这次执行没有回滚保险。`,
141
+ },
142
+ ];
143
+ }
144
+ const result = await chain.run({ depth }, run);
145
+ if (snapWarnings.length) {
146
+ result.warnings = [...(result.warnings ?? []), ...snapWarnings];
147
+ }
148
+ return result;
149
+ }
150
+ //# sourceMappingURL=auto-snapshot.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"auto-snapshot.js","sourceRoot":"","sources":["../../src/server/auto-snapshot.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,30 @@
1
+ /**
2
+ * Input: 一次 tools/call 的取消信号
3
+ * Output: 同一次调用链深处也能拿到它
4
+ * Pos: 取消信号的传递上下文。一旦我被修改,请更新我的头部注释,以及所属文件夹的md。
5
+ *
6
+ * 为什么用 AsyncLocalStorage 而不是改函数签名
7
+ * ------------------------------------------
8
+ * 工具 handler 的签名是 `(args) => Promise<ToolCallResult>`,全仓 285 个工具都是这个形状。
9
+ * 要把 signal 传下去就得改 285 处签名 + 每个 client 调用点 —— 收益极低、破坏面极大。
10
+ * 用 AsyncLocalStorage 在【请求入口】放一次,调用链深处任何地方都能取到,
11
+ * 签名一个字都不用动。
12
+ *
13
+ * 语义边界
14
+ * --------
15
+ * 这里只负责"把信号递下去"。该不该真取消、取消到哪一档,由 bridge/cancellable.ts 裁决。
16
+ */
17
+ export interface CancelContext {
18
+ signal?: AbortSignal;
19
+ /** 工具名,仅用于日志 */
20
+ toolName?: string;
21
+ }
22
+ /**
23
+ * 在一次调用外层包一下,之后这条链上任意深度都能用 currentSignal() 取到信号。
24
+ */
25
+ export declare function runWithCancel<T>(ctx: CancelContext, fn: () => Promise<T>): Promise<T>;
26
+ /** 当前调用链上的取消信号(没有就是 undefined,即"不可取消") */
27
+ export declare function currentSignal(): AbortSignal | undefined;
28
+ /** 当前工具名(日志用) */
29
+ export declare function currentToolName(): string | undefined;
30
+ //# sourceMappingURL=cancel-context.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cancel-context.d.ts","sourceRoot":"","sources":["../../src/server/cancel-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAErF;AAED,0CAA0C;AAC1C,wBAAgB,aAAa,IAAI,WAAW,GAAG,SAAS,CAEvD;AAED,iBAAiB;AACjB,wBAAgB,eAAe,IAAI,MAAM,GAAG,SAAS,CAEpD"}
@@ -0,0 +1,38 @@
1
+ "use strict";
2
+ /**
3
+ * Input: 一次 tools/call 的取消信号
4
+ * Output: 同一次调用链深处也能拿到它
5
+ * Pos: 取消信号的传递上下文。一旦我被修改,请更新我的头部注释,以及所属文件夹的md。
6
+ *
7
+ * 为什么用 AsyncLocalStorage 而不是改函数签名
8
+ * ------------------------------------------
9
+ * 工具 handler 的签名是 `(args) => Promise<ToolCallResult>`,全仓 285 个工具都是这个形状。
10
+ * 要把 signal 传下去就得改 285 处签名 + 每个 client 调用点 —— 收益极低、破坏面极大。
11
+ * 用 AsyncLocalStorage 在【请求入口】放一次,调用链深处任何地方都能取到,
12
+ * 签名一个字都不用动。
13
+ *
14
+ * 语义边界
15
+ * --------
16
+ * 这里只负责"把信号递下去"。该不该真取消、取消到哪一档,由 bridge/cancellable.ts 裁决。
17
+ */
18
+ Object.defineProperty(exports, "__esModule", { value: true });
19
+ exports.runWithCancel = runWithCancel;
20
+ exports.currentSignal = currentSignal;
21
+ exports.currentToolName = currentToolName;
22
+ const async_hooks_1 = require("async_hooks");
23
+ const storage = new async_hooks_1.AsyncLocalStorage();
24
+ /**
25
+ * 在一次调用外层包一下,之后这条链上任意深度都能用 currentSignal() 取到信号。
26
+ */
27
+ function runWithCancel(ctx, fn) {
28
+ return storage.run(ctx, fn);
29
+ }
30
+ /** 当前调用链上的取消信号(没有就是 undefined,即"不可取消") */
31
+ function currentSignal() {
32
+ return storage.getStore()?.signal;
33
+ }
34
+ /** 当前工具名(日志用) */
35
+ function currentToolName() {
36
+ return storage.getStore()?.toolName;
37
+ }
38
+ //# sourceMappingURL=cancel-context.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cancel-context.js","sourceRoot":"","sources":["../../src/server/cancel-context.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;AAeH,sCAEC;AAGD,sCAEC;AAGD,0CAEC;AAzBD,6CAAgD;AAQhD,MAAM,OAAO,GAAG,IAAI,+BAAiB,EAAiB,CAAC;AAEvD;;GAEG;AACH,SAAgB,aAAa,CAAI,GAAkB,EAAE,EAAoB;IACvE,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED,0CAA0C;AAC1C,SAAgB,aAAa;IAC3B,OAAO,OAAO,CAAC,QAAQ,EAAE,EAAE,MAAM,CAAC;AACpC,CAAC;AAED,iBAAiB;AACjB,SAAgB,eAAe;IAC7B,OAAO,OAAO,CAAC,QAAQ,EAAE,EAAE,QAAQ,CAAC;AACtC,CAAC"}
@@ -0,0 +1,74 @@
1
+ /**
2
+ * Input: MCP 协议请求
3
+ * Output: Tool 调用响应
4
+ * Pos: MCP Server 核心实现。一旦我被修改,请更新我的头部注释,以及所属文件夹的md。
5
+ * MCP Server实现 - WPS 的 MCP 协议实现
6
+ * 这是整个系统的核心,处理MCP协议通信
7
+ * 基于stdio传输,Claude Desktop就是这么连的
8
+ */
9
+ import { ToolCallResult, ToolContent } from '../types/tools';
10
+ /**
11
+ * MCP Server配置
12
+ */
13
+ export interface McpServerConfig {
14
+ /** 服务器名称 */
15
+ name: string;
16
+ /** 服务器版本 */
17
+ version: string;
18
+ /** 是否启用调试模式 */
19
+ debug?: boolean;
20
+ }
21
+ /**
22
+ * WPS MCP Server - 核心服务器类
23
+ */
24
+ export declare class WpsMcpServer {
25
+ private readonly config;
26
+ private readonly server;
27
+ private readonly registry;
28
+ private isRunning;
29
+ /** 工具组变更通知是否已接上(避免重复订阅) */
30
+ private groupsNotifyWired;
31
+ private static dataCache;
32
+ constructor(config?: Partial<McpServerConfig>);
33
+ /**
34
+ * 设置请求处理器
35
+ */
36
+ private setupRequestHandlers;
37
+ /** tools/call 的实际处理(拆出来是为了好包取消上下文) */
38
+ private handleToolCall;
39
+ /**
40
+ * 注册内置Tools - 一些基础的WPS操作Tool
41
+ */
42
+ registerBuiltinTools(): void;
43
+ /**
44
+ * 启动服务器
45
+ */
46
+ start(): Promise<void>;
47
+ /**
48
+ * 发 notifications/tools/list_changed,让客户端重新拉工具列表。
49
+ * 失败只记日志 —— 通知失败不该影响工具本身的结果。
50
+ */
51
+ private notifyToolsChanged;
52
+ /**
53
+ * 停止服务器
54
+ */
55
+ stop(): Promise<void>;
56
+ /**
57
+ * 获取服务器状态
58
+ */
59
+ getStatus(): {
60
+ running: boolean;
61
+ toolCount: number;
62
+ };
63
+ }
64
+ export declare const createMcpServer: (config?: Partial<McpServerConfig>) => WpsMcpServer;
65
+ export default WpsMcpServer;
66
+ /**
67
+ * 成功但有保留时,在正文前挂一段提示。
68
+ *
69
+ * 为什么必须显式写出来:模型看到 success=true 就会当"全好了",
70
+ * 不说的话它不会去看 warnings —— 而 warnings 里的内容往往正是用户需要知道的
71
+ * ("某个属性没设上""这个锚点插不进去")。宁可啰嗦一点,也不能让用户以为全好。
72
+ */
73
+ export declare function prefixWithWarnings(result: ToolCallResult): ToolContent[];
74
+ //# sourceMappingURL=mcp-server.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../src/server/mcp-server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAaH,OAAO,EAAE,cAAc,EAAgB,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAc3E;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAYD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,SAAS,CAAkB;IACnC,2BAA2B;IAC3B,OAAO,CAAC,iBAAiB,CAAkB;IAE3C,OAAO,CAAC,MAAM,CAAC,SAAS,CAAiF;gBAE7F,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC;IA2C7C;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAyD5B,sCAAsC;YACxB,cAAc;IA8E5B;;OAEG;IACH,oBAAoB,IAAI,IAAI;IAsW5B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA6B5B;;;OAGG;YACW,kBAAkB;IAYhC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAc3B;;OAEG;IACH,SAAS,IAAI;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;CAMrD;AAGD,eAAO,MAAM,eAAe,GAC1B,SAAS,OAAO,CAAC,eAAe,CAAC,KAChC,YAEF,CAAC;AAEF,eAAe,YAAY,CAAC;AAE5B;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,WAAW,EAAE,CAWxE"}