opc-agent 1.1.3 → 1.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (156) hide show
  1. package/CHANGELOG.md +6 -0
  2. package/CONTRIBUTING.md +75 -75
  3. package/README.md +429 -429
  4. package/README.zh-CN.md +415 -415
  5. package/dist/channels/web.js +256 -256
  6. package/dist/core/streaming.d.ts +56 -0
  7. package/dist/core/streaming.js +160 -0
  8. package/dist/deploy/hermes.js +22 -22
  9. package/dist/deploy/openclaw.js +31 -31
  10. package/dist/index.d.ts +4 -0
  11. package/dist/index.js +7 -1
  12. package/dist/providers/index.d.ts +1 -1
  13. package/dist/providers/index.js +13 -148
  14. package/dist/schema/oad.d.ts +3 -3
  15. package/dist/templates/code-reviewer.js +5 -5
  16. package/dist/templates/customer-service.js +2 -2
  17. package/dist/templates/data-analyst.js +5 -5
  18. package/dist/templates/knowledge-base.js +2 -2
  19. package/dist/templates/sales-assistant.js +4 -4
  20. package/dist/templates/teacher.js +6 -6
  21. package/dist/tools/gateway.d.ts +28 -0
  22. package/dist/tools/gateway.js +177 -0
  23. package/docs/.vitepress/config.ts +103 -103
  24. package/docs/api/cli.md +48 -48
  25. package/docs/api/oad-schema.md +64 -64
  26. package/docs/api/sdk.md +80 -80
  27. package/docs/guide/concepts.md +51 -51
  28. package/docs/guide/configuration.md +79 -79
  29. package/docs/guide/deployment.md +42 -42
  30. package/docs/guide/getting-started.md +44 -44
  31. package/docs/guide/templates.md +28 -28
  32. package/docs/guide/testing.md +84 -84
  33. package/docs/index.md +27 -27
  34. package/docs/zh/api/cli.md +54 -54
  35. package/docs/zh/api/oad-schema.md +87 -87
  36. package/docs/zh/api/sdk.md +102 -102
  37. package/docs/zh/guide/concepts.md +104 -104
  38. package/docs/zh/guide/configuration.md +135 -135
  39. package/docs/zh/guide/deployment.md +81 -81
  40. package/docs/zh/guide/getting-started.md +82 -82
  41. package/docs/zh/guide/templates.md +84 -84
  42. package/docs/zh/guide/testing.md +88 -88
  43. package/docs/zh/index.md +27 -27
  44. package/examples/customer-service-demo/README.md +90 -90
  45. package/examples/customer-service-demo/oad.yaml +107 -107
  46. package/package.json +1 -1
  47. package/src/analytics/index.ts +66 -66
  48. package/src/channels/discord.ts +192 -192
  49. package/src/channels/email.ts +177 -177
  50. package/src/channels/feishu.ts +236 -236
  51. package/src/channels/index.ts +15 -15
  52. package/src/channels/slack.ts +160 -160
  53. package/src/channels/telegram.ts +90 -90
  54. package/src/channels/voice.ts +106 -106
  55. package/src/channels/web.ts +17 -17
  56. package/src/channels/webhook.ts +199 -199
  57. package/src/channels/websocket.ts +87 -87
  58. package/src/channels/wechat.ts +149 -149
  59. package/src/core/a2a.ts +143 -143
  60. package/src/core/agent.ts +152 -152
  61. package/src/core/analytics-engine.ts +186 -186
  62. package/src/core/auth.ts +57 -57
  63. package/src/core/cache.ts +141 -141
  64. package/src/core/compose.ts +77 -77
  65. package/src/core/config.ts +14 -14
  66. package/src/core/errors.ts +148 -148
  67. package/src/core/hitl.ts +138 -138
  68. package/src/core/knowledge.ts +49 -4
  69. package/src/core/logger.ts +57 -57
  70. package/src/core/orchestrator.ts +215 -215
  71. package/src/core/performance.ts +187 -187
  72. package/src/core/rate-limiter.ts +128 -128
  73. package/src/core/room.ts +109 -109
  74. package/src/core/runtime.ts +152 -152
  75. package/src/core/sandbox.ts +101 -101
  76. package/src/core/security.ts +171 -171
  77. package/src/core/streaming.ts +195 -0
  78. package/src/core/types.ts +68 -68
  79. package/src/core/versioning.ts +106 -106
  80. package/src/core/watch.ts +178 -178
  81. package/src/core/workflow.ts +235 -235
  82. package/src/deploy/hermes.ts +156 -156
  83. package/src/deploy/openclaw.ts +200 -200
  84. package/src/dtv/data.ts +29 -29
  85. package/src/dtv/trust.ts +43 -43
  86. package/src/dtv/value.ts +47 -47
  87. package/src/i18n/index.ts +216 -216
  88. package/src/index.ts +6 -0
  89. package/src/marketplace/index.ts +223 -223
  90. package/src/memory/deepbrain.ts +108 -108
  91. package/src/memory/index.ts +34 -34
  92. package/src/plugins/index.ts +208 -208
  93. package/src/providers/index.ts +12 -3
  94. package/src/schema/oad.ts +155 -155
  95. package/src/skills/base.ts +16 -16
  96. package/src/skills/document.ts +100 -100
  97. package/src/skills/http.ts +35 -35
  98. package/src/skills/index.ts +27 -27
  99. package/src/skills/scheduler.ts +80 -80
  100. package/src/skills/webhook-trigger.ts +59 -59
  101. package/src/templates/code-reviewer.ts +34 -34
  102. package/src/templates/customer-service.ts +80 -80
  103. package/src/templates/data-analyst.ts +70 -70
  104. package/src/templates/executive-assistant.ts +71 -71
  105. package/src/templates/financial-advisor.ts +60 -60
  106. package/src/templates/knowledge-base.ts +31 -31
  107. package/src/templates/legal-assistant.ts +71 -71
  108. package/src/templates/sales-assistant.ts +79 -79
  109. package/src/templates/teacher.ts +79 -79
  110. package/src/testing/index.ts +181 -181
  111. package/src/tools/calculator.ts +73 -73
  112. package/src/tools/datetime.ts +149 -149
  113. package/src/tools/gateway.ts +220 -0
  114. package/src/tools/json-transform.ts +187 -187
  115. package/src/tools/mcp.ts +76 -76
  116. package/src/tools/text-analysis.ts +116 -116
  117. package/templates/Dockerfile +15 -15
  118. package/templates/code-reviewer/README.md +27 -27
  119. package/templates/code-reviewer/oad.yaml +41 -41
  120. package/templates/customer-service/README.md +22 -22
  121. package/templates/customer-service/oad.yaml +36 -36
  122. package/templates/docker-compose.yml +21 -21
  123. package/templates/ecommerce-assistant/README.md +45 -0
  124. package/templates/ecommerce-assistant/oad.yaml +47 -0
  125. package/templates/knowledge-base/README.md +28 -28
  126. package/templates/knowledge-base/oad.yaml +38 -38
  127. package/templates/sales-assistant/README.md +26 -26
  128. package/templates/sales-assistant/oad.yaml +43 -43
  129. package/templates/tech-support/README.md +43 -0
  130. package/templates/tech-support/oad.yaml +45 -0
  131. package/tests/a2a.test.ts +66 -66
  132. package/tests/agent.test.ts +72 -72
  133. package/tests/analytics.test.ts +50 -50
  134. package/tests/channel.test.ts +39 -39
  135. package/tests/e2e.test.ts +134 -134
  136. package/tests/errors.test.ts +83 -83
  137. package/tests/gateway.test.ts +71 -0
  138. package/tests/hitl.test.ts +71 -71
  139. package/tests/i18n.test.ts +41 -41
  140. package/tests/mcp.test.ts +54 -54
  141. package/tests/oad.test.ts +68 -68
  142. package/tests/performance.test.ts +115 -115
  143. package/tests/plugin.test.ts +74 -74
  144. package/tests/room.test.ts +106 -106
  145. package/tests/runtime.test.ts +42 -42
  146. package/tests/sandbox.test.ts +46 -46
  147. package/tests/security.test.ts +60 -60
  148. package/tests/streaming.test.ts +109 -0
  149. package/tests/templates.test.ts +77 -77
  150. package/tests/v070.test.ts +76 -76
  151. package/tests/versioning.test.ts +75 -75
  152. package/tests/voice.test.ts +61 -61
  153. package/tests/webhook.test.ts +29 -29
  154. package/tests/workflow.test.ts +143 -143
  155. package/tsconfig.json +19 -19
  156. package/vitest.config.ts +9 -9
@@ -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,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
- 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
+ dtv: {
26
+ trust: { level: 'sandbox' as const },
27
+ value: { metrics: ['queries_answered', 'docs_indexed'] },
28
+ },
29
+ },
30
+ };
31
+ }
@@ -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,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
- 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
+ dtv: {
74
+ trust: { level: 'sandbox' as const },
75
+ value: { metrics: ['leads_captured', 'appointments_booked'] },
76
+ },
77
+ },
78
+ };
79
+ }