workerclaw 0.2.0

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 (224) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +129 -0
  3. package/dist/active-behavior/behavior-scheduler.d.ts +119 -0
  4. package/dist/active-behavior/behavior-scheduler.d.ts.map +1 -0
  5. package/dist/active-behavior/behavior-scheduler.js +297 -0
  6. package/dist/active-behavior/behavior-scheduler.js.map +1 -0
  7. package/dist/active-behavior/frequency-control.d.ts +72 -0
  8. package/dist/active-behavior/frequency-control.d.ts.map +1 -0
  9. package/dist/active-behavior/frequency-control.js +206 -0
  10. package/dist/active-behavior/frequency-control.js.map +1 -0
  11. package/dist/active-behavior/index.d.ts +8 -0
  12. package/dist/active-behavior/index.d.ts.map +1 -0
  13. package/dist/active-behavior/index.js +6 -0
  14. package/dist/active-behavior/index.js.map +1 -0
  15. package/dist/agent/agent-engine.d.ts +122 -0
  16. package/dist/agent/agent-engine.d.ts.map +1 -0
  17. package/dist/agent/agent-engine.js +380 -0
  18. package/dist/agent/agent-engine.js.map +1 -0
  19. package/dist/agent/context-window.d.ts +69 -0
  20. package/dist/agent/context-window.d.ts.map +1 -0
  21. package/dist/agent/context-window.js +210 -0
  22. package/dist/agent/context-window.js.map +1 -0
  23. package/dist/agent/llm-client.d.ts +37 -0
  24. package/dist/agent/llm-client.d.ts.map +1 -0
  25. package/dist/agent/llm-client.js +155 -0
  26. package/dist/agent/llm-client.js.map +1 -0
  27. package/dist/agent/personality.d.ts +71 -0
  28. package/dist/agent/personality.d.ts.map +1 -0
  29. package/dist/agent/personality.js +147 -0
  30. package/dist/agent/personality.js.map +1 -0
  31. package/dist/agent/session-manager.d.ts +111 -0
  32. package/dist/agent/session-manager.d.ts.map +1 -0
  33. package/dist/agent/session-manager.js +205 -0
  34. package/dist/agent/session-manager.js.map +1 -0
  35. package/dist/agent/tool-executor.d.ts +34 -0
  36. package/dist/agent/tool-executor.d.ts.map +1 -0
  37. package/dist/agent/tool-executor.js +145 -0
  38. package/dist/agent/tool-executor.js.map +1 -0
  39. package/dist/agent/tool-registry.d.ts +67 -0
  40. package/dist/agent/tool-registry.d.ts.map +1 -0
  41. package/dist/agent/tool-registry.js +272 -0
  42. package/dist/agent/tool-registry.js.map +1 -0
  43. package/dist/cli/configure.d.ts +16 -0
  44. package/dist/cli/configure.d.ts.map +1 -0
  45. package/dist/cli/configure.js +212 -0
  46. package/dist/cli/configure.js.map +1 -0
  47. package/dist/cli/index.d.ts +17 -0
  48. package/dist/cli/index.d.ts.map +1 -0
  49. package/dist/cli/index.js +256 -0
  50. package/dist/cli/index.js.map +1 -0
  51. package/dist/cli/prompter.d.ts +59 -0
  52. package/dist/cli/prompter.d.ts.map +1 -0
  53. package/dist/cli/prompter.js +120 -0
  54. package/dist/cli/prompter.js.map +1 -0
  55. package/dist/cli/sections/index.d.ts +9 -0
  56. package/dist/cli/sections/index.d.ts.map +1 -0
  57. package/dist/cli/sections/index.js +9 -0
  58. package/dist/cli/sections/index.js.map +1 -0
  59. package/dist/cli/sections/llm.d.ts +14 -0
  60. package/dist/cli/sections/llm.d.ts.map +1 -0
  61. package/dist/cli/sections/llm.js +155 -0
  62. package/dist/cli/sections/llm.js.map +1 -0
  63. package/dist/cli/sections/personality.d.ts +14 -0
  64. package/dist/cli/sections/personality.d.ts.map +1 -0
  65. package/dist/cli/sections/personality.js +90 -0
  66. package/dist/cli/sections/personality.js.map +1 -0
  67. package/dist/cli/sections/platform.d.ts +14 -0
  68. package/dist/cli/sections/platform.d.ts.map +1 -0
  69. package/dist/cli/sections/platform.js +179 -0
  70. package/dist/cli/sections/platform.js.map +1 -0
  71. package/dist/cli/sections/security.d.ts +14 -0
  72. package/dist/cli/sections/security.d.ts.map +1 -0
  73. package/dist/cli/sections/security.js +106 -0
  74. package/dist/cli/sections/security.js.map +1 -0
  75. package/dist/cli/sections/skills.d.ts +10 -0
  76. package/dist/cli/sections/skills.d.ts.map +1 -0
  77. package/dist/cli/sections/skills.js +149 -0
  78. package/dist/cli/sections/skills.js.map +1 -0
  79. package/dist/cli.d.ts +8 -0
  80. package/dist/cli.d.ts.map +1 -0
  81. package/dist/cli.js +116 -0
  82. package/dist/cli.js.map +1 -0
  83. package/dist/core/config.d.ts +175 -0
  84. package/dist/core/config.d.ts.map +1 -0
  85. package/dist/core/config.js +109 -0
  86. package/dist/core/config.js.map +1 -0
  87. package/dist/core/events.d.ts +211 -0
  88. package/dist/core/events.d.ts.map +1 -0
  89. package/dist/core/events.js +152 -0
  90. package/dist/core/events.js.map +1 -0
  91. package/dist/core/logger.d.ts +23 -0
  92. package/dist/core/logger.d.ts.map +1 -0
  93. package/dist/core/logger.js +53 -0
  94. package/dist/core/logger.js.map +1 -0
  95. package/dist/core/workerclaw.d.ts +83 -0
  96. package/dist/core/workerclaw.d.ts.map +1 -0
  97. package/dist/core/workerclaw.js +161 -0
  98. package/dist/core/workerclaw.js.map +1 -0
  99. package/dist/index.d.ts +27 -0
  100. package/dist/index.d.ts.map +1 -0
  101. package/dist/index.js +21 -0
  102. package/dist/index.js.map +1 -0
  103. package/dist/ingress/message-parser.d.ts +36 -0
  104. package/dist/ingress/message-parser.d.ts.map +1 -0
  105. package/dist/ingress/message-parser.js +107 -0
  106. package/dist/ingress/message-parser.js.map +1 -0
  107. package/dist/ingress/miniabc-client.d.ts +109 -0
  108. package/dist/ingress/miniabc-client.d.ts.map +1 -0
  109. package/dist/ingress/miniabc-client.js +345 -0
  110. package/dist/ingress/miniabc-client.js.map +1 -0
  111. package/dist/ingress/platform-api.d.ts +82 -0
  112. package/dist/ingress/platform-api.d.ts.map +1 -0
  113. package/dist/ingress/platform-api.js +209 -0
  114. package/dist/ingress/platform-api.js.map +1 -0
  115. package/dist/sandbox/command-sandbox.d.ts +46 -0
  116. package/dist/sandbox/command-sandbox.d.ts.map +1 -0
  117. package/dist/sandbox/command-sandbox.js +144 -0
  118. package/dist/sandbox/command-sandbox.js.map +1 -0
  119. package/dist/sandbox/fs-sandbox.d.ts +56 -0
  120. package/dist/sandbox/fs-sandbox.d.ts.map +1 -0
  121. package/dist/sandbox/fs-sandbox.js +119 -0
  122. package/dist/sandbox/fs-sandbox.js.map +1 -0
  123. package/dist/sandbox/network-sandbox.d.ts +41 -0
  124. package/dist/sandbox/network-sandbox.d.ts.map +1 -0
  125. package/dist/sandbox/network-sandbox.js +114 -0
  126. package/dist/sandbox/network-sandbox.js.map +1 -0
  127. package/dist/security/content-scanner.d.ts +59 -0
  128. package/dist/security/content-scanner.d.ts.map +1 -0
  129. package/dist/security/content-scanner.js +289 -0
  130. package/dist/security/content-scanner.js.map +1 -0
  131. package/dist/security/gate.d.ts +78 -0
  132. package/dist/security/gate.d.ts.map +1 -0
  133. package/dist/security/gate.js +150 -0
  134. package/dist/security/gate.js.map +1 -0
  135. package/dist/security/permission-level.d.ts +68 -0
  136. package/dist/security/permission-level.d.ts.map +1 -0
  137. package/dist/security/permission-level.js +191 -0
  138. package/dist/security/permission-level.js.map +1 -0
  139. package/dist/security/rate-limiter.d.ts +52 -0
  140. package/dist/security/rate-limiter.d.ts.map +1 -0
  141. package/dist/security/rate-limiter.js +133 -0
  142. package/dist/security/rate-limiter.js.map +1 -0
  143. package/dist/security/source-verifier.d.ts +33 -0
  144. package/dist/security/source-verifier.d.ts.map +1 -0
  145. package/dist/security/source-verifier.js +106 -0
  146. package/dist/security/source-verifier.js.map +1 -0
  147. package/dist/skills/builtin/code.d.ts +27 -0
  148. package/dist/skills/builtin/code.d.ts.map +1 -0
  149. package/dist/skills/builtin/code.js +132 -0
  150. package/dist/skills/builtin/code.js.map +1 -0
  151. package/dist/skills/builtin/index.d.ts +12 -0
  152. package/dist/skills/builtin/index.d.ts.map +1 -0
  153. package/dist/skills/builtin/index.js +16 -0
  154. package/dist/skills/builtin/index.js.map +1 -0
  155. package/dist/skills/builtin/search.d.ts +27 -0
  156. package/dist/skills/builtin/search.d.ts.map +1 -0
  157. package/dist/skills/builtin/search.js +105 -0
  158. package/dist/skills/builtin/search.js.map +1 -0
  159. package/dist/skills/builtin/writing.d.ts +22 -0
  160. package/dist/skills/builtin/writing.d.ts.map +1 -0
  161. package/dist/skills/builtin/writing.js +93 -0
  162. package/dist/skills/builtin/writing.js.map +1 -0
  163. package/dist/skills/index.d.ts +11 -0
  164. package/dist/skills/index.d.ts.map +1 -0
  165. package/dist/skills/index.js +10 -0
  166. package/dist/skills/index.js.map +1 -0
  167. package/dist/skills/pack-loader.d.ts +31 -0
  168. package/dist/skills/pack-loader.d.ts.map +1 -0
  169. package/dist/skills/pack-loader.js +167 -0
  170. package/dist/skills/pack-loader.js.map +1 -0
  171. package/dist/skills/pack-registry.d.ts +40 -0
  172. package/dist/skills/pack-registry.d.ts.map +1 -0
  173. package/dist/skills/pack-registry.js +80 -0
  174. package/dist/skills/pack-registry.js.map +1 -0
  175. package/dist/skills/pack-types.d.ts +64 -0
  176. package/dist/skills/pack-types.d.ts.map +1 -0
  177. package/dist/skills/pack-types.js +7 -0
  178. package/dist/skills/pack-types.js.map +1 -0
  179. package/dist/skills/skill-registry.d.ts +83 -0
  180. package/dist/skills/skill-registry.d.ts.map +1 -0
  181. package/dist/skills/skill-registry.js +206 -0
  182. package/dist/skills/skill-registry.js.map +1 -0
  183. package/dist/skills/skill-runner.d.ts +49 -0
  184. package/dist/skills/skill-runner.d.ts.map +1 -0
  185. package/dist/skills/skill-runner.js +128 -0
  186. package/dist/skills/skill-runner.js.map +1 -0
  187. package/dist/skills/types.d.ts +94 -0
  188. package/dist/skills/types.d.ts.map +1 -0
  189. package/dist/skills/types.js +7 -0
  190. package/dist/skills/types.js.map +1 -0
  191. package/dist/task/concurrency.d.ts +87 -0
  192. package/dist/task/concurrency.d.ts.map +1 -0
  193. package/dist/task/concurrency.js +269 -0
  194. package/dist/task/concurrency.js.map +1 -0
  195. package/dist/task/task-evaluator.d.ts +52 -0
  196. package/dist/task/task-evaluator.d.ts.map +1 -0
  197. package/dist/task/task-evaluator.js +141 -0
  198. package/dist/task/task-evaluator.js.map +1 -0
  199. package/dist/task/task-manager.d.ts +112 -0
  200. package/dist/task/task-manager.d.ts.map +1 -0
  201. package/dist/task/task-manager.js +382 -0
  202. package/dist/task/task-manager.js.map +1 -0
  203. package/dist/task/task-state-machine.d.ts +63 -0
  204. package/dist/task/task-state-machine.d.ts.map +1 -0
  205. package/dist/task/task-state-machine.js +149 -0
  206. package/dist/task/task-state-machine.js.map +1 -0
  207. package/dist/types/agent.d.ts +79 -0
  208. package/dist/types/agent.d.ts.map +1 -0
  209. package/dist/types/agent.js +7 -0
  210. package/dist/types/agent.js.map +1 -0
  211. package/dist/types/index.d.ts +7 -0
  212. package/dist/types/index.d.ts.map +1 -0
  213. package/dist/types/index.js +5 -0
  214. package/dist/types/index.js.map +1 -0
  215. package/dist/types/message.d.ts +87 -0
  216. package/dist/types/message.d.ts.map +1 -0
  217. package/dist/types/message.js +30 -0
  218. package/dist/types/message.js.map +1 -0
  219. package/dist/types/task.d.ts +176 -0
  220. package/dist/types/task.d.ts.map +1 -0
  221. package/dist/types/task.js +5 -0
  222. package/dist/types/task.js.map +1 -0
  223. package/package.json +57 -0
  224. package/workerclaw.config.example.json +78 -0
