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.
Files changed (186) hide show
  1. package/.github/ISSUE_TEMPLATE/bug_report.md +20 -0
  2. package/.github/ISSUE_TEMPLATE/feature_request.md +14 -0
  3. package/.github/PULL_REQUEST_TEMPLATE.md +13 -0
  4. package/.github/workflows/ci.yml +24 -0
  5. package/CHANGELOG.md +23 -63
  6. package/CONTRIBUTING.md +21 -60
  7. package/README.md +235 -358
  8. package/README.zh-CN.md +415 -415
  9. package/dist/channels/slack.js +93 -10
  10. package/dist/channels/web.d.ts +10 -0
  11. package/dist/channels/web.js +33 -2
  12. package/dist/cli.js +255 -60
  13. package/dist/core/runtime.d.ts +4 -0
  14. package/dist/core/runtime.js +27 -0
  15. package/dist/deploy/hermes.js +22 -22
  16. package/dist/deploy/openclaw.js +31 -40
  17. package/dist/index.d.ts +3 -10
  18. package/dist/index.js +6 -15
  19. package/dist/providers/index.d.ts +1 -1
  20. package/dist/providers/index.js +7 -1
  21. package/dist/schema/oad.d.ts +1 -2
  22. package/dist/templates/code-reviewer.d.ts +0 -8
  23. package/dist/templates/code-reviewer.js +5 -9
  24. package/dist/templates/customer-service.d.ts +0 -8
  25. package/dist/templates/customer-service.js +2 -6
  26. package/dist/templates/data-analyst.d.ts +0 -8
  27. package/dist/templates/data-analyst.js +5 -9
  28. package/dist/templates/knowledge-base.d.ts +0 -8
  29. package/dist/templates/knowledge-base.js +2 -6
  30. package/dist/templates/sales-assistant.d.ts +0 -8
  31. package/dist/templates/sales-assistant.js +4 -8
  32. package/dist/templates/teacher.d.ts +0 -8
  33. package/dist/templates/teacher.js +6 -10
  34. package/dist/traces/index.d.ts +49 -0
  35. package/dist/traces/index.js +102 -0
  36. package/docs/.vitepress/config.ts +103 -103
  37. package/docs/api/cli.md +48 -48
  38. package/docs/api/oad-schema.md +64 -64
  39. package/docs/api/sdk.md +80 -80
  40. package/docs/guide/concepts.md +51 -51
  41. package/docs/guide/configuration.md +79 -79
  42. package/docs/guide/deployment.md +42 -42
  43. package/docs/guide/getting-started.md +44 -44
  44. package/docs/guide/templates.md +28 -28
  45. package/docs/guide/testing.md +84 -84
  46. package/docs/index.md +27 -27
  47. package/docs/zh/api/cli.md +54 -54
  48. package/docs/zh/api/oad-schema.md +87 -87
  49. package/docs/zh/api/sdk.md +102 -102
  50. package/docs/zh/guide/concepts.md +104 -104
  51. package/docs/zh/guide/configuration.md +135 -135
  52. package/docs/zh/guide/deployment.md +81 -81
  53. package/docs/zh/guide/getting-started.md +82 -82
  54. package/docs/zh/guide/templates.md +84 -84
  55. package/docs/zh/guide/testing.md +88 -88
  56. package/docs/zh/index.md +27 -27
  57. package/examples/README.md +22 -0
  58. package/examples/basic-agent.ts +90 -0
  59. package/examples/brain-integration.ts +71 -0
  60. package/examples/customer-service-demo/README.md +90 -90
  61. package/examples/customer-service-demo/oad.yaml +107 -107
  62. package/examples/multi-channel.ts +74 -0
  63. package/package.json +1 -1
  64. package/src/analytics/index.ts +66 -66
  65. package/src/channels/discord.ts +192 -192
  66. package/src/channels/email.ts +177 -177
  67. package/src/channels/feishu.ts +236 -236
  68. package/src/channels/index.ts +15 -15
  69. package/src/channels/slack.ts +217 -160
  70. package/src/channels/telegram.ts +90 -90
  71. package/src/channels/voice.ts +106 -106
  72. package/src/channels/web.ts +38 -2
  73. package/src/channels/webhook.ts +199 -199
  74. package/src/channels/websocket.ts +87 -87
  75. package/src/channels/wechat.ts +149 -149
  76. package/src/cli.ts +282 -58
  77. package/src/core/a2a.ts +143 -143
  78. package/src/core/agent.ts +152 -152
  79. package/src/core/analytics-engine.ts +186 -186
  80. package/src/core/auth.ts +57 -57
  81. package/src/core/cache.ts +141 -141
  82. package/src/core/compose.ts +77 -77
  83. package/src/core/config.ts +14 -14
  84. package/src/core/errors.ts +148 -148
  85. package/src/core/hitl.ts +138 -138
  86. package/src/core/logger.ts +57 -57
  87. package/src/core/orchestrator.ts +215 -215
  88. package/src/core/performance.ts +187 -187
  89. package/src/core/rate-limiter.ts +128 -128
  90. package/src/core/room.ts +109 -109
  91. package/src/core/runtime.ts +183 -152
  92. package/src/core/sandbox.ts +101 -101
  93. package/src/core/security.ts +171 -171
  94. package/src/core/types.ts +68 -68
  95. package/src/core/versioning.ts +106 -106
  96. package/src/core/watch.ts +178 -178
  97. package/src/core/workflow.ts +235 -235
  98. package/src/deploy/hermes.ts +156 -156
  99. package/src/deploy/openclaw.ts +190 -200
  100. package/src/i18n/index.ts +216 -216
  101. package/src/index.ts +3 -10
  102. package/src/memory/deepbrain.ts +108 -108
  103. package/src/memory/index.ts +34 -34
  104. package/src/plugins/index.ts +208 -208
  105. package/src/providers/index.ts +9 -1
  106. package/src/schema/oad.ts +154 -155
  107. package/src/skills/base.ts +16 -16
  108. package/src/skills/document.ts +100 -100
  109. package/src/skills/http.ts +35 -35
  110. package/src/skills/index.ts +27 -27
  111. package/src/skills/scheduler.ts +80 -80
  112. package/src/skills/webhook-trigger.ts +59 -59
  113. package/src/templates/code-reviewer.ts +30 -34
  114. package/src/templates/customer-service.ts +76 -80
  115. package/src/templates/data-analyst.ts +66 -70
  116. package/src/templates/executive-assistant.ts +71 -71
  117. package/src/templates/financial-advisor.ts +60 -60
  118. package/src/templates/knowledge-base.ts +27 -31
  119. package/src/templates/legal-assistant.ts +71 -71
  120. package/src/templates/sales-assistant.ts +75 -79
  121. package/src/templates/teacher.ts +75 -79
  122. package/src/testing/index.ts +181 -181
  123. package/src/tools/calculator.ts +73 -73
  124. package/src/tools/datetime.ts +149 -149
  125. package/src/tools/json-transform.ts +187 -187
  126. package/src/tools/mcp.ts +76 -76
  127. package/src/tools/text-analysis.ts +116 -116
  128. package/src/traces/index.ts +132 -0
  129. package/templates/Dockerfile +15 -15
  130. package/templates/code-reviewer/README.md +27 -27
  131. package/templates/code-reviewer/oad.yaml +41 -41
  132. package/templates/customer-service/README.md +22 -22
  133. package/templates/customer-service/oad.yaml +36 -36
  134. package/templates/docker-compose.yml +21 -21
  135. package/templates/ecommerce-assistant/README.md +45 -45
  136. package/templates/ecommerce-assistant/oad.yaml +47 -47
  137. package/templates/knowledge-base/README.md +28 -28
  138. package/templates/knowledge-base/oad.yaml +38 -38
  139. package/templates/sales-assistant/README.md +26 -26
  140. package/templates/sales-assistant/oad.yaml +43 -43
  141. package/templates/tech-support/README.md +43 -43
  142. package/templates/tech-support/oad.yaml +45 -45
  143. package/test-agent/Dockerfile +9 -0
  144. package/test-agent/README.md +50 -0
  145. package/test-agent/agent.yaml +23 -0
  146. package/test-agent/docker-compose.yml +11 -0
  147. package/test-agent/oad.yaml +31 -0
  148. package/test-agent/package-lock.json +1492 -0
  149. package/test-agent/package.json +18 -0
  150. package/test-agent/src/index.ts +24 -0
  151. package/test-agent/src/skills/echo.ts +15 -0
  152. package/test-agent/tsconfig.json +25 -0
  153. package/tests/a2a.test.ts +66 -66
  154. package/tests/agent.test.ts +72 -72
  155. package/tests/analytics.test.ts +50 -50
  156. package/tests/channel.test.ts +39 -39
  157. package/tests/e2e.test.ts +134 -134
  158. package/tests/errors.test.ts +83 -83
  159. package/tests/hitl.test.ts +71 -71
  160. package/tests/i18n.test.ts +41 -41
  161. package/tests/mcp.test.ts +54 -54
  162. package/tests/oad.test.ts +68 -68
  163. package/tests/performance.test.ts +115 -115
  164. package/tests/plugin.test.ts +74 -74
  165. package/tests/room.test.ts +106 -106
  166. package/tests/runtime.test.ts +42 -42
  167. package/tests/sandbox.test.ts +46 -46
  168. package/tests/security.test.ts +60 -60
  169. package/tests/templates.test.ts +77 -77
  170. package/tests/v070.test.ts +76 -76
  171. package/tests/versioning.test.ts +75 -75
  172. package/tests/voice.test.ts +61 -61
  173. package/tests/webhook.test.ts +29 -29
  174. package/tests/workflow.test.ts +143 -143
  175. package/tsconfig.json +19 -19
  176. package/vitest.config.ts +9 -9
  177. package/dist/core/dashboard.d.ts +0 -35
  178. package/dist/core/dashboard.js +0 -157
  179. package/dist/core/priority.d.ts +0 -52
  180. package/dist/core/priority.js +0 -102
  181. package/src/core/dashboard.ts +0 -219
  182. package/src/core/priority.ts +0 -140
  183. package/src/dtv/data.ts +0 -29
  184. package/src/dtv/trust.ts +0 -43
  185. package/src/dtv/value.ts +0 -47
  186. package/src/marketplace/index.ts +0 -223
@@ -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
@@ -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
- }
@@ -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
- }