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.
- package/.github/workflows/ci.yml +24 -0
- package/CONTRIBUTING.md +75 -75
- package/README.md +235 -358
- package/README.zh-CN.md +415 -415
- package/dist/channels/web.js +256 -256
- package/dist/cli.js +118 -34
- package/dist/core/knowledge.d.ts +5 -0
- package/dist/core/knowledge.js +39 -2
- package/dist/deploy/hermes.js +22 -22
- package/dist/deploy/openclaw.js +31 -40
- package/dist/index.d.ts +3 -6
- package/dist/index.js +7 -11
- package/dist/providers/index.d.ts +1 -1
- package/dist/providers/index.js +158 -14
- package/dist/schema/oad.d.ts +4 -5
- 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/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 -160
- package/src/channels/telegram.ts +90 -90
- package/src/channels/voice.ts +106 -106
- 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 +124 -32
- 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 +152 -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 +5 -6
- package/src/memory/deepbrain.ts +108 -108
- package/src/memory/index.ts +34 -34
- package/src/plugins/index.ts +208 -208
- 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/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/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
|
-
}
|