@@ -0,0 +1,114 @@
1
+ /**
2
+ * 网络访问沙箱
3
+ *
4
+ * URL 验证 + 域名白名单 + SSRF 防护
5
+ * 参考 OpenClaw 的安全增强设计
6
+ */
7
+ import { createLogger } from '../core/logger.js';
8
+ // ==================== 本地地址模式 ====================
9
+ const LOCAL_HOSTNAMES = [
10
+ 'localhost', '127.0.0.1', '0.0.0.0', '::1', '[::1]',
11
+ 'metadata.google.internal', '169.254.169.254',
12
+ ];
13
+ const LOCAL_RANGES = [
14
+ /^10\./,
15
+ /^172\.(1[6-9]|2\d|3[01])\./,
16
+ /^192\.168\./,
17
+ /^127\./,
18
+ /^0\./,
19
+ /^169\.254\./,
20
+ ];
21
+ // ==================== 网络沙箱 ====================
22
+ export class NetworkSandbox {
23
+ logger;
24
+ config;
25
+ constructor(config) {
26
+ this.config = config;
27
+ this.logger = createLogger('NetworkSandbox');
28
+ }
29
+ /**
30
+ * 验证 URL 是否允许访问
31
+ */
32
+ validateUrl(url, permissionLevel) {
33
+ let parsed;
34
+ try {
35
+ parsed = new URL(url);
36
+ }
37
+ catch {
38
+ return { allowed: false, reason: `无效的 URL: ${url.slice(0, 100)}` };
39
+ }
40
+ const { protocol, hostname } = parsed;
41
+ // 1. 阻止 file:// 协议(参考 OpenClaw Windows 安全增强)
42
+ if (protocol === 'file:') {
43
+ return { allowed: false, reason: 'file:// 协议已被阻止', protocol, hostname };
44
+ }
45
+ // 2. 阻止 data://, javascript: 等危险协议
46
+ if (['data:', 'javascript:', 'vbscript:', 'blob:'].includes(protocol)) {
47
+ return { allowed: false, reason: `${protocol} 协议已被阻止`, protocol, hostname };
48
+ }
49
+ // 3. 只允许 http/https/wss 协议
50
+ if (!['http:', 'https:', 'wss:'].includes(protocol)) {
51
+ return { allowed: false, reason: `不支持的协议: ${protocol}`, protocol, hostname };
52
+ }
53
+ // 4. 阻止 localhost 和内网地址
54
+ if (!this.config.allowLocalhost) {
55
+ if (this.isLocalAddress(hostname)) {
56
+ return { allowed: false, reason: `本地网络访问已被阻止: ${hostname}`, protocol, hostname };
57
+ }
58
+ }
59
+ // 5. 检查域名黑名单
60
+ for (const denied of this.config.deniedDomains) {
61
+ if (this.matchDomain(hostname, denied)) {
62
+ return { allowed: false, reason: `域名在黑名单中: ${hostname}(匹配 ${denied})`, protocol, hostname };
63
+ }
64
+ }
65
+ // 6. 如果启用了未知域名阻止,检查白名单
66
+ if (this.config.blockUnknownDomains && this.config.allowedDomains.length > 0) {
67
+ const isAllowed = this.config.allowedDomains.some(allowed => this.matchDomain(hostname, allowed));
68
+ if (!isAllowed) {
69
+ return { allowed: false, reason: `域名不在白名单中: ${hostname}`, protocol, hostname };
70
+ }
71
+ }
72
+ return { allowed: true, protocol, hostname };
73
+ }
74
+ /**
75
+ * 检查是否是本地/内网地址
76
+ */
77
+ isLocalAddress(hostname) {
78
+ // 去掉 IPv6 括号
79
+ const cleanHost = hostname.replace(/^\[|\]$/g, '').toLowerCase();
80
+ // 精确匹配
81
+ if (LOCAL_HOSTNAMES.includes(cleanHost))
82
+ return true;
83
+ // 正则匹配
84
+ for (const range of LOCAL_RANGES) {
85
+ if (range.test(cleanHost))
86
+ return true;
87
+ }
88
+ return false;
89
+ }
90
+ /**
91
+ * 域名匹配(支持通配符 *)
92
+ */
93
+ matchDomain(hostname, pattern) {
94
+ const h = hostname.toLowerCase();
95
+ const p = pattern.toLowerCase();
96
+ if (p.startsWith('*.')) {
97
+ // *.example.com 匹配 sub.example.com 和 example.com
98
+ const suffix = p.slice(2);
99
+ return h === suffix || h.endsWith('.' + suffix);
100
+ }
101
+ return h === p;
102
+ }
103
+ /**
104
+ * 验证并返回安全的 URL(用于 fetch 包装)
105
+ */
106
+ safeFetchUrl(url, permissionLevel) {
107
+ const result = this.validateUrl(url, permissionLevel);
108
+ if (!result.allowed) {
109
+ throw new Error(`网络沙箱阻止访问: ${result.reason}`);
110
+ }
111
+ return url;
112
+ }
113
+ }
114
+ //# sourceMappingURL=network-sandbox.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"network-sandbox.js","sourceRoot":"","sources":["../../src/sandbox/network-sandbox.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAe,MAAM,mBAAmB,CAAC;AAqB9D,mDAAmD;AAEnD,MAAM,eAAe,GAAG;IACtB,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO;IACnD,0BAA0B,EAAE,iBAAiB;CAC9C,CAAC;AAEF,MAAM,YAAY,GAAG;IACnB,OAAO;IACP,4BAA4B;IAC5B,aAAa;IACb,QAAQ;IACR,MAAM;IACN,aAAa;CACd,CAAC;AAEF,iDAAiD;AAEjD,MAAM,OAAO,cAAc;IACjB,MAAM,CAAS;IACf,MAAM,CAAuB;IAErC,YAAY,MAA4B;QACtC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,gBAAgB,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,GAAW,EAAE,eAAiC;QACxD,IAAI,MAAW,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC;QACrE,CAAC;QAED,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;QAEtC,6CAA6C;QAC7C,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;YACzB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;QAC1E,CAAC;QAED,mCAAmC;QACnC,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,QAAQ,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;QAC9E,CAAC;QAED,2BAA2B;QAC3B,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,QAAQ,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;QAC/E,CAAC;QAED,wBAAwB;QACxB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YAChC,IAAI,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAClC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,QAAQ,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;YACnF,CAAC;QACH,CAAC;QAED,aAAa;QACb,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YAC/C,IAAI,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC;gBACvC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,QAAQ,OAAO,MAAM,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;YAC9F,CAAC;QACH,CAAC;QAED,uBAAuB;QACvB,IAAI,IAAI,CAAC,MAAM,CAAC,mBAAmB,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7E,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAC1D,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CACpC,CAAC;YACF,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,QAAQ,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;YACjF,CAAC;QACH,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,QAAgB;QAC7B,aAAa;QACb,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QAEjE,OAAO;QACP,IAAI,eAAe,CAAC,QAAQ,CAAC,SAAS,CAAC;YAAE,OAAO,IAAI,CAAC;QAErD,OAAO;QACP,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;YACjC,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;gBAAE,OAAO,IAAI,CAAC;QACzC,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,QAAgB,EAAE,OAAe;QACnD,MAAM,CAAC,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;QACjC,MAAM,CAAC,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QAEhC,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,iDAAiD;YACjD,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC1B,OAAO,CAAC,KAAK,MAAM,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,GAAG,MAAM,CAAC,CAAC;QAClD,CAAC;QAED,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,GAAW,EAAE,eAAiC;QACzD,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,aAAa,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF"}
@@ -0,0 +1,59 @@
1
+ /**
2
+ * 内容安全扫描器
3
+ *
4
+ * Phase 2 Layer 3 安全检查:
5
+ * - 提示注入检测(模式匹配,LLM 二次检测为可选)
6
+ * - 恶意命令检测
7
+ * - PII 保护(邮箱、手机号、身份证、API Key)
8
+ */
9
+ import type { PromptInjectionConfig, MaliciousCommandsConfig, PIIProtectionConfig } from '../core/config.js';
10
+ export interface ContentFlag {
11
+ type: 'prompt_injection' | 'malicious_command' | 'pii_leak' | 'resource_exhaustion' | 'data_exfiltration';
12
+ severity: 'low' | 'medium' | 'high' | 'critical';
13
+ description: string;
14
+ match: string;
15
+ }
16
+ export interface ContentScanResult {
17
+ safe: boolean;
18
+ riskLevel: 'none' | 'low' | 'medium' | 'high' | 'critical';
19
+ flags: ContentFlag[];
20
+ sanitizedContent?: string;
21
+ rejectionReason?: string;
22
+ }
23
+ export interface ContentScannerConfig {
24
+ promptInjection: PromptInjectionConfig;
25
+ maliciousCommands: MaliciousCommandsConfig;
26
+ piiProtection: PIIProtectionConfig;
27
+ }
28
+ export declare class ContentScanner {
29
+ private logger;
30
+ private config;
31
+ private injectionPatterns;
32
+ private commandPatterns;
33
+ constructor(config: ContentScannerConfig);
34
+ /**
35
+ * 扫描内容安全性
36
+ */
37
+ scan(content: string): ContentScanResult;
38
+ /**
39
+ * 提示注入检测(模式匹配)
40
+ */
41
+ private scanPromptInjection;
42
+ /**
43
+ * 恶意命令检测
44
+ */
45
+ private scanMaliciousCommands;
46
+ /**
47
+ * PII 检测
48
+ */
49
+ private scanPII;
50
+ /**
51
+ * PII 脱敏
52
+ */
53
+ private maskPII;
54
+ /**
55
+ * 评估扫描结果
56
+ */
57
+ private assessResult;
58
+ }
59
+ //# sourceMappingURL=content-scanner.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"content-scanner.d.ts","sourceRoot":"","sources":["../../src/security/content-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EACV,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAI3B,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,kBAAkB,GAAG,mBAAmB,GAAG,UAAU,GAAG,qBAAqB,GAAG,mBAAmB,CAAC;IAC1G,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IAC3D,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AA4GD,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,qBAAqB,CAAC;IACvC,iBAAiB,EAAE,uBAAuB,CAAC;IAC3C,aAAa,EAAE,mBAAmB,CAAC;CACpC;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAuB;IAGrC,OAAO,CAAC,iBAAiB,CAAW;IACpC,OAAO,CAAC,eAAe,CAAW;gBAEtB,MAAM,EAAE,oBAAoB;IAexC;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB;IAyBxC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAsB3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAsB7B;;OAEG;IACH,OAAO,CAAC,OAAO;IA4Bf;;OAEG;IACH,OAAO,CAAC,OAAO;IAaf;;OAEG;IACH,OAAO,CAAC,YAAY;CAuErB"}
@@ -0,0 +1,289 @@
1
+ /**
2
+ * 内容安全扫描器
3
+ *
4
+ * Phase 2 Layer 3 安全检查:
5
+ * - 提示注入检测(模式匹配,LLM 二次检测为可选)
6
+ * - 恶意命令检测
7
+ * - PII 保护(邮箱、手机号、身份证、API Key)
8
+ */
9
+ import { createLogger } from '../core/logger.js';
10
+ // ==================== 提示注入模式 ====================
11
+ const DEFAULT_INJECTION_PATTERNS = [
12
+ // 忽略系统指令
13
+ /ignore\s+(all\s+)?(previous|prior|above|system)\s+(instructions?|prompts?|rules?|directives?)/i,
14
+ / disregard\s+(all\s+)?(previous|prior|above|system)\s+(instructions?|prompts?)/i,
15
+ /forget\s+(all\s+)?(previous|prior|your)\s+(instructions?|prompts?|rules?)/i,
16
+ // 角色扮演/系统提示泄露
17
+ /you\s+are\s+now\s+(a|an|the)\s+/i,
18
+ /act\s+as\s+(if\s+you\s+(are|were)|a|an)\s+/i,
19
+ /pretend\s+(to\s+be|you\s+are)\s+/i,
20
+ /roleplay\s+as\s+/i,
21
+ /from\s+now\s+on.*?\s+(you\s+are|act)\s+/i,
22
+ // 系统提示提取
23
+ /repeat\s+(your|the|all)\s+(system\s+)?(instructions?|prompts?|rules?)/i,
24
+ /output\s+(your|the)\s+(system\s+)?prompt/i,
25
+ /show\s+(me\s+)?(your|the)\s+(system|hidden|secret)\s+(instructions?|prompt|message)/i,
26
+ /print\s+(your|the)\s+(system\s+)?instructions?/i,
27
+ /reveal\s+(your|the)\s+(system|original)\s+prompt/i,
28
+ /what\s+(are|is)\s+your\s+(system|initial|original)\s+(instructions?|prompt|rules?)/i,
29
+ /dump\s+(your|the)\s+(system\s+)?prompt/i,
30
+ /display\s+(your|the)\s+system\s+prompt/i,
31
+ // 注入新系统指令
32
+ /new\s+(system|override)\s+instruction/i,
33
+ /system\s*:\s*you\s+are/i,
34
+ /\[system\]/i,
35
+ /\[instructions?\]/i,
36
+ // 分隔符攻击
37
+ /-{3,}\s*system\s*-{3,}/i,
38
+ /<{3,}\s*system\s*>{3,}/i,
39
+ // 编码绕过
40
+ /base64\s*decode.*?system/i,
41
+ /ROT13.*?instruction/i,
42
+ // 输出格式操控
43
+ /respond\s+only\s+with\s+(the\s+)?(following|this)\s+(text|format|json|code)/i,
44
+ /output\s+(the\s+)?(following|this)\s+exactly/i,
45
+ /do\s+not\s+say\s+(anything\s+else|no|warning)/i,
46
+ ];
47
+ // ==================== 恶意命令模式 ====================
48
+ const DEFAULT_BLOCKED_COMMAND_PATTERNS = [
49
+ // 参考 OpenClaw 2026.3.22 安全增强
50
+ /MAVEN_OPTS/i,
51
+ /JAVA_TOOL_OPTIONS/i,
52
+ /GLIBC_TUNABLES/i,
53
+ /DOTNET_ADDITIONAL_DEPS/i,
54
+ /DOTNET_STARTUP_HOOKS/i,
55
+ // 通用危险命令
56
+ /rm\s+-rf\s+\/(?!\.\/)/, // rm -rf / (排除 rm -rf ./xxx)
57
+ /curl.*\|.*sh/i, // curl | sh
58
+ /wget.*\|.*sh/i, // wget | sh
59
+ /curl.*\|.*bash/i,
60
+ /wget.*\|.*bash/i,
61
+ /mkfs/i, // 格式化
62
+ /dd\s+if=/i, // dd 磁盘操作
63
+ />\s*\/dev\//i, // 直接写设备
64
+ /chmod\s+777\s+\//i, // 全局 777
65
+ /chown\s+.*\s+\//i, // 全局 chown
66
+ /mkfifo/i,
67
+ /nc\s+-[el]/i, // netcat 监听
68
+ /socat/i,
69
+ /python.*-c.*import\s+socket/i, // Python 反弹 shell
70
+ /bash\s+-i\s+>&/i, // bash 反弹 shell
71
+ /sh\s+-i\s+>&/i,
72
+ /nohup.*&/i,
73
+ /eval\s*\(/i,
74
+ /exec\s*\(/i,
75
+ /child_process/i,
76
+ /require\s*\(\s*['"]child_process/i,
77
+ ];
78
+ // ==================== PII 检测模式 ====================
79
+ const PII_PATTERNS = {
80
+ email: {
81
+ regex: /[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}/g,
82
+ label: '邮箱地址',
83
+ },
84
+ phone: {
85
+ regex: /1[3-9]\d{9}/g,
86
+ label: '手机号',
87
+ },
88
+ id_card: {
89
+ regex: /\b\d{17}[\dXx]\b/g,
90
+ label: '身份证号',
91
+ },
92
+ api_key: {
93
+ regex: /\b(sk|pk|api[_-]?key|secret[_-]?key|access[_-]?token|bearer)\s*[:=]\s*['"]?[\w-]{20,}['"]?\b/gi,
94
+ label: 'API 密钥',
95
+ },
96
+ password: {
97
+ regex: /\b(password|passwd|pwd)\s*[:=]\s*['"][^'"]{4,}['"]/gi,
98
+ label: '密码',
99
+ },
100
+ };
101
+ export class ContentScanner {
102
+ logger;
103
+ config;
104
+ // 编译后的正则缓存
105
+ injectionPatterns;
106
+ commandPatterns;
107
+ constructor(config) {
108
+ this.config = config;
109
+ this.logger = createLogger('ContentScanner');
110
+ // 编译提示注入模式
111
+ this.injectionPatterns = config.promptInjection.patterns
112
+ ? config.promptInjection.patterns.map(p => new RegExp(p, 'i'))
113
+ : DEFAULT_INJECTION_PATTERNS;
114
+ // 编译恶意命令模式
115
+ this.commandPatterns = config.maliciousCommands.blockPatterns
116
+ ? config.maliciousCommands.blockPatterns.map(p => new RegExp(p, 'i'))
117
+ : DEFAULT_BLOCKED_COMMAND_PATTERNS;
118
+ }
119
+ /**
120
+ * 扫描内容安全性
121
+ */
122
+ scan(content) {
123
+ const flags = [];
124
+ // 1. 提示注入检测
125
+ if (this.config.promptInjection.enabled) {
126
+ const injectionFlags = this.scanPromptInjection(content);
127
+ flags.push(...injectionFlags);
128
+ }
129
+ // 2. 恶意命令检测
130
+ if (this.config.maliciousCommands.enabled) {
131
+ const commandFlags = this.scanMaliciousCommands(content);
132
+ flags.push(...commandFlags);
133
+ }
134
+ // 3. PII 保护
135
+ if (this.config.piiProtection?.enabled) {
136
+ const piiFlags = this.scanPII(content);
137
+ flags.push(...piiFlags);
138
+ }
139
+ // 评估整体风险
140
+ return this.assessResult(content, flags);
141
+ }
142
+ /**
143
+ * 提示注入检测(模式匹配)
144
+ */
145
+ scanPromptInjection(content) {
146
+ const flags = [];
147
+ for (const pattern of this.injectionPatterns) {
148
+ const match = content.match(pattern);
149
+ if (match) {
150
+ flags.push({
151
+ type: 'prompt_injection',
152
+ severity: 'high',
153
+ description: '检测到疑似提示注入',
154
+ match: match[0].slice(0, 100),
155
+ });
156
+ }
157
+ }
158
+ if (flags.length > 0) {
159
+ this.logger.warn(`检测到 ${flags.length} 个提示注入模式`);
160
+ }
161
+ return flags;
162
+ }
163
+ /**
164
+ * 恶意命令检测
165
+ */
166
+ scanMaliciousCommands(content) {
167
+ const flags = [];
168
+ for (const pattern of this.commandPatterns) {
169
+ const match = content.match(pattern);
170
+ if (match) {
171
+ flags.push({
172
+ type: 'malicious_command',
173
+ severity: 'critical',
174
+ description: '检测到恶意命令模式',
175
+ match: match[0].slice(0, 100),
176
+ });
177
+ }
178
+ }
179
+ if (flags.length > 0) {
180
+ this.logger.warn(`检测到 ${flags.length} 个恶意命令`);
181
+ }
182
+ return flags;
183
+ }
184
+ /**
185
+ * PII 检测
186
+ */
187
+ scanPII(content) {
188
+ const flags = [];
189
+ const detectTypes = this.config.piiProtection?.detectTypes || ['api_key', 'password'];
190
+ for (const type of detectTypes) {
191
+ const piiDef = PII_PATTERNS[type];
192
+ if (!piiDef)
193
+ continue;
194
+ const matches = content.match(piiDef.regex);
195
+ if (matches) {
196
+ for (const m of matches) {
197
+ flags.push({
198
+ type: 'pii_leak',
199
+ severity: 'medium',
200
+ description: `检测到${piiDef.label}`,
201
+ match: this.maskPII(m, type),
202
+ });
203
+ }
204
+ }
205
+ }
206
+ if (flags.length > 0) {
207
+ this.logger.warn(`检测到 ${flags.length} 个 PII 信息泄露`);
208
+ }
209
+ return flags;
210
+ }
211
+ /**
212
+ * PII 脱敏
213
+ */
214
+ maskPII(value, type) {
215
+ switch (type) {
216
+ case 'email':
217
+ return value.replace(/(.{2})(.*)(@.*)/, '$1***$3');
218
+ case 'phone':
219
+ return value.replace(/(\d{3})\d{4}(\d{4})/, '$1****$2');
220
+ case 'id_card':
221
+ return value.replace(/(\d{4})\d{10}(\d{4})/, '$1**********$2');
222
+ default:
223
+ return value.slice(0, 4) + '***';
224
+ }
225
+ }
226
+ /**
227
+ * 评估扫描结果
228
+ */
229
+ assessResult(content, flags) {
230
+ if (flags.length === 0) {
231
+ return { safe: true, riskLevel: 'none', flags: [] };
232
+ }
233
+ // 确定最高风险级别
234
+ const severityOrder = ['low', 'medium', 'high', 'critical'];
235
+ const highestSeverity = flags.reduce((max, f) => {
236
+ const idx = severityOrder.indexOf(f.severity);
237
+ const maxIdx = severityOrder.indexOf(max);
238
+ return idx > maxIdx ? f.severity : max;
239
+ }, 'low');
240
+ const riskLevel = highestSeverity === 'critical' ? 'critical'
241
+ : highestSeverity === 'high' ? 'high'
242
+ : highestSeverity === 'medium' ? 'medium'
243
+ : 'low';
244
+ // critical 或 high 且包含 prompt_injection/malicious_command → 拒绝
245
+ const hasCriticalFlag = flags.some(f => (f.type === 'prompt_injection' && f.severity === 'high') ||
246
+ f.type === 'malicious_command');
247
+ if (hasCriticalFlag) {
248
+ const rejectionReason = flags
249
+ .filter(f => f.type === 'prompt_injection' || f.type === 'malicious_command')
250
+ .map(f => f.description)
251
+ .join('; ');
252
+ return {
253
+ safe: false,
254
+ riskLevel: 'high',
255
+ flags,
256
+ rejectionReason: `内容安全扫描未通过: ${rejectionReason}`,
257
+ };
258
+ }
259
+ // PII 泄露根据 action 决定
260
+ const piiFlags = flags.filter(f => f.type === 'pii_leak');
261
+ if (piiFlags.length > 0) {
262
+ const action = this.config.piiProtection?.action || 'warn';
263
+ if (action === 'block') {
264
+ return {
265
+ safe: false,
266
+ riskLevel: 'medium',
267
+ flags,
268
+ rejectionReason: `内容包含敏感信息(${piiFlags.length} 处 PII),已被阻止`,
269
+ };
270
+ }
271
+ if (action === 'mask') {
272
+ return {
273
+ safe: true,
274
+ riskLevel: 'low',
275
+ flags,
276
+ };
277
+ }
278
+ // warn 模式:允许通过但标记
279
+ this.logger.warn(`内容包含 ${piiFlags.length} 处 PII 信息(warn 模式,已放行)`);
280
+ }
281
+ // low 风险 → 放行并记录
282
+ return {
283
+ safe: true,
284
+ riskLevel,
285
+ flags,
286
+ };
287
+ }
288
+ }
289
+ //# sourceMappingURL=content-scanner.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"content-scanner.js","sourceRoot":"","sources":["../../src/security/content-scanner.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,78 @@
1
+ /**
2
+ * 安全门(Security Gate)
3
+ *
4
+ * 安全审查的总调度器,串联四层安全检查:
5
+ * Layer 1: 速率限制
6
+ * Layer 2: 来源验证
7
+ * Layer 3: 内容安全扫描
8
+ * Layer 4: 权限分级
9
+ */
10
+ import { EventBus } from '../core/events.js';
11
+ import { PermissionGrader, type PermissionLevel } from './permission-level.js';
12
+ import type { PlatformMessage } from '../types/message.js';
13
+ import type { Task } from '../types/task.js';
14
+ import type { SecurityConfig } from '../core/config.js';
15
+ export interface SecurityCheckResult {
16
+ passed: boolean;
17
+ blockedBy?: string;
18
+ reason?: string;
19
+ permissionLevel?: PermissionLevel;
20
+ contentFlags?: any[];
21
+ }
22
+ export interface SecurityGateConfig {
23
+ rateLimit: SecurityConfig['rateLimit'];
24
+ sourceVerify: {
25
+ validateTimestamp: boolean;
26
+ maxTimestampSkewMs: number;
27
+ };
28
+ contentScan: SecurityConfig['contentScan'];
29
+ sandbox: SecurityConfig['sandbox'];
30
+ }
31
+ export declare class SecurityGate {
32
+ private logger;
33
+ private rateLimiter;
34
+ private sourceVerifier;
35
+ private contentScanner;
36
+ private permissionGrader;
37
+ private eventBus;
38
+ constructor(config: SecurityGateConfig, eventBus: EventBus);
39
+ /**
40
+ * 对消息执行完整安全检查(Layer 1-2-3)
41
+ */
42
+ check(message: PlatformMessage): Promise<SecurityCheckResult>;
43
+ /**
44
+ * Layer 4: 为任务确定权限级别
45
+ */
46
+ gradePermission(task: Task): PermissionLevel;
47
+ /**
48
+ * 获取权限分级器(供外部查询权限)
49
+ */
50
+ getPermissionGrader(): PermissionGrader;
51
+ /**
52
+ * 扫描 Agent 输出内容的安全性
53
+ */
54
+ scanOutput(content: string): {
55
+ safe: boolean;
56
+ reason?: string;
57
+ };
58
+ /**
59
+ * 检查任务容量
60
+ */
61
+ checkTaskCapacity(): boolean;
62
+ /**
63
+ * 通知任务开始
64
+ */
65
+ taskStarted(): void;
66
+ /**
67
+ * 通知任务结束
68
+ */
69
+ taskFinished(): void;
70
+ /**
71
+ * 获取速率限制器状态
72
+ */
73
+ getRateLimitStatus(): {
74
+ runningTasks: number;
75
+ maxConcurrent: number;
76
+ };
77
+ }
78
+ //# sourceMappingURL=gate.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../../src/security/gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,QAAQ,EAAmB,MAAM,mBAAmB,CAAC;AAI9D,OAAO,EAAE,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,IAAI,EAAwB,MAAM,kBAAkB,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,YAAY,CAAC,EAAE,GAAG,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC;IACvC,YAAY,EAAE;QACZ,iBAAiB,EAAE,OAAO,CAAC;QAC3B,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,WAAW,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;IAC3C,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;CACpC;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,cAAc,CAAwB;IAC9C,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAW;gBAEf,MAAM,EAAE,kBAAkB,EAAE,QAAQ,EAAE,QAAQ;IAqB1D;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAiEnE;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,eAAe;IAI5C;;OAEG;IACH,mBAAmB,IAAI,gBAAgB;IAIvC;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAM/D;;OAEG;IACH,iBAAiB,IAAI,OAAO;IAI5B;;OAEG;IACH,WAAW,IAAI,IAAI;IAInB;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,kBAAkB;;;;CAGnB"}