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,71 +1,71 @@
1
- import { BaseSkill } from '../skills/base';
2
- import type { AgentContext, Message, SkillResult } from '../core/types';
3
- import type { OADDocument } from '../schema/oad';
4
-
5
- export class CalendarSkill extends BaseSkill {
6
- name = 'calendar-management';
7
- description = 'Manage calendar and scheduling';
8
-
9
- async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
10
- const lower = message.content.toLowerCase();
11
- if (lower.includes('schedule') || lower.includes('meeting') || lower.includes('calendar')) {
12
- return this.match('I can help manage your calendar. I can schedule meetings, check availability, send invites, and set reminders. What would you like to do?', 0.8);
13
- }
14
- if (lower.includes('remind') || lower.includes('reminder')) {
15
- return this.match('I\'ll set a reminder for you. Please provide the date, time, and what you\'d like to be reminded about.', 0.75);
16
- }
17
- return this.noMatch();
18
- }
19
- }
20
-
21
- export class EmailDraftSkill extends BaseSkill {
22
- name = 'email-drafting';
23
- description = 'Draft professional emails';
24
-
25
- async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
26
- const lower = message.content.toLowerCase();
27
- if (lower.includes('email') || lower.includes('draft') || lower.includes('write')) {
28
- return this.match('I can draft emails for you. Please provide: the recipient, subject, key points to cover, and desired tone (formal/casual/friendly).', 0.8);
29
- }
30
- return this.noMatch();
31
- }
32
- }
33
-
34
- export class MeetingPrepSkill extends BaseSkill {
35
- name = 'meeting-prep';
36
- description = 'Prepare for meetings with agendas and notes';
37
-
38
- async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
39
- const lower = message.content.toLowerCase();
40
- if (lower.includes('agenda') || lower.includes('prep') || lower.includes('prepare')) {
41
- return this.match('I can prepare meeting materials including: agenda creation, attendee briefings, talking points, action item tracking, and follow-up summaries.', 0.8);
42
- }
43
- return this.noMatch();
44
- }
45
- }
46
-
47
- export function createExecutiveAssistantConfig(): OADDocument {
48
- return {
49
- apiVersion: 'opc/v1',
50
- kind: 'Agent',
51
- metadata: {
52
- name: 'executive-assistant',
53
- version: '1.0.0',
54
- description: 'AI Executive Assistant - calendar management, email drafting, meeting prep',
55
- author: 'OPC',
56
- license: 'Apache-2.0',
57
- },
58
- spec: {
59
- model: 'deepseek-chat',
60
- systemPrompt: 'You are an executive assistant AI. Help users manage their calendar, draft emails, and prepare for meetings. Be professional, concise, and proactive.',
61
- skills: [
62
- { name: 'calendar-management', description: 'Manage calendar and scheduling' },
63
- { name: 'email-drafting', description: 'Draft professional emails' },
64
- { name: 'meeting-prep', description: 'Prepare meeting materials' },
65
- ],
66
- channels: [{ type: 'web', port: 3000 }],
67
- memory: { shortTerm: true, longTerm: false },
68
- streaming: false,
69
- },
70
- };
71
- }
1
+ import { BaseSkill } from '../skills/base';
2
+ import type { AgentContext, Message, SkillResult } from '../core/types';
3
+ import type { OADDocument } from '../schema/oad';
4
+
5
+ export class CalendarSkill extends BaseSkill {
6
+ name = 'calendar-management';
7
+ description = 'Manage calendar and scheduling';
8
+
9
+ async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
10
+ const lower = message.content.toLowerCase();
11
+ if (lower.includes('schedule') || lower.includes('meeting') || lower.includes('calendar')) {
12
+ return this.match('I can help manage your calendar. I can schedule meetings, check availability, send invites, and set reminders. What would you like to do?', 0.8);
13
+ }
14
+ if (lower.includes('remind') || lower.includes('reminder')) {
15
+ return this.match('I\'ll set a reminder for you. Please provide the date, time, and what you\'d like to be reminded about.', 0.75);
16
+ }
17
+ return this.noMatch();
18
+ }
19
+ }
20
+
21
+ export class EmailDraftSkill extends BaseSkill {
22
+ name = 'email-drafting';
23
+ description = 'Draft professional emails';
24
+
25
+ async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
26
+ const lower = message.content.toLowerCase();
27
+ if (lower.includes('email') || lower.includes('draft') || lower.includes('write')) {
28
+ return this.match('I can draft emails for you. Please provide: the recipient, subject, key points to cover, and desired tone (formal/casual/friendly).', 0.8);
29
+ }
30
+ return this.noMatch();
31
+ }
32
+ }
33
+
34
+ export class MeetingPrepSkill extends BaseSkill {
35
+ name = 'meeting-prep';
36
+ description = 'Prepare for meetings with agendas and notes';
37
+
38
+ async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
39
+ const lower = message.content.toLowerCase();
40
+ if (lower.includes('agenda') || lower.includes('prep') || lower.includes('prepare')) {
41
+ return this.match('I can prepare meeting materials including: agenda creation, attendee briefings, talking points, action item tracking, and follow-up summaries.', 0.8);
42
+ }
43
+ return this.noMatch();
44
+ }
45
+ }
46
+
47
+ export function createExecutiveAssistantConfig(): OADDocument {
48
+ return {
49
+ apiVersion: 'opc/v1',
50
+ kind: 'Agent',
51
+ metadata: {
52
+ name: 'executive-assistant',
53
+ version: '1.0.0',
54
+ description: 'AI Executive Assistant - calendar management, email drafting, meeting prep',
55
+ author: 'OPC',
56
+ license: 'Apache-2.0',
57
+ },
58
+ spec: {
59
+ model: 'deepseek-chat',
60
+ systemPrompt: 'You are an executive assistant AI. Help users manage their calendar, draft emails, and prepare for meetings. Be professional, concise, and proactive.',
61
+ skills: [
62
+ { name: 'calendar-management', description: 'Manage calendar and scheduling' },
63
+ { name: 'email-drafting', description: 'Draft professional emails' },
64
+ { name: 'meeting-prep', description: 'Prepare meeting materials' },
65
+ ],
66
+ channels: [{ type: 'web', port: 3000 }],
67
+ memory: { shortTerm: true, longTerm: false },
68
+ streaming: false,
69
+ },
70
+ };
71
+ }
@@ -1,60 +1,60 @@
1
- import { BaseSkill } from '../skills/base';
2
- import type { AgentContext, Message, SkillResult } from '../core/types';
3
- import type { OADDocument } from '../schema/oad';
4
-
5
- export class BudgetAnalysisSkill extends BaseSkill {
6
- name = 'budget-analysis';
7
- description = 'Analyze budgets and expenses';
8
-
9
- async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
10
- const lower = message.content.toLowerCase();
11
- if (lower.includes('budget') || lower.includes('expense') || lower.includes('cost')) {
12
- return this.match('I can help analyze your budget. Please share your income and expense categories, and I\'ll provide insights on spending patterns and savings opportunities.', 0.8);
13
- }
14
- if (lower.includes('save') || lower.includes('saving')) {
15
- return this.match('Common savings strategies: 50/30/20 rule (needs/wants/savings), automate transfers, review subscriptions, negotiate bills, and track daily spending.', 0.75);
16
- }
17
- return this.noMatch();
18
- }
19
- }
20
-
21
- export class FinancialPlanningSkill extends BaseSkill {
22
- name = 'financial-planning';
23
- description = 'Help with financial planning and advice';
24
-
25
- async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
26
- const lower = message.content.toLowerCase();
27
- if (lower.includes('invest') || lower.includes('portfolio')) {
28
- return this.match('For investment planning, consider: risk tolerance, time horizon, diversification, asset allocation, and regular rebalancing. This is general guidance — consult a certified financial advisor for personalized advice.', 0.8);
29
- }
30
- if (lower.includes('retire') || lower.includes('pension')) {
31
- return this.match('Retirement planning essentials: estimate target savings (25x annual expenses), maximize employer matching, consider tax-advantaged accounts, and start early for compound growth.', 0.8);
32
- }
33
- return this.noMatch();
34
- }
35
- }
36
-
37
- export function createFinancialAdvisorConfig(): OADDocument {
38
- return {
39
- apiVersion: 'opc/v1',
40
- kind: 'Agent',
41
- metadata: {
42
- name: 'financial-advisor',
43
- version: '1.0.0',
44
- description: 'AI Financial Advisor - budget analysis, expense tracking, financial planning',
45
- author: 'OPC',
46
- license: 'Apache-2.0',
47
- },
48
- spec: {
49
- model: 'deepseek-chat',
50
- systemPrompt: 'You are a financial advisor AI. Help users with budget analysis, expense tracking, and financial planning. Always recommend consulting a certified financial advisor for binding decisions.',
51
- skills: [
52
- { name: 'budget-analysis', description: 'Analyze budgets and expenses' },
53
- { name: 'financial-planning', description: 'Financial planning advice' },
54
- ],
55
- channels: [{ type: 'web', port: 3000 }],
56
- memory: { shortTerm: true, longTerm: false },
57
- streaming: false,
58
- },
59
- };
60
- }
1
+ import { BaseSkill } from '../skills/base';
2
+ import type { AgentContext, Message, SkillResult } from '../core/types';
3
+ import type { OADDocument } from '../schema/oad';
4
+
5
+ export class BudgetAnalysisSkill extends BaseSkill {
6
+ name = 'budget-analysis';
7
+ description = 'Analyze budgets and expenses';
8
+
9
+ async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
10
+ const lower = message.content.toLowerCase();
11
+ if (lower.includes('budget') || lower.includes('expense') || lower.includes('cost')) {
12
+ return this.match('I can help analyze your budget. Please share your income and expense categories, and I\'ll provide insights on spending patterns and savings opportunities.', 0.8);
13
+ }
14
+ if (lower.includes('save') || lower.includes('saving')) {
15
+ return this.match('Common savings strategies: 50/30/20 rule (needs/wants/savings), automate transfers, review subscriptions, negotiate bills, and track daily spending.', 0.75);
16
+ }
17
+ return this.noMatch();
18
+ }
19
+ }
20
+
21
+ export class FinancialPlanningSkill extends BaseSkill {
22
+ name = 'financial-planning';
23
+ description = 'Help with financial planning and advice';
24
+
25
+ async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
26
+ const lower = message.content.toLowerCase();
27
+ if (lower.includes('invest') || lower.includes('portfolio')) {
28
+ return this.match('For investment planning, consider: risk tolerance, time horizon, diversification, asset allocation, and regular rebalancing. This is general guidance — consult a certified financial advisor for personalized advice.', 0.8);
29
+ }
30
+ if (lower.includes('retire') || lower.includes('pension')) {
31
+ return this.match('Retirement planning essentials: estimate target savings (25x annual expenses), maximize employer matching, consider tax-advantaged accounts, and start early for compound growth.', 0.8);
32
+ }
33
+ return this.noMatch();
34
+ }
35
+ }
36
+
37
+ export function createFinancialAdvisorConfig(): OADDocument {
38
+ return {
39
+ apiVersion: 'opc/v1',
40
+ kind: 'Agent',
41
+ metadata: {
42
+ name: 'financial-advisor',
43
+ version: '1.0.0',
44
+ description: 'AI Financial Advisor - budget analysis, expense tracking, financial planning',
45
+ author: 'OPC',
46
+ license: 'Apache-2.0',
47
+ },
48
+ spec: {
49
+ model: 'deepseek-chat',
50
+ systemPrompt: 'You are a financial advisor AI. Help users with budget analysis, expense tracking, and financial planning. Always recommend consulting a certified financial advisor for binding decisions.',
51
+ skills: [
52
+ { name: 'budget-analysis', description: 'Analyze budgets and expenses' },
53
+ { name: 'financial-planning', description: 'Financial planning advice' },
54
+ ],
55
+ channels: [{ type: 'web', port: 3000 }],
56
+ memory: { shortTerm: true, longTerm: false },
57
+ streaming: false,
58
+ },
59
+ };
60
+ }
@@ -1,31 +1,27 @@
1
- export const KNOWLEDGE_BASE_SYSTEM_PROMPT = `You are a knowledge base assistant. Answer questions using the company documents
2
- and knowledge provided to you. If you don't have enough information, say so honestly.
3
- Always cite sources when possible. Be accurate and concise.`;
4
-
5
- export function createKnowledgeBaseConfig() {
6
- return {
7
- apiVersion: 'opc/v1' as const,
8
- kind: 'Agent' as const,
9
- metadata: {
10
- name: 'knowledge-base',
11
- version: '1.0.0',
12
- description: 'RAG-powered knowledge base agent using DeepBrain for semantic search',
13
- author: 'OPC Agent',
14
- license: 'Apache-2.0',
15
- },
16
- spec: {
17
- provider: { default: 'deepseek', allowed: ['openai', 'deepseek', 'qwen'] },
18
- model: 'deepseek-chat',
19
- systemPrompt: KNOWLEDGE_BASE_SYSTEM_PROMPT,
20
- skills: [
21
- { name: 'doc-search', description: 'Search company documents' },
22
- ],
23
- channels: [{ type: 'web' as const, port: 3000 }],
24
- memory: { shortTerm: true, longTerm: { provider: 'deepbrain' as const, collection: 'company-knowledge' } },
25
- dtv: {
26
- trust: { level: 'sandbox' as const },
27
- value: { metrics: ['queries_answered', 'docs_indexed'] },
28
- },
29
- },
30
- };
31
- }
1
+ export const KNOWLEDGE_BASE_SYSTEM_PROMPT = `You are a knowledge base assistant. Answer questions using the company documents
2
+ and knowledge provided to you. If you don't have enough information, say so honestly.
3
+ Always cite sources when possible. Be accurate and concise.`;
4
+
5
+ export function createKnowledgeBaseConfig() {
6
+ return {
7
+ apiVersion: 'opc/v1' as const,
8
+ kind: 'Agent' as const,
9
+ metadata: {
10
+ name: 'knowledge-base',
11
+ version: '1.0.0',
12
+ description: 'RAG-powered knowledge base agent using DeepBrain for semantic search',
13
+ author: 'OPC Agent',
14
+ license: 'Apache-2.0',
15
+ },
16
+ spec: {
17
+ provider: { default: 'deepseek', allowed: ['openai', 'deepseek', 'qwen'] },
18
+ model: 'deepseek-chat',
19
+ systemPrompt: KNOWLEDGE_BASE_SYSTEM_PROMPT,
20
+ skills: [
21
+ { name: 'doc-search', description: 'Search company documents' },
22
+ ],
23
+ channels: [{ type: 'web' as const, port: 3000 }],
24
+ memory: { shortTerm: true, longTerm: { provider: 'deepbrain' as const, collection: 'company-knowledge' } },
25
+ },
26
+ };
27
+ }
@@ -1,71 +1,71 @@
1
- import { BaseSkill } from '../skills/base';
2
- import type { AgentContext, Message, SkillResult } from '../core/types';
3
- import type { OADDocument } from '../schema/oad';
4
-
5
- const LEGAL_TERMS: Record<string, string> = {
6
- 'force majeure': 'A clause that frees parties from obligations due to extraordinary events.',
7
- 'indemnification': 'One party agrees to compensate the other for certain damages or losses.',
8
- 'limitation of liability': 'A cap on the amount one party can claim from the other.',
9
- 'non-compete': 'Restricts a party from competing within a specified scope and timeframe.',
10
- 'confidentiality': 'Obligations to keep certain information private.',
11
- 'termination': 'Conditions under which the agreement may be ended.',
12
- };
13
-
14
- export class ContractReviewSkill extends BaseSkill {
15
- name = 'contract-review';
16
- description = 'Review contracts and identify key clauses';
17
-
18
- async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
19
- const lower = message.content.toLowerCase();
20
- for (const [term, explanation] of Object.entries(LEGAL_TERMS)) {
21
- if (lower.includes(term)) {
22
- return this.match(`📋 **${term.toUpperCase()}**: ${explanation}`, 0.85);
23
- }
24
- }
25
- if (lower.includes('review') || lower.includes('contract')) {
26
- return this.match('I can review contracts for key clauses like force majeure, indemnification, limitation of liability, non-compete, confidentiality, and termination provisions.', 0.7);
27
- }
28
- return this.noMatch();
29
- }
30
- }
31
-
32
- export class ComplianceCheckSkill extends BaseSkill {
33
- name = 'compliance-check';
34
- description = 'Check compliance with regulations';
35
-
36
- async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
37
- const lower = message.content.toLowerCase();
38
- if (lower.includes('gdpr') || lower.includes('privacy')) {
39
- return this.match('GDPR compliance requires: data minimization, consent mechanisms, right to erasure, data protection officer, and breach notification within 72 hours.', 0.9);
40
- }
41
- if (lower.includes('compliance') || lower.includes('regulation')) {
42
- return this.match('I can check compliance with GDPR, CCPA, SOX, HIPAA, and other major regulations. Please specify the regulation and context.', 0.7);
43
- }
44
- return this.noMatch();
45
- }
46
- }
47
-
48
- export function createLegalAssistantConfig(): OADDocument {
49
- return {
50
- apiVersion: 'opc/v1',
51
- kind: 'Agent',
52
- metadata: {
53
- name: 'legal-assistant',
54
- version: '1.0.0',
55
- description: 'AI Legal Assistant - contract review, compliance checking, legal research',
56
- author: 'OPC',
57
- license: 'Apache-2.0',
58
- },
59
- spec: {
60
- model: 'deepseek-chat',
61
- systemPrompt: 'You are a legal assistant AI. Help users review contracts, check compliance, and research legal topics. Always recommend consulting a qualified attorney for binding decisions.',
62
- skills: [
63
- { name: 'contract-review', description: 'Review contracts and identify key clauses' },
64
- { name: 'compliance-check', description: 'Check regulatory compliance' },
65
- ],
66
- channels: [{ type: 'web', port: 3000 }],
67
- memory: { shortTerm: true, longTerm: false },
68
- streaming: false,
69
- },
70
- };
71
- }
1
+ import { BaseSkill } from '../skills/base';
2
+ import type { AgentContext, Message, SkillResult } from '../core/types';
3
+ import type { OADDocument } from '../schema/oad';
4
+
5
+ const LEGAL_TERMS: Record<string, string> = {
6
+ 'force majeure': 'A clause that frees parties from obligations due to extraordinary events.',
7
+ 'indemnification': 'One party agrees to compensate the other for certain damages or losses.',
8
+ 'limitation of liability': 'A cap on the amount one party can claim from the other.',
9
+ 'non-compete': 'Restricts a party from competing within a specified scope and timeframe.',
10
+ 'confidentiality': 'Obligations to keep certain information private.',
11
+ 'termination': 'Conditions under which the agreement may be ended.',
12
+ };
13
+
14
+ export class ContractReviewSkill extends BaseSkill {
15
+ name = 'contract-review';
16
+ description = 'Review contracts and identify key clauses';
17
+
18
+ async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
19
+ const lower = message.content.toLowerCase();
20
+ for (const [term, explanation] of Object.entries(LEGAL_TERMS)) {
21
+ if (lower.includes(term)) {
22
+ return this.match(`📋 **${term.toUpperCase()}**: ${explanation}`, 0.85);
23
+ }
24
+ }
25
+ if (lower.includes('review') || lower.includes('contract')) {
26
+ return this.match('I can review contracts for key clauses like force majeure, indemnification, limitation of liability, non-compete, confidentiality, and termination provisions.', 0.7);
27
+ }
28
+ return this.noMatch();
29
+ }
30
+ }
31
+
32
+ export class ComplianceCheckSkill extends BaseSkill {
33
+ name = 'compliance-check';
34
+ description = 'Check compliance with regulations';
35
+
36
+ async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
37
+ const lower = message.content.toLowerCase();
38
+ if (lower.includes('gdpr') || lower.includes('privacy')) {
39
+ return this.match('GDPR compliance requires: data minimization, consent mechanisms, right to erasure, data protection officer, and breach notification within 72 hours.', 0.9);
40
+ }
41
+ if (lower.includes('compliance') || lower.includes('regulation')) {
42
+ return this.match('I can check compliance with GDPR, CCPA, SOX, HIPAA, and other major regulations. Please specify the regulation and context.', 0.7);
43
+ }
44
+ return this.noMatch();
45
+ }
46
+ }
47
+
48
+ export function createLegalAssistantConfig(): OADDocument {
49
+ return {
50
+ apiVersion: 'opc/v1',
51
+ kind: 'Agent',
52
+ metadata: {
53
+ name: 'legal-assistant',
54
+ version: '1.0.0',
55
+ description: 'AI Legal Assistant - contract review, compliance checking, legal research',
56
+ author: 'OPC',
57
+ license: 'Apache-2.0',
58
+ },
59
+ spec: {
60
+ model: 'deepseek-chat',
61
+ systemPrompt: 'You are a legal assistant AI. Help users review contracts, check compliance, and research legal topics. Always recommend consulting a qualified attorney for binding decisions.',
62
+ skills: [
63
+ { name: 'contract-review', description: 'Review contracts and identify key clauses' },
64
+ { name: 'compliance-check', description: 'Check regulatory compliance' },
65
+ ],
66
+ channels: [{ type: 'web', port: 3000 }],
67
+ memory: { shortTerm: true, longTerm: false },
68
+ streaming: false,
69
+ },
70
+ };
71
+ }
@@ -1,79 +1,75 @@
1
- import { BaseSkill } from '../skills/base';
2
- import type { AgentContext, Message, SkillResult } from '../core/types';
3
-
4
- export class ProductQASkill extends BaseSkill {
5
- name = 'product-qa';
6
- description = 'Answer product-related questions';
7
- private catalog: Record<string, string>;
8
-
9
- constructor(catalog?: Record<string, string>) {
10
- super();
11
- this.catalog = catalog ?? {
12
- pricing: 'Please visit our pricing page or contact sales for a custom quote.',
13
- features: 'Our product includes AI-powered automation, analytics dashboard, and API access.',
14
- demo: 'I\'d love to schedule a demo for you! Could you share your email and preferred time?',
15
- };
16
- }
17
-
18
- async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
19
- const lower = message.content.toLowerCase();
20
- for (const [key, answer] of Object.entries(this.catalog)) {
21
- if (lower.includes(key)) return this.match(answer, 0.85);
22
- }
23
- return this.noMatch();
24
- }
25
- }
26
-
27
- export class LeadCaptureSkill extends BaseSkill {
28
- name = 'lead-capture';
29
- description = 'Capture prospect information';
30
- private emailRegex = /[\w.-]+@[\w.-]+\.\w+/;
31
-
32
- async execute(context: AgentContext, message: Message): Promise<SkillResult> {
33
- const email = message.content.match(this.emailRegex);
34
- if (email) {
35
- await context.memory.set(`lead:${email[0]}`, {
36
- email: email[0],
37
- capturedAt: Date.now(),
38
- messages: context.messages.length,
39
- });
40
- return this.match(`Thanks! I've noted your email (${email[0]}). Our team will reach out shortly.`, 0.95);
41
- }
42
- return this.noMatch();
43
- }
44
- }
45
-
46
- export const SALES_ASSISTANT_SYSTEM_PROMPT = `You are a professional sales assistant. Your goals:
47
- 1. Answer product questions accurately and enthusiastically
48
- 2. Capture leads by collecting name, email, and company info
49
- 3. Book appointments when prospects are ready
50
- Be friendly, persuasive but not pushy. Always provide value first.`;
51
-
52
- export function createSalesAssistantConfig() {
53
- return {
54
- apiVersion: 'opc/v1' as const,
55
- kind: 'Agent' as const,
56
- metadata: {
57
- name: 'sales-assistant',
58
- version: '1.0.0',
59
- description: 'AI sales assistant with product Q&A, lead capture, and appointment booking',
60
- author: 'OPC Agent',
61
- license: 'Apache-2.0',
62
- },
63
- spec: {
64
- provider: { default: 'deepseek', allowed: ['openai', 'deepseek', 'qwen'] },
65
- model: 'deepseek-chat',
66
- systemPrompt: SALES_ASSISTANT_SYSTEM_PROMPT,
67
- skills: [
68
- { name: 'product-qa', description: 'Answer product questions' },
69
- { name: 'lead-capture', description: 'Capture prospect info' },
70
- ],
71
- channels: [{ type: 'web' as const, port: 3000 }],
72
- memory: { shortTerm: true, longTerm: false },
73
- dtv: {
74
- trust: { level: 'sandbox' as const },
75
- value: { metrics: ['leads_captured', 'appointments_booked'] },
76
- },
77
- },
78
- };
79
- }
1
+ import { BaseSkill } from '../skills/base';
2
+ import type { AgentContext, Message, SkillResult } from '../core/types';
3
+
4
+ export class ProductQASkill extends BaseSkill {
5
+ name = 'product-qa';
6
+ description = 'Answer product-related questions';
7
+ private catalog: Record<string, string>;
8
+
9
+ constructor(catalog?: Record<string, string>) {
10
+ super();
11
+ this.catalog = catalog ?? {
12
+ pricing: 'Please visit our pricing page or contact sales for a custom quote.',
13
+ features: 'Our product includes AI-powered automation, analytics dashboard, and API access.',
14
+ demo: 'I\'d love to schedule a demo for you! Could you share your email and preferred time?',
15
+ };
16
+ }
17
+
18
+ async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
19
+ const lower = message.content.toLowerCase();
20
+ for (const [key, answer] of Object.entries(this.catalog)) {
21
+ if (lower.includes(key)) return this.match(answer, 0.85);
22
+ }
23
+ return this.noMatch();
24
+ }
25
+ }
26
+
27
+ export class LeadCaptureSkill extends BaseSkill {
28
+ name = 'lead-capture';
29
+ description = 'Capture prospect information';
30
+ private emailRegex = /[\w.-]+@[\w.-]+\.\w+/;
31
+
32
+ async execute(context: AgentContext, message: Message): Promise<SkillResult> {
33
+ const email = message.content.match(this.emailRegex);
34
+ if (email) {
35
+ await context.memory.set(`lead:${email[0]}`, {
36
+ email: email[0],
37
+ capturedAt: Date.now(),
38
+ messages: context.messages.length,
39
+ });
40
+ return this.match(`Thanks! I've noted your email (${email[0]}). Our team will reach out shortly.`, 0.95);
41
+ }
42
+ return this.noMatch();
43
+ }
44
+ }
45
+
46
+ export const SALES_ASSISTANT_SYSTEM_PROMPT = `You are a professional sales assistant. Your goals:
47
+ 1. Answer product questions accurately and enthusiastically
48
+ 2. Capture leads by collecting name, email, and company info
49
+ 3. Book appointments when prospects are ready
50
+ Be friendly, persuasive but not pushy. Always provide value first.`;
51
+
52
+ export function createSalesAssistantConfig() {
53
+ return {
54
+ apiVersion: 'opc/v1' as const,
55
+ kind: 'Agent' as const,
56
+ metadata: {
57
+ name: 'sales-assistant',
58
+ version: '1.0.0',
59
+ description: 'AI sales assistant with product Q&A, lead capture, and appointment booking',
60
+ author: 'OPC Agent',
61
+ license: 'Apache-2.0',
62
+ },
63
+ spec: {
64
+ provider: { default: 'deepseek', allowed: ['openai', 'deepseek', 'qwen'] },
65
+ model: 'deepseek-chat',
66
+ systemPrompt: SALES_ASSISTANT_SYSTEM_PROMPT,
67
+ skills: [
68
+ { name: 'product-qa', description: 'Answer product questions' },
69
+ { name: 'lead-capture', description: 'Capture prospect info' },
70
+ ],
71
+ channels: [{ type: 'web' as const, port: 3000 }],
72
+ memory: { shortTerm: true, longTerm: false },
73
+ },
74
+ };
75
+ }