opc-agent 1.4.0 → 1.4.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.
- package/CHANGELOG.md +69 -23
- package/CONTRIBUTING.md +60 -21
- package/README.md +358 -235
- package/README.zh-CN.md +415 -415
- package/dist/channels/slack.js +10 -93
- package/dist/channels/web.d.ts +0 -10
- package/dist/channels/web.js +2 -33
- package/dist/cli.js +60 -255
- package/dist/core/dashboard.d.ts +35 -0
- package/dist/core/dashboard.js +157 -0
- package/dist/core/fast-mode.d.ts +27 -0
- package/dist/core/fast-mode.js +59 -0
- package/dist/core/priority.d.ts +52 -0
- package/dist/core/priority.js +102 -0
- package/dist/core/runtime.d.ts +0 -4
- package/dist/core/runtime.js +0 -27
- package/dist/deploy/hermes.js +22 -22
- package/dist/deploy/openclaw.js +40 -31
- package/dist/index.d.ts +14 -3
- package/dist/index.js +20 -6
- package/dist/memory/cloud-storage.d.ts +40 -0
- package/dist/memory/cloud-storage.js +211 -0
- package/dist/providers/index.d.ts +1 -1
- package/dist/providers/index.js +1 -7
- package/dist/schema/oad.d.ts +2 -1
- package/dist/templates/code-reviewer.d.ts +8 -0
- package/dist/templates/code-reviewer.js +9 -5
- package/dist/templates/customer-service.d.ts +8 -0
- package/dist/templates/customer-service.js +6 -2
- package/dist/templates/data-analyst.d.ts +8 -0
- package/dist/templates/data-analyst.js +9 -5
- package/dist/templates/knowledge-base.d.ts +8 -0
- package/dist/templates/knowledge-base.js +6 -2
- package/dist/templates/sales-assistant.d.ts +8 -0
- package/dist/templates/sales-assistant.js +8 -4
- package/dist/templates/teacher.d.ts +8 -0
- package/dist/templates/teacher.js +10 -6
- package/docs/.vitepress/config.ts +103 -103
- package/docs/api/cli.md +48 -48
- package/docs/api/oad-schema.md +64 -64
- package/docs/api/sdk.md +80 -80
- package/docs/guide/concepts.md +51 -51
- package/docs/guide/configuration.md +79 -79
- package/docs/guide/deployment.md +42 -42
- package/docs/guide/getting-started.md +44 -44
- package/docs/guide/templates.md +28 -28
- package/docs/guide/testing.md +84 -84
- package/docs/index.md +27 -27
- package/docs/zh/api/cli.md +54 -54
- package/docs/zh/api/oad-schema.md +87 -87
- package/docs/zh/api/sdk.md +102 -102
- package/docs/zh/guide/concepts.md +104 -104
- package/docs/zh/guide/configuration.md +135 -135
- package/docs/zh/guide/deployment.md +81 -81
- package/docs/zh/guide/getting-started.md +82 -82
- package/docs/zh/guide/templates.md +84 -84
- package/docs/zh/guide/testing.md +88 -88
- package/docs/zh/index.md +27 -27
- package/examples/customer-service-demo/README.md +90 -90
- package/examples/customer-service-demo/oad.yaml +107 -107
- package/package.json +1 -1
- package/src/analytics/index.ts +66 -66
- package/src/channels/discord.ts +192 -192
- package/src/channels/email.ts +177 -177
- package/src/channels/feishu.ts +236 -236
- package/src/channels/index.ts +15 -15
- package/src/channels/slack.ts +160 -217
- package/src/channels/telegram.ts +90 -90
- package/src/channels/voice.ts +106 -106
- package/src/channels/web.ts +2 -38
- package/src/channels/webhook.ts +199 -199
- package/src/channels/websocket.ts +87 -87
- package/src/channels/wechat.ts +149 -149
- package/src/cli.ts +58 -282
- package/src/core/a2a.ts +143 -143
- package/src/core/agent.ts +152 -152
- package/src/core/analytics-engine.ts +186 -186
- package/src/core/auth.ts +57 -57
- package/src/core/cache.ts +141 -141
- package/src/core/compose.ts +77 -77
- package/src/core/config.ts +14 -14
- package/src/core/dashboard.ts +219 -0
- package/src/core/errors.ts +148 -148
- package/src/core/fast-mode.ts +75 -0
- package/src/core/hitl.ts +138 -138
- package/src/core/logger.ts +57 -57
- package/src/core/orchestrator.ts +215 -215
- package/src/core/performance.ts +187 -187
- package/src/core/priority.ts +140 -0
- package/src/core/rate-limiter.ts +128 -128
- package/src/core/room.ts +109 -109
- package/src/core/runtime.ts +152 -183
- package/src/core/sandbox.ts +101 -101
- package/src/core/security.ts +171 -171
- package/src/core/types.ts +68 -68
- package/src/core/versioning.ts +106 -106
- package/src/core/watch.ts +178 -178
- package/src/core/workflow.ts +235 -235
- package/src/deploy/hermes.ts +156 -156
- package/src/deploy/openclaw.ts +200 -190
- package/src/dtv/data.ts +29 -0
- package/src/dtv/trust.ts +43 -0
- package/src/dtv/value.ts +47 -0
- package/src/i18n/index.ts +216 -216
- package/src/index.ts +16 -3
- package/src/marketplace/index.ts +223 -0
- package/src/memory/cloud-storage.ts +217 -0
- package/src/memory/deepbrain.ts +108 -108
- package/src/memory/index.ts +34 -34
- package/src/plugins/index.ts +208 -208
- package/src/providers/index.ts +1 -9
- package/src/schema/oad.ts +155 -154
- package/src/skills/base.ts +16 -16
- package/src/skills/document.ts +100 -100
- package/src/skills/http.ts +35 -35
- package/src/skills/index.ts +27 -27
- package/src/skills/scheduler.ts +80 -80
- package/src/skills/webhook-trigger.ts +59 -59
- package/src/templates/code-reviewer.ts +34 -30
- package/src/templates/customer-service.ts +80 -76
- package/src/templates/data-analyst.ts +70 -66
- package/src/templates/executive-assistant.ts +71 -71
- package/src/templates/financial-advisor.ts +60 -60
- package/src/templates/knowledge-base.ts +31 -27
- package/src/templates/legal-assistant.ts +71 -71
- package/src/templates/sales-assistant.ts +79 -75
- package/src/templates/teacher.ts +79 -75
- package/src/testing/index.ts +181 -181
- package/src/tools/calculator.ts +73 -73
- package/src/tools/datetime.ts +149 -149
- package/src/tools/json-transform.ts +187 -187
- package/src/tools/mcp.ts +76 -76
- package/src/tools/text-analysis.ts +116 -116
- package/templates/Dockerfile +15 -15
- package/templates/code-reviewer/README.md +27 -27
- package/templates/code-reviewer/oad.yaml +41 -41
- package/templates/customer-service/README.md +22 -22
- package/templates/customer-service/oad.yaml +36 -36
- package/templates/docker-compose.yml +21 -21
- package/templates/ecommerce-assistant/README.md +45 -45
- package/templates/ecommerce-assistant/oad.yaml +47 -47
- package/templates/knowledge-base/README.md +28 -28
- package/templates/knowledge-base/oad.yaml +38 -38
- package/templates/sales-assistant/README.md +26 -26
- package/templates/sales-assistant/oad.yaml +43 -43
- package/templates/tech-support/README.md +43 -43
- package/templates/tech-support/oad.yaml +45 -45
- package/tests/a2a.test.ts +66 -66
- package/tests/agent.test.ts +72 -72
- package/tests/analytics.test.ts +50 -50
- package/tests/channel.test.ts +39 -39
- package/tests/e2e.test.ts +134 -134
- package/tests/errors.test.ts +83 -83
- package/tests/hitl.test.ts +71 -71
- package/tests/i18n.test.ts +41 -41
- package/tests/mcp.test.ts +54 -54
- package/tests/oad.test.ts +68 -68
- package/tests/performance.test.ts +115 -115
- package/tests/plugin.test.ts +74 -74
- package/tests/room.test.ts +106 -106
- package/tests/runtime.test.ts +42 -42
- package/tests/sandbox.test.ts +46 -46
- package/tests/security.test.ts +60 -60
- package/tests/templates.test.ts +77 -77
- package/tests/v070.test.ts +76 -76
- package/tests/versioning.test.ts +75 -75
- package/tests/voice.test.ts +61 -61
- package/tests/webhook.test.ts +29 -29
- package/tests/workflow.test.ts +143 -143
- package/tsconfig.json +19 -19
- package/vitest.config.ts +9 -9
- package/.github/ISSUE_TEMPLATE/bug_report.md +0 -20
- package/.github/ISSUE_TEMPLATE/feature_request.md +0 -14
- package/.github/PULL_REQUEST_TEMPLATE.md +0 -13
- package/.github/workflows/ci.yml +0 -24
- package/dist/traces/index.d.ts +0 -49
- package/dist/traces/index.js +0 -102
- package/examples/README.md +0 -22
- package/examples/basic-agent.ts +0 -90
- package/examples/brain-integration.ts +0 -71
- package/examples/multi-channel.ts +0 -74
- package/src/traces/index.ts +0 -132
- package/test-agent/Dockerfile +0 -9
- package/test-agent/README.md +0 -50
- package/test-agent/agent.yaml +0 -23
- package/test-agent/docker-compose.yml +0 -11
- package/test-agent/oad.yaml +0 -31
- package/test-agent/package-lock.json +0 -1492
- package/test-agent/package.json +0 -18
- package/test-agent/src/index.ts +0 -24
- package/test-agent/src/skills/echo.ts +0 -15
- package/test-agent/tsconfig.json +0 -25
package/src/channels/voice.ts
CHANGED
|
@@ -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
|
+
}
|
package/src/channels/web.ts
CHANGED
|
@@ -288,11 +288,6 @@ export class WebChannel extends BaseChannel {
|
|
|
288
288
|
private port: number;
|
|
289
289
|
private streamHandler: ((msg: Message, res: Response) => Promise<void>) | null = null;
|
|
290
290
|
private agentName: string = 'OPC Agent';
|
|
291
|
-
private agentVersion: string = '1.0.0';
|
|
292
|
-
private memoryType: string = 'in-memory';
|
|
293
|
-
private skillNames: string[] = [];
|
|
294
|
-
private channelNames: string[] = ['web'];
|
|
295
|
-
private analyticsProvider: (() => any) | null = null;
|
|
296
291
|
private currentProvider: string = 'openai';
|
|
297
292
|
private stats = { sessions: 0, messages: 0, totalResponseMs: 0, tokenUsage: 0, knowledgeFiles: 0, startedAt: Date.now(), errors: 0 };
|
|
298
293
|
private eventHandlers: Map<string, Function[]> = new Map();
|
|
@@ -340,26 +335,6 @@ export class WebChannel extends BaseChannel {
|
|
|
340
335
|
this.agentName = name;
|
|
341
336
|
}
|
|
342
337
|
|
|
343
|
-
setAgentVersion(version: string): void {
|
|
344
|
-
this.agentVersion = version;
|
|
345
|
-
}
|
|
346
|
-
|
|
347
|
-
setMemoryType(type: string): void {
|
|
348
|
-
this.memoryType = type;
|
|
349
|
-
}
|
|
350
|
-
|
|
351
|
-
setSkillNames(names: string[]): void {
|
|
352
|
-
this.skillNames = names;
|
|
353
|
-
}
|
|
354
|
-
|
|
355
|
-
setChannelNames(names: string[]): void {
|
|
356
|
-
this.channelNames = names;
|
|
357
|
-
}
|
|
358
|
-
|
|
359
|
-
setAnalyticsProvider(fn: () => any): void {
|
|
360
|
-
this.analyticsProvider = fn;
|
|
361
|
-
}
|
|
362
|
-
|
|
363
338
|
onStreamMessage(handler: (msg: Message, res: Response) => Promise<void>): void {
|
|
364
339
|
this.streamHandler = handler;
|
|
365
340
|
}
|
|
@@ -370,17 +345,7 @@ export class WebChannel extends BaseChannel {
|
|
|
370
345
|
});
|
|
371
346
|
|
|
372
347
|
this.app.get('/health', (_req: Request, res: Response) => {
|
|
373
|
-
res.json({
|
|
374
|
-
status: 'ok',
|
|
375
|
-
agent: this.agentName,
|
|
376
|
-
version: this.agentVersion,
|
|
377
|
-
uptime: Date.now() - this.stats.startedAt,
|
|
378
|
-
memory: this.memoryType,
|
|
379
|
-
skills: this.skillNames,
|
|
380
|
-
channels: this.channelNames,
|
|
381
|
-
analytics: this.analyticsProvider ? this.analyticsProvider() : null,
|
|
382
|
-
timestamp: Date.now(),
|
|
383
|
-
});
|
|
348
|
+
res.json({ status: 'ok', timestamp: Date.now() });
|
|
384
349
|
});
|
|
385
350
|
|
|
386
351
|
this.app.get('/api/info', (_req: Request, res: Response) => {
|
|
@@ -461,8 +426,7 @@ export class WebChannel extends BaseChannel {
|
|
|
461
426
|
});
|
|
462
427
|
|
|
463
428
|
this.app.get('/api/dashboard', (_req: Request, res: Response) => {
|
|
464
|
-
|
|
465
|
-
res.json({ ...this.stats, analytics });
|
|
429
|
+
res.json(this.stats);
|
|
466
430
|
});
|
|
467
431
|
|
|
468
432
|
// --- Knowledge Base Upload ---
|
package/src/channels/webhook.ts
CHANGED
|
@@ -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
|
+
}
|