opc-agent 1.2.1 → 1.3.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 (158) hide show
  1. package/.github/workflows/ci.yml +24 -0
  2. package/CONTRIBUTING.md +75 -75
  3. package/README.md +235 -358
  4. package/README.zh-CN.md +415 -415
  5. package/dist/channels/web.js +256 -256
  6. package/dist/cli.js +118 -34
  7. package/dist/core/knowledge.d.ts +5 -0
  8. package/dist/core/knowledge.js +39 -2
  9. package/dist/deploy/hermes.js +22 -22
  10. package/dist/deploy/openclaw.js +31 -40
  11. package/dist/index.d.ts +3 -6
  12. package/dist/index.js +7 -11
  13. package/dist/providers/index.d.ts +1 -1
  14. package/dist/providers/index.js +158 -14
  15. package/dist/schema/oad.d.ts +4 -5
  16. package/dist/templates/code-reviewer.d.ts +0 -8
  17. package/dist/templates/code-reviewer.js +5 -9
  18. package/dist/templates/customer-service.d.ts +0 -8
  19. package/dist/templates/customer-service.js +2 -6
  20. package/dist/templates/data-analyst.d.ts +0 -8
  21. package/dist/templates/data-analyst.js +5 -9
  22. package/dist/templates/knowledge-base.d.ts +0 -8
  23. package/dist/templates/knowledge-base.js +2 -6
  24. package/dist/templates/sales-assistant.d.ts +0 -8
  25. package/dist/templates/sales-assistant.js +4 -8
  26. package/dist/templates/teacher.d.ts +0 -8
  27. package/dist/templates/teacher.js +6 -10
  28. package/dist/traces/index.d.ts +49 -0
  29. package/dist/traces/index.js +102 -0
  30. package/docs/.vitepress/config.ts +103 -103
  31. package/docs/api/cli.md +48 -48
  32. package/docs/api/oad-schema.md +64 -64
  33. package/docs/api/sdk.md +80 -80
  34. package/docs/guide/concepts.md +51 -51
  35. package/docs/guide/configuration.md +79 -79
  36. package/docs/guide/deployment.md +42 -42
  37. package/docs/guide/getting-started.md +44 -44
  38. package/docs/guide/templates.md +28 -28
  39. package/docs/guide/testing.md +84 -84
  40. package/docs/index.md +27 -27
  41. package/docs/zh/api/cli.md +54 -54
  42. package/docs/zh/api/oad-schema.md +87 -87
  43. package/docs/zh/api/sdk.md +102 -102
  44. package/docs/zh/guide/concepts.md +104 -104
  45. package/docs/zh/guide/configuration.md +135 -135
  46. package/docs/zh/guide/deployment.md +81 -81
  47. package/docs/zh/guide/getting-started.md +82 -82
  48. package/docs/zh/guide/templates.md +84 -84
  49. package/docs/zh/guide/testing.md +88 -88
  50. package/docs/zh/index.md +27 -27
  51. package/examples/customer-service-demo/README.md +90 -90
  52. package/examples/customer-service-demo/oad.yaml +107 -107
  53. package/package.json +1 -1
  54. package/src/analytics/index.ts +66 -66
  55. package/src/channels/discord.ts +192 -192
  56. package/src/channels/email.ts +177 -177
  57. package/src/channels/feishu.ts +236 -236
  58. package/src/channels/index.ts +15 -15
  59. package/src/channels/slack.ts +160 -160
  60. package/src/channels/telegram.ts +90 -90
  61. package/src/channels/voice.ts +106 -106
  62. package/src/channels/webhook.ts +199 -199
  63. package/src/channels/websocket.ts +87 -87
  64. package/src/channels/wechat.ts +149 -149
  65. package/src/cli.ts +124 -32
  66. package/src/core/a2a.ts +143 -143
  67. package/src/core/agent.ts +152 -152
  68. package/src/core/analytics-engine.ts +186 -186
  69. package/src/core/auth.ts +57 -57
  70. package/src/core/cache.ts +141 -141
  71. package/src/core/compose.ts +77 -77
  72. package/src/core/config.ts +14 -14
  73. package/src/core/errors.ts +148 -148
  74. package/src/core/hitl.ts +138 -138
  75. package/src/core/logger.ts +57 -57
  76. package/src/core/orchestrator.ts +215 -215
  77. package/src/core/performance.ts +187 -187
  78. package/src/core/rate-limiter.ts +128 -128
  79. package/src/core/room.ts +109 -109
  80. package/src/core/runtime.ts +152 -152
  81. package/src/core/sandbox.ts +101 -101
  82. package/src/core/security.ts +171 -171
  83. package/src/core/types.ts +68 -68
  84. package/src/core/versioning.ts +106 -106
  85. package/src/core/watch.ts +178 -178
  86. package/src/core/workflow.ts +235 -235
  87. package/src/deploy/hermes.ts +156 -156
  88. package/src/deploy/openclaw.ts +190 -200
  89. package/src/i18n/index.ts +216 -216
  90. package/src/index.ts +5 -6
  91. package/src/memory/deepbrain.ts +108 -108
  92. package/src/memory/index.ts +34 -34
  93. package/src/plugins/index.ts +208 -208
  94. package/src/schema/oad.ts +154 -155
  95. package/src/skills/base.ts +16 -16
  96. package/src/skills/document.ts +100 -100
  97. package/src/skills/http.ts +35 -35
  98. package/src/skills/index.ts +27 -27
  99. package/src/skills/scheduler.ts +80 -80
  100. package/src/skills/webhook-trigger.ts +59 -59
  101. package/src/templates/code-reviewer.ts +30 -34
  102. package/src/templates/customer-service.ts +76 -80
  103. package/src/templates/data-analyst.ts +66 -70
  104. package/src/templates/executive-assistant.ts +71 -71
  105. package/src/templates/financial-advisor.ts +60 -60
  106. package/src/templates/knowledge-base.ts +27 -31
  107. package/src/templates/legal-assistant.ts +71 -71
  108. package/src/templates/sales-assistant.ts +75 -79
  109. package/src/templates/teacher.ts +75 -79
  110. package/src/testing/index.ts +181 -181
  111. package/src/tools/calculator.ts +73 -73
  112. package/src/tools/datetime.ts +149 -149
  113. package/src/tools/json-transform.ts +187 -187
  114. package/src/tools/mcp.ts +76 -76
  115. package/src/tools/text-analysis.ts +116 -116
  116. package/src/traces/index.ts +132 -0
  117. package/templates/Dockerfile +15 -15
  118. package/templates/code-reviewer/README.md +27 -27
  119. package/templates/code-reviewer/oad.yaml +41 -41
  120. package/templates/customer-service/README.md +22 -22
  121. package/templates/customer-service/oad.yaml +36 -36
  122. package/templates/docker-compose.yml +21 -21
  123. package/templates/ecommerce-assistant/README.md +45 -45
  124. package/templates/ecommerce-assistant/oad.yaml +47 -47
  125. package/templates/knowledge-base/README.md +28 -28
  126. package/templates/knowledge-base/oad.yaml +38 -38
  127. package/templates/sales-assistant/README.md +26 -26
  128. package/templates/sales-assistant/oad.yaml +43 -43
  129. package/templates/tech-support/README.md +43 -43
  130. package/templates/tech-support/oad.yaml +45 -45
  131. package/tests/a2a.test.ts +66 -66
  132. package/tests/agent.test.ts +72 -72
  133. package/tests/analytics.test.ts +50 -50
  134. package/tests/channel.test.ts +39 -39
  135. package/tests/e2e.test.ts +134 -134
  136. package/tests/errors.test.ts +83 -83
  137. package/tests/hitl.test.ts +71 -71
  138. package/tests/i18n.test.ts +41 -41
  139. package/tests/mcp.test.ts +54 -54
  140. package/tests/oad.test.ts +68 -68
  141. package/tests/performance.test.ts +115 -115
  142. package/tests/plugin.test.ts +74 -74
  143. package/tests/room.test.ts +106 -106
  144. package/tests/runtime.test.ts +42 -42
  145. package/tests/sandbox.test.ts +46 -46
  146. package/tests/security.test.ts +60 -60
  147. package/tests/templates.test.ts +77 -77
  148. package/tests/v070.test.ts +76 -76
  149. package/tests/versioning.test.ts +75 -75
  150. package/tests/voice.test.ts +61 -61
  151. package/tests/webhook.test.ts +29 -29
  152. package/tests/workflow.test.ts +143 -143
  153. package/tsconfig.json +19 -19
  154. package/vitest.config.ts +9 -9
  155. package/src/dtv/data.ts +0 -29
  156. package/src/dtv/trust.ts +0 -43
  157. package/src/dtv/value.ts +0 -47
  158. package/src/marketplace/index.ts +0 -223
