opc-agent 2.0.0 → 2.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.
- package/README.md +545 -365
- package/dist/channels/email.d.ts +32 -26
- package/dist/channels/email.js +239 -62
- package/dist/channels/feishu.d.ts +21 -6
- package/dist/channels/feishu.js +225 -126
- package/dist/channels/websocket.d.ts +46 -3
- package/dist/channels/websocket.js +306 -37
- package/dist/channels/wechat.d.ts +33 -13
- package/dist/channels/wechat.js +229 -42
- package/dist/cli.js +712 -11
- package/dist/core/a2a.d.ts +17 -0
- package/dist/core/a2a.js +43 -1
- package/dist/core/agent.d.ts +16 -0
- package/dist/core/agent.js +108 -0
- package/dist/core/runtime.d.ts +6 -0
- package/dist/core/runtime.js +161 -2
- package/dist/core/sandbox.d.ts +26 -0
- package/dist/core/sandbox.js +117 -0
- package/dist/core/workflow-graph.d.ts +93 -0
- package/dist/core/workflow-graph.js +247 -0
- package/dist/doctor.d.ts +15 -0
- package/dist/doctor.js +183 -0
- package/dist/eval/index.d.ts +65 -0
- package/dist/eval/index.js +191 -0
- package/dist/index.d.ts +32 -6
- package/dist/index.js +63 -4
- package/dist/plugins/content-filter.d.ts +7 -0
- package/dist/plugins/content-filter.js +25 -0
- package/dist/plugins/index.d.ts +42 -0
- package/dist/plugins/index.js +108 -2
- package/dist/plugins/logger.d.ts +6 -0
- package/dist/plugins/logger.js +20 -0
- package/dist/plugins/rate-limiter.d.ts +7 -0
- package/dist/plugins/rate-limiter.js +35 -0
- package/dist/protocols/a2a/client.d.ts +25 -0
- package/dist/protocols/a2a/client.js +115 -0
- package/dist/protocols/a2a/index.d.ts +6 -0
- package/dist/protocols/a2a/index.js +12 -0
- package/dist/protocols/a2a/server.d.ts +41 -0
- package/dist/protocols/a2a/server.js +295 -0
- package/dist/protocols/a2a/types.d.ts +91 -0
- package/dist/protocols/a2a/types.js +15 -0
- package/dist/protocols/a2a/utils.d.ts +6 -0
- package/dist/protocols/a2a/utils.js +47 -0
- package/dist/protocols/agui/client.d.ts +10 -0
- package/dist/protocols/agui/client.js +75 -0
- package/dist/protocols/agui/index.d.ts +4 -0
- package/dist/protocols/agui/index.js +25 -0
- package/dist/protocols/agui/server.d.ts +37 -0
- package/dist/protocols/agui/server.js +191 -0
- package/dist/protocols/agui/types.d.ts +107 -0
- package/dist/protocols/agui/types.js +17 -0
- package/dist/protocols/index.d.ts +2 -0
- package/dist/protocols/index.js +19 -0
- package/dist/protocols/mcp/agent-tools.d.ts +11 -0
- package/dist/protocols/mcp/agent-tools.js +129 -0
- package/dist/protocols/mcp/index.d.ts +5 -0
- package/dist/protocols/mcp/index.js +11 -0
- package/dist/protocols/mcp/server.d.ts +31 -0
- package/dist/protocols/mcp/server.js +248 -0
- package/dist/protocols/mcp/types.d.ts +92 -0
- package/dist/protocols/mcp/types.js +17 -0
- package/dist/publish/index.d.ts +45 -0
- package/dist/publish/index.js +350 -0
- package/dist/schema/oad.d.ts +682 -65
- package/dist/schema/oad.js +36 -3
- package/dist/security/approval.d.ts +36 -0
- package/dist/security/approval.js +113 -0
- package/dist/security/index.d.ts +4 -0
- package/dist/security/index.js +8 -0
- package/dist/security/keys.d.ts +16 -0
- package/dist/security/keys.js +117 -0
- package/dist/studio/server.d.ts +63 -0
- package/dist/studio/server.js +625 -0
- package/dist/studio-ui/index.html +662 -0
- package/dist/telemetry/index.d.ts +93 -0
- package/dist/telemetry/index.js +285 -0
- package/package.json +5 -3
- package/scripts/install.ps1 +31 -0
- package/scripts/install.sh +40 -0
- package/src/channels/email.ts +351 -177
- package/src/channels/feishu.ts +349 -236
- package/src/channels/websocket.ts +399 -87
- package/src/channels/wechat.ts +329 -149
- package/src/cli.ts +783 -12
- package/src/core/a2a.ts +60 -0
- package/src/core/agent.ts +125 -0
- package/src/core/runtime.ts +127 -0
- package/src/core/sandbox.ts +143 -0
- package/src/core/workflow-graph.ts +365 -0
- package/src/doctor.ts +156 -0
- package/src/eval/index.ts +211 -0
- package/src/eval/suites/basic.json +16 -0
- package/src/eval/suites/memory.json +12 -0
- package/src/eval/suites/safety.json +14 -0
- package/src/index.ts +58 -6
- package/src/plugins/content-filter.ts +23 -0
- package/src/plugins/index.ts +133 -2
- package/src/plugins/logger.ts +18 -0
- package/src/plugins/rate-limiter.ts +38 -0
- package/src/protocols/a2a/client.ts +132 -0
- package/src/protocols/a2a/index.ts +8 -0
- package/src/protocols/a2a/server.ts +333 -0
- package/src/protocols/a2a/types.ts +88 -0
- package/src/protocols/a2a/utils.ts +50 -0
- package/src/protocols/agui/client.ts +83 -0
- package/src/protocols/agui/index.ts +4 -0
- package/src/protocols/agui/server.ts +218 -0
- package/src/protocols/agui/types.ts +153 -0
- package/src/protocols/index.ts +2 -0
- package/src/protocols/mcp/agent-tools.ts +134 -0
- package/src/protocols/mcp/index.ts +8 -0
- package/src/protocols/mcp/server.ts +262 -0
- package/src/protocols/mcp/types.ts +69 -0
- package/src/publish/index.ts +376 -0
- package/src/schema/oad.ts +39 -2
- package/src/security/approval.ts +131 -0
- package/src/security/index.ts +3 -0
- package/src/security/keys.ts +87 -0
- package/src/studio/server.ts +629 -0
- package/src/studio-ui/index.html +662 -0
- package/src/telemetry/index.ts +324 -0
- package/src/types/agent-workstation.d.ts +2 -0
- package/tests/a2a-protocol.test.ts +285 -0
- package/tests/agui-protocol.test.ts +246 -0
- package/tests/channels/discord.test.ts +79 -0
- package/tests/channels/email.test.ts +148 -0
- package/tests/channels/feishu.test.ts +123 -0
- package/tests/channels/telegram.test.ts +129 -0
- package/tests/channels/websocket.test.ts +53 -0
- package/tests/channels/wechat.test.ts +170 -0
- package/tests/chat-cli.test.ts +160 -0
- package/tests/daemon.test.ts +135 -0
- package/tests/deepbrain-wire.test.ts +234 -0
- package/tests/doctor.test.ts +38 -0
- package/tests/eval.test.ts +173 -0
- package/tests/init-role.test.ts +124 -0
- package/tests/mcp-client.test.ts +92 -0
- package/tests/mcp-server.test.ts +178 -0
- package/tests/plugin-a2a-enhanced.test.ts +230 -0
- package/tests/publish.test.ts +231 -0
- package/tests/scheduler.test.ts +200 -0
- package/tests/security-enhanced.test.ts +233 -0
- package/tests/skill-learner.test.ts +161 -0
- package/tests/studio.test.ts +229 -0
- package/tests/subagent.test.ts +63 -0
- package/tests/telemetry.test.ts +186 -0
- package/tests/tools/builtin-extended.test.ts +138 -0
- package/tests/workflow-graph.test.ts +279 -0
- package/tutorial/customer-service-agent/README.md +612 -0
- package/tutorial/customer-service-agent/SOUL.md +26 -0
- package/tutorial/customer-service-agent/agent.yaml +63 -0
- package/tutorial/customer-service-agent/package.json +19 -0
- package/tutorial/customer-service-agent/src/index.ts +69 -0
- package/tutorial/customer-service-agent/src/skills/faq.ts +27 -0
- package/tutorial/customer-service-agent/src/skills/ticket.ts +22 -0
- package/tutorial/customer-service-agent/tsconfig.json +14 -0
package/src/schema/oad.ts
CHANGED
|
@@ -60,7 +60,7 @@ export const AuthSchema = z.object({
|
|
|
60
60
|
});
|
|
61
61
|
|
|
62
62
|
export const ChannelSchema = z.object({
|
|
63
|
-
type: z.enum(['web', 'websocket', 'telegram', 'cli', 'voice', 'webhook']),
|
|
63
|
+
type: z.enum(['web', 'websocket', 'telegram', 'cli', 'voice', 'webhook', 'wechat', 'feishu', 'email', 'slack', 'discord']),
|
|
64
64
|
port: z.number().optional(),
|
|
65
65
|
config: z.record(z.unknown()).optional(),
|
|
66
66
|
});
|
|
@@ -68,7 +68,13 @@ export const ChannelSchema = z.object({
|
|
|
68
68
|
export const LongTermMemorySchema = z.object({
|
|
69
69
|
provider: z.enum(['in-memory', 'deepbrain']).default('in-memory'),
|
|
70
70
|
collection: z.string().optional(),
|
|
71
|
-
config: z.
|
|
71
|
+
config: z.object({
|
|
72
|
+
database: z.string().optional(),
|
|
73
|
+
embeddingProvider: z.string().optional(),
|
|
74
|
+
autoLearn: z.boolean().optional(),
|
|
75
|
+
autoRecall: z.boolean().optional(),
|
|
76
|
+
evolveInterval: z.number().optional(),
|
|
77
|
+
}).passthrough().optional(),
|
|
72
78
|
});
|
|
73
79
|
|
|
74
80
|
export const MemorySchema = z.object({
|
|
@@ -127,11 +133,40 @@ export const MCPServerSchema = z.object({
|
|
|
127
133
|
env: z.record(z.string()).optional(),
|
|
128
134
|
});
|
|
129
135
|
|
|
136
|
+
export const MCPServeSchema = z.object({
|
|
137
|
+
enabled: z.boolean().default(false),
|
|
138
|
+
mode: z.enum(['stdio', 'http']).default('stdio'),
|
|
139
|
+
port: z.number().default(3002),
|
|
140
|
+
exposedTools: z.array(z.string()).optional(),
|
|
141
|
+
});
|
|
142
|
+
|
|
130
143
|
export const ToolsSchema = z.object({
|
|
131
144
|
builtin: z.array(z.string()).optional(),
|
|
132
145
|
mcp: z.array(MCPServerSchema).optional(),
|
|
133
146
|
});
|
|
134
147
|
|
|
148
|
+
export const TelemetrySchema = z.object({
|
|
149
|
+
enabled: z.boolean().default(false),
|
|
150
|
+
exporter: z.enum(['console', 'file', 'otlp']).default('console'),
|
|
151
|
+
endpoint: z.string().optional(),
|
|
152
|
+
filePath: z.string().optional(),
|
|
153
|
+
maxSpans: z.number().optional(),
|
|
154
|
+
});
|
|
155
|
+
|
|
156
|
+
export const AGUIProtocolSchema = z.object({
|
|
157
|
+
enabled: z.boolean().default(false),
|
|
158
|
+
path: z.string().default('/agui'),
|
|
159
|
+
});
|
|
160
|
+
|
|
161
|
+
export const ProtocolsSchema = z.object({
|
|
162
|
+
a2a: z.object({
|
|
163
|
+
enabled: z.boolean().default(false),
|
|
164
|
+
port: z.number().optional(),
|
|
165
|
+
}).optional(),
|
|
166
|
+
agui: AGUIProtocolSchema.optional(),
|
|
167
|
+
mcp: MCPServeSchema.optional(),
|
|
168
|
+
});
|
|
169
|
+
|
|
135
170
|
export const SpecSchema = z.object({
|
|
136
171
|
provider: ProviderSchema.optional(),
|
|
137
172
|
model: z.string().default('deepseek-chat'),
|
|
@@ -149,6 +184,8 @@ export const SpecSchema = z.object({
|
|
|
149
184
|
webhook: WebhookSchema.optional(),
|
|
150
185
|
hitl: HITLSchema.optional(),
|
|
151
186
|
auth: AuthSchema.optional(),
|
|
187
|
+
telemetry: TelemetrySchema.optional(),
|
|
188
|
+
protocols: ProtocolsSchema.optional(),
|
|
152
189
|
plugins: z.array(PluginRefSchema).optional(),
|
|
153
190
|
});
|
|
154
191
|
|
|
@@ -0,0 +1,131 @@
|
|
|
1
|
+
import { randomUUID } from 'crypto';
|
|
2
|
+
|
|
3
|
+
export type ApprovalPolicy = 'always' | 'dangerous' | 'never';
|
|
4
|
+
|
|
5
|
+
export interface ApprovalRequest {
|
|
6
|
+
id: string;
|
|
7
|
+
type: 'shell' | 'file_write' | 'file_delete' | 'network' | 'plugin';
|
|
8
|
+
command: string;
|
|
9
|
+
description: string;
|
|
10
|
+
requestedAt: Date;
|
|
11
|
+
status: 'pending' | 'approved' | 'denied';
|
|
12
|
+
approvedBy?: string;
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
export class ApprovalManager {
|
|
16
|
+
private policy: ApprovalPolicy;
|
|
17
|
+
private pendingApprovals: Map<string, ApprovalRequest> = new Map();
|
|
18
|
+
private allowlist: Set<string> = new Set();
|
|
19
|
+
private blocklist: Set<string> = new Set();
|
|
20
|
+
|
|
21
|
+
private static readonly DANGEROUS_PATTERNS = [
|
|
22
|
+
/rm\s+-rf/i, /del\s+\/s/i, /format\s+/i,
|
|
23
|
+
/DROP\s+TABLE/i, /DELETE\s+FROM/i,
|
|
24
|
+
/curl.*\|.*sh/i, /wget.*\|.*sh/i,
|
|
25
|
+
/chmod\s+777/i, /sudo\s+/i,
|
|
26
|
+
/npm\s+publish/i,
|
|
27
|
+
];
|
|
28
|
+
|
|
29
|
+
constructor(policy: ApprovalPolicy = 'dangerous') {
|
|
30
|
+
this.policy = policy;
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
getPolicy(): ApprovalPolicy {
|
|
34
|
+
return this.policy;
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
setPolicy(policy: ApprovalPolicy): void {
|
|
38
|
+
this.policy = policy;
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
needsApproval(type: string, command: string): boolean {
|
|
42
|
+
// Blocklist always needs approval (effectively blocked)
|
|
43
|
+
if (this.isBlocked(command)) return true;
|
|
44
|
+
// Allowlist never needs approval
|
|
45
|
+
if (this.isAllowed(command)) return false;
|
|
46
|
+
|
|
47
|
+
if (this.policy === 'never') return false;
|
|
48
|
+
if (this.policy === 'always') return true;
|
|
49
|
+
// 'dangerous'
|
|
50
|
+
return this.isDangerous(type, command);
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
private isDangerous(_type: string, command: string): boolean {
|
|
54
|
+
return ApprovalManager.DANGEROUS_PATTERNS.some(p => p.test(command));
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
private isAllowed(command: string): boolean {
|
|
58
|
+
for (const pattern of this.allowlist) {
|
|
59
|
+
if (command.includes(pattern)) return true;
|
|
60
|
+
}
|
|
61
|
+
return false;
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
private isBlocked(command: string): boolean {
|
|
65
|
+
for (const pattern of this.blocklist) {
|
|
66
|
+
if (command.includes(pattern)) return true;
|
|
67
|
+
}
|
|
68
|
+
return false;
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
requestApproval(type: ApprovalRequest['type'], command: string, description: string): ApprovalRequest {
|
|
72
|
+
const request: ApprovalRequest = {
|
|
73
|
+
id: randomUUID(),
|
|
74
|
+
type,
|
|
75
|
+
command,
|
|
76
|
+
description,
|
|
77
|
+
requestedAt: new Date(),
|
|
78
|
+
status: 'pending',
|
|
79
|
+
};
|
|
80
|
+
this.pendingApprovals.set(request.id, request);
|
|
81
|
+
return request;
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
approve(id: string, approver: string): void {
|
|
85
|
+
const req = this.pendingApprovals.get(id);
|
|
86
|
+
if (!req) throw new Error(`Approval request ${id} not found`);
|
|
87
|
+
if (req.status !== 'pending') throw new Error(`Request ${id} is already ${req.status}`);
|
|
88
|
+
req.status = 'approved';
|
|
89
|
+
req.approvedBy = approver;
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
deny(id: string, approver: string): void {
|
|
93
|
+
const req = this.pendingApprovals.get(id);
|
|
94
|
+
if (!req) throw new Error(`Approval request ${id} not found`);
|
|
95
|
+
if (req.status !== 'pending') throw new Error(`Request ${id} is already ${req.status}`);
|
|
96
|
+
req.status = 'denied';
|
|
97
|
+
req.approvedBy = approver;
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
getRequest(id: string): ApprovalRequest | undefined {
|
|
101
|
+
return this.pendingApprovals.get(id);
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
addToAllowlist(pattern: string): void {
|
|
105
|
+
this.allowlist.add(pattern);
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
removeFromAllowlist(pattern: string): void {
|
|
109
|
+
this.allowlist.delete(pattern);
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
addToBlocklist(pattern: string): void {
|
|
113
|
+
this.blocklist.add(pattern);
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
removeFromBlocklist(pattern: string): void {
|
|
117
|
+
this.blocklist.delete(pattern);
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
getPending(): ApprovalRequest[] {
|
|
121
|
+
return Array.from(this.pendingApprovals.values()).filter(r => r.status === 'pending');
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
getAllowlist(): string[] {
|
|
125
|
+
return Array.from(this.allowlist);
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
getBlocklist(): string[] {
|
|
129
|
+
return Array.from(this.blocklist);
|
|
130
|
+
}
|
|
131
|
+
}
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
import * as fs from 'fs';
|
|
2
|
+
import * as path from 'path';
|
|
3
|
+
import * as crypto from 'crypto';
|
|
4
|
+
import * as os from 'os';
|
|
5
|
+
|
|
6
|
+
export class KeyManager {
|
|
7
|
+
private keys: Map<string, string> = new Map();
|
|
8
|
+
private keyFile: string;
|
|
9
|
+
private secret: Buffer;
|
|
10
|
+
|
|
11
|
+
constructor(keyFile: string = '.opc/keys.json') {
|
|
12
|
+
this.keyFile = path.resolve(keyFile);
|
|
13
|
+
this.secret = this.deriveSecret();
|
|
14
|
+
this.load();
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
private deriveSecret(): Buffer {
|
|
18
|
+
// Derive a key from machine-specific info (hostname + homedir)
|
|
19
|
+
const machineId = `${os.hostname()}:${os.homedir()}:opc-agent-keys`;
|
|
20
|
+
return crypto.createHash('sha256').update(machineId).digest();
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
set(name: string, value: string): void {
|
|
24
|
+
this.keys.set(name, value);
|
|
25
|
+
this.save();
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
get(name: string): string | undefined {
|
|
29
|
+
return this.keys.get(name);
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
delete(name: string): boolean {
|
|
33
|
+
const result = this.keys.delete(name);
|
|
34
|
+
if (result) this.save();
|
|
35
|
+
return result;
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
list(): string[] {
|
|
39
|
+
return Array.from(this.keys.keys());
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
private load(): void {
|
|
43
|
+
try {
|
|
44
|
+
if (fs.existsSync(this.keyFile)) {
|
|
45
|
+
const data = JSON.parse(fs.readFileSync(this.keyFile, 'utf-8'));
|
|
46
|
+
for (const [name, encoded] of Object.entries(data)) {
|
|
47
|
+
try {
|
|
48
|
+
this.keys.set(name, this.decode(encoded as string));
|
|
49
|
+
} catch {
|
|
50
|
+
// Skip corrupted entries
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
} catch {
|
|
55
|
+
// File doesn't exist or is corrupted — start fresh
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
private save(): void {
|
|
60
|
+
const dir = path.dirname(this.keyFile);
|
|
61
|
+
if (!fs.existsSync(dir)) {
|
|
62
|
+
fs.mkdirSync(dir, { recursive: true });
|
|
63
|
+
}
|
|
64
|
+
const data: Record<string, string> = {};
|
|
65
|
+
for (const [name, value] of this.keys) {
|
|
66
|
+
data[name] = this.encode(value);
|
|
67
|
+
}
|
|
68
|
+
fs.writeFileSync(this.keyFile, JSON.stringify(data, null, 2), 'utf-8');
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
private encode(value: string): string {
|
|
72
|
+
const iv = crypto.randomBytes(16);
|
|
73
|
+
const cipher = crypto.createCipheriv('aes-256-cbc', this.secret, iv);
|
|
74
|
+
let encrypted = cipher.update(value, 'utf-8', 'hex');
|
|
75
|
+
encrypted += cipher.final('hex');
|
|
76
|
+
return iv.toString('hex') + ':' + encrypted;
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
private decode(encoded: string): string {
|
|
80
|
+
const [ivHex, encrypted] = encoded.split(':');
|
|
81
|
+
const iv = Buffer.from(ivHex, 'hex');
|
|
82
|
+
const decipher = crypto.createDecipheriv('aes-256-cbc', this.secret, iv);
|
|
83
|
+
let decrypted = decipher.update(encrypted, 'hex', 'utf-8');
|
|
84
|
+
decrypted += decipher.final('utf-8');
|
|
85
|
+
return decrypted;
|
|
86
|
+
}
|
|
87
|
+
}
|