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.
Files changed (157) hide show
  1. package/README.md +545 -365
  2. package/dist/channels/email.d.ts +32 -26
  3. package/dist/channels/email.js +239 -62
  4. package/dist/channels/feishu.d.ts +21 -6
  5. package/dist/channels/feishu.js +225 -126
  6. package/dist/channels/websocket.d.ts +46 -3
  7. package/dist/channels/websocket.js +306 -37
  8. package/dist/channels/wechat.d.ts +33 -13
  9. package/dist/channels/wechat.js +229 -42
  10. package/dist/cli.js +712 -11
  11. package/dist/core/a2a.d.ts +17 -0
  12. package/dist/core/a2a.js +43 -1
  13. package/dist/core/agent.d.ts +16 -0
  14. package/dist/core/agent.js +108 -0
  15. package/dist/core/runtime.d.ts +6 -0
  16. package/dist/core/runtime.js +161 -2
  17. package/dist/core/sandbox.d.ts +26 -0
  18. package/dist/core/sandbox.js +117 -0
  19. package/dist/core/workflow-graph.d.ts +93 -0
  20. package/dist/core/workflow-graph.js +247 -0
  21. package/dist/doctor.d.ts +15 -0
  22. package/dist/doctor.js +183 -0
  23. package/dist/eval/index.d.ts +65 -0
  24. package/dist/eval/index.js +191 -0
  25. package/dist/index.d.ts +32 -6
  26. package/dist/index.js +63 -4
  27. package/dist/plugins/content-filter.d.ts +7 -0
  28. package/dist/plugins/content-filter.js +25 -0
  29. package/dist/plugins/index.d.ts +42 -0
  30. package/dist/plugins/index.js +108 -2
  31. package/dist/plugins/logger.d.ts +6 -0
  32. package/dist/plugins/logger.js +20 -0
  33. package/dist/plugins/rate-limiter.d.ts +7 -0
  34. package/dist/plugins/rate-limiter.js +35 -0
  35. package/dist/protocols/a2a/client.d.ts +25 -0
  36. package/dist/protocols/a2a/client.js +115 -0
  37. package/dist/protocols/a2a/index.d.ts +6 -0
  38. package/dist/protocols/a2a/index.js +12 -0
  39. package/dist/protocols/a2a/server.d.ts +41 -0
  40. package/dist/protocols/a2a/server.js +295 -0
  41. package/dist/protocols/a2a/types.d.ts +91 -0
  42. package/dist/protocols/a2a/types.js +15 -0
  43. package/dist/protocols/a2a/utils.d.ts +6 -0
  44. package/dist/protocols/a2a/utils.js +47 -0
  45. package/dist/protocols/agui/client.d.ts +10 -0
  46. package/dist/protocols/agui/client.js +75 -0
  47. package/dist/protocols/agui/index.d.ts +4 -0
  48. package/dist/protocols/agui/index.js +25 -0
  49. package/dist/protocols/agui/server.d.ts +37 -0
  50. package/dist/protocols/agui/server.js +191 -0
  51. package/dist/protocols/agui/types.d.ts +107 -0
  52. package/dist/protocols/agui/types.js +17 -0
  53. package/dist/protocols/index.d.ts +2 -0
  54. package/dist/protocols/index.js +19 -0
  55. package/dist/protocols/mcp/agent-tools.d.ts +11 -0
  56. package/dist/protocols/mcp/agent-tools.js +129 -0
  57. package/dist/protocols/mcp/index.d.ts +5 -0
  58. package/dist/protocols/mcp/index.js +11 -0
  59. package/dist/protocols/mcp/server.d.ts +31 -0
  60. package/dist/protocols/mcp/server.js +248 -0
  61. package/dist/protocols/mcp/types.d.ts +92 -0
  62. package/dist/protocols/mcp/types.js +17 -0
  63. package/dist/publish/index.d.ts +45 -0
  64. package/dist/publish/index.js +350 -0
  65. package/dist/schema/oad.d.ts +682 -65
  66. package/dist/schema/oad.js +36 -3
  67. package/dist/security/approval.d.ts +36 -0
  68. package/dist/security/approval.js +113 -0
  69. package/dist/security/index.d.ts +4 -0
  70. package/dist/security/index.js +8 -0
  71. package/dist/security/keys.d.ts +16 -0
  72. package/dist/security/keys.js +117 -0
  73. package/dist/studio/server.d.ts +63 -0
  74. package/dist/studio/server.js +625 -0
  75. package/dist/studio-ui/index.html +662 -0
  76. package/dist/telemetry/index.d.ts +93 -0
  77. package/dist/telemetry/index.js +285 -0
  78. package/package.json +5 -3
  79. package/scripts/install.ps1 +31 -0
  80. package/scripts/install.sh +40 -0
  81. package/src/channels/email.ts +351 -177
  82. package/src/channels/feishu.ts +349 -236
  83. package/src/channels/websocket.ts +399 -87
  84. package/src/channels/wechat.ts +329 -149
  85. package/src/cli.ts +783 -12
  86. package/src/core/a2a.ts +60 -0
  87. package/src/core/agent.ts +125 -0
  88. package/src/core/runtime.ts +127 -0
  89. package/src/core/sandbox.ts +143 -0
  90. package/src/core/workflow-graph.ts +365 -0
  91. package/src/doctor.ts +156 -0
  92. package/src/eval/index.ts +211 -0
  93. package/src/eval/suites/basic.json +16 -0
  94. package/src/eval/suites/memory.json +12 -0
  95. package/src/eval/suites/safety.json +14 -0
  96. package/src/index.ts +58 -6
  97. package/src/plugins/content-filter.ts +23 -0
  98. package/src/plugins/index.ts +133 -2
  99. package/src/plugins/logger.ts +18 -0
  100. package/src/plugins/rate-limiter.ts +38 -0
  101. package/src/protocols/a2a/client.ts +132 -0
  102. package/src/protocols/a2a/index.ts +8 -0
  103. package/src/protocols/a2a/server.ts +333 -0
  104. package/src/protocols/a2a/types.ts +88 -0
  105. package/src/protocols/a2a/utils.ts +50 -0
  106. package/src/protocols/agui/client.ts +83 -0
  107. package/src/protocols/agui/index.ts +4 -0
  108. package/src/protocols/agui/server.ts +218 -0
  109. package/src/protocols/agui/types.ts +153 -0
  110. package/src/protocols/index.ts +2 -0
  111. package/src/protocols/mcp/agent-tools.ts +134 -0
  112. package/src/protocols/mcp/index.ts +8 -0
  113. package/src/protocols/mcp/server.ts +262 -0
  114. package/src/protocols/mcp/types.ts +69 -0
  115. package/src/publish/index.ts +376 -0
  116. package/src/schema/oad.ts +39 -2
  117. package/src/security/approval.ts +131 -0
  118. package/src/security/index.ts +3 -0
  119. package/src/security/keys.ts +87 -0
  120. package/src/studio/server.ts +629 -0
  121. package/src/studio-ui/index.html +662 -0
  122. package/src/telemetry/index.ts +324 -0
  123. package/src/types/agent-workstation.d.ts +2 -0
  124. package/tests/a2a-protocol.test.ts +285 -0
  125. package/tests/agui-protocol.test.ts +246 -0
  126. package/tests/channels/discord.test.ts +79 -0
  127. package/tests/channels/email.test.ts +148 -0
  128. package/tests/channels/feishu.test.ts +123 -0
  129. package/tests/channels/telegram.test.ts +129 -0
  130. package/tests/channels/websocket.test.ts +53 -0
  131. package/tests/channels/wechat.test.ts +170 -0
  132. package/tests/chat-cli.test.ts +160 -0
  133. package/tests/daemon.test.ts +135 -0
  134. package/tests/deepbrain-wire.test.ts +234 -0
  135. package/tests/doctor.test.ts +38 -0
  136. package/tests/eval.test.ts +173 -0
  137. package/tests/init-role.test.ts +124 -0
  138. package/tests/mcp-client.test.ts +92 -0
  139. package/tests/mcp-server.test.ts +178 -0
  140. package/tests/plugin-a2a-enhanced.test.ts +230 -0
  141. package/tests/publish.test.ts +231 -0
  142. package/tests/scheduler.test.ts +200 -0
  143. package/tests/security-enhanced.test.ts +233 -0
  144. package/tests/skill-learner.test.ts +161 -0
  145. package/tests/studio.test.ts +229 -0
  146. package/tests/subagent.test.ts +63 -0
  147. package/tests/telemetry.test.ts +186 -0
  148. package/tests/tools/builtin-extended.test.ts +138 -0
  149. package/tests/workflow-graph.test.ts +279 -0
  150. package/tutorial/customer-service-agent/README.md +612 -0
  151. package/tutorial/customer-service-agent/SOUL.md +26 -0
  152. package/tutorial/customer-service-agent/agent.yaml +63 -0
  153. package/tutorial/customer-service-agent/package.json +19 -0
  154. package/tutorial/customer-service-agent/src/index.ts +69 -0
  155. package/tutorial/customer-service-agent/src/skills/faq.ts +27 -0
  156. package/tutorial/customer-service-agent/src/skills/ticket.ts +22 -0
  157. 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.record(z.unknown()).optional(),
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,3 @@
1
+ export { ApprovalManager } from './approval';
2
+ export type { ApprovalPolicy, ApprovalRequest } from './approval';
3
+ export { KeyManager } from './keys';
@@ -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
+ }