opc-agent 2.0.0 → 2.0.1

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 (156) hide show
  1. package/dist/channels/email.d.ts +32 -26
  2. package/dist/channels/email.js +239 -62
  3. package/dist/channels/feishu.d.ts +21 -6
  4. package/dist/channels/feishu.js +225 -126
  5. package/dist/channels/websocket.d.ts +46 -3
  6. package/dist/channels/websocket.js +306 -37
  7. package/dist/channels/wechat.d.ts +33 -13
  8. package/dist/channels/wechat.js +229 -42
  9. package/dist/cli.js +712 -11
  10. package/dist/core/a2a.d.ts +17 -0
  11. package/dist/core/a2a.js +43 -1
  12. package/dist/core/agent.d.ts +16 -0
  13. package/dist/core/agent.js +108 -0
  14. package/dist/core/runtime.d.ts +6 -0
  15. package/dist/core/runtime.js +161 -2
  16. package/dist/core/sandbox.d.ts +26 -0
  17. package/dist/core/sandbox.js +117 -0
  18. package/dist/core/workflow-graph.d.ts +93 -0
  19. package/dist/core/workflow-graph.js +247 -0
  20. package/dist/doctor.d.ts +15 -0
  21. package/dist/doctor.js +183 -0
  22. package/dist/eval/index.d.ts +65 -0
  23. package/dist/eval/index.js +191 -0
  24. package/dist/index.d.ts +30 -6
  25. package/dist/index.js +60 -4
  26. package/dist/plugins/content-filter.d.ts +7 -0
  27. package/dist/plugins/content-filter.js +25 -0
  28. package/dist/plugins/index.d.ts +42 -0
  29. package/dist/plugins/index.js +108 -2
  30. package/dist/plugins/logger.d.ts +6 -0
  31. package/dist/plugins/logger.js +20 -0
  32. package/dist/plugins/rate-limiter.d.ts +7 -0
  33. package/dist/plugins/rate-limiter.js +35 -0
  34. package/dist/protocols/a2a/client.d.ts +25 -0
  35. package/dist/protocols/a2a/client.js +115 -0
  36. package/dist/protocols/a2a/index.d.ts +6 -0
  37. package/dist/protocols/a2a/index.js +12 -0
  38. package/dist/protocols/a2a/server.d.ts +41 -0
  39. package/dist/protocols/a2a/server.js +295 -0
  40. package/dist/protocols/a2a/types.d.ts +91 -0
  41. package/dist/protocols/a2a/types.js +15 -0
  42. package/dist/protocols/a2a/utils.d.ts +6 -0
  43. package/dist/protocols/a2a/utils.js +47 -0
  44. package/dist/protocols/agui/client.d.ts +10 -0
  45. package/dist/protocols/agui/client.js +75 -0
  46. package/dist/protocols/agui/index.d.ts +4 -0
  47. package/dist/protocols/agui/index.js +25 -0
  48. package/dist/protocols/agui/server.d.ts +37 -0
  49. package/dist/protocols/agui/server.js +191 -0
  50. package/dist/protocols/agui/types.d.ts +107 -0
  51. package/dist/protocols/agui/types.js +17 -0
  52. package/dist/protocols/index.d.ts +2 -0
  53. package/dist/protocols/index.js +19 -0
  54. package/dist/protocols/mcp/agent-tools.d.ts +11 -0
  55. package/dist/protocols/mcp/agent-tools.js +129 -0
  56. package/dist/protocols/mcp/index.d.ts +5 -0
  57. package/dist/protocols/mcp/index.js +11 -0
  58. package/dist/protocols/mcp/server.d.ts +31 -0
  59. package/dist/protocols/mcp/server.js +248 -0
  60. package/dist/protocols/mcp/types.d.ts +92 -0
  61. package/dist/protocols/mcp/types.js +17 -0
  62. package/dist/publish/index.d.ts +45 -0
  63. package/dist/publish/index.js +350 -0
  64. package/dist/schema/oad.d.ts +682 -65
  65. package/dist/schema/oad.js +36 -3
  66. package/dist/security/approval.d.ts +36 -0
  67. package/dist/security/approval.js +113 -0
  68. package/dist/security/index.d.ts +4 -0
  69. package/dist/security/index.js +8 -0
  70. package/dist/security/keys.d.ts +16 -0
  71. package/dist/security/keys.js +117 -0
  72. package/dist/studio/server.d.ts +63 -0
  73. package/dist/studio/server.js +625 -0
  74. package/dist/studio-ui/index.html +662 -0
  75. package/dist/telemetry/index.d.ts +93 -0
  76. package/dist/telemetry/index.js +285 -0
  77. package/package.json +5 -3
  78. package/scripts/install.ps1 +31 -0
  79. package/scripts/install.sh +40 -0
  80. package/src/channels/email.ts +351 -177
  81. package/src/channels/feishu.ts +349 -236
  82. package/src/channels/websocket.ts +399 -87
  83. package/src/channels/wechat.ts +329 -149
  84. package/src/cli.ts +783 -12
  85. package/src/core/a2a.ts +60 -0
  86. package/src/core/agent.ts +125 -0
  87. package/src/core/runtime.ts +127 -0
  88. package/src/core/sandbox.ts +143 -0
  89. package/src/core/workflow-graph.ts +365 -0
  90. package/src/doctor.ts +156 -0
  91. package/src/eval/index.ts +211 -0
  92. package/src/eval/suites/basic.json +16 -0
  93. package/src/eval/suites/memory.json +12 -0
  94. package/src/eval/suites/safety.json +14 -0
  95. package/src/index.ts +54 -6
  96. package/src/plugins/content-filter.ts +23 -0
  97. package/src/plugins/index.ts +133 -2
  98. package/src/plugins/logger.ts +18 -0
  99. package/src/plugins/rate-limiter.ts +38 -0
  100. package/src/protocols/a2a/client.ts +132 -0
  101. package/src/protocols/a2a/index.ts +8 -0
  102. package/src/protocols/a2a/server.ts +333 -0
  103. package/src/protocols/a2a/types.ts +88 -0
  104. package/src/protocols/a2a/utils.ts +50 -0
  105. package/src/protocols/agui/client.ts +83 -0
  106. package/src/protocols/agui/index.ts +4 -0
  107. package/src/protocols/agui/server.ts +218 -0
  108. package/src/protocols/agui/types.ts +153 -0
  109. package/src/protocols/index.ts +2 -0
  110. package/src/protocols/mcp/agent-tools.ts +134 -0
  111. package/src/protocols/mcp/index.ts +8 -0
  112. package/src/protocols/mcp/server.ts +262 -0
  113. package/src/protocols/mcp/types.ts +69 -0
  114. package/src/publish/index.ts +376 -0
  115. package/src/schema/oad.ts +39 -2
  116. package/src/security/approval.ts +131 -0
  117. package/src/security/index.ts +3 -0
  118. package/src/security/keys.ts +87 -0
  119. package/src/studio/server.ts +629 -0
  120. package/src/studio-ui/index.html +662 -0
  121. package/src/telemetry/index.ts +324 -0
  122. package/src/types/agent-workstation.d.ts +2 -0
  123. package/tests/a2a-protocol.test.ts +285 -0
  124. package/tests/agui-protocol.test.ts +246 -0
  125. package/tests/channels/discord.test.ts +79 -0
  126. package/tests/channels/email.test.ts +148 -0
  127. package/tests/channels/feishu.test.ts +123 -0
  128. package/tests/channels/telegram.test.ts +129 -0
  129. package/tests/channels/websocket.test.ts +53 -0
  130. package/tests/channels/wechat.test.ts +170 -0
  131. package/tests/chat-cli.test.ts +160 -0
  132. package/tests/daemon.test.ts +135 -0
  133. package/tests/deepbrain-wire.test.ts +234 -0
  134. package/tests/doctor.test.ts +38 -0
  135. package/tests/eval.test.ts +173 -0
  136. package/tests/init-role.test.ts +124 -0
  137. package/tests/mcp-client.test.ts +92 -0
  138. package/tests/mcp-server.test.ts +178 -0
  139. package/tests/plugin-a2a-enhanced.test.ts +230 -0
  140. package/tests/publish.test.ts +231 -0
  141. package/tests/scheduler.test.ts +200 -0
  142. package/tests/security-enhanced.test.ts +233 -0
  143. package/tests/skill-learner.test.ts +161 -0
  144. package/tests/studio.test.ts +229 -0
  145. package/tests/subagent.test.ts +63 -0
  146. package/tests/telemetry.test.ts +186 -0
  147. package/tests/tools/builtin-extended.test.ts +138 -0
  148. package/tests/workflow-graph.test.ts +279 -0
  149. package/tutorial/customer-service-agent/README.md +612 -0
  150. package/tutorial/customer-service-agent/SOUL.md +26 -0
  151. package/tutorial/customer-service-agent/agent.yaml +63 -0
  152. package/tutorial/customer-service-agent/package.json +19 -0
  153. package/tutorial/customer-service-agent/src/index.ts +69 -0
  154. package/tutorial/customer-service-agent/src/skills/faq.ts +27 -0
  155. package/tutorial/customer-service-agent/src/skills/ticket.ts +22 -0
  156. package/tutorial/customer-service-agent/tsconfig.json +14 -0
