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.
- package/LICENSE +21 -0
- package/README.md +129 -0
- package/dist/active-behavior/behavior-scheduler.d.ts +119 -0
- package/dist/active-behavior/behavior-scheduler.d.ts.map +1 -0
- package/dist/active-behavior/behavior-scheduler.js +297 -0
- package/dist/active-behavior/behavior-scheduler.js.map +1 -0
- package/dist/active-behavior/frequency-control.d.ts +72 -0
- package/dist/active-behavior/frequency-control.d.ts.map +1 -0
- package/dist/active-behavior/frequency-control.js +206 -0
- package/dist/active-behavior/frequency-control.js.map +1 -0
- package/dist/active-behavior/index.d.ts +8 -0
- package/dist/active-behavior/index.d.ts.map +1 -0
- package/dist/active-behavior/index.js +6 -0
- package/dist/active-behavior/index.js.map +1 -0
- package/dist/agent/agent-engine.d.ts +122 -0
- package/dist/agent/agent-engine.d.ts.map +1 -0
- package/dist/agent/agent-engine.js +380 -0
- package/dist/agent/agent-engine.js.map +1 -0
- package/dist/agent/context-window.d.ts +69 -0
- package/dist/agent/context-window.d.ts.map +1 -0
- package/dist/agent/context-window.js +210 -0
- package/dist/agent/context-window.js.map +1 -0
- package/dist/agent/llm-client.d.ts +37 -0
- package/dist/agent/llm-client.d.ts.map +1 -0
- package/dist/agent/llm-client.js +155 -0
- package/dist/agent/llm-client.js.map +1 -0
- package/dist/agent/personality.d.ts +71 -0
- package/dist/agent/personality.d.ts.map +1 -0
- package/dist/agent/personality.js +147 -0
- package/dist/agent/personality.js.map +1 -0
- package/dist/agent/session-manager.d.ts +111 -0
- package/dist/agent/session-manager.d.ts.map +1 -0
- package/dist/agent/session-manager.js +205 -0
- package/dist/agent/session-manager.js.map +1 -0
- package/dist/agent/tool-executor.d.ts +34 -0
- package/dist/agent/tool-executor.d.ts.map +1 -0
- package/dist/agent/tool-executor.js +145 -0
- package/dist/agent/tool-executor.js.map +1 -0
- package/dist/agent/tool-registry.d.ts +67 -0
- package/dist/agent/tool-registry.d.ts.map +1 -0
- package/dist/agent/tool-registry.js +272 -0
- package/dist/agent/tool-registry.js.map +1 -0
- package/dist/cli/configure.d.ts +16 -0
- package/dist/cli/configure.d.ts.map +1 -0
- package/dist/cli/configure.js +212 -0
- package/dist/cli/configure.js.map +1 -0
- package/dist/cli/index.d.ts +17 -0
- package/dist/cli/index.d.ts.map +1 -0
- package/dist/cli/index.js +256 -0
- package/dist/cli/index.js.map +1 -0
- package/dist/cli/prompter.d.ts +59 -0
- package/dist/cli/prompter.d.ts.map +1 -0
- package/dist/cli/prompter.js +120 -0
- package/dist/cli/prompter.js.map +1 -0
- package/dist/cli/sections/index.d.ts +9 -0
- package/dist/cli/sections/index.d.ts.map +1 -0
- package/dist/cli/sections/index.js +9 -0
- package/dist/cli/sections/index.js.map +1 -0
- package/dist/cli/sections/llm.d.ts +14 -0
- package/dist/cli/sections/llm.d.ts.map +1 -0
- package/dist/cli/sections/llm.js +155 -0
- package/dist/cli/sections/llm.js.map +1 -0
- package/dist/cli/sections/personality.d.ts +14 -0
- package/dist/cli/sections/personality.d.ts.map +1 -0
- package/dist/cli/sections/personality.js +90 -0
- package/dist/cli/sections/personality.js.map +1 -0
- package/dist/cli/sections/platform.d.ts +14 -0
- package/dist/cli/sections/platform.d.ts.map +1 -0
- package/dist/cli/sections/platform.js +179 -0
- package/dist/cli/sections/platform.js.map +1 -0
- package/dist/cli/sections/security.d.ts +14 -0
- package/dist/cli/sections/security.d.ts.map +1 -0
- package/dist/cli/sections/security.js +106 -0
- package/dist/cli/sections/security.js.map +1 -0
- package/dist/cli/sections/skills.d.ts +10 -0
- package/dist/cli/sections/skills.d.ts.map +1 -0
- package/dist/cli/sections/skills.js +149 -0
- package/dist/cli/sections/skills.js.map +1 -0
- package/dist/cli.d.ts +8 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +116 -0
- package/dist/cli.js.map +1 -0
- package/dist/core/config.d.ts +175 -0
- package/dist/core/config.d.ts.map +1 -0
- package/dist/core/config.js +109 -0
- package/dist/core/config.js.map +1 -0
- package/dist/core/events.d.ts +211 -0
- package/dist/core/events.d.ts.map +1 -0
- package/dist/core/events.js +152 -0
- package/dist/core/events.js.map +1 -0
- package/dist/core/logger.d.ts +23 -0
- package/dist/core/logger.d.ts.map +1 -0
- package/dist/core/logger.js +53 -0
- package/dist/core/logger.js.map +1 -0
- package/dist/core/workerclaw.d.ts +83 -0
- package/dist/core/workerclaw.d.ts.map +1 -0
- package/dist/core/workerclaw.js +161 -0
- package/dist/core/workerclaw.js.map +1 -0
- package/dist/index.d.ts +27 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +21 -0
- package/dist/index.js.map +1 -0
- package/dist/ingress/message-parser.d.ts +36 -0
- package/dist/ingress/message-parser.d.ts.map +1 -0
- package/dist/ingress/message-parser.js +107 -0
- package/dist/ingress/message-parser.js.map +1 -0
- package/dist/ingress/miniabc-client.d.ts +109 -0
- package/dist/ingress/miniabc-client.d.ts.map +1 -0
- package/dist/ingress/miniabc-client.js +345 -0
- package/dist/ingress/miniabc-client.js.map +1 -0
- package/dist/ingress/platform-api.d.ts +82 -0
- package/dist/ingress/platform-api.d.ts.map +1 -0
- package/dist/ingress/platform-api.js +209 -0
- package/dist/ingress/platform-api.js.map +1 -0
- package/dist/sandbox/command-sandbox.d.ts +46 -0
- package/dist/sandbox/command-sandbox.d.ts.map +1 -0
- package/dist/sandbox/command-sandbox.js +144 -0
- package/dist/sandbox/command-sandbox.js.map +1 -0
- package/dist/sandbox/fs-sandbox.d.ts +56 -0
- package/dist/sandbox/fs-sandbox.d.ts.map +1 -0
- package/dist/sandbox/fs-sandbox.js +119 -0
- package/dist/sandbox/fs-sandbox.js.map +1 -0
- package/dist/sandbox/network-sandbox.d.ts +41 -0
- package/dist/sandbox/network-sandbox.d.ts.map +1 -0
- package/dist/sandbox/network-sandbox.js +114 -0
- package/dist/sandbox/network-sandbox.js.map +1 -0
- package/dist/security/content-scanner.d.ts +59 -0
- package/dist/security/content-scanner.d.ts.map +1 -0
- package/dist/security/content-scanner.js +289 -0
- package/dist/security/content-scanner.js.map +1 -0
- package/dist/security/gate.d.ts +78 -0
- package/dist/security/gate.d.ts.map +1 -0
- package/dist/security/gate.js +150 -0
- package/dist/security/gate.js.map +1 -0
- package/dist/security/permission-level.d.ts +68 -0
- package/dist/security/permission-level.d.ts.map +1 -0
- package/dist/security/permission-level.js +191 -0
- package/dist/security/permission-level.js.map +1 -0
- package/dist/security/rate-limiter.d.ts +52 -0
- package/dist/security/rate-limiter.d.ts.map +1 -0
- package/dist/security/rate-limiter.js +133 -0
- package/dist/security/rate-limiter.js.map +1 -0
- package/dist/security/source-verifier.d.ts +33 -0
- package/dist/security/source-verifier.d.ts.map +1 -0
- package/dist/security/source-verifier.js +106 -0
- package/dist/security/source-verifier.js.map +1 -0
- package/dist/skills/builtin/code.d.ts +27 -0
- package/dist/skills/builtin/code.d.ts.map +1 -0
- package/dist/skills/builtin/code.js +132 -0
- package/dist/skills/builtin/code.js.map +1 -0
- package/dist/skills/builtin/index.d.ts +12 -0
- package/dist/skills/builtin/index.d.ts.map +1 -0
- package/dist/skills/builtin/index.js +16 -0
- package/dist/skills/builtin/index.js.map +1 -0
- package/dist/skills/builtin/search.d.ts +27 -0
- package/dist/skills/builtin/search.d.ts.map +1 -0
- package/dist/skills/builtin/search.js +105 -0
- package/dist/skills/builtin/search.js.map +1 -0
- package/dist/skills/builtin/writing.d.ts +22 -0
- package/dist/skills/builtin/writing.d.ts.map +1 -0
- package/dist/skills/builtin/writing.js +93 -0
- package/dist/skills/builtin/writing.js.map +1 -0
- package/dist/skills/index.d.ts +11 -0
- package/dist/skills/index.d.ts.map +1 -0
- package/dist/skills/index.js +10 -0
- package/dist/skills/index.js.map +1 -0
- package/dist/skills/pack-loader.d.ts +31 -0
- package/dist/skills/pack-loader.d.ts.map +1 -0
- package/dist/skills/pack-loader.js +167 -0
- package/dist/skills/pack-loader.js.map +1 -0
- package/dist/skills/pack-registry.d.ts +40 -0
- package/dist/skills/pack-registry.d.ts.map +1 -0
- package/dist/skills/pack-registry.js +80 -0
- package/dist/skills/pack-registry.js.map +1 -0
- package/dist/skills/pack-types.d.ts +64 -0
- package/dist/skills/pack-types.d.ts.map +1 -0
- package/dist/skills/pack-types.js +7 -0
- package/dist/skills/pack-types.js.map +1 -0
- package/dist/skills/skill-registry.d.ts +83 -0
- package/dist/skills/skill-registry.d.ts.map +1 -0
- package/dist/skills/skill-registry.js +206 -0
- package/dist/skills/skill-registry.js.map +1 -0
- package/dist/skills/skill-runner.d.ts +49 -0
- package/dist/skills/skill-runner.d.ts.map +1 -0
- package/dist/skills/skill-runner.js +128 -0
- package/dist/skills/skill-runner.js.map +1 -0
- package/dist/skills/types.d.ts +94 -0
- package/dist/skills/types.d.ts.map +1 -0
- package/dist/skills/types.js +7 -0
- package/dist/skills/types.js.map +1 -0
- package/dist/task/concurrency.d.ts +87 -0
- package/dist/task/concurrency.d.ts.map +1 -0
- package/dist/task/concurrency.js +269 -0
- package/dist/task/concurrency.js.map +1 -0
- package/dist/task/task-evaluator.d.ts +52 -0
- package/dist/task/task-evaluator.d.ts.map +1 -0
- package/dist/task/task-evaluator.js +141 -0
- package/dist/task/task-evaluator.js.map +1 -0
- package/dist/task/task-manager.d.ts +112 -0
- package/dist/task/task-manager.d.ts.map +1 -0
- package/dist/task/task-manager.js +382 -0
- package/dist/task/task-manager.js.map +1 -0
- package/dist/task/task-state-machine.d.ts +63 -0
- package/dist/task/task-state-machine.d.ts.map +1 -0
- package/dist/task/task-state-machine.js +149 -0
- package/dist/task/task-state-machine.js.map +1 -0
- package/dist/types/agent.d.ts +79 -0
- package/dist/types/agent.d.ts.map +1 -0
- package/dist/types/agent.js +7 -0
- package/dist/types/agent.js.map +1 -0
- package/dist/types/index.d.ts +7 -0
- package/dist/types/index.d.ts.map +1 -0
- package/dist/types/index.js +5 -0
- package/dist/types/index.js.map +1 -0
- package/dist/types/message.d.ts +87 -0
- package/dist/types/message.d.ts.map +1 -0
- package/dist/types/message.js +30 -0
- package/dist/types/message.js.map +1 -0
- package/dist/types/task.d.ts +176 -0
- package/dist/types/task.d.ts.map +1 -0
- package/dist/types/task.js +5 -0
- package/dist/types/task.js.map +1 -0
- package/package.json +57 -0
- 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":"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"}
|
|
@@ -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"}
|