opc-agent 1.3.2 → 1.4.0
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/.github/ISSUE_TEMPLATE/bug_report.md +20 -0
- package/.github/ISSUE_TEMPLATE/feature_request.md +14 -0
- package/.github/PULL_REQUEST_TEMPLATE.md +13 -0
- package/.github/workflows/ci.yml +24 -0
- package/CHANGELOG.md +23 -63
- package/CONTRIBUTING.md +21 -60
- package/README.md +235 -358
- package/README.zh-CN.md +415 -415
- package/dist/channels/slack.js +93 -10
- package/dist/channels/web.d.ts +10 -0
- package/dist/channels/web.js +33 -2
- package/dist/cli.js +255 -60
- package/dist/core/runtime.d.ts +4 -0
- package/dist/core/runtime.js +27 -0
- package/dist/deploy/hermes.js +22 -22
- package/dist/deploy/openclaw.js +31 -40
- package/dist/index.d.ts +3 -10
- package/dist/index.js +6 -15
- package/dist/providers/index.d.ts +1 -1
- package/dist/providers/index.js +7 -1
- package/dist/schema/oad.d.ts +1 -2
- package/dist/templates/code-reviewer.d.ts +0 -8
- package/dist/templates/code-reviewer.js +5 -9
- package/dist/templates/customer-service.d.ts +0 -8
- package/dist/templates/customer-service.js +2 -6
- package/dist/templates/data-analyst.d.ts +0 -8
- package/dist/templates/data-analyst.js +5 -9
- package/dist/templates/knowledge-base.d.ts +0 -8
- package/dist/templates/knowledge-base.js +2 -6
- package/dist/templates/sales-assistant.d.ts +0 -8
- package/dist/templates/sales-assistant.js +4 -8
- package/dist/templates/teacher.d.ts +0 -8
- package/dist/templates/teacher.js +6 -10
- package/dist/traces/index.d.ts +49 -0
- package/dist/traces/index.js +102 -0
- 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/README.md +22 -0
- package/examples/basic-agent.ts +90 -0
- package/examples/brain-integration.ts +71 -0
- package/examples/customer-service-demo/README.md +90 -90
- package/examples/customer-service-demo/oad.yaml +107 -107
- package/examples/multi-channel.ts +74 -0
- 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 +217 -160
- package/src/channels/telegram.ts +90 -90
- package/src/channels/voice.ts +106 -106
- package/src/channels/web.ts +38 -2
- 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 +282 -58
- 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/errors.ts +148 -148
- 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/rate-limiter.ts +128 -128
- package/src/core/room.ts +109 -109
- package/src/core/runtime.ts +183 -152
- 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 +190 -200
- package/src/i18n/index.ts +216 -216
- package/src/index.ts +3 -10
- 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 +9 -1
- package/src/schema/oad.ts +154 -155
- 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 +30 -34
- package/src/templates/customer-service.ts +76 -80
- package/src/templates/data-analyst.ts +66 -70
- package/src/templates/executive-assistant.ts +71 -71
- package/src/templates/financial-advisor.ts +60 -60
- package/src/templates/knowledge-base.ts +27 -31
- package/src/templates/legal-assistant.ts +71 -71
- package/src/templates/sales-assistant.ts +75 -79
- package/src/templates/teacher.ts +75 -79
- 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/src/traces/index.ts +132 -0
- 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/test-agent/Dockerfile +9 -0
- package/test-agent/README.md +50 -0
- package/test-agent/agent.yaml +23 -0
- package/test-agent/docker-compose.yml +11 -0
- package/test-agent/oad.yaml +31 -0
- package/test-agent/package-lock.json +1492 -0
- package/test-agent/package.json +18 -0
- package/test-agent/src/index.ts +24 -0
- package/test-agent/src/skills/echo.ts +15 -0
- package/test-agent/tsconfig.json +25 -0
- 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/dist/core/dashboard.d.ts +0 -35
- package/dist/core/dashboard.js +0 -157
- package/dist/core/priority.d.ts +0 -52
- package/dist/core/priority.js +0 -102
- package/src/core/dashboard.ts +0 -219
- package/src/core/priority.ts +0 -140
- package/src/dtv/data.ts +0 -29
- package/src/dtv/trust.ts +0 -43
- package/src/dtv/value.ts +0 -47
- package/src/marketplace/index.ts +0 -223
package/src/marketplace/index.ts
DELETED
|
@@ -1,223 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Agent Marketplace - Package, publish, and install agents
|
|
3
|
-
*/
|
|
4
|
-
import * as fs from 'fs';
|
|
5
|
-
import * as path from 'path';
|
|
6
|
-
import * as crypto from 'crypto';
|
|
7
|
-
import { execSync } from 'child_process';
|
|
8
|
-
|
|
9
|
-
export interface AgentManifest {
|
|
10
|
-
name: string;
|
|
11
|
-
version: string;
|
|
12
|
-
description: string;
|
|
13
|
-
author: string;
|
|
14
|
-
license: string;
|
|
15
|
-
oadVersion: string;
|
|
16
|
-
channels: string[];
|
|
17
|
-
skills: string[];
|
|
18
|
-
files: string[];
|
|
19
|
-
checksum: string;
|
|
20
|
-
publishedAt: string;
|
|
21
|
-
homepage?: string;
|
|
22
|
-
repository?: string;
|
|
23
|
-
tags?: string[];
|
|
24
|
-
}
|
|
25
|
-
|
|
26
|
-
export interface PublishOptions {
|
|
27
|
-
oadPath: string;
|
|
28
|
-
outputDir?: string;
|
|
29
|
-
includeKnowledge?: boolean;
|
|
30
|
-
}
|
|
31
|
-
|
|
32
|
-
export interface InstallOptions {
|
|
33
|
-
source: string; // local path or URL
|
|
34
|
-
targetDir?: string;
|
|
35
|
-
}
|
|
36
|
-
|
|
37
|
-
function computeChecksum(filePath: string): string {
|
|
38
|
-
const content = fs.readFileSync(filePath);
|
|
39
|
-
return crypto.createHash('sha256').update(content).digest('hex').slice(0, 16);
|
|
40
|
-
}
|
|
41
|
-
|
|
42
|
-
export async function publishAgent(options: PublishOptions): Promise<{ archivePath: string; manifest: AgentManifest }> {
|
|
43
|
-
const { oadPath, outputDir = '.', includeKnowledge = false } = options;
|
|
44
|
-
const absOad = path.resolve(oadPath);
|
|
45
|
-
const baseDir = path.dirname(absOad);
|
|
46
|
-
|
|
47
|
-
if (!fs.existsSync(absOad)) {
|
|
48
|
-
throw new Error(`OAD file not found: ${absOad}`);
|
|
49
|
-
}
|
|
50
|
-
|
|
51
|
-
// Dynamic import yaml
|
|
52
|
-
const yaml = await import('js-yaml');
|
|
53
|
-
const oadContent = fs.readFileSync(absOad, 'utf-8');
|
|
54
|
-
const oad = yaml.load(oadContent) as any;
|
|
55
|
-
|
|
56
|
-
const name = oad.metadata?.name ?? 'unnamed-agent';
|
|
57
|
-
const version = oad.metadata?.version ?? '0.0.0';
|
|
58
|
-
const safeName = name.toLowerCase().replace(/[^a-z0-9-]/g, '-');
|
|
59
|
-
|
|
60
|
-
// Collect files to package
|
|
61
|
-
const filesToPack: { rel: string; abs: string }[] = [
|
|
62
|
-
{ rel: path.basename(absOad), abs: absOad },
|
|
63
|
-
];
|
|
64
|
-
|
|
65
|
-
// Include common files
|
|
66
|
-
const extras = ['.env.example', 'README.md', 'package.json'];
|
|
67
|
-
for (const f of extras) {
|
|
68
|
-
const fp = path.join(baseDir, f);
|
|
69
|
-
if (fs.existsSync(fp)) {
|
|
70
|
-
filesToPack.push({ rel: f, abs: fp });
|
|
71
|
-
}
|
|
72
|
-
}
|
|
73
|
-
|
|
74
|
-
// Include knowledge base if requested
|
|
75
|
-
if (includeKnowledge) {
|
|
76
|
-
const kbFile = path.join(baseDir, '.opc-knowledge.json');
|
|
77
|
-
if (fs.existsSync(kbFile)) {
|
|
78
|
-
filesToPack.push({ rel: '.opc-knowledge.json', abs: kbFile });
|
|
79
|
-
}
|
|
80
|
-
}
|
|
81
|
-
|
|
82
|
-
// Include prompts directory if exists
|
|
83
|
-
const promptsDir = path.join(baseDir, 'prompts');
|
|
84
|
-
if (fs.existsSync(promptsDir) && fs.statSync(promptsDir).isDirectory()) {
|
|
85
|
-
const promptFiles = fs.readdirSync(promptsDir);
|
|
86
|
-
for (const pf of promptFiles) {
|
|
87
|
-
filesToPack.push({ rel: `prompts/${pf}`, abs: path.join(promptsDir, pf) });
|
|
88
|
-
}
|
|
89
|
-
}
|
|
90
|
-
|
|
91
|
-
// Build manifest
|
|
92
|
-
const manifest: AgentManifest = {
|
|
93
|
-
name: safeName,
|
|
94
|
-
version,
|
|
95
|
-
description: oad.metadata?.description ?? '',
|
|
96
|
-
author: oad.metadata?.author ?? '',
|
|
97
|
-
license: oad.metadata?.license ?? 'Apache-2.0',
|
|
98
|
-
oadVersion: 'opc/v1',
|
|
99
|
-
channels: (oad.spec?.channels ?? []).map((c: any) => c.type),
|
|
100
|
-
skills: (oad.spec?.skills ?? []).map((s: any) => s.name),
|
|
101
|
-
files: filesToPack.map(f => f.rel),
|
|
102
|
-
checksum: '',
|
|
103
|
-
publishedAt: new Date().toISOString(),
|
|
104
|
-
tags: oad.metadata?.marketplace?.tags,
|
|
105
|
-
};
|
|
106
|
-
|
|
107
|
-
// Create staging directory
|
|
108
|
-
const stageDir = path.join(outputDir, `.opc-stage-${safeName}`);
|
|
109
|
-
fs.mkdirSync(stageDir, { recursive: true });
|
|
110
|
-
|
|
111
|
-
for (const f of filesToPack) {
|
|
112
|
-
const dest = path.join(stageDir, f.rel);
|
|
113
|
-
fs.mkdirSync(path.dirname(dest), { recursive: true });
|
|
114
|
-
fs.copyFileSync(f.abs, dest);
|
|
115
|
-
}
|
|
116
|
-
|
|
117
|
-
// Write manifest
|
|
118
|
-
fs.writeFileSync(path.join(stageDir, 'opc-manifest.json'), JSON.stringify(manifest, null, 2));
|
|
119
|
-
|
|
120
|
-
// Create tar.gz
|
|
121
|
-
const archiveName = `${safeName}-${version}.tar.gz`;
|
|
122
|
-
const archivePath = path.join(outputDir, archiveName);
|
|
123
|
-
|
|
124
|
-
try {
|
|
125
|
-
execSync(`tar -czf "${archivePath}" -C "${stageDir}" .`, { stdio: 'pipe' });
|
|
126
|
-
} catch {
|
|
127
|
-
// Fallback: just zip the directory content list
|
|
128
|
-
// On Windows without tar, create a simple zip-like package
|
|
129
|
-
const packageData = {
|
|
130
|
-
manifest,
|
|
131
|
-
files: filesToPack.map(f => ({
|
|
132
|
-
path: f.rel,
|
|
133
|
-
content: fs.readFileSync(f.abs, 'utf-8'),
|
|
134
|
-
})),
|
|
135
|
-
};
|
|
136
|
-
fs.writeFileSync(
|
|
137
|
-
archivePath.replace('.tar.gz', '.opc.json'),
|
|
138
|
-
JSON.stringify(packageData, null, 2),
|
|
139
|
-
);
|
|
140
|
-
}
|
|
141
|
-
|
|
142
|
-
// Compute checksum
|
|
143
|
-
if (fs.existsSync(archivePath)) {
|
|
144
|
-
manifest.checksum = computeChecksum(archivePath);
|
|
145
|
-
}
|
|
146
|
-
|
|
147
|
-
// Cleanup staging
|
|
148
|
-
fs.rmSync(stageDir, { recursive: true, force: true });
|
|
149
|
-
|
|
150
|
-
// Write final manifest
|
|
151
|
-
fs.writeFileSync(
|
|
152
|
-
path.join(outputDir, 'opc-manifest.json'),
|
|
153
|
-
JSON.stringify(manifest, null, 2),
|
|
154
|
-
);
|
|
155
|
-
|
|
156
|
-
return { archivePath: fs.existsSync(archivePath) ? archivePath : archivePath.replace('.tar.gz', '.opc.json'), manifest };
|
|
157
|
-
}
|
|
158
|
-
|
|
159
|
-
export async function installAgent(options: InstallOptions): Promise<{ dir: string; manifest: AgentManifest }> {
|
|
160
|
-
const { source, targetDir } = options;
|
|
161
|
-
const absSource = path.resolve(source);
|
|
162
|
-
|
|
163
|
-
if (!fs.existsSync(absSource)) {
|
|
164
|
-
throw new Error(`Package not found: ${absSource}`);
|
|
165
|
-
}
|
|
166
|
-
|
|
167
|
-
let manifest: AgentManifest;
|
|
168
|
-
let installDir: string;
|
|
169
|
-
|
|
170
|
-
if (absSource.endsWith('.opc.json')) {
|
|
171
|
-
// JSON package format
|
|
172
|
-
const pkg = JSON.parse(fs.readFileSync(absSource, 'utf-8'));
|
|
173
|
-
manifest = pkg.manifest;
|
|
174
|
-
installDir = targetDir ?? path.join('.', manifest.name);
|
|
175
|
-
fs.mkdirSync(installDir, { recursive: true });
|
|
176
|
-
|
|
177
|
-
for (const f of pkg.files) {
|
|
178
|
-
const dest = path.join(installDir, f.path);
|
|
179
|
-
fs.mkdirSync(path.dirname(dest), { recursive: true });
|
|
180
|
-
fs.writeFileSync(dest, f.content, 'utf-8');
|
|
181
|
-
}
|
|
182
|
-
fs.writeFileSync(path.join(installDir, 'opc-manifest.json'), JSON.stringify(manifest, null, 2));
|
|
183
|
-
} else {
|
|
184
|
-
// tar.gz format
|
|
185
|
-
const tmpDir = path.join(path.dirname(absSource), '.opc-extract-tmp');
|
|
186
|
-
fs.mkdirSync(tmpDir, { recursive: true });
|
|
187
|
-
|
|
188
|
-
try {
|
|
189
|
-
execSync(`tar -xzf "${absSource}" -C "${tmpDir}"`, { stdio: 'pipe' });
|
|
190
|
-
} catch {
|
|
191
|
-
throw new Error('Failed to extract package. Ensure tar is available.');
|
|
192
|
-
}
|
|
193
|
-
|
|
194
|
-
const manifestPath = path.join(tmpDir, 'opc-manifest.json');
|
|
195
|
-
if (!fs.existsSync(manifestPath)) {
|
|
196
|
-
fs.rmSync(tmpDir, { recursive: true, force: true });
|
|
197
|
-
throw new Error('Invalid package: missing opc-manifest.json');
|
|
198
|
-
}
|
|
199
|
-
|
|
200
|
-
manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf-8'));
|
|
201
|
-
installDir = targetDir ?? path.join('.', manifest.name);
|
|
202
|
-
|
|
203
|
-
// Move files
|
|
204
|
-
fs.mkdirSync(installDir, { recursive: true });
|
|
205
|
-
const copyRecursive = (src: string, dest: string) => {
|
|
206
|
-
const entries = fs.readdirSync(src, { withFileTypes: true });
|
|
207
|
-
for (const entry of entries) {
|
|
208
|
-
const srcPath = path.join(src, entry.name);
|
|
209
|
-
const destPath = path.join(dest, entry.name);
|
|
210
|
-
if (entry.isDirectory()) {
|
|
211
|
-
fs.mkdirSync(destPath, { recursive: true });
|
|
212
|
-
copyRecursive(srcPath, destPath);
|
|
213
|
-
} else {
|
|
214
|
-
fs.copyFileSync(srcPath, destPath);
|
|
215
|
-
}
|
|
216
|
-
}
|
|
217
|
-
};
|
|
218
|
-
copyRecursive(tmpDir, installDir);
|
|
219
|
-
fs.rmSync(tmpDir, { recursive: true, force: true });
|
|
220
|
-
}
|
|
221
|
-
|
|
222
|
-
return { dir: installDir, manifest };
|
|
223
|
-
}
|