@@ -1,37 +1,167 @@
1
1
  "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
15
+ }) : function(o, v) {
16
+ o["default"] = v;
17
+ });
18
+ var __importStar = (this && this.__importStar) || (function () {
19
+ var ownKeys = function(o) {
20
+ ownKeys = Object.getOwnPropertyNames || function (o) {
21
+ var ar = [];
22
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
23
+ return ar;
24
+ };
25
+ return ownKeys(o);
26
+ };
27
+ return function (mod) {
28
+ if (mod && mod.__esModule) return mod;
29
+ var result = {};
30
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
31
+ __setModuleDefault(result, mod);
32
+ return result;
33
+ };
34
+ })();
2
35
  Object.defineProperty(exports, "__esModule", { value: true });
3
36
  exports.WeChatChannel = void 0;
4
37
  const index_1 = require("./index");
38
+ const http = __importStar(require("http"));
39
+ const https = __importStar(require("https"));
40
+ const crypto = __importStar(require("crypto"));
5
41
  class WeChatChannel extends index_1.BaseChannel {
6
42
  type = 'wechat';
7
43
  config;
8
44
  accessToken = null;
9
45
  tokenExpiry = 0;
46
+ server = null;
10
47
  constructor(config) {
11
48
  super();
12
49
  this.config = config;
13
50
  }
14
51
  async start() {
15
- // TODO: Start HTTP server to receive WeChat push messages
16
- // 1. Verify signature on GET requests
17
- // 2. Parse XML messages on POST requests
18
- // 3. Route to handler and reply with XML
52
+ const port = this.config.port ?? 8080;
53
+ this.server = http.createServer(async (req, res) => {
54
+ try {
55
+ if (req.method === 'GET') {
56
+ await this.handleVerification(req, res);
57
+ }
58
+ else if (req.method === 'POST') {
59
+ await this.handleIncoming(req, res);
60
+ }
61
+ else {
62
+ res.writeHead(405);
63
+ res.end('Method Not Allowed');
64
+ }
65
+ }
66
+ catch (err) {
67
+ console.error('[WeChatChannel] Error:', err);
68
+ res.writeHead(500);
69
+ res.end('Internal Server Error');
70
+ }
71
+ });
72
+ return new Promise((resolve) => {
73
+ this.server.listen(port, () => {
74
+ console.log(`[WeChatChannel] Listening on port ${port}`);
75
+ resolve();
76
+ });
77
+ });
19
78
  }
20
79
  async stop() {
21
- // TODO: Stop HTTP server
80
+ return new Promise((resolve, reject) => {
81
+ if (!this.server)
82
+ return resolve();
83
+ this.server.close((err) => (err ? reject(err) : resolve()));
84
+ });
22
85
  }
23
- /** Get or refresh access token */
24
- async getAccessToken() {
25
- if (this.accessToken && Date.now() < this.tokenExpiry) {
26
- return this.accessToken;
86
+ /** Verify WeChat signature for GET requests */
87
+ async handleVerification(req, res) {
88
+ const url = new URL(req.url ?? '/', `http://localhost`);
89
+ const signature = url.searchParams.get('signature') ?? '';
90
+ const timestamp = url.searchParams.get('timestamp') ?? '';
91
+ const nonce = url.searchParams.get('nonce') ?? '';
92
+ const echostr = url.searchParams.get('echostr') ?? '';
93
+ if (this.verifySignature(signature, timestamp, nonce)) {
94
+ res.writeHead(200, { 'Content-Type': 'text/plain' });
95
+ res.end(echostr);
96
+ }
97
+ else {
98
+ res.writeHead(403);
99
+ res.end('Invalid signature');
100
+ }
101
+ }
102
+ /** Handle incoming POST messages (XML) */
103
+ async handleIncoming(req, res) {
104
+ const body = await this.readBody(req);
105
+ const wxMsg = WeChatChannel.parseXML(body);
106
+ if (!wxMsg) {
107
+ res.writeHead(400);
108
+ res.end('Bad Request');
109
+ return;
110
+ }
111
+ const replyText = await this.handleMessage(wxMsg);
112
+ if (replyText) {
113
+ const xml = WeChatChannel.formatXMLResponse(wxMsg.fromUserName, wxMsg.toUserName, replyText);
114
+ res.writeHead(200, { 'Content-Type': 'application/xml' });
115
+ res.end(xml);
27
116
  }
28
- // TODO: Implement token refresh
29
- // const url = `https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=${this.config.appId}&secret=${this.config.appSecret}`;
30
- // const res = await fetch(url);
31
- // const data = await res.json();
32
- // this.accessToken = data.access_token;
33
- // this.tokenExpiry = Date.now() + (data.expires_in - 300) * 1000;
34
- return this.accessToken ?? '';
117
+ else {
118
+ // Return "success" to prevent WeChat retries
119
+ res.writeHead(200, { 'Content-Type': 'text/plain' });
120
+ res.end('success');
121
+ }
122
+ }
123
+ /** Verify WeChat signature */
124
+ verifySignature(signature, timestamp, nonce) {
125
+ const arr = [this.config.token, timestamp, nonce].sort();
126
+ const hash = crypto.createHash('sha1').update(arr.join('')).digest('hex');
127
+ return hash === signature;
128
+ }
129
+ /** Parse WeChat XML message using regex */
130
+ static parseXML(xml) {
131
+ const extract = (tag) => {
132
+ const cdataMatch = xml.match(new RegExp(`<${tag}><!\\[CDATA\\[([\\s\\S]*?)\\]\\]></${tag}>`));
133
+ if (cdataMatch)
134
+ return cdataMatch[1];
135
+ const plainMatch = xml.match(new RegExp(`<${tag}>([\\s\\S]*?)</${tag}>`));
136
+ return plainMatch ? plainMatch[1] : '';
137
+ };
138
+ const toUserName = extract('ToUserName');
139
+ const fromUserName = extract('FromUserName');
140
+ const createTime = extract('CreateTime');
141
+ const msgType = extract('MsgType');
142
+ if (!toUserName || !fromUserName || !msgType)
143
+ return null;
144
+ return {
145
+ toUserName,
146
+ fromUserName,
147
+ createTime: parseInt(createTime, 10) || 0,
148
+ msgType: msgType,
149
+ content: extract('Content') || undefined,
150
+ msgId: extract('MsgId') || undefined,
151
+ event: extract('Event') || undefined,
152
+ eventKey: extract('EventKey') || undefined,
153
+ };
154
+ }
155
+ /** Format response as WeChat XML */
156
+ static formatXMLResponse(toUser, fromUser, content) {
157
+ const timestamp = Math.floor(Date.now() / 1000);
158
+ return `<xml>
159
+ <ToUserName><![CDATA[${toUser}]]></ToUserName>
160
+ <FromUserName><![CDATA[${fromUser}]]></FromUserName>
161
+ <CreateTime>${timestamp}</CreateTime>
162
+ <MsgType><![CDATA[text]]></MsgType>
163
+ <Content><![CDATA[${content}]]></Content>
164
+ </xml>`;
35
165
  }
36
166
  /** Handle incoming WeChat message */
37
167
  async handleMessage(wxMsg) {
@@ -45,11 +175,13 @@ class WeChatChannel extends index_1.BaseChannel {
45
175
  }
46
176
  return '';
47
177
  }
48
- /** Handle WeChat events (subscribe, scan, etc.) */
178
+ /** Handle WeChat events */
49
179
  handleEvent(wxMsg) {
50
180
  switch (wxMsg.event) {
51
181
  case 'subscribe':
52
182
  return 'Welcome! How can I help you?';
183
+ case 'unsubscribe':
184
+ return '';
53
185
  case 'SCAN':
54
186
  return `QR code scanned: ${wxMsg.eventKey}`;
55
187
  default:
@@ -71,33 +203,88 @@ class WeChatChannel extends index_1.BaseChannel {
71
203
  },
72
204
  };
73
205
  }
206
+ /** Get or refresh access token */
207
+ async getAccessToken() {
208
+ if (this.accessToken && Date.now() < this.tokenExpiry) {
209
+ return this.accessToken;
210
+ }
211
+ const url = `https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=${this.config.appId}&secret=${this.config.appSecret}`;
212
+ const data = await this.httpsGet(url);
213
+ const parsed = JSON.parse(data);
214
+ if (parsed.access_token) {
215
+ this.accessToken = parsed.access_token;
216
+ this.tokenExpiry = Date.now() + (parsed.expires_in - 300) * 1000;
217
+ return this.accessToken;
218
+ }
219
+ throw new Error(`[WeChatChannel] Failed to get access token: ${data}`);
220
+ }
221
+ /** Send customer service message */
222
+ async sendMessage(openId, text) {
223
+ const token = await this.getAccessToken();
224
+ const url = `https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=${token}`;
225
+ const body = JSON.stringify({
226
+ touser: openId,
227
+ msgtype: 'text',
228
+ text: { content: text },
229
+ });
230
+ await this.httpsPost(url, body);
231
+ }
74
232
  /** Send template message */
75
233
  async sendTemplateMessage(data) {
76
- // TODO: Implement
77
- // const token = await this.getAccessToken();
78
- // const url = `https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=${token}`;
79
- // const res = await fetch(url, {
80
- // method: 'POST',
81
- // body: JSON.stringify({
82
- // touser: data.toUser,
83
- // template_id: data.templateId,
84
- // url: data.url,
85
- // data: data.data,
86
- // }),
87
- // });
88
- void data;
89
- return true;
90
- }
91
- /** Generate QR code for login (stub) */
92
- async generateLoginQR() {
93
- // TODO: Implement with WeChat QR code API
94
- // const token = await this.getAccessToken();
95
- // POST to https://api.weixin.qq.com/cgi-bin/qrcode/create
96
- return {
97
- ticket: 'stub-ticket',
98
- url: 'https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=stub-ticket',
99
- expireSeconds: 300,
100
- };
234
+ const token = await this.getAccessToken();
235
+ const url = `https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=${token}`;
236
+ const body = JSON.stringify({
237
+ touser: data.toUser,
238
+ template_id: data.templateId,
239
+ url: data.url,
240
+ data: data.data,
241
+ });
242
+ const result = await this.httpsPost(url, body);
243
+ const parsed = JSON.parse(result);
244
+ return parsed.errcode === 0;
245
+ }
246
+ /** Read request body */
247
+ readBody(req) {
248
+ return new Promise((resolve, reject) => {
249
+ const chunks = [];
250
+ req.on('data', (chunk) => chunks.push(chunk));
251
+ req.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')));
252
+ req.on('error', reject);
253
+ });
254
+ }
255
+ /** Simple HTTPS GET */
256
+ httpsGet(url) {
257
+ return new Promise((resolve, reject) => {
258
+ https.get(url, (res) => {
259
+ const chunks = [];
260
+ res.on('data', (chunk) => chunks.push(chunk));
261
+ res.on('end', () => resolve(Buffer.concat(chunks).toString()));
262
+ res.on('error', reject);
263
+ }).on('error', reject);
264
+ });
265
+ }
266
+ /** Simple HTTPS POST */
267
+ httpsPost(url, body) {
268
+ return new Promise((resolve, reject) => {
269
+ const parsed = new URL(url);
270
+ const req = https.request({
271
+ hostname: parsed.hostname,
272
+ path: parsed.pathname + parsed.search,
273
+ method: 'POST',
274
+ headers: {
275
+ 'Content-Type': 'application/json',
276
+ 'Content-Length': Buffer.byteLength(body),
277
+ },
278
+ }, (res) => {
279
+ const chunks = [];
280
+ res.on('data', (chunk) => chunks.push(chunk));
281
+ res.on('end', () => resolve(Buffer.concat(chunks).toString()));
282
+ res.on('error', reject);
283
+ });
284
+ req.on('error', reject);
285
+ req.write(body);
286
+ req.end();
287
+ });
101
288
  }
102
289
  }
103
290
  exports.WeChatChannel = WeChatChannel;