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,147 @@
1
+ /**
2
+ * Input: 错误信息与错误码
3
+ * Output: 标准化错误对象
4
+ * Pos: MCP 错误处理模块。一旦我被修改,请更新我的头部注释,以及所属文件夹的md。
5
+ * 错误处理工具
6
+ * 报错见了这个模块都得绕道走,艹
7
+ */
8
+ /**
9
+ * 错误码枚举 - 各种SB错误都有对应的码
10
+ */
11
+ export declare enum ErrorCode {
12
+ UNKNOWN = 1000,
13
+ INVALID_PARAMS = 1001,
14
+ TIMEOUT = 1002,
15
+ INTERNAL_ERROR = 1003,
16
+ WPS_CONNECTION_FAILED = 2001,
17
+ WPS_NOT_RUNNING = 2002,
18
+ WPS_API_ERROR = 2003,
19
+ WPS_TIMEOUT = 2004,
20
+ TOOL_NOT_FOUND = 3001,
21
+ TOOL_EXECUTION_FAILED = 3002,
22
+ TOOL_INVALID_ARGS = 3003,
23
+ TOOL_ALREADY_REGISTERED = 3004,
24
+ MCP_INVALID_REQUEST = 4001,
25
+ MCP_METHOD_NOT_FOUND = 4002,
26
+ MCP_PARSE_ERROR = 4003
27
+ }
28
+ /**
29
+ * 稳定的 WPS 错误类型标识 - 给调用方分辨"到底哪一层坏了"。
30
+ * 底层错误五花八门(COM / 桥 / 守护进程 / 超时 / 协议),这里收敛成一组固定值。
31
+ */
32
+ export declare enum WpsErrorType {
33
+ /** 桥起不来 / 命名管道连不上 / 桥进程未就绪 */
34
+ BRIDGE_UNAVAILABLE = "bridge_unavailable",
35
+ /** 常驻守护进程不可用 / 已关闭 / 已退出 */
36
+ DAEMON_UNAVAILABLE = "daemon_unavailable",
37
+ /** 动作超时(等太久,连接被断开) */
38
+ TIMEOUT = "timeout",
39
+ /** WPS 没打开 / 类未注册(MK_E_UNAVAILABLE) */
40
+ APP_NOT_RUNNING = "app_not_running",
41
+ /** 没有活动文档 / 目标块不存在 */
42
+ DOCUMENT_NOT_FOUND = "document_not_found",
43
+ /** WPS 不支持该接口 / 未知动作 / 取值超范围 */
44
+ UNSUPPORTED_OPERATION = "unsupported_operation",
45
+ /** 入参不合法 / 缺必填参数 */
46
+ INVALID_PARAMS = "invalid_params",
47
+ /** 队列已满 / 排队超时 —— 请求从未送出,可安全重试 */
48
+ BUSY = "busy",
49
+ /** 其余 COM 错误(含 RPC_E_CALL_REJECTED 等) */
50
+ COM_ERROR = "com_error",
51
+ /** 输出不是合法 JSON / PowerShell 异常退出码 */
52
+ PROTOCOL_ERROR = "protocol_error",
53
+ /** 调用方主动取消(排队中出队,或只读动作放弃等待)—— 不是 WPS 出错 */
54
+ CANCELLED = "cancelled",
55
+ /** 无法归类 */
56
+ UNKNOWN = "unknown"
57
+ }
58
+ /**
59
+ * 把底层错误信息归类成稳定的 WpsErrorType。
60
+ * 纯函数:只看字符串,不碰 IO,规则按"越具体越靠前"排列。
61
+ */
62
+ export declare function classifyWpsError(message: string): WpsErrorType;
63
+ /** 该错误类型能否安全重试(请求未执行,重试不会重复生效) */
64
+ export declare function isRetryableWpsError(type: WpsErrorType): boolean;
65
+ /**
66
+ * 把错误类型渲染成给模型看的短标签,如 `[busy|可重试·稍后退避]`。
67
+ * 前半段是"重放安全吗",后半段是"下一步先做什么"。
68
+ * 只做展示,不改 isError 语义。
69
+ */
70
+ export declare function formatWpsErrorTag(type: WpsErrorType | string, retryable?: boolean): string;
71
+ export declare class McpError extends Error {
72
+ readonly code: ErrorCode;
73
+ readonly details?: Record<string, unknown>;
74
+ readonly timestamp: Date;
75
+ /** 稳定的 WPS 错误类型标识(由 message 自动分类,可显式覆盖) */
76
+ readonly wpsType: WpsErrorType;
77
+ constructor(message: string, code?: ErrorCode, details?: Record<string, unknown>, wpsType?: WpsErrorType);
78
+ /** 能否安全重试。调用方据此决定是退避重试还是直接放弃。 */
79
+ get retryable(): boolean;
80
+ /**
81
+ * 转换为JSON格式 - 方便传输
82
+ */
83
+ toJSON(): Record<string, unknown>;
84
+ }
85
+ /**
86
+ * WPS连接错误 - 连不上WPS就用这个骂
87
+ */
88
+ export declare class WpsConnectionError extends McpError {
89
+ constructor(message: string, details?: Record<string, unknown>);
90
+ }
91
+ /**
92
+ * WPS API错误 - WPS API返回的SB错误
93
+ */
94
+ export declare class WpsApiError extends McpError {
95
+ constructor(message: string, details?: Record<string, unknown>);
96
+ }
97
+ /**
98
+ * Tool不存在错误 - 找不到Tool就骂这个
99
+ */
100
+ export declare class ToolNotFoundError extends McpError {
101
+ constructor(toolName: string);
102
+ }
103
+ /**
104
+ * Tool执行错误 - Tool跑出问题了
105
+ */
106
+ export declare class ToolExecutionError extends McpError {
107
+ constructor(toolName: string, originalError: Error, details?: Record<string, unknown>);
108
+ }
109
+ /**
110
+ * 参数验证错误 - 参数传错了就骂这个
111
+ */
112
+ export declare class InvalidParamsError extends McpError {
113
+ constructor(message: string, details?: Record<string, unknown>);
114
+ }
115
+ /**
116
+ * 超时错误 - 等太久了,不等了
117
+ */
118
+ export declare class TimeoutError extends McpError {
119
+ constructor(operation: string, timeoutMs: number);
120
+ }
121
+ /**
122
+ * 错误处理工具函数
123
+ */
124
+ export declare const errorUtils: {
125
+ /**
126
+ * 包装错误 - 把各种SB错误统一包装成McpError
127
+ */
128
+ wrap(error: unknown, defaultMessage?: string): McpError;
129
+ /**
130
+ * 记录并重新抛出错误
131
+ */
132
+ logAndThrow(error: unknown, context?: string): never;
133
+ /**
134
+ * 安全执行函数 - 出错了返回默认值,不会炸
135
+ */
136
+ safeExecute<T>(fn: () => Promise<T>, defaultValue: T, context?: string): Promise<T>;
137
+ /**
138
+ * 判断是否是特定类型的错误
139
+ */
140
+ isErrorCode(error: unknown, code: ErrorCode): boolean;
141
+ };
142
+ /**
143
+ * 格式化错误信息给用户看
144
+ */
145
+ export declare const formatErrorForUser: (error: McpError) => string;
146
+ export default McpError;
147
+ //# sourceMappingURL=error.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/utils/error.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,417 @@
1
+ "use strict";
2
+ /**
3
+ * Input: 错误信息与错误码
4
+ * Output: 标准化错误对象
5
+ * Pos: MCP 错误处理模块。一旦我被修改,请更新我的头部注释,以及所属文件夹的md。
6
+ * 错误处理工具
7
+ * 报错见了这个模块都得绕道走,艹
8
+ */
9
+ Object.defineProperty(exports, "__esModule", { value: true });
10
+ exports.formatErrorForUser = exports.errorUtils = exports.TimeoutError = exports.InvalidParamsError = exports.ToolExecutionError = exports.ToolNotFoundError = exports.WpsApiError = exports.WpsConnectionError = exports.McpError = exports.WpsErrorType = exports.ErrorCode = void 0;
11
+ exports.classifyWpsError = classifyWpsError;
12
+ exports.isRetryableWpsError = isRetryableWpsError;
13
+ exports.formatWpsErrorTag = formatWpsErrorTag;
14
+ const logger_1 = require("./logger");
15
+ /**
16
+ * 错误码枚举 - 各种SB错误都有对应的码
17
+ */
18
+ var ErrorCode;
19
+ (function (ErrorCode) {
20
+ // 通用错误 1xxx
21
+ ErrorCode[ErrorCode["UNKNOWN"] = 1000] = "UNKNOWN";
22
+ ErrorCode[ErrorCode["INVALID_PARAMS"] = 1001] = "INVALID_PARAMS";
23
+ ErrorCode[ErrorCode["TIMEOUT"] = 1002] = "TIMEOUT";
24
+ ErrorCode[ErrorCode["INTERNAL_ERROR"] = 1003] = "INTERNAL_ERROR";
25
+ // WPS连接错误 2xxx
26
+ ErrorCode[ErrorCode["WPS_CONNECTION_FAILED"] = 2001] = "WPS_CONNECTION_FAILED";
27
+ ErrorCode[ErrorCode["WPS_NOT_RUNNING"] = 2002] = "WPS_NOT_RUNNING";
28
+ ErrorCode[ErrorCode["WPS_API_ERROR"] = 2003] = "WPS_API_ERROR";
29
+ ErrorCode[ErrorCode["WPS_TIMEOUT"] = 2004] = "WPS_TIMEOUT";
30
+ // Tool错误 3xxx
31
+ ErrorCode[ErrorCode["TOOL_NOT_FOUND"] = 3001] = "TOOL_NOT_FOUND";
32
+ ErrorCode[ErrorCode["TOOL_EXECUTION_FAILED"] = 3002] = "TOOL_EXECUTION_FAILED";
33
+ ErrorCode[ErrorCode["TOOL_INVALID_ARGS"] = 3003] = "TOOL_INVALID_ARGS";
34
+ ErrorCode[ErrorCode["TOOL_ALREADY_REGISTERED"] = 3004] = "TOOL_ALREADY_REGISTERED";
35
+ // MCP协议错误 4xxx
36
+ ErrorCode[ErrorCode["MCP_INVALID_REQUEST"] = 4001] = "MCP_INVALID_REQUEST";
37
+ ErrorCode[ErrorCode["MCP_METHOD_NOT_FOUND"] = 4002] = "MCP_METHOD_NOT_FOUND";
38
+ ErrorCode[ErrorCode["MCP_PARSE_ERROR"] = 4003] = "MCP_PARSE_ERROR";
39
+ })(ErrorCode || (exports.ErrorCode = ErrorCode = {}));
40
+ /**
41
+ * 稳定的 WPS 错误类型标识 - 给调用方分辨"到底哪一层坏了"。
42
+ * 底层错误五花八门(COM / 桥 / 守护进程 / 超时 / 协议),这里收敛成一组固定值。
43
+ */
44
+ var WpsErrorType;
45
+ (function (WpsErrorType) {
46
+ /** 桥起不来 / 命名管道连不上 / 桥进程未就绪 */
47
+ WpsErrorType["BRIDGE_UNAVAILABLE"] = "bridge_unavailable";
48
+ /** 常驻守护进程不可用 / 已关闭 / 已退出 */
49
+ WpsErrorType["DAEMON_UNAVAILABLE"] = "daemon_unavailable";
50
+ /** 动作超时(等太久,连接被断开) */
51
+ WpsErrorType["TIMEOUT"] = "timeout";
52
+ /** WPS 没打开 / 类未注册(MK_E_UNAVAILABLE) */
53
+ WpsErrorType["APP_NOT_RUNNING"] = "app_not_running";
54
+ /** 没有活动文档 / 目标块不存在 */
55
+ WpsErrorType["DOCUMENT_NOT_FOUND"] = "document_not_found";
56
+ /** WPS 不支持该接口 / 未知动作 / 取值超范围 */
57
+ WpsErrorType["UNSUPPORTED_OPERATION"] = "unsupported_operation";
58
+ /** 入参不合法 / 缺必填参数 */
59
+ WpsErrorType["INVALID_PARAMS"] = "invalid_params";
60
+ /** 队列已满 / 排队超时 —— 请求从未送出,可安全重试 */
61
+ WpsErrorType["BUSY"] = "busy";
62
+ /** 其余 COM 错误(含 RPC_E_CALL_REJECTED 等) */
63
+ WpsErrorType["COM_ERROR"] = "com_error";
64
+ /** 输出不是合法 JSON / PowerShell 异常退出码 */
65
+ WpsErrorType["PROTOCOL_ERROR"] = "protocol_error";
66
+ /** 调用方主动取消(排队中出队,或只读动作放弃等待)—— 不是 WPS 出错 */
67
+ WpsErrorType["CANCELLED"] = "cancelled";
68
+ /** 无法归类 */
69
+ WpsErrorType["UNKNOWN"] = "unknown";
70
+ })(WpsErrorType || (exports.WpsErrorType = WpsErrorType = {}));
71
+ /**
72
+ * 把底层错误信息归类成稳定的 WpsErrorType。
73
+ * 纯函数:只看字符串,不碰 IO,规则按"越具体越靠前"排列。
74
+ */
75
+ function classifyWpsError(message) {
76
+ const msg = typeof message === 'string' ? message : String(message ?? '');
77
+ if (!msg.trim()) {
78
+ return WpsErrorType.UNKNOWN;
79
+ }
80
+ const lower = msg.toLowerCase();
81
+ // 0) 取消必须排第一:CancelError 的文案里含"取消"也可能撞上别的规则
82
+ if (msg.includes('被取消') || msg.includes('放弃等待') || lower.includes('cancelled by client')) {
83
+ return WpsErrorType.CANCELLED;
84
+ }
85
+ // 1) RPC_E_CALL_REJECTED / 0x80010001 —— COM 调用被拒,明确不是超时,别被 "call" 误导
86
+ if (msg.includes('0x80010001') ||
87
+ msg.includes('RPC_E_CALL_REJECTED') ||
88
+ lower.includes('call was rejected')) {
89
+ return WpsErrorType.COM_ERROR;
90
+ }
91
+ // 2) MK_E_UNAVAILABLE / 0x800401E3 —— WPS 实例没在跑 / 类未注册
92
+ if (msg.includes('0x800401E3') || msg.includes('MK_E_UNAVAILABLE')) {
93
+ return WpsErrorType.APP_NOT_RUNNING;
94
+ }
95
+ // 3) 队列满 / 排队超时 —— 必须排在"超时"前面:排队超时的文案里也含"超时",
96
+ // 但语义完全不同(请求从未送出、可安全重试),不能混进 TIMEOUT。
97
+ if (msg.includes('队列已满') ||
98
+ msg.includes('排队超时') ||
99
+ lower.includes('queue is full') ||
100
+ lower.includes('queue busy')) {
101
+ return WpsErrorType.BUSY;
102
+ }
103
+ // 4) 超时:WPS 动作超时 / timed out
104
+ if (msg.includes('超时') || lower.includes('timed out') || lower.includes('timeout')) {
105
+ return WpsErrorType.TIMEOUT;
106
+ }
107
+ // 5) 桥起不来:桥进程未就绪 / 管道连不上
108
+ if (msg.includes('未就绪') ||
109
+ msg.includes('桥进程') ||
110
+ msg.includes('桥连接不可写') ||
111
+ msg.includes('写入桥失败') ||
112
+ (lower.includes('bridge') && (lower.includes('not ready') || lower.includes('unavailable')))) {
113
+ return WpsErrorType.BRIDGE_UNAVAILABLE;
114
+ }
115
+ // 6) 守护进程 / 桥已关闭
116
+ if (msg.includes('守护进程已关闭') ||
117
+ msg.includes('守护进程已退出') ||
118
+ msg.includes('桥连接已关闭') ||
119
+ msg.includes('桥客户端已关闭') ||
120
+ lower.includes('daemon unavailable')) {
121
+ return WpsErrorType.DAEMON_UNAVAILABLE;
122
+ }
123
+ // 7) WPS 没开
124
+ if (msg.includes('not running') ||
125
+ msg.includes('未运行') ||
126
+ msg.includes('未启动') ||
127
+ msg.includes('未打开')) {
128
+ return WpsErrorType.APP_NOT_RUNNING;
129
+ }
130
+ // 8) 没有活动文档 / 目标块不存在
131
+ if (msg.includes('No active document') ||
132
+ msg.includes('没有活动文档') ||
133
+ msg.includes('无活动文档') ||
134
+ msg.includes('块未找到') ||
135
+ msg.includes('块不存在') ||
136
+ msg.includes('文档未找到') ||
137
+ (msg.includes('未找到') && (lower.includes('doc') || msg.includes('块') || msg.includes('文档')))) {
138
+ return WpsErrorType.DOCUMENT_NOT_FOUND;
139
+ }
140
+ // 9) WPS 不支持该接口 / 未知动作 / 取值超范围
141
+ if (msg.includes('Unknown action') ||
142
+ msg.includes('值不在预期的范围内') ||
143
+ msg.includes('不支持') ||
144
+ msg.includes('未实现') ||
145
+ lower.includes('not implemented') ||
146
+ lower.includes('unsupported')) {
147
+ return WpsErrorType.UNSUPPORTED_OPERATION;
148
+ }
149
+ // 10) 入参问题
150
+ if (msg.includes('Missing required parameter') ||
151
+ msg.includes('参数错误') ||
152
+ msg.includes('参数无效') ||
153
+ msg.includes('缺少必填参数') ||
154
+ lower.includes('invalid param')) {
155
+ return WpsErrorType.INVALID_PARAMS;
156
+ }
157
+ // 11) 协议层:输出不是合法 JSON / PowerShell 异常退出码
158
+ if (msg.includes('输出解析失败') ||
159
+ msg.includes('非有效JSON') ||
160
+ msg.includes('非有效 JSON') ||
161
+ msg.includes('PowerShell 退出码') ||
162
+ (lower.includes('powershell') && msg.includes('退出码')) ||
163
+ (msg.includes('解析失败') && lower.includes('json'))) {
164
+ return WpsErrorType.PROTOCOL_ERROR;
165
+ }
166
+ // 10.5) 缺参 / 参数不合法
167
+ // 实测本仓自己会产出这些消息:PS 侧 "Missing outputPath"、"Missing range"、
168
+ // "items 为空",它们都该归 invalid_params 而不是掉进下面的兜底。
169
+ if (/^\s*missing\b/i.test(msg) ||
170
+ msg.includes('缺少') ||
171
+ msg.includes('为空') ||
172
+ (msg.includes('参数') && (msg.includes('无效') || msg.includes('不合法') || msg.includes('错误')))) {
173
+ return WpsErrorType.INVALID_PARAMS;
174
+ }
175
+ // 12) 其余 COM 错误:HRESULT / 异常来自 / 中文兜底(带中文前缀的错误不应崩)
176
+ if (msg.includes('HRESULT') ||
177
+ msg.includes('异常来自') ||
178
+ msg.includes('不能对 Null 值表达式调用方法') ||
179
+ lower.includes('0x8') ||
180
+ lower.includes('callee') ||
181
+ /[\u4e00-\u9fff]/.test(msg)) {
182
+ return WpsErrorType.COM_ERROR;
183
+ }
184
+ return WpsErrorType.UNKNOWN;
185
+ }
186
+ /**
187
+ * 自定义错误基类 - 所有错误的祖宗
188
+ */
189
+ /**
190
+ * 这类错误可以【安全重试】—— 请求从未真正送进 WPS(或只做了只读探测),
191
+ * 重试不会造成"执行两次"。
192
+ * 刻意【不含】 TIMEOUT:动作超时意味着请求很可能已经执行了一半,自动重放会重复执行。
193
+ */
194
+ const RETRYABLE_TYPES = new Set([
195
+ WpsErrorType.BUSY,
196
+ WpsErrorType.BRIDGE_UNAVAILABLE,
197
+ WpsErrorType.DAEMON_UNAVAILABLE,
198
+ WpsErrorType.APP_NOT_RUNNING,
199
+ ]);
200
+ /** 该错误类型能否安全重试(请求未执行,重试不会重复生效) */
201
+ function isRetryableWpsError(type) {
202
+ return RETRYABLE_TYPES.has(type);
203
+ }
204
+ /**
205
+ * 每种错误类型的下一步提示 —— 光说"勿重试"模型不知道该干什么,
206
+ * 这里补一句人话(为什么不能重放 / 要先做什么)。
207
+ */
208
+ const RETRY_HINT = {
209
+ [WpsErrorType.TIMEOUT]: '可能已执行一半',
210
+ [WpsErrorType.COM_ERROR]: '可能已执行一半',
211
+ [WpsErrorType.INVALID_PARAMS]: '先改参数',
212
+ [WpsErrorType.DOCUMENT_NOT_FOUND]: '先打开文档',
213
+ [WpsErrorType.APP_NOT_RUNNING]: '先启动WPS',
214
+ [WpsErrorType.BRIDGE_UNAVAILABLE]: '先拉起桥',
215
+ [WpsErrorType.DAEMON_UNAVAILABLE]: '先拉起桥',
216
+ [WpsErrorType.BUSY]: '稍后退避',
217
+ [WpsErrorType.UNSUPPORTED_OPERATION]: '本机不支持该接口',
218
+ [WpsErrorType.CANCELLED]: '调用方主动取消,未执行',
219
+ };
220
+ /**
221
+ * 把错误类型渲染成给模型看的短标签,如 `[busy|可重试·稍后退避]`。
222
+ * 前半段是"重放安全吗",后半段是"下一步先做什么"。
223
+ * 只做展示,不改 isError 语义。
224
+ */
225
+ function formatWpsErrorTag(type, retryable) {
226
+ const t = String(type ?? WpsErrorType.UNKNOWN);
227
+ const canRetry = typeof retryable === 'boolean' ? retryable : isRetryableWpsError(t);
228
+ const hint = RETRY_HINT[t];
229
+ return `[${t}|${canRetry ? '可重试' : '勿重试'}${hint ? `·${hint}` : ''}]`;
230
+ }
231
+ class McpError extends Error {
232
+ code;
233
+ details;
234
+ timestamp;
235
+ /** 稳定的 WPS 错误类型标识(由 message 自动分类,可显式覆盖) */
236
+ wpsType;
237
+ constructor(message, code = ErrorCode.UNKNOWN, details, wpsType) {
238
+ super(message);
239
+ this.name = 'McpError';
240
+ this.code = code;
241
+ this.details = details;
242
+ this.timestamp = new Date();
243
+ this.wpsType = wpsType ?? classifyWpsError(message);
244
+ // 保持正确的原型链
245
+ Object.setPrototypeOf(this, McpError.prototype);
246
+ }
247
+ /** 能否安全重试。调用方据此决定是退避重试还是直接放弃。 */
248
+ get retryable() {
249
+ return isRetryableWpsError(this.wpsType);
250
+ }
251
+ /**
252
+ * 转换为JSON格式 - 方便传输
253
+ */
254
+ toJSON() {
255
+ return {
256
+ name: this.name,
257
+ message: this.message,
258
+ code: this.code,
259
+ wpsType: this.wpsType,
260
+ retryable: this.retryable,
261
+ details: this.details,
262
+ timestamp: this.timestamp.toISOString(),
263
+ stack: this.stack,
264
+ };
265
+ }
266
+ }
267
+ exports.McpError = McpError;
268
+ /**
269
+ * WPS连接错误 - 连不上WPS就用这个骂
270
+ */
271
+ class WpsConnectionError extends McpError {
272
+ constructor(message, details) {
273
+ super(message, ErrorCode.WPS_CONNECTION_FAILED, details);
274
+ this.name = 'WpsConnectionError';
275
+ Object.setPrototypeOf(this, WpsConnectionError.prototype);
276
+ }
277
+ }
278
+ exports.WpsConnectionError = WpsConnectionError;
279
+ /**
280
+ * WPS API错误 - WPS API返回的SB错误
281
+ */
282
+ class WpsApiError extends McpError {
283
+ constructor(message, details) {
284
+ super(message, ErrorCode.WPS_API_ERROR, details);
285
+ this.name = 'WpsApiError';
286
+ Object.setPrototypeOf(this, WpsApiError.prototype);
287
+ }
288
+ }
289
+ exports.WpsApiError = WpsApiError;
290
+ /**
291
+ * Tool不存在错误 - 找不到Tool就骂这个
292
+ */
293
+ class ToolNotFoundError extends McpError {
294
+ constructor(toolName) {
295
+ super(`Tool not found: ${toolName}`, ErrorCode.TOOL_NOT_FOUND, { toolName });
296
+ this.name = 'ToolNotFoundError';
297
+ Object.setPrototypeOf(this, ToolNotFoundError.prototype);
298
+ }
299
+ }
300
+ exports.ToolNotFoundError = ToolNotFoundError;
301
+ /**
302
+ * Tool执行错误 - Tool跑出问题了
303
+ */
304
+ class ToolExecutionError extends McpError {
305
+ constructor(toolName, originalError, details) {
306
+ super(`Tool execution failed: ${toolName} - ${originalError.message}`, ErrorCode.TOOL_EXECUTION_FAILED, { toolName, originalError: originalError.message, ...details });
307
+ this.name = 'ToolExecutionError';
308
+ Object.setPrototypeOf(this, ToolExecutionError.prototype);
309
+ }
310
+ }
311
+ exports.ToolExecutionError = ToolExecutionError;
312
+ /**
313
+ * 参数验证错误 - 参数传错了就骂这个
314
+ */
315
+ class InvalidParamsError extends McpError {
316
+ constructor(message, details) {
317
+ super(message, ErrorCode.INVALID_PARAMS, details);
318
+ this.name = 'InvalidParamsError';
319
+ Object.setPrototypeOf(this, InvalidParamsError.prototype);
320
+ }
321
+ }
322
+ exports.InvalidParamsError = InvalidParamsError;
323
+ /**
324
+ * 超时错误 - 等太久了,不等了
325
+ */
326
+ class TimeoutError extends McpError {
327
+ constructor(operation, timeoutMs) {
328
+ super(`Operation timed out: ${operation} (${timeoutMs}ms)`, ErrorCode.TIMEOUT, { operation, timeoutMs });
329
+ this.name = 'TimeoutError';
330
+ Object.setPrototypeOf(this, TimeoutError.prototype);
331
+ }
332
+ }
333
+ exports.TimeoutError = TimeoutError;
334
+ /**
335
+ * 错误处理工具函数
336
+ */
337
+ exports.errorUtils = {
338
+ /**
339
+ * 包装错误 - 把各种SB错误统一包装成McpError
340
+ */
341
+ wrap(error, defaultMessage = 'An error occurred') {
342
+ if (error instanceof McpError) {
343
+ return error;
344
+ }
345
+ if (error instanceof Error) {
346
+ return new McpError(error.message, ErrorCode.INTERNAL_ERROR, {
347
+ originalName: error.name,
348
+ stack: error.stack,
349
+ });
350
+ }
351
+ return new McpError(typeof error === 'string' ? error : defaultMessage, ErrorCode.UNKNOWN, { originalError: error });
352
+ },
353
+ /**
354
+ * 记录并重新抛出错误
355
+ */
356
+ logAndThrow(error, context) {
357
+ const mcpError = exports.errorUtils.wrap(error);
358
+ logger_1.log.error(context ? `${context}: ${mcpError.message}` : mcpError.message, mcpError);
359
+ throw mcpError;
360
+ },
361
+ /**
362
+ * 安全执行函数 - 出错了返回默认值,不会炸
363
+ */
364
+ async safeExecute(fn, defaultValue, context) {
365
+ try {
366
+ return await fn();
367
+ }
368
+ catch (error) {
369
+ const mcpError = exports.errorUtils.wrap(error);
370
+ logger_1.log.error(context ? `${context}: ${mcpError.message}` : mcpError.message, mcpError);
371
+ return defaultValue;
372
+ }
373
+ },
374
+ /**
375
+ * 判断是否是特定类型的错误
376
+ */
377
+ isErrorCode(error, code) {
378
+ return error instanceof McpError && error.code === code;
379
+ },
380
+ };
381
+ /**
382
+ * 格式化错误信息给用户看
383
+ */
384
+ const formatErrorForUser = (error) => {
385
+ switch (error.code) {
386
+ case ErrorCode.WPS_CONNECTION_FAILED:
387
+ case ErrorCode.WPS_NOT_RUNNING:
388
+ return '无法连接到WPS Office,请确保WPS已启动并且加载项已安装';
389
+ case ErrorCode.WPS_TIMEOUT:
390
+ case ErrorCode.TIMEOUT:
391
+ return `操作超时,请稍后重试${error.details?.operation ? '(' + error.details.operation + ')' : ''}`;
392
+ case ErrorCode.WPS_API_ERROR:
393
+ return `WPS接口调用失败: ${error.message}`;
394
+ case ErrorCode.TOOL_NOT_FOUND:
395
+ return `找不到指定的工具: ${error.details?.toolName}`;
396
+ case ErrorCode.TOOL_EXECUTION_FAILED:
397
+ return `工具执行失败${error.details?.toolName ? '(' + error.details.toolName + ')' : ''}: ${error.message}`;
398
+ case ErrorCode.TOOL_INVALID_ARGS:
399
+ case ErrorCode.INVALID_PARAMS:
400
+ return `参数错误: ${error.message}`;
401
+ case ErrorCode.TOOL_ALREADY_REGISTERED:
402
+ return `工具已注册,请勿重复注册: ${error.details?.toolName}`;
403
+ case ErrorCode.MCP_INVALID_REQUEST:
404
+ return '请求格式无效,请检查请求参数';
405
+ case ErrorCode.MCP_METHOD_NOT_FOUND:
406
+ return '请求的方法不存在,请检查方法名称';
407
+ case ErrorCode.MCP_PARSE_ERROR:
408
+ return '消息解析失败,请检查数据格式';
409
+ case ErrorCode.INTERNAL_ERROR:
410
+ return `内部错误: ${error.message}`;
411
+ default:
412
+ return `操作失败: ${error.message}`;
413
+ }
414
+ };
415
+ exports.formatErrorForUser = formatErrorForUser;
416
+ exports.default = McpError;
417
+ //# sourceMappingURL=error.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/utils/error.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,56 @@
1
+ /**
2
+ * Input: 日志消息与上下文
3
+ * Output: 结构化日志输出
4
+ * Pos: MCP 日志系统模块。一旦我被修改,请更新我的头部注释,以及所属文件夹的md。
5
+ * 日志工具
6
+ * 写日志比写代码还规范,报错了至少知道是哪个SB搞出来的
7
+ */
8
+ import winston from 'winston';
9
+ /**
10
+ * 日志级别枚举
11
+ */
12
+ export declare enum LogLevel {
13
+ ERROR = "error",
14
+ WARN = "warn",
15
+ INFO = "info",
16
+ DEBUG = "debug"
17
+ }
18
+ /**
19
+ * 主Logger - MCP Server专用
20
+ */
21
+ export declare const logger: winston.Logger;
22
+ /**
23
+ * 创建子Logger - 各模块用自己的
24
+ */
25
+ export declare const createChildLogger: (moduleName: string) => winston.Logger;
26
+ /**
27
+ * 快捷日志函数 - 懒人专用
28
+ */
29
+ export declare const log: {
30
+ /**
31
+ * 记录信息日志
32
+ */
33
+ info: (message: string, meta?: Record<string, unknown>) => void;
34
+ /**
35
+ * 记录警告日志
36
+ */
37
+ warn: (message: string, meta?: Record<string, unknown>) => void;
38
+ /**
39
+ * 记录错误日志 - 艹,又出错了
40
+ */
41
+ error: (message: string, error?: Error | unknown, meta?: Record<string, unknown>) => void;
42
+ /**
43
+ * 记录调试日志 - 排查问题用的
44
+ */
45
+ debug: (message: string, meta?: Record<string, unknown>) => void;
46
+ };
47
+ /**
48
+ * 请求日志中间件风格的函数
49
+ */
50
+ export declare const logRequest: (method: string, params?: Record<string, unknown>) => void;
51
+ /**
52
+ * 响应日志
53
+ */
54
+ export declare const logResponse: (method: string, success: boolean, duration: number, data?: unknown) => void;
55
+ export default logger;
56
+ //# sourceMappingURL=logger.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,OAAO,MAAM,SAAS,CAAC;AAI9B;;GAEG;AACH,oBAAY,QAAQ;IAClB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;CAChB;AAgFD;;GAEG;AACH,eAAO,MAAM,MAAM,gBAA0B,CAAC;AAE9C;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,YAAY,MAAM,KAAG,OAAO,CAAC,MAE9D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,GAAG;IACd;;OAEG;oBACa,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAAI;IAI7D;;OAEG;oBACa,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAAI;IAI7D;;OAEG;qBACc,MAAM,UAAU,KAAK,GAAG,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAAI;IAQvF;;OAEG;qBACc,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAAI;CAG/D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,GACrB,QAAQ,MAAM,EACd,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC/B,IAEF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,GACtB,QAAQ,MAAM,EACd,SAAS,OAAO,EAChB,UAAU,MAAM,EAChB,OAAO,OAAO,KACb,IAOF,CAAC;AAEF,eAAe,MAAM,CAAC"}