opc-agent 1.3.2 → 2.0.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 +48 -63
- package/CONTRIBUTING.md +21 -60
- package/README.md +284 -348
- package/README.zh-CN.md +415 -415
- package/dist/channels/slack.js +93 -10
- package/dist/channels/telegram.d.ts +30 -9
- package/dist/channels/telegram.js +125 -33
- package/dist/channels/web.d.ts +10 -0
- package/dist/channels/web.js +33 -2
- package/dist/cli.js +667 -65
- package/dist/core/agent.d.ts +23 -0
- package/dist/core/agent.js +120 -3
- package/dist/core/runtime.d.ts +5 -0
- package/dist/core/runtime.js +71 -0
- package/dist/core/scheduler.d.ts +52 -0
- package/dist/core/scheduler.js +168 -0
- package/dist/core/subagent.d.ts +28 -0
- package/dist/core/subagent.js +65 -0
- package/dist/daemon.d.ts +3 -0
- package/dist/daemon.js +134 -0
- package/dist/deploy/hermes.js +22 -22
- package/dist/deploy/openclaw.js +31 -40
- package/dist/index.d.ts +10 -10
- package/dist/index.js +22 -15
- package/dist/providers/index.d.ts +6 -2
- package/dist/providers/index.js +22 -9
- package/dist/schema/oad.d.ts +180 -6
- package/dist/schema/oad.js +12 -1
- package/dist/skills/auto-learn.d.ts +28 -0
- package/dist/skills/auto-learn.js +257 -0
- 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/tools/builtin/datetime.d.ts +3 -0
- package/dist/tools/builtin/datetime.js +44 -0
- package/dist/tools/builtin/file.d.ts +3 -0
- package/dist/tools/builtin/file.js +151 -0
- package/dist/tools/builtin/index.d.ts +15 -0
- package/dist/tools/builtin/index.js +30 -0
- package/dist/tools/builtin/shell.d.ts +3 -0
- package/dist/tools/builtin/shell.js +43 -0
- package/dist/tools/builtin/web.d.ts +3 -0
- package/dist/tools/builtin/web.js +37 -0
- package/dist/tools/mcp-client.d.ts +24 -0
- package/dist/tools/mcp-client.js +119 -0
- 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 +155 -33
- 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 +697 -63
- package/src/core/a2a.ts +143 -143
- package/src/core/agent.ts +146 -3
- 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 +230 -152
- package/src/core/sandbox.ts +101 -101
- package/src/core/scheduler.ts +187 -0
- package/src/core/security.ts +171 -171
- package/src/core/subagent.ts +98 -0
- 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/daemon.ts +96 -0
- 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 +14 -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 +354 -331
- package/src/schema/oad.ts +14 -2
- package/src/skills/auto-learn.ts +262 -0
- 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/builtin/datetime.ts +41 -0
- package/src/tools/builtin/file.ts +107 -0
- package/src/tools/builtin/index.ts +28 -0
- package/src/tools/builtin/shell.ts +43 -0
- package/src/tools/builtin/web.ts +35 -0
- 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-client.ts +131 -0
- 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/auto-learn.test.ts +105 -0
- package/tests/builtin-tools.test.ts +83 -0
- package/tests/channel.test.ts +39 -39
- package/tests/cli.test.ts +46 -0
- 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/subagent.test.ts +130 -0
- package/tests/telegram-discord.test.ts +60 -0
- 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/dist/core/priority.js
DELETED
|
@@ -1,102 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
// ─── Priority / Fast Mode ────────────────────────────────────
|
|
3
|
-
// Route requests through provider priority tiers for lower latency.
|
|
4
|
-
// Toggle via config or runtime command.
|
|
5
|
-
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
-
exports.PriorityRouter = void 0;
|
|
7
|
-
// Known priority-capable providers and their routing
|
|
8
|
-
const PROVIDER_PRIORITY_MAP = {
|
|
9
|
-
openai: {
|
|
10
|
-
headerKey: 'X-OpenAI-Processing-Priority',
|
|
11
|
-
headerValue: { fast: 'priority', standard: 'auto', batch: 'batch' },
|
|
12
|
-
supportedModels: ['gpt-5', 'gpt-5.4', 'gpt-4.1', 'codex-*', 'o3-*', 'o4-mini*'],
|
|
13
|
-
},
|
|
14
|
-
anthropic: {
|
|
15
|
-
headerKey: 'anthropic-priority',
|
|
16
|
-
headerValue: { fast: 'high', standard: 'normal', batch: 'low' },
|
|
17
|
-
supportedModels: ['claude-opus-*', 'claude-sonnet-*', 'claude-4*'],
|
|
18
|
-
},
|
|
19
|
-
google: {
|
|
20
|
-
headerKey: 'X-Goog-Priority',
|
|
21
|
-
headerValue: { fast: 'high', standard: 'normal', batch: 'low' },
|
|
22
|
-
supportedModels: ['gemini-2.5-*', 'gemini-3-*'],
|
|
23
|
-
},
|
|
24
|
-
};
|
|
25
|
-
class PriorityRouter {
|
|
26
|
-
config;
|
|
27
|
-
runtimeTier;
|
|
28
|
-
constructor(config) {
|
|
29
|
-
this.config = config;
|
|
30
|
-
this.runtimeTier = config.defaultTier ?? 'standard';
|
|
31
|
-
}
|
|
32
|
-
/** Toggle fast mode on/off at runtime */
|
|
33
|
-
toggle() {
|
|
34
|
-
this.runtimeTier = this.runtimeTier === 'fast' ? 'standard' : 'fast';
|
|
35
|
-
return this.runtimeTier;
|
|
36
|
-
}
|
|
37
|
-
/** Set specific tier */
|
|
38
|
-
setTier(tier) {
|
|
39
|
-
this.runtimeTier = tier;
|
|
40
|
-
}
|
|
41
|
-
/** Get current tier */
|
|
42
|
-
getTier() {
|
|
43
|
-
return this.runtimeTier;
|
|
44
|
-
}
|
|
45
|
-
/** Check if fast mode is active */
|
|
46
|
-
isFast() {
|
|
47
|
-
return this.runtimeTier === 'fast';
|
|
48
|
-
}
|
|
49
|
-
/**
|
|
50
|
-
* Get priority headers for a provider + model combination.
|
|
51
|
-
* Returns empty object if provider doesn't support priority or model isn't eligible.
|
|
52
|
-
*/
|
|
53
|
-
getHeaders(provider, model) {
|
|
54
|
-
if (!this.config.enabled)
|
|
55
|
-
return {};
|
|
56
|
-
const tier = this.getEffectiveTier(provider);
|
|
57
|
-
if (tier === 'standard')
|
|
58
|
-
return {};
|
|
59
|
-
const providerMap = PROVIDER_PRIORITY_MAP[provider.toLowerCase()];
|
|
60
|
-
if (!providerMap)
|
|
61
|
-
return {};
|
|
62
|
-
// Check model eligibility
|
|
63
|
-
if (!this.isModelEligible(providerMap.supportedModels, model))
|
|
64
|
-
return {};
|
|
65
|
-
return { [providerMap.headerKey]: providerMap.headerValue[tier] };
|
|
66
|
-
}
|
|
67
|
-
/**
|
|
68
|
-
* Get effective endpoint for a provider, allowing priority-specific routing.
|
|
69
|
-
*/
|
|
70
|
-
getEndpoint(provider, defaultEndpoint) {
|
|
71
|
-
const providerConfig = this.config.providers?.find((p) => p.provider.toLowerCase() === provider.toLowerCase());
|
|
72
|
-
if (providerConfig?.endpoint && this.runtimeTier === 'fast') {
|
|
73
|
-
return providerConfig.endpoint;
|
|
74
|
-
}
|
|
75
|
-
return defaultEndpoint;
|
|
76
|
-
}
|
|
77
|
-
getEffectiveTier(provider) {
|
|
78
|
-
// Check provider-specific override first
|
|
79
|
-
const providerConfig = this.config.providers?.find((p) => p.provider.toLowerCase() === provider.toLowerCase());
|
|
80
|
-
if (providerConfig)
|
|
81
|
-
return providerConfig.tier;
|
|
82
|
-
return this.runtimeTier;
|
|
83
|
-
}
|
|
84
|
-
isModelEligible(patterns, model) {
|
|
85
|
-
return patterns.some((pattern) => {
|
|
86
|
-
if (pattern.endsWith('*')) {
|
|
87
|
-
return model.startsWith(pattern.slice(0, -1));
|
|
88
|
-
}
|
|
89
|
-
return model === pattern;
|
|
90
|
-
});
|
|
91
|
-
}
|
|
92
|
-
/** Status summary for dashboard / CLI */
|
|
93
|
-
status() {
|
|
94
|
-
return {
|
|
95
|
-
tier: this.runtimeTier,
|
|
96
|
-
enabled: this.config.enabled,
|
|
97
|
-
providers: Object.keys(PROVIDER_PRIORITY_MAP),
|
|
98
|
-
};
|
|
99
|
-
}
|
|
100
|
-
}
|
|
101
|
-
exports.PriorityRouter = PriorityRouter;
|
|
102
|
-
//# sourceMappingURL=priority.js.map
|
package/src/core/dashboard.ts
DELETED
|
@@ -1,219 +0,0 @@
|
|
|
1
|
-
import express, { Request, Response } from 'express';
|
|
2
|
-
|
|
3
|
-
// ─── Types ───────────────────────────────────────────────────
|
|
4
|
-
|
|
5
|
-
export interface DashboardConfig {
|
|
6
|
-
/** Enable the dashboard (default: false) */
|
|
7
|
-
enabled: boolean;
|
|
8
|
-
/** HTTP port (default: 4100) */
|
|
9
|
-
port?: number;
|
|
10
|
-
/** Bind address (default: 127.0.0.1 for security) */
|
|
11
|
-
host?: string;
|
|
12
|
-
/** Enable CORS (default: false) */
|
|
13
|
-
cors?: boolean;
|
|
14
|
-
}
|
|
15
|
-
|
|
16
|
-
interface DashboardState {
|
|
17
|
-
agent: { name: string; version: string; status: string; uptime: number };
|
|
18
|
-
sessions: SessionSummary[];
|
|
19
|
-
tools: ToolSummary[];
|
|
20
|
-
channels: ChannelSummary[];
|
|
21
|
-
memory: MemorySummary;
|
|
22
|
-
modelAuth: ModelAuthSummary;
|
|
23
|
-
}
|
|
24
|
-
|
|
25
|
-
interface SessionSummary {
|
|
26
|
-
id: string;
|
|
27
|
-
channel: string;
|
|
28
|
-
messages: number;
|
|
29
|
-
lastActive: number;
|
|
30
|
-
status: 'active' | 'idle' | 'closed';
|
|
31
|
-
}
|
|
32
|
-
|
|
33
|
-
interface ToolSummary {
|
|
34
|
-
name: string;
|
|
35
|
-
type: 'builtin' | 'mcp' | 'gateway';
|
|
36
|
-
enabled: boolean;
|
|
37
|
-
invocations: number;
|
|
38
|
-
lastUsed?: number;
|
|
39
|
-
}
|
|
40
|
-
|
|
41
|
-
interface ChannelSummary {
|
|
42
|
-
name: string;
|
|
43
|
-
type: string;
|
|
44
|
-
connected: boolean;
|
|
45
|
-
messageCount: number;
|
|
46
|
-
}
|
|
47
|
-
|
|
48
|
-
interface MemorySummary {
|
|
49
|
-
provider: string;
|
|
50
|
-
entries: number;
|
|
51
|
-
lastSync?: number;
|
|
52
|
-
}
|
|
53
|
-
|
|
54
|
-
interface ModelAuthSummary {
|
|
55
|
-
providers: { name: string; status: 'healthy' | 'expiring' | 'expired' | 'unconfigured'; expiresAt?: number }[];
|
|
56
|
-
}
|
|
57
|
-
|
|
58
|
-
// ─── Dashboard Server ────────────────────────────────────────
|
|
59
|
-
|
|
60
|
-
export class Dashboard {
|
|
61
|
-
private app = express();
|
|
62
|
-
private server: ReturnType<typeof this.app.listen> | null = null;
|
|
63
|
-
private config: Required<DashboardConfig>;
|
|
64
|
-
private startTime = Date.now();
|
|
65
|
-
private stats = {
|
|
66
|
-
sessions: new Map<string, SessionSummary>(),
|
|
67
|
-
toolInvocations: new Map<string, { count: number; lastUsed: number }>(),
|
|
68
|
-
channelStats: new Map<string, { connected: boolean; messages: number }>(),
|
|
69
|
-
};
|
|
70
|
-
|
|
71
|
-
constructor(config: DashboardConfig) {
|
|
72
|
-
this.config = {
|
|
73
|
-
enabled: config.enabled,
|
|
74
|
-
port: config.port ?? 4100,
|
|
75
|
-
host: config.host ?? '127.0.0.1',
|
|
76
|
-
cors: config.cors ?? false,
|
|
77
|
-
};
|
|
78
|
-
this.setupRoutes();
|
|
79
|
-
}
|
|
80
|
-
|
|
81
|
-
private setupRoutes(): void {
|
|
82
|
-
if (this.config.cors) {
|
|
83
|
-
this.app.use((_req, res, next) => {
|
|
84
|
-
res.header('Access-Control-Allow-Origin', '*');
|
|
85
|
-
res.header('Access-Control-Allow-Headers', 'Content-Type');
|
|
86
|
-
next();
|
|
87
|
-
});
|
|
88
|
-
}
|
|
89
|
-
this.app.use(express.json());
|
|
90
|
-
|
|
91
|
-
// Health check
|
|
92
|
-
this.app.get('/api/health', (_req: Request, res: Response) => {
|
|
93
|
-
res.json({ status: 'ok', uptime: Date.now() - this.startTime });
|
|
94
|
-
});
|
|
95
|
-
|
|
96
|
-
// Overview state
|
|
97
|
-
this.app.get('/api/state', (_req: Request, res: Response) => {
|
|
98
|
-
res.json(this.getState());
|
|
99
|
-
});
|
|
100
|
-
|
|
101
|
-
// Sessions
|
|
102
|
-
this.app.get('/api/sessions', (_req: Request, res: Response) => {
|
|
103
|
-
res.json([...this.stats.sessions.values()]);
|
|
104
|
-
});
|
|
105
|
-
|
|
106
|
-
// Tools
|
|
107
|
-
this.app.get('/api/tools', (_req: Request, res: Response) => {
|
|
108
|
-
const tools: ToolSummary[] = [];
|
|
109
|
-
for (const [name, stat] of this.stats.toolInvocations) {
|
|
110
|
-
tools.push({ name, type: 'builtin', enabled: true, invocations: stat.count, lastUsed: stat.lastUsed });
|
|
111
|
-
}
|
|
112
|
-
res.json(tools);
|
|
113
|
-
});
|
|
114
|
-
|
|
115
|
-
// Channels
|
|
116
|
-
this.app.get('/api/channels', (_req: Request, res: Response) => {
|
|
117
|
-
const channels: ChannelSummary[] = [];
|
|
118
|
-
for (const [name, stat] of this.stats.channelStats) {
|
|
119
|
-
channels.push({ name, type: name, connected: stat.connected, messageCount: stat.messages });
|
|
120
|
-
}
|
|
121
|
-
res.json(channels);
|
|
122
|
-
});
|
|
123
|
-
|
|
124
|
-
// Simple HTML dashboard
|
|
125
|
-
this.app.get('/', (_req: Request, res: Response) => {
|
|
126
|
-
res.send(this.renderHTML());
|
|
127
|
-
});
|
|
128
|
-
}
|
|
129
|
-
|
|
130
|
-
private getState(): DashboardState {
|
|
131
|
-
return {
|
|
132
|
-
agent: { name: 'opc-agent', version: '1.3.0', status: 'running', uptime: Date.now() - this.startTime },
|
|
133
|
-
sessions: [...this.stats.sessions.values()],
|
|
134
|
-
tools: [...this.stats.toolInvocations.entries()].map(([name, s]) => ({
|
|
135
|
-
name, type: 'builtin' as const, enabled: true, invocations: s.count, lastUsed: s.lastUsed,
|
|
136
|
-
})),
|
|
137
|
-
channels: [...this.stats.channelStats.entries()].map(([name, s]) => ({
|
|
138
|
-
name, type: name, connected: s.connected, messageCount: s.messages,
|
|
139
|
-
})),
|
|
140
|
-
memory: { provider: 'unknown', entries: 0 },
|
|
141
|
-
modelAuth: { providers: [] },
|
|
142
|
-
};
|
|
143
|
-
}
|
|
144
|
-
|
|
145
|
-
// ─── Event Tracking ──────────────────────────────────────
|
|
146
|
-
|
|
147
|
-
trackSession(session: SessionSummary): void {
|
|
148
|
-
this.stats.sessions.set(session.id, session);
|
|
149
|
-
}
|
|
150
|
-
|
|
151
|
-
trackToolCall(toolName: string): void {
|
|
152
|
-
const existing = this.stats.toolInvocations.get(toolName) ?? { count: 0, lastUsed: 0 };
|
|
153
|
-
existing.count++;
|
|
154
|
-
existing.lastUsed = Date.now();
|
|
155
|
-
this.stats.toolInvocations.set(toolName, existing);
|
|
156
|
-
}
|
|
157
|
-
|
|
158
|
-
trackChannel(name: string, connected: boolean, messages?: number): void {
|
|
159
|
-
const existing = this.stats.channelStats.get(name) ?? { connected: false, messages: 0 };
|
|
160
|
-
existing.connected = connected;
|
|
161
|
-
if (messages !== undefined) existing.messages = messages;
|
|
162
|
-
this.stats.channelStats.set(name, existing);
|
|
163
|
-
}
|
|
164
|
-
|
|
165
|
-
// ─── Lifecycle ───────────────────────────────────────────
|
|
166
|
-
|
|
167
|
-
async start(): Promise<void> {
|
|
168
|
-
if (!this.config.enabled) return;
|
|
169
|
-
return new Promise((resolve) => {
|
|
170
|
-
this.server = this.app.listen(this.config.port, this.config.host, () => {
|
|
171
|
-
console.log(`[dashboard] http://${this.config.host}:${this.config.port}`);
|
|
172
|
-
resolve();
|
|
173
|
-
});
|
|
174
|
-
});
|
|
175
|
-
}
|
|
176
|
-
|
|
177
|
-
async stop(): Promise<void> {
|
|
178
|
-
return new Promise((resolve) => {
|
|
179
|
-
if (this.server) this.server.close(() => resolve());
|
|
180
|
-
else resolve();
|
|
181
|
-
});
|
|
182
|
-
}
|
|
183
|
-
|
|
184
|
-
private renderHTML(): string {
|
|
185
|
-
return `<!DOCTYPE html>
|
|
186
|
-
<html><head><meta charset="utf-8"><title>OPC Agent Dashboard</title>
|
|
187
|
-
<meta name="viewport" content="width=device-width,initial-scale=1">
|
|
188
|
-
<style>
|
|
189
|
-
*{box-sizing:border-box;margin:0;padding:0}
|
|
190
|
-
body{font-family:system-ui,-apple-system,sans-serif;background:#0a0a0f;color:#e0e0e0;padding:24px}
|
|
191
|
-
h1{font-size:1.5rem;margin-bottom:20px;color:#7c9aff}
|
|
192
|
-
.grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(280px,1fr));gap:16px}
|
|
193
|
-
.card{background:#14141f;border:1px solid #2a2a3a;border-radius:12px;padding:20px}
|
|
194
|
-
.card h2{font-size:0.85rem;text-transform:uppercase;letter-spacing:1px;color:#888;margin-bottom:12px}
|
|
195
|
-
.stat{font-size:2rem;font-weight:700;color:#7c9aff}
|
|
196
|
-
.sub{font-size:0.8rem;color:#666;margin-top:4px}
|
|
197
|
-
#data{margin-top:20px;font-family:monospace;font-size:0.75rem;color:#555;white-space:pre-wrap}
|
|
198
|
-
</style></head><body>
|
|
199
|
-
<h1>⚡ OPC Agent Dashboard</h1>
|
|
200
|
-
<div class="grid">
|
|
201
|
-
<div class="card"><h2>Status</h2><div class="stat" id="status">Loading…</div><div class="sub" id="uptime"></div></div>
|
|
202
|
-
<div class="card"><h2>Sessions</h2><div class="stat" id="sessions">-</div></div>
|
|
203
|
-
<div class="card"><h2>Tools</h2><div class="stat" id="tools">-</div></div>
|
|
204
|
-
<div class="card"><h2>Channels</h2><div class="stat" id="channels">-</div></div>
|
|
205
|
-
</div>
|
|
206
|
-
<div id="data"></div>
|
|
207
|
-
<script>
|
|
208
|
-
async function poll(){try{const r=await fetch('/api/state');const d=await r.json();
|
|
209
|
-
document.getElementById('status').textContent=d.agent.status;
|
|
210
|
-
document.getElementById('uptime').textContent='Uptime: '+Math.floor(d.agent.uptime/1000)+'s';
|
|
211
|
-
document.getElementById('sessions').textContent=d.sessions.length;
|
|
212
|
-
document.getElementById('tools').textContent=d.tools.length;
|
|
213
|
-
document.getElementById('channels').textContent=d.channels.length;
|
|
214
|
-
document.getElementById('data').textContent=JSON.stringify(d,null,2);
|
|
215
|
-
}catch(e){document.getElementById('status').textContent='offline'}}
|
|
216
|
-
poll();setInterval(poll,5000);
|
|
217
|
-
</script></body></html>`;
|
|
218
|
-
}
|
|
219
|
-
}
|
package/src/core/priority.ts
DELETED
|
@@ -1,140 +0,0 @@
|
|
|
1
|
-
// ─── Priority / Fast Mode ────────────────────────────────────
|
|
2
|
-
// Route requests through provider priority tiers for lower latency.
|
|
3
|
-
// Toggle via config or runtime command.
|
|
4
|
-
|
|
5
|
-
export interface PriorityConfig {
|
|
6
|
-
/** Enable priority mode (default: false) */
|
|
7
|
-
enabled: boolean;
|
|
8
|
-
/** Provider-specific priority settings */
|
|
9
|
-
providers?: PriorityProviderConfig[];
|
|
10
|
-
/** Default priority tier */
|
|
11
|
-
defaultTier?: PriorityTier;
|
|
12
|
-
}
|
|
13
|
-
|
|
14
|
-
export type PriorityTier = 'standard' | 'fast' | 'batch';
|
|
15
|
-
|
|
16
|
-
export interface PriorityProviderConfig {
|
|
17
|
-
provider: string;
|
|
18
|
-
tier: PriorityTier;
|
|
19
|
-
/** Custom endpoint override for priority routing */
|
|
20
|
-
endpoint?: string;
|
|
21
|
-
/** Supported models for this tier */
|
|
22
|
-
models?: string[];
|
|
23
|
-
}
|
|
24
|
-
|
|
25
|
-
interface PriorityHeaders {
|
|
26
|
-
[key: string]: string;
|
|
27
|
-
}
|
|
28
|
-
|
|
29
|
-
// Known priority-capable providers and their routing
|
|
30
|
-
const PROVIDER_PRIORITY_MAP: Record<string, {
|
|
31
|
-
headerKey: string;
|
|
32
|
-
headerValue: Record<PriorityTier, string>;
|
|
33
|
-
supportedModels: string[];
|
|
34
|
-
}> = {
|
|
35
|
-
openai: {
|
|
36
|
-
headerKey: 'X-OpenAI-Processing-Priority',
|
|
37
|
-
headerValue: { fast: 'priority', standard: 'auto', batch: 'batch' },
|
|
38
|
-
supportedModels: ['gpt-5', 'gpt-5.4', 'gpt-4.1', 'codex-*', 'o3-*', 'o4-mini*'],
|
|
39
|
-
},
|
|
40
|
-
anthropic: {
|
|
41
|
-
headerKey: 'anthropic-priority',
|
|
42
|
-
headerValue: { fast: 'high', standard: 'normal', batch: 'low' },
|
|
43
|
-
supportedModels: ['claude-opus-*', 'claude-sonnet-*', 'claude-4*'],
|
|
44
|
-
},
|
|
45
|
-
google: {
|
|
46
|
-
headerKey: 'X-Goog-Priority',
|
|
47
|
-
headerValue: { fast: 'high', standard: 'normal', batch: 'low' },
|
|
48
|
-
supportedModels: ['gemini-2.5-*', 'gemini-3-*'],
|
|
49
|
-
},
|
|
50
|
-
};
|
|
51
|
-
|
|
52
|
-
export class PriorityRouter {
|
|
53
|
-
private config: PriorityConfig;
|
|
54
|
-
private runtimeTier: PriorityTier;
|
|
55
|
-
|
|
56
|
-
constructor(config: PriorityConfig) {
|
|
57
|
-
this.config = config;
|
|
58
|
-
this.runtimeTier = config.defaultTier ?? 'standard';
|
|
59
|
-
}
|
|
60
|
-
|
|
61
|
-
/** Toggle fast mode on/off at runtime */
|
|
62
|
-
toggle(): PriorityTier {
|
|
63
|
-
this.runtimeTier = this.runtimeTier === 'fast' ? 'standard' : 'fast';
|
|
64
|
-
return this.runtimeTier;
|
|
65
|
-
}
|
|
66
|
-
|
|
67
|
-
/** Set specific tier */
|
|
68
|
-
setTier(tier: PriorityTier): void {
|
|
69
|
-
this.runtimeTier = tier;
|
|
70
|
-
}
|
|
71
|
-
|
|
72
|
-
/** Get current tier */
|
|
73
|
-
getTier(): PriorityTier {
|
|
74
|
-
return this.runtimeTier;
|
|
75
|
-
}
|
|
76
|
-
|
|
77
|
-
/** Check if fast mode is active */
|
|
78
|
-
isFast(): boolean {
|
|
79
|
-
return this.runtimeTier === 'fast';
|
|
80
|
-
}
|
|
81
|
-
|
|
82
|
-
/**
|
|
83
|
-
* Get priority headers for a provider + model combination.
|
|
84
|
-
* Returns empty object if provider doesn't support priority or model isn't eligible.
|
|
85
|
-
*/
|
|
86
|
-
getHeaders(provider: string, model: string): PriorityHeaders {
|
|
87
|
-
if (!this.config.enabled) return {};
|
|
88
|
-
|
|
89
|
-
const tier = this.getEffectiveTier(provider);
|
|
90
|
-
if (tier === 'standard') return {};
|
|
91
|
-
|
|
92
|
-
const providerMap = PROVIDER_PRIORITY_MAP[provider.toLowerCase()];
|
|
93
|
-
if (!providerMap) return {};
|
|
94
|
-
|
|
95
|
-
// Check model eligibility
|
|
96
|
-
if (!this.isModelEligible(providerMap.supportedModels, model)) return {};
|
|
97
|
-
|
|
98
|
-
return { [providerMap.headerKey]: providerMap.headerValue[tier] };
|
|
99
|
-
}
|
|
100
|
-
|
|
101
|
-
/**
|
|
102
|
-
* Get effective endpoint for a provider, allowing priority-specific routing.
|
|
103
|
-
*/
|
|
104
|
-
getEndpoint(provider: string, defaultEndpoint: string): string {
|
|
105
|
-
const providerConfig = this.config.providers?.find(
|
|
106
|
-
(p) => p.provider.toLowerCase() === provider.toLowerCase()
|
|
107
|
-
);
|
|
108
|
-
if (providerConfig?.endpoint && this.runtimeTier === 'fast') {
|
|
109
|
-
return providerConfig.endpoint;
|
|
110
|
-
}
|
|
111
|
-
return defaultEndpoint;
|
|
112
|
-
}
|
|
113
|
-
|
|
114
|
-
private getEffectiveTier(provider: string): PriorityTier {
|
|
115
|
-
// Check provider-specific override first
|
|
116
|
-
const providerConfig = this.config.providers?.find(
|
|
117
|
-
(p) => p.provider.toLowerCase() === provider.toLowerCase()
|
|
118
|
-
);
|
|
119
|
-
if (providerConfig) return providerConfig.tier;
|
|
120
|
-
return this.runtimeTier;
|
|
121
|
-
}
|
|
122
|
-
|
|
123
|
-
private isModelEligible(patterns: string[], model: string): boolean {
|
|
124
|
-
return patterns.some((pattern) => {
|
|
125
|
-
if (pattern.endsWith('*')) {
|
|
126
|
-
return model.startsWith(pattern.slice(0, -1));
|
|
127
|
-
}
|
|
128
|
-
return model === pattern;
|
|
129
|
-
});
|
|
130
|
-
}
|
|
131
|
-
|
|
132
|
-
/** Status summary for dashboard / CLI */
|
|
133
|
-
status(): { tier: PriorityTier; enabled: boolean; providers: string[] } {
|
|
134
|
-
return {
|
|
135
|
-
tier: this.runtimeTier,
|
|
136
|
-
enabled: this.config.enabled,
|
|
137
|
-
providers: Object.keys(PROVIDER_PRIORITY_MAP),
|
|
138
|
-
};
|
|
139
|
-
}
|
|
140
|
-
}
|
package/src/dtv/data.ts
DELETED
|
@@ -1,29 +0,0 @@
|
|
|
1
|
-
export interface DataSource {
|
|
2
|
-
readonly name: string;
|
|
3
|
-
readonly type: string;
|
|
4
|
-
read(key: string): Promise<unknown>;
|
|
5
|
-
}
|
|
6
|
-
|
|
7
|
-
/**
|
|
8
|
-
* MRGConfig reader — read-only data layer for agents.
|
|
9
|
-
* Agents can read business data but cannot modify source systems.
|
|
10
|
-
*/
|
|
11
|
-
export class MRGConfigReader implements DataSource {
|
|
12
|
-
readonly name = 'mrg-config';
|
|
13
|
-
readonly type = 'config';
|
|
14
|
-
private data: Map<string, unknown>;
|
|
15
|
-
|
|
16
|
-
constructor(initial?: Record<string, unknown>) {
|
|
17
|
-
this.data = new Map(Object.entries(initial ?? {}));
|
|
18
|
-
}
|
|
19
|
-
|
|
20
|
-
async read(key: string): Promise<unknown> {
|
|
21
|
-
return this.data.get(key);
|
|
22
|
-
}
|
|
23
|
-
|
|
24
|
-
load(data: Record<string, unknown>): void {
|
|
25
|
-
for (const [k, v] of Object.entries(data)) {
|
|
26
|
-
this.data.set(k, v);
|
|
27
|
-
}
|
|
28
|
-
}
|
|
29
|
-
}
|
package/src/dtv/trust.ts
DELETED
|
@@ -1,43 +0,0 @@
|
|
|
1
|
-
import type { TrustLevelType } from '../schema/oad';
|
|
2
|
-
|
|
3
|
-
/**
|
|
4
|
-
* Trust levels: sandbox → verified → certified → listed
|
|
5
|
-
*
|
|
6
|
-
* - sandbox: No network, no file system, limited capabilities
|
|
7
|
-
* - verified: Identity verified, basic capabilities
|
|
8
|
-
* - certified: Passed security audit, full capabilities
|
|
9
|
-
* - listed: Published in OPC marketplace
|
|
10
|
-
*/
|
|
11
|
-
export class TrustManager {
|
|
12
|
-
private level: TrustLevelType;
|
|
13
|
-
|
|
14
|
-
constructor(level: TrustLevelType = 'sandbox') {
|
|
15
|
-
this.level = level;
|
|
16
|
-
}
|
|
17
|
-
|
|
18
|
-
getLevel(): TrustLevelType {
|
|
19
|
-
return this.level;
|
|
20
|
-
}
|
|
21
|
-
|
|
22
|
-
canAccessNetwork(): boolean {
|
|
23
|
-
return this.level !== 'sandbox';
|
|
24
|
-
}
|
|
25
|
-
|
|
26
|
-
canAccessFileSystem(): boolean {
|
|
27
|
-
return this.level === 'certified' || this.level === 'listed';
|
|
28
|
-
}
|
|
29
|
-
|
|
30
|
-
canPublish(): boolean {
|
|
31
|
-
return this.level === 'listed';
|
|
32
|
-
}
|
|
33
|
-
|
|
34
|
-
upgrade(to: TrustLevelType): void {
|
|
35
|
-
const order: TrustLevelType[] = ['sandbox', 'verified', 'certified', 'listed'];
|
|
36
|
-
const currentIdx = order.indexOf(this.level);
|
|
37
|
-
const targetIdx = order.indexOf(to);
|
|
38
|
-
if (targetIdx <= currentIdx) {
|
|
39
|
-
throw new Error(`Cannot downgrade trust from ${this.level} to ${to}`);
|
|
40
|
-
}
|
|
41
|
-
this.level = to;
|
|
42
|
-
}
|
|
43
|
-
}
|
package/src/dtv/value.ts
DELETED
|
@@ -1,47 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Value tracking — metrics and ROI for agent operations.
|
|
3
|
-
*/
|
|
4
|
-
export interface ValueMetric {
|
|
5
|
-
name: string;
|
|
6
|
-
value: number;
|
|
7
|
-
unit: string;
|
|
8
|
-
timestamp: number;
|
|
9
|
-
}
|
|
10
|
-
|
|
11
|
-
export class ValueTracker {
|
|
12
|
-
private metrics: Map<string, ValueMetric[]> = new Map();
|
|
13
|
-
private trackedNames: Set<string>;
|
|
14
|
-
|
|
15
|
-
constructor(metricNames: string[] = []) {
|
|
16
|
-
this.trackedNames = new Set(metricNames);
|
|
17
|
-
}
|
|
18
|
-
|
|
19
|
-
record(name: string, value: number, unit: string = ''): void {
|
|
20
|
-
if (!this.metrics.has(name)) {
|
|
21
|
-
this.metrics.set(name, []);
|
|
22
|
-
}
|
|
23
|
-
this.metrics.get(name)!.push({ name, value, unit, timestamp: Date.now() });
|
|
24
|
-
}
|
|
25
|
-
|
|
26
|
-
getMetrics(name: string): ValueMetric[] {
|
|
27
|
-
return this.metrics.get(name) ?? [];
|
|
28
|
-
}
|
|
29
|
-
|
|
30
|
-
getAverage(name: string): number {
|
|
31
|
-
const m = this.getMetrics(name);
|
|
32
|
-
if (m.length === 0) return 0;
|
|
33
|
-
return m.reduce((sum, v) => sum + v.value, 0) / m.length;
|
|
34
|
-
}
|
|
35
|
-
|
|
36
|
-
getSummary(): Record<string, { count: number; average: number; last: number }> {
|
|
37
|
-
const result: Record<string, { count: number; average: number; last: number }> = {};
|
|
38
|
-
for (const [name, values] of this.metrics) {
|
|
39
|
-
result[name] = {
|
|
40
|
-
count: values.length,
|
|
41
|
-
average: this.getAverage(name),
|
|
42
|
-
last: values[values.length - 1]?.value ?? 0,
|
|
43
|
-
};
|
|
44
|
-
}
|
|
45
|
-
return result;
|
|
46
|
-
}
|
|
47
|
-
}
|