@@ -1,106 +1,106 @@
1
- import { BaseChannel } from './index';
2
- import type { Message } from '../core/types';
3
- import { Logger } from '../core/logger';
4
-
5
- // ── Voice Channel Types ─────────────────────────────────────
6
-
7
- export interface STTProvider {
8
- name: string;
9
- transcribe(audio: Buffer, options?: STTOptions): Promise<string>;
10
- }
11
-
12
- export interface TTSProvider {
13
- name: string;
14
- synthesize(text: string, options?: TTSOptions): Promise<Buffer>;
15
- }
16
-
17
- export interface STTOptions {
18
- language?: string;
19
- model?: string;
20
- }
21
-
22
- export interface TTSOptions {
23
- voice?: string;
24
- speed?: number;
25
- language?: string;
26
- }
27
-
28
- export interface VoiceChannelConfig {
29
- sttProvider?: STTProvider;
30
- ttsProvider?: TTSProvider;
31
- sampleRate?: number;
32
- language?: string;
33
- }
34
-
35
- // ── Voice Channel ───────────────────────────────────────────
36
-
37
- export class VoiceChannel extends BaseChannel {
38
- type = 'voice';
39
- private config: VoiceChannelConfig;
40
- private logger = new Logger('voice-channel');
41
- private running = false;
42
-
43
- constructor(config?: VoiceChannelConfig) {
44
- super();
45
- this.config = config ?? {};
46
- }
47
-
48
- async start(): Promise<void> {
49
- this.running = true;
50
- this.logger.info('Voice channel started', {
51
- stt: this.config.sttProvider?.name ?? 'none',
52
- tts: this.config.ttsProvider?.name ?? 'none',
53
- });
54
- }
55
-
56
- async stop(): Promise<void> {
57
- this.running = false;
58
- this.logger.info('Voice channel stopped');
59
- }
60
-
61
- isRunning(): boolean {
62
- return this.running;
63
- }
64
-
65
- /** Process audio input: STT → Agent → TTS */
66
- async processAudio(audio: Buffer): Promise<{ text: string; response: string; audioResponse?: Buffer }> {
67
- if (!this.handler) throw new Error('No message handler set');
68
-
69
- // STT
70
- let text: string;
71
- if (this.config.sttProvider) {
72
- text = await this.config.sttProvider.transcribe(audio, { language: this.config.language });
73
- } else {
74
- text = audio.toString('utf-8'); // Fallback: treat as text
75
- }
76
-
77
- this.logger.debug('STT result', { text });
78
-
79
- // Create message and send to agent
80
- const message: Message = {
81
- id: `voice_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
82
- role: 'user',
83
- content: text,
84
- timestamp: Date.now(),
85
- metadata: { channel: 'voice' },
86
- };
87
-
88
- const response = await this.handler(message);
89
-
90
- // TTS
91
- let audioResponse: Buffer | undefined;
92
- if (this.config.ttsProvider) {
93
- audioResponse = await this.config.ttsProvider.synthesize(response.content, { language: this.config.language });
94
- }
95
-
96
- return { text, response: response.content, audioResponse };
97
- }
98
-
99
- setSTTProvider(provider: STTProvider): void {
100
- this.config.sttProvider = provider;
101
- }
102
-
103
- setTTSProvider(provider: TTSProvider): void {
104
- this.config.ttsProvider = provider;
105
- }
106
- }
1
+ import { BaseChannel } from './index';
2
+ import type { Message } from '../core/types';
3
+ import { Logger } from '../core/logger';
4
+
5
+ // ── Voice Channel Types ─────────────────────────────────────
6
+
7
+ export interface STTProvider {
8
+ name: string;
9
+ transcribe(audio: Buffer, options?: STTOptions): Promise<string>;
10
+ }
11
+
12
+ export interface TTSProvider {
13
+ name: string;
14
+ synthesize(text: string, options?: TTSOptions): Promise<Buffer>;
15
+ }
16
+
17
+ export interface STTOptions {
18
+ language?: string;
19
+ model?: string;
20
+ }
21
+
22
+ export interface TTSOptions {
23
+ voice?: string;
24
+ speed?: number;
25
+ language?: string;
26
+ }
27
+
28
+ export interface VoiceChannelConfig {
29
+ sttProvider?: STTProvider;
30
+ ttsProvider?: TTSProvider;
31
+ sampleRate?: number;
32
+ language?: string;
33
+ }
34
+
35
+ // ── Voice Channel ───────────────────────────────────────────
36
+
37
+ export class VoiceChannel extends BaseChannel {
38
+ type = 'voice';
39
+ private config: VoiceChannelConfig;
40
+ private logger = new Logger('voice-channel');
41
+ private running = false;
42
+
43
+ constructor(config?: VoiceChannelConfig) {
44
+ super();
45
+ this.config = config ?? {};
46
+ }
47
+
48
+ async start(): Promise<void> {
49
+ this.running = true;
50
+ this.logger.info('Voice channel started', {
51
+ stt: this.config.sttProvider?.name ?? 'none',
52
+ tts: this.config.ttsProvider?.name ?? 'none',
53
+ });
54
+ }
55
+
56
+ async stop(): Promise<void> {
57
+ this.running = false;
58
+ this.logger.info('Voice channel stopped');
59
+ }
60
+
61
+ isRunning(): boolean {
62
+ return this.running;
63
+ }
64
+
65
+ /** Process audio input: STT → Agent → TTS */
66
+ async processAudio(audio: Buffer): Promise<{ text: string; response: string; audioResponse?: Buffer }> {
67
+ if (!this.handler) throw new Error('No message handler set');
68
+
69
+ // STT
70
+ let text: string;
71
+ if (this.config.sttProvider) {
72
+ text = await this.config.sttProvider.transcribe(audio, { language: this.config.language });
73
+ } else {
74
+ text = audio.toString('utf-8'); // Fallback: treat as text
75
+ }
76
+
77
+ this.logger.debug('STT result', { text });
78
+
79
+ // Create message and send to agent
80
+ const message: Message = {
81
+ id: `voice_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
82
+ role: 'user',
83
+ content: text,
84
+ timestamp: Date.now(),
85
+ metadata: { channel: 'voice' },
86
+ };
87
+
88
+ const response = await this.handler(message);
89
+
90
+ // TTS
91
+ let audioResponse: Buffer | undefined;
92
+ if (this.config.ttsProvider) {
93
+ audioResponse = await this.config.ttsProvider.synthesize(response.content, { language: this.config.language });
94
+ }
95
+
96
+ return { text, response: response.content, audioResponse };
97
+ }
98
+
99
+ setSTTProvider(provider: STTProvider): void {
100
+ this.config.sttProvider = provider;
101
+ }
102
+
103
+ setTTSProvider(provider: TTSProvider): void {
104
+ this.config.ttsProvider = provider;
105
+ }
106
+ }
@@ -1,199 +1,199 @@
1
- import { BaseChannel } from './index';
2
- import type { Message } from '../core/types';
3
- import { Logger } from '../core/logger';
4
- import * as http from 'http';
5
- import * as crypto from 'crypto';
6
-
7
- // ── Webhook Types ───────────────────────────────────────────
8
-
9
- export interface WebhookConfig {
10
- port?: number;
11
- path?: string;
12
- secret?: string;
13
- retryAttempts?: number;
14
- retryDelayMs?: number;
15
- outgoing?: WebhookOutgoing[];
16
- }
17
-
18
- export interface WebhookOutgoing {
19
- name: string;
20
- url: string;
21
- secret?: string;
22
- events: string[];
23
- }
24
-
25
- export interface WebhookPayload {
26
- event: string;
27
- data: unknown;
28
- timestamp: number;
29
- id: string;
30
- }
31
-
32
- // ── Webhook Channel ─────────────────────────────────────────
33
-
34
- export class WebhookChannel extends BaseChannel {
35
- type = 'webhook';
36
- private config: WebhookConfig;
37
- private server: http.Server | null = null;
38
- private logger = new Logger('webhook-channel');
39
- private outgoing: WebhookOutgoing[] = [];
40
-
41
- constructor(config?: WebhookConfig) {
42
- super();
43
- this.config = config ?? {};
44
- this.outgoing = config?.outgoing ?? [];
45
- }
46
-
47
- async start(): Promise<void> {
48
- const port = this.config.port ?? 3100;
49
- const path = this.config.path ?? '/webhook';
50
-
51
- this.server = http.createServer(async (req, res) => {
52
- if (req.url !== path || req.method !== 'POST') {
53
- res.writeHead(404);
54
- res.end('Not found');
55
- return;
56
- }
57
-
58
- try {
59
- const body = await this.readBody(req);
60
-
61
- // Verify signature if secret configured
62
- if (this.config.secret) {
63
- const signature = req.headers['x-webhook-signature'] as string;
64
- if (!this.verifySignature(body, signature, this.config.secret)) {
65
- res.writeHead(401);
66
- res.end('Invalid signature');
67
- return;
68
- }
69
- }
70
-
71
- const payload: WebhookPayload = JSON.parse(body);
72
- const message: Message = {
73
- id: payload.id ?? `wh_${Date.now()}`,
74
- role: 'user',
75
- content: typeof payload.data === 'string' ? payload.data : JSON.stringify(payload.data),
76
- timestamp: payload.timestamp ?? Date.now(),
77
- metadata: { channel: 'webhook', event: payload.event },
78
- };
79
-
80
- if (this.handler) {
81
- const response = await this.handler(message);
82
- res.writeHead(200, { 'Content-Type': 'application/json' });
83
- res.end(JSON.stringify({ status: 'ok', response: response.content }));
84
- } else {
85
- res.writeHead(200, { 'Content-Type': 'application/json' });
86
- res.end(JSON.stringify({ status: 'ok' }));
87
- }
88
- } catch (err) {
89
- this.logger.error('Webhook error', { error: (err as Error).message });
90
- res.writeHead(500);
91
- res.end('Internal error');
92
- }
93
- });
94
-
95
- return new Promise((resolve) => {
96
- this.server!.listen(port, () => {
97
- this.logger.info('Webhook channel started', { port, path });
98
- resolve();
99
- });
100
- });
101
- }
102
-
103
- async stop(): Promise<void> {
104
- return new Promise((resolve) => {
105
- if (this.server) {
106
- this.server.close(() => {
107
- this.logger.info('Webhook channel stopped');
108
- resolve();
109
- });
110
- } else {
111
- resolve();
112
- }
113
- });
114
- }
115
-
116
- /** Send a webhook to outgoing endpoints */
117
- async send(event: string, data: unknown): Promise<void> {
118
- const targets = this.outgoing.filter(o => o.events.includes(event) || o.events.includes('*'));
119
-
120
- for (const target of targets) {
121
- const payload: WebhookPayload = {
122
- event,
123
- data,
124
- timestamp: Date.now(),
125
- id: `wh_out_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
126
- };
127
-
128
- await this.sendWithRetry(target, payload);
129
- }
130
- }
131
-
132
- private async sendWithRetry(target: WebhookOutgoing, payload: WebhookPayload): Promise<void> {
133
- const maxRetries = this.config.retryAttempts ?? 3;
134
- const retryDelay = this.config.retryDelayMs ?? 1000;
135
- const body = JSON.stringify(payload);
136
-
137
- for (let attempt = 0; attempt <= maxRetries; attempt++) {
138
- try {
139
- await this.httpPost(target.url, body, target.secret);
140
- return;
141
- } catch (err) {
142
- if (attempt === maxRetries) {
143
- this.logger.error('Webhook delivery failed', { target: target.name, error: (err as Error).message });
144
- throw err;
145
- }
146
- await new Promise(r => setTimeout(r, retryDelay * Math.pow(2, attempt)));
147
- }
148
- }
149
- }
150
-
151
- private httpPost(url: string, body: string, secret?: string): Promise<void> {
152
- return new Promise((resolve, reject) => {
153
- const urlObj = new URL(url);
154
- const headers: Record<string, string> = { 'Content-Type': 'application/json' };
155
- if (secret) {
156
- headers['x-webhook-signature'] = this.createSignature(body, secret);
157
- }
158
-
159
- const req = http.request(
160
- { hostname: urlObj.hostname, port: urlObj.port, path: urlObj.pathname, method: 'POST', headers },
161
- (res) => {
162
- if (res.statusCode && res.statusCode >= 200 && res.statusCode < 300) {
163
- resolve();
164
- } else {
165
- reject(new Error(`HTTP ${res.statusCode}`));
166
- }
167
- res.resume();
168
- },
169
- );
170
- req.on('error', reject);
171
- req.write(body);
172
- req.end();
173
- });
174
- }
175
-
176
- private readBody(req: http.IncomingMessage): Promise<string> {
177
- return new Promise((resolve, reject) => {
178
- const chunks: Buffer[] = [];
179
- req.on('data', (c: Buffer) => chunks.push(c));
180
- req.on('end', () => resolve(Buffer.concat(chunks).toString()));
181
- req.on('error', reject);
182
- });
183
- }
184
-
185
- verifySignature(body: string, signature: string, secret: string): boolean {
186
- if (!signature) return false;
187
- const expected = this.createSignature(body, secret);
188
- if (signature.length !== expected.length) return false;
189
- return crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected));
190
- }
191
-
192
- createSignature(body: string, secret: string): string {
193
- return crypto.createHmac('sha256', secret).update(body).digest('hex');
194
- }
195
-
196
- addOutgoing(outgoing: WebhookOutgoing): void {
197
- this.outgoing.push(outgoing);
198
- }
199
- }
1
+ import { BaseChannel } from './index';
2
+ import type { Message } from '../core/types';
3
+ import { Logger } from '../core/logger';
4
+ import * as http from 'http';
5
+ import * as crypto from 'crypto';
6
+
7
+ // ── Webhook Types ───────────────────────────────────────────
8
+
9
+ export interface WebhookConfig {
10
+ port?: number;
11
+ path?: string;
12
+ secret?: string;
13
+ retryAttempts?: number;
14
+ retryDelayMs?: number;
15
+ outgoing?: WebhookOutgoing[];
16
+ }
17
+
18
+ export interface WebhookOutgoing {
19
+ name: string;
20
+ url: string;
21
+ secret?: string;
22
+ events: string[];
23
+ }
24
+
25
+ export interface WebhookPayload {
26
+ event: string;
27
+ data: unknown;
28
+ timestamp: number;
29
+ id: string;
30
+ }
31
+
32
+ // ── Webhook Channel ─────────────────────────────────────────
33
+
34
+ export class WebhookChannel extends BaseChannel {
35
+ type = 'webhook';
36
+ private config: WebhookConfig;
37
+ private server: http.Server | null = null;
38
+ private logger = new Logger('webhook-channel');
39
+ private outgoing: WebhookOutgoing[] = [];
40
+
41
+ constructor(config?: WebhookConfig) {
42
+ super();
43
+ this.config = config ?? {};
44
+ this.outgoing = config?.outgoing ?? [];
45
+ }
46
+
47
+ async start(): Promise<void> {
48
+ const port = this.config.port ?? 3100;
49
+ const path = this.config.path ?? '/webhook';
50
+
51
+ this.server = http.createServer(async (req, res) => {
52
+ if (req.url !== path || req.method !== 'POST') {
53
+ res.writeHead(404);
54
+ res.end('Not found');
55
+ return;
56
+ }
57
+
58
+ try {
59
+ const body = await this.readBody(req);
60
+
61
+ // Verify signature if secret configured
62
+ if (this.config.secret) {
63
+ const signature = req.headers['x-webhook-signature'] as string;
64
+ if (!this.verifySignature(body, signature, this.config.secret)) {
65
+ res.writeHead(401);
66
+ res.end('Invalid signature');
67
+ return;
68
+ }
69
+ }
70
+
71
+ const payload: WebhookPayload = JSON.parse(body);
72
+ const message: Message = {
73
+ id: payload.id ?? `wh_${Date.now()}`,
74
+ role: 'user',
75
+ content: typeof payload.data === 'string' ? payload.data : JSON.stringify(payload.data),
76
+ timestamp: payload.timestamp ?? Date.now(),
77
+ metadata: { channel: 'webhook', event: payload.event },
78
+ };
79
+
80
+ if (this.handler) {
81
+ const response = await this.handler(message);
82
+ res.writeHead(200, { 'Content-Type': 'application/json' });
83
+ res.end(JSON.stringify({ status: 'ok', response: response.content }));
84
+ } else {
85
+ res.writeHead(200, { 'Content-Type': 'application/json' });
86
+ res.end(JSON.stringify({ status: 'ok' }));
87
+ }
88
+ } catch (err) {
89
+ this.logger.error('Webhook error', { error: (err as Error).message });
90
+ res.writeHead(500);
91
+ res.end('Internal error');
92
+ }
93
+ });
94
+
95
+ return new Promise((resolve) => {
96
+ this.server!.listen(port, () => {
97
+ this.logger.info('Webhook channel started', { port, path });
98
+ resolve();
99
+ });
100
+ });
101
+ }
102
+
103
+ async stop(): Promise<void> {
104
+ return new Promise((resolve) => {
105
+ if (this.server) {
106
+ this.server.close(() => {
107
+ this.logger.info('Webhook channel stopped');
108
+ resolve();
109
+ });
110
+ } else {
111
+ resolve();
112
+ }
113
+ });
114
+ }
115
+
116
+ /** Send a webhook to outgoing endpoints */
117
+ async send(event: string, data: unknown): Promise<void> {
118
+ const targets = this.outgoing.filter(o => o.events.includes(event) || o.events.includes('*'));
119
+
120
+ for (const target of targets) {
121
+ const payload: WebhookPayload = {
122
+ event,
123
+ data,
124
+ timestamp: Date.now(),
125
+ id: `wh_out_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
126
+ };
127
+
128
+ await this.sendWithRetry(target, payload);
129
+ }
130
+ }
131
+
132
+ private async sendWithRetry(target: WebhookOutgoing, payload: WebhookPayload): Promise<void> {
133
+ const maxRetries = this.config.retryAttempts ?? 3;
134
+ const retryDelay = this.config.retryDelayMs ?? 1000;
135
+ const body = JSON.stringify(payload);
136
+
137
+ for (let attempt = 0; attempt <= maxRetries; attempt++) {
138
+ try {
139
+ await this.httpPost(target.url, body, target.secret);
140
+ return;
141
+ } catch (err) {
142
+ if (attempt === maxRetries) {
143
+ this.logger.error('Webhook delivery failed', { target: target.name, error: (err as Error).message });
144
+ throw err;
145
+ }
146
+ await new Promise(r => setTimeout(r, retryDelay * Math.pow(2, attempt)));
147
+ }
148
+ }
149
+ }
150
+
151
+ private httpPost(url: string, body: string, secret?: string): Promise<void> {
152
+ return new Promise((resolve, reject) => {
153
+ const urlObj = new URL(url);
154
+ const headers: Record<string, string> = { 'Content-Type': 'application/json' };
155
+ if (secret) {
156
+ headers['x-webhook-signature'] = this.createSignature(body, secret);
157
+ }
158
+
159
+ const req = http.request(
160
+ { hostname: urlObj.hostname, port: urlObj.port, path: urlObj.pathname, method: 'POST', headers },
161
+ (res) => {
162
+ if (res.statusCode && res.statusCode >= 200 && res.statusCode < 300) {
163
+ resolve();
164
+ } else {
165
+ reject(new Error(`HTTP ${res.statusCode}`));
166
+ }
167
+ res.resume();
168
+ },
169
+ );
170
+ req.on('error', reject);
171
+ req.write(body);
172
+ req.end();
173
+ });
174
+ }
175
+
176
+ private readBody(req: http.IncomingMessage): Promise<string> {
177
+ return new Promise((resolve, reject) => {
178
+ const chunks: Buffer[] = [];
179
+ req.on('data', (c: Buffer) => chunks.push(c));
180
+ req.on('end', () => resolve(Buffer.concat(chunks).toString()));
181
+ req.on('error', reject);
182
+ });
183
+ }
184
+
185
+ verifySignature(body: string, signature: string, secret: string): boolean {
186
+ if (!signature) return false;
187
+ const expected = this.createSignature(body, secret);
188
+ if (signature.length !== expected.length) return false;
189
+ return crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected));
190
+ }
191
+
192
+ createSignature(body: string, secret: string): string {
193
+ return crypto.createHmac('sha256', secret).update(body).digest('hex');
194
+ }
195
+
196
+ addOutgoing(outgoing: WebhookOutgoing): void {
197
+ this.outgoing.push(outgoing);
198
+ }
199
+ }