opc-agent 4.0.44 → 4.1.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 (250) hide show
  1. package/.github/ISSUE_TEMPLATE/bug_report.md +20 -20
  2. package/.github/ISSUE_TEMPLATE/feature_request.md +14 -14
  3. package/.github/PULL_REQUEST_TEMPLATE.md +13 -13
  4. package/CHANGELOG.md +48 -48
  5. package/CONTRIBUTING.md +36 -36
  6. package/README.zh-CN.md +497 -497
  7. package/dist/channels/wechat.js +6 -6
  8. package/dist/cli.js +2 -2
  9. package/dist/core/runtime.js +18 -0
  10. package/dist/deploy/index.js +56 -56
  11. package/dist/providers/index.js +39 -13
  12. package/dist/studio/server.js +211 -20
  13. package/dist/studio-ui/index.html +279 -24
  14. package/dist/ui/components.js +105 -105
  15. package/examples/README.md +22 -22
  16. package/examples/basic-agent.ts +90 -90
  17. package/examples/brain-integration.ts +71 -71
  18. package/examples/multi-channel.ts +74 -74
  19. package/fix-sidebar.mjs +188 -188
  20. package/install.ps1 +154 -154
  21. package/install.sh +164 -164
  22. package/package.json +1 -1
  23. package/scripts/install.ps1 +31 -31
  24. package/scripts/install.sh +40 -40
  25. package/serve-studio.js +13 -13
  26. package/serve-test.js +25 -25
  27. package/src/channels/dingtalk.ts +46 -46
  28. package/src/channels/email.ts +351 -351
  29. package/src/channels/feishu.ts +349 -349
  30. package/src/channels/googlechat.ts +42 -42
  31. package/src/channels/imessage.ts +31 -31
  32. package/src/channels/irc.ts +82 -82
  33. package/src/channels/line.ts +32 -32
  34. package/src/channels/matrix.ts +33 -33
  35. package/src/channels/mattermost.ts +57 -57
  36. package/src/channels/msteams.ts +32 -32
  37. package/src/channels/nostr.ts +32 -32
  38. package/src/channels/qq.ts +33 -33
  39. package/src/channels/signal.ts +32 -32
  40. package/src/channels/sms.ts +33 -33
  41. package/src/channels/telegram.ts +616 -616
  42. package/src/channels/twitch.ts +65 -65
  43. package/src/channels/voice-call.ts +100 -100
  44. package/src/channels/websocket.ts +399 -399
  45. package/src/channels/wechat.ts +329 -329
  46. package/src/channels/whatsapp.ts +32 -32
  47. package/src/cli/chat.ts +99 -99
  48. package/src/cli/setup.ts +314 -314
  49. package/src/cli.ts +2 -2
  50. package/src/core/agent.ts +476 -476
  51. package/src/core/api-server.ts +277 -277
  52. package/src/core/audio.ts +98 -98
  53. package/src/core/collaboration.ts +275 -275
  54. package/src/core/context-discovery.ts +85 -85
  55. package/src/core/context-refs.ts +140 -140
  56. package/src/core/gateway.ts +106 -106
  57. package/src/core/heartbeat.ts +51 -51
  58. package/src/core/hooks.ts +105 -105
  59. package/src/core/ide-bridge.ts +133 -133
  60. package/src/core/node-network.ts +86 -86
  61. package/src/core/profiles.ts +122 -122
  62. package/src/core/runtime.ts +18 -0
  63. package/src/core/scheduler.ts +187 -187
  64. package/src/core/session-manager.ts +137 -137
  65. package/src/core/subagent.ts +98 -98
  66. package/src/core/vision.ts +180 -180
  67. package/src/core/workflow-graph.ts +365 -365
  68. package/src/daemon.ts +96 -96
  69. package/src/deploy/index.ts +255 -255
  70. package/src/doctor.ts +156 -156
  71. package/src/eval/index.ts +211 -211
  72. package/src/eval/suites/basic.json +16 -16
  73. package/src/eval/suites/memory.json +12 -12
  74. package/src/eval/suites/safety.json +14 -14
  75. package/src/hub/brain-seed.ts +54 -54
  76. package/src/hub/client.ts +60 -60
  77. package/src/mcp/servers/calculator-mcp.ts +65 -65
  78. package/src/mcp/servers/crypto-mcp.ts +73 -73
  79. package/src/mcp/servers/database-mcp.ts +72 -72
  80. package/src/mcp/servers/datetime-mcp.ts +69 -69
  81. package/src/mcp/servers/filesystem.ts +66 -66
  82. package/src/mcp/servers/github-mcp.ts +58 -58
  83. package/src/mcp/servers/index.ts +63 -63
  84. package/src/mcp/servers/json-mcp.ts +102 -102
  85. package/src/mcp/servers/memory-mcp.ts +56 -56
  86. package/src/mcp/servers/regex-mcp.ts +53 -53
  87. package/src/mcp/servers/web-mcp.ts +49 -49
  88. package/src/memory/context-compressor.ts +189 -189
  89. package/src/memory/seed-loader.ts +212 -212
  90. package/src/memory/user-profiler.ts +215 -215
  91. package/src/plugins/content-filter.ts +23 -23
  92. package/src/plugins/logger.ts +18 -18
  93. package/src/plugins/rate-limiter.ts +38 -38
  94. package/src/protocols/a2a/client.ts +132 -132
  95. package/src/protocols/a2a/index.ts +8 -8
  96. package/src/protocols/a2a/server.ts +333 -333
  97. package/src/protocols/a2a/types.ts +88 -88
  98. package/src/protocols/a2a/utils.ts +50 -50
  99. package/src/protocols/agui/client.ts +83 -83
  100. package/src/protocols/agui/index.ts +4 -4
  101. package/src/protocols/agui/server.ts +218 -218
  102. package/src/protocols/agui/types.ts +153 -153
  103. package/src/protocols/index.ts +2 -2
  104. package/src/protocols/mcp/agent-tools.ts +134 -134
  105. package/src/protocols/mcp/index.ts +8 -8
  106. package/src/protocols/mcp/server.ts +262 -262
  107. package/src/protocols/mcp/types.ts +69 -69
  108. package/src/providers/index.ts +632 -608
  109. package/src/publish/index.ts +376 -376
  110. package/src/scheduler/cron-engine.ts +191 -191
  111. package/src/scheduler/index.ts +2 -2
  112. package/src/schema/oad.ts +217 -217
  113. package/src/security/approval.ts +131 -131
  114. package/src/security/approvals.ts +143 -143
  115. package/src/security/elevated.ts +105 -105
  116. package/src/security/guardrails.ts +248 -248
  117. package/src/security/index.ts +9 -9
  118. package/src/security/keys.ts +87 -87
  119. package/src/security/secrets.ts +129 -129
  120. package/src/skills/builtin/index.ts +408 -408
  121. package/src/skills/marketplace.ts +113 -113
  122. package/src/skills/types.ts +42 -42
  123. package/src/studio/server.ts +209 -22
  124. package/src/studio/templates-data.ts +178 -178
  125. package/src/studio-ui/index.html +279 -24
  126. package/src/telemetry/index.ts +324 -324
  127. package/src/tools/builtin/browser.ts +299 -299
  128. package/src/tools/builtin/datetime.ts +41 -41
  129. package/src/tools/builtin/file.ts +107 -107
  130. package/src/tools/builtin/home-assistant.ts +116 -116
  131. package/src/tools/builtin/rl-tools.ts +243 -243
  132. package/src/tools/builtin/shell.ts +43 -43
  133. package/src/tools/builtin/vision.ts +64 -64
  134. package/src/tools/builtin/web-search.ts +126 -126
  135. package/src/tools/builtin/web.ts +35 -35
  136. package/src/tools/document-processor.ts +213 -213
  137. package/src/tools/image-generator.ts +150 -150
  138. package/src/tools/integrations/calendar.ts +73 -73
  139. package/src/tools/integrations/code-exec.ts +39 -39
  140. package/src/tools/integrations/csv-analyzer.ts +92 -92
  141. package/src/tools/integrations/database.ts +44 -44
  142. package/src/tools/integrations/email-send.ts +76 -76
  143. package/src/tools/integrations/git-tool.ts +42 -42
  144. package/src/tools/integrations/github-tool.ts +76 -76
  145. package/src/tools/integrations/image-gen.ts +56 -56
  146. package/src/tools/integrations/index.ts +92 -92
  147. package/src/tools/integrations/jira.ts +83 -83
  148. package/src/tools/integrations/notion.ts +71 -71
  149. package/src/tools/integrations/npm-tool.ts +48 -48
  150. package/src/tools/integrations/pdf-reader.ts +58 -58
  151. package/src/tools/integrations/slack.ts +65 -65
  152. package/src/tools/integrations/summarizer.ts +49 -49
  153. package/src/tools/integrations/translator.ts +48 -48
  154. package/src/tools/integrations/trello.ts +60 -60
  155. package/src/tools/integrations/vector-search.ts +42 -42
  156. package/src/tools/integrations/web-scraper.ts +47 -47
  157. package/src/tools/integrations/web-search.ts +58 -58
  158. package/src/tools/integrations/webhook.ts +38 -38
  159. package/src/tools/mcp-client.ts +131 -131
  160. package/src/tools/web-scraper.ts +179 -179
  161. package/src/tools/web-search.ts +180 -180
  162. package/src/ui/components.ts +127 -127
  163. package/srv-out.txt +1 -1
  164. package/templates/ecommerce-assistant/README.md +45 -45
  165. package/templates/ecommerce-assistant/oad.yaml +47 -47
  166. package/templates/tech-support/README.md +43 -43
  167. package/templates/tech-support/oad.yaml +45 -45
  168. package/test-agent/Dockerfile +9 -9
  169. package/test-agent/README.md +50 -50
  170. package/test-agent/agent.yaml +23 -23
  171. package/test-agent/docker-compose.yml +11 -11
  172. package/test-agent/oad.yaml +31 -31
  173. package/test-agent/package-lock.json +1492 -1492
  174. package/test-agent/package.json +17 -17
  175. package/test-agent/src/index.ts +24 -24
  176. package/test-agent/src/skills/echo.ts +15 -15
  177. package/test-agent/tsconfig.json +24 -24
  178. package/test-full.js +43 -43
  179. package/test-sidebar.js +22 -22
  180. package/test-studio3.js +75 -75
  181. package/test-studio4.js +41 -41
  182. package/tests/a2a-protocol.test.ts +285 -285
  183. package/tests/agui-protocol.test.ts +246 -246
  184. package/tests/api-server.test.ts +148 -148
  185. package/tests/approvals.test.ts +89 -89
  186. package/tests/audio.test.ts +40 -40
  187. package/tests/brain-seed-extended.test.ts +490 -490
  188. package/tests/brain-seed.test.ts +239 -239
  189. package/tests/browser.test.ts +179 -179
  190. package/tests/channels/discord.test.ts +79 -79
  191. package/tests/channels/email.test.ts +148 -148
  192. package/tests/channels/feishu.test.ts +123 -123
  193. package/tests/channels/telegram.test.ts +129 -129
  194. package/tests/channels/websocket.test.ts +53 -53
  195. package/tests/channels/wechat.test.ts +170 -170
  196. package/tests/channels-extra.test.ts +45 -45
  197. package/tests/chat-cli.test.ts +160 -160
  198. package/tests/cli.test.ts +46 -46
  199. package/tests/context-compressor.test.ts +172 -172
  200. package/tests/context-refs.test.ts +121 -121
  201. package/tests/cron-engine.test.ts +101 -101
  202. package/tests/daemon.test.ts +135 -135
  203. package/tests/deepbrain-wire.test.ts +234 -234
  204. package/tests/deploy-and-dag.test.ts +196 -196
  205. package/tests/doctor.test.ts +38 -38
  206. package/tests/document-processor.test.ts +69 -69
  207. package/tests/e2e-nocode.test.ts +442 -442
  208. package/tests/elevated.test.ts +69 -69
  209. package/tests/eval.test.ts +173 -173
  210. package/tests/gateway.test.ts +63 -63
  211. package/tests/guardrails.test.ts +177 -177
  212. package/tests/home-assistant.test.ts +40 -40
  213. package/tests/hooks.test.ts +79 -79
  214. package/tests/ide-bridge.test.ts +38 -38
  215. package/tests/image-generator.test.ts +84 -84
  216. package/tests/init-role.test.ts +124 -124
  217. package/tests/integrations.test.ts +249 -249
  218. package/tests/mcp-client.test.ts +92 -92
  219. package/tests/mcp-server.test.ts +178 -178
  220. package/tests/mcp-servers.test.ts +260 -260
  221. package/tests/node-network.test.ts +74 -74
  222. package/tests/plugin-a2a-enhanced.test.ts +230 -230
  223. package/tests/profiles.test.ts +61 -61
  224. package/tests/publish.test.ts +231 -231
  225. package/tests/rl-tools.test.ts +93 -93
  226. package/tests/sandbox-manager.test.ts +46 -46
  227. package/tests/scheduler.test.ts +200 -200
  228. package/tests/secrets.test.ts +107 -107
  229. package/tests/security-enhanced.test.ts +233 -233
  230. package/tests/settings-api.test.ts +148 -148
  231. package/tests/setup.test.ts +73 -73
  232. package/tests/subagent.test.ts +193 -193
  233. package/tests/telegram-discord.test.ts +60 -60
  234. package/tests/telemetry.test.ts +186 -186
  235. package/tests/user-profiler.test.ts +169 -169
  236. package/tests/v090-features.test.ts +254 -254
  237. package/tests/vision.test.ts +61 -61
  238. package/tests/voice-call.test.ts +47 -47
  239. package/tests/voice-enhanced.test.ts +169 -169
  240. package/tests/voice-interaction.test.ts +38 -38
  241. package/tests/web-search.test.ts +155 -155
  242. package/tests/workflow-graph.test.ts +279 -279
  243. package/tutorial/customer-service-agent/README.md +612 -612
  244. package/tutorial/customer-service-agent/SOUL.md +26 -26
  245. package/tutorial/customer-service-agent/agent.yaml +63 -63
  246. package/tutorial/customer-service-agent/package.json +19 -19
  247. package/tutorial/customer-service-agent/src/index.ts +69 -69
  248. package/tutorial/customer-service-agent/src/skills/faq.ts +27 -27
  249. package/tutorial/customer-service-agent/src/skills/ticket.ts +22 -22
  250. package/tutorial/customer-service-agent/tsconfig.json +14 -14
@@ -1,71 +1,71 @@
1
- import type { MCPTool, MCPToolResult } from '../mcp';
2
-
3
- export const NotionTool: MCPTool = {
4
- name: 'notion',
5
- description: 'Interact with Notion API: create pages, search, append blocks. Requires NOTION_API_KEY env var.',
6
- inputSchema: {
7
- type: 'object',
8
- properties: {
9
- action: { type: 'string', enum: ['create_page', 'search', 'append_block'], description: 'Action to perform' },
10
- parent_id: { type: 'string', description: 'Parent page/database ID' },
11
- title: { type: 'string', description: 'Page title (for create_page)' },
12
- content: { type: 'string', description: 'Content text (for create_page or append_block)' },
13
- query: { type: 'string', description: 'Search query (for search)' },
14
- block_id: { type: 'string', description: 'Block ID (for append_block)' },
15
- },
16
- required: ['action'],
17
- },
18
-
19
- async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
20
- const apiKey = process.env.NOTION_API_KEY;
21
- if (!apiKey) return { content: 'Error: NOTION_API_KEY required', isError: true };
22
-
23
- const action = String(input.action ?? '');
24
- const headers = {
25
- 'Authorization': `Bearer ${apiKey}`,
26
- 'Content-Type': 'application/json',
27
- 'Notion-Version': '2022-06-28',
28
- };
29
-
30
- try {
31
- if (action === 'create_page') {
32
- if (!input.parent_id) return { content: 'Error: parent_id required', isError: true };
33
- const res = await fetch('https://api.notion.com/v1/pages', {
34
- method: 'POST', headers,
35
- body: JSON.stringify({
36
- parent: { page_id: input.parent_id },
37
- properties: { title: { title: [{ text: { content: String(input.title ?? 'Untitled') } }] } },
38
- children: input.content ? [{ object: 'block', type: 'paragraph', paragraph: { rich_text: [{ text: { content: String(input.content) } }] } }] : [],
39
- }),
40
- });
41
- const data = await res.json() as Record<string, unknown>;
42
- return { content: `Page created: ${data.id ?? 'unknown'}` };
43
- }
44
-
45
- if (action === 'search') {
46
- const res = await fetch('https://api.notion.com/v1/search', {
47
- method: 'POST', headers,
48
- body: JSON.stringify({ query: String(input.query ?? '') }),
49
- });
50
- const data = await res.json() as Record<string, unknown>;
51
- return { content: JSON.stringify(data, null, 2).slice(0, 4000) };
52
- }
53
-
54
- if (action === 'append_block') {
55
- if (!input.block_id) return { content: 'Error: block_id required', isError: true };
56
- const res = await fetch(`https://api.notion.com/v1/blocks/${input.block_id}/children`, {
57
- method: 'PATCH', headers,
58
- body: JSON.stringify({
59
- children: [{ object: 'block', type: 'paragraph', paragraph: { rich_text: [{ text: { content: String(input.content ?? '') } }] } }],
60
- }),
61
- });
62
- const data = await res.json() as Record<string, unknown>;
63
- return { content: `Block appended: ${JSON.stringify(data).slice(0, 500)}` };
64
- }
65
-
66
- return { content: `Unknown action: ${action}`, isError: true };
67
- } catch (err) {
68
- return { content: `Notion error: ${(err as Error).message}`, isError: true };
69
- }
70
- },
71
- };
1
+ import type { MCPTool, MCPToolResult } from '../mcp';
2
+
3
+ export const NotionTool: MCPTool = {
4
+ name: 'notion',
5
+ description: 'Interact with Notion API: create pages, search, append blocks. Requires NOTION_API_KEY env var.',
6
+ inputSchema: {
7
+ type: 'object',
8
+ properties: {
9
+ action: { type: 'string', enum: ['create_page', 'search', 'append_block'], description: 'Action to perform' },
10
+ parent_id: { type: 'string', description: 'Parent page/database ID' },
11
+ title: { type: 'string', description: 'Page title (for create_page)' },
12
+ content: { type: 'string', description: 'Content text (for create_page or append_block)' },
13
+ query: { type: 'string', description: 'Search query (for search)' },
14
+ block_id: { type: 'string', description: 'Block ID (for append_block)' },
15
+ },
16
+ required: ['action'],
17
+ },
18
+
19
+ async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
20
+ const apiKey = process.env.NOTION_API_KEY;
21
+ if (!apiKey) return { content: 'Error: NOTION_API_KEY required', isError: true };
22
+
23
+ const action = String(input.action ?? '');
24
+ const headers = {
25
+ 'Authorization': `Bearer ${apiKey}`,
26
+ 'Content-Type': 'application/json',
27
+ 'Notion-Version': '2022-06-28',
28
+ };
29
+
30
+ try {
31
+ if (action === 'create_page') {
32
+ if (!input.parent_id) return { content: 'Error: parent_id required', isError: true };
33
+ const res = await fetch('https://api.notion.com/v1/pages', {
34
+ method: 'POST', headers,
35
+ body: JSON.stringify({
36
+ parent: { page_id: input.parent_id },
37
+ properties: { title: { title: [{ text: { content: String(input.title ?? 'Untitled') } }] } },
38
+ children: input.content ? [{ object: 'block', type: 'paragraph', paragraph: { rich_text: [{ text: { content: String(input.content) } }] } }] : [],
39
+ }),
40
+ });
41
+ const data = await res.json() as Record<string, unknown>;
42
+ return { content: `Page created: ${data.id ?? 'unknown'}` };
43
+ }
44
+
45
+ if (action === 'search') {
46
+ const res = await fetch('https://api.notion.com/v1/search', {
47
+ method: 'POST', headers,
48
+ body: JSON.stringify({ query: String(input.query ?? '') }),
49
+ });
50
+ const data = await res.json() as Record<string, unknown>;
51
+ return { content: JSON.stringify(data, null, 2).slice(0, 4000) };
52
+ }
53
+
54
+ if (action === 'append_block') {
55
+ if (!input.block_id) return { content: 'Error: block_id required', isError: true };
56
+ const res = await fetch(`https://api.notion.com/v1/blocks/${input.block_id}/children`, {
57
+ method: 'PATCH', headers,
58
+ body: JSON.stringify({
59
+ children: [{ object: 'block', type: 'paragraph', paragraph: { rich_text: [{ text: { content: String(input.content ?? '') } }] } }],
60
+ }),
61
+ });
62
+ const data = await res.json() as Record<string, unknown>;
63
+ return { content: `Block appended: ${JSON.stringify(data).slice(0, 500)}` };
64
+ }
65
+
66
+ return { content: `Unknown action: ${action}`, isError: true };
67
+ } catch (err) {
68
+ return { content: `Notion error: ${(err as Error).message}`, isError: true };
69
+ }
70
+ },
71
+ };
@@ -1,48 +1,48 @@
1
- import type { MCPTool, MCPToolResult } from '../mcp';
2
-
3
- export const NpmTool: MCPTool = {
4
- name: 'npm',
5
- description: 'Search npm registry, get package info, or list installed packages.',
6
- inputSchema: {
7
- type: 'object',
8
- properties: {
9
- action: { type: 'string', enum: ['search', 'info', 'install'], description: 'Action' },
10
- package: { type: 'string', description: 'Package name' },
11
- query: { type: 'string', description: 'Search query (for search)' },
12
- },
13
- required: ['action'],
14
- },
15
-
16
- async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
17
- const action = String(input.action ?? '');
18
-
19
- try {
20
- if (action === 'search') {
21
- const q = String(input.query ?? input.package ?? '');
22
- if (!q) return { content: 'Error: query required', isError: true };
23
- const res = await fetch(`https://registry.npmjs.org/-/v1/search?text=${encodeURIComponent(q)}&size=10`);
24
- const data = await res.json() as { objects?: Array<{ package: { name: string; version: string; description: string } }> };
25
- const results = (data.objects ?? []).map((o) => `${o.package.name}@${o.package.version} — ${o.package.description}`).join('\n');
26
- return { content: results || 'No results' };
27
- }
28
-
29
- if (action === 'info') {
30
- const pkg = String(input.package ?? '');
31
- if (!pkg) return { content: 'Error: package required', isError: true };
32
- const res = await fetch(`https://registry.npmjs.org/${encodeURIComponent(pkg)}`);
33
- if (!res.ok) return { content: `Package not found: ${pkg}`, isError: true };
34
- const data = await res.json() as Record<string, unknown>;
35
- const latest = (data['dist-tags'] as Record<string, string>)?.latest;
36
- return { content: `${data.name}@${latest}\n${data.description}\nLicense: ${data.license}\nHomepage: ${data.homepage}` };
37
- }
38
-
39
- if (action === 'install') {
40
- return { content: 'Error: npm install is not supported via this tool for security. Use shell access instead.', isError: true };
41
- }
42
-
43
- return { content: `Unknown action: ${action}`, isError: true };
44
- } catch (err) {
45
- return { content: `NPM error: ${(err as Error).message}`, isError: true };
46
- }
47
- },
48
- };
1
+ import type { MCPTool, MCPToolResult } from '../mcp';
2
+
3
+ export const NpmTool: MCPTool = {
4
+ name: 'npm',
5
+ description: 'Search npm registry, get package info, or list installed packages.',
6
+ inputSchema: {
7
+ type: 'object',
8
+ properties: {
9
+ action: { type: 'string', enum: ['search', 'info', 'install'], description: 'Action' },
10
+ package: { type: 'string', description: 'Package name' },
11
+ query: { type: 'string', description: 'Search query (for search)' },
12
+ },
13
+ required: ['action'],
14
+ },
15
+
16
+ async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
17
+ const action = String(input.action ?? '');
18
+
19
+ try {
20
+ if (action === 'search') {
21
+ const q = String(input.query ?? input.package ?? '');
22
+ if (!q) return { content: 'Error: query required', isError: true };
23
+ const res = await fetch(`https://registry.npmjs.org/-/v1/search?text=${encodeURIComponent(q)}&size=10`);
24
+ const data = await res.json() as { objects?: Array<{ package: { name: string; version: string; description: string } }> };
25
+ const results = (data.objects ?? []).map((o) => `${o.package.name}@${o.package.version} — ${o.package.description}`).join('\n');
26
+ return { content: results || 'No results' };
27
+ }
28
+
29
+ if (action === 'info') {
30
+ const pkg = String(input.package ?? '');
31
+ if (!pkg) return { content: 'Error: package required', isError: true };
32
+ const res = await fetch(`https://registry.npmjs.org/${encodeURIComponent(pkg)}`);
33
+ if (!res.ok) return { content: `Package not found: ${pkg}`, isError: true };
34
+ const data = await res.json() as Record<string, unknown>;
35
+ const latest = (data['dist-tags'] as Record<string, string>)?.latest;
36
+ return { content: `${data.name}@${latest}\n${data.description}\nLicense: ${data.license}\nHomepage: ${data.homepage}` };
37
+ }
38
+
39
+ if (action === 'install') {
40
+ return { content: 'Error: npm install is not supported via this tool for security. Use shell access instead.', isError: true };
41
+ }
42
+
43
+ return { content: `Unknown action: ${action}`, isError: true };
44
+ } catch (err) {
45
+ return { content: `NPM error: ${(err as Error).message}`, isError: true };
46
+ }
47
+ },
48
+ };
@@ -1,58 +1,58 @@
1
- import type { MCPTool, MCPToolResult } from '../mcp';
2
- import * as fs from 'fs';
3
-
4
- export const PDFReaderTool: MCPTool = {
5
- name: 'pdf-reader',
6
- description: 'Extract text content from a PDF file. Uses basic binary parsing (no external deps).',
7
- inputSchema: {
8
- type: 'object',
9
- properties: {
10
- file_path: { type: 'string', description: 'Path to PDF file' },
11
- url: { type: 'string', description: 'URL of PDF file (alternative to file_path)' },
12
- max_length: { type: 'number', description: 'Max characters to return (default: 5000)' },
13
- },
14
- required: [],
15
- },
16
-
17
- async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
18
- const maxLen = Number(input.max_length ?? 5000);
19
-
20
- try {
21
- let buffer: Buffer;
22
-
23
- if (input.url) {
24
- const res = await fetch(String(input.url));
25
- if (!res.ok) return { content: `HTTP ${res.status}`, isError: true };
26
- buffer = Buffer.from(await res.arrayBuffer());
27
- } else if (input.file_path) {
28
- buffer = fs.readFileSync(String(input.file_path));
29
- } else {
30
- return { content: 'Error: file_path or url required', isError: true };
31
- }
32
-
33
- // Basic PDF text extraction — find text between BT/ET markers and decode
34
- const content = buffer.toString('latin1');
35
- const textParts: string[] = [];
36
-
37
- // Extract text from stream objects
38
- const streamRegex = /stream\r?\n([\s\S]*?)\r?\nendstream/g;
39
- let match: RegExpExecArray | null;
40
- while ((match = streamRegex.exec(content)) !== null) {
41
- const stream = match[1];
42
- // Extract text shown with Tj or TJ operators
43
- const tjRegex = /\(([^)]*)\)\s*Tj/g;
44
- let tjMatch: RegExpExecArray | null;
45
- while ((tjMatch = tjRegex.exec(stream)) !== null) {
46
- textParts.push(tjMatch[1]);
47
- }
48
- }
49
-
50
- const text = textParts.join(' ').replace(/\\n/g, '\n').replace(/\\\(/g, '(').replace(/\\\)/g, ')');
51
- if (!text.trim()) return { content: '(No extractable text found — PDF may use compressed streams. Consider using a dedicated PDF library.)' };
52
-
53
- return { content: text.slice(0, maxLen), metadata: { pages_approx: (content.match(/\/Type\s*\/Page[^s]/g) || []).length } };
54
- } catch (err) {
55
- return { content: `PDF error: ${(err as Error).message}`, isError: true };
56
- }
57
- },
58
- };
1
+ import type { MCPTool, MCPToolResult } from '../mcp';
2
+ import * as fs from 'fs';
3
+
4
+ export const PDFReaderTool: MCPTool = {
5
+ name: 'pdf-reader',
6
+ description: 'Extract text content from a PDF file. Uses basic binary parsing (no external deps).',
7
+ inputSchema: {
8
+ type: 'object',
9
+ properties: {
10
+ file_path: { type: 'string', description: 'Path to PDF file' },
11
+ url: { type: 'string', description: 'URL of PDF file (alternative to file_path)' },
12
+ max_length: { type: 'number', description: 'Max characters to return (default: 5000)' },
13
+ },
14
+ required: [],
15
+ },
16
+
17
+ async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
18
+ const maxLen = Number(input.max_length ?? 5000);
19
+
20
+ try {
21
+ let buffer: Buffer;
22
+
23
+ if (input.url) {
24
+ const res = await fetch(String(input.url));
25
+ if (!res.ok) return { content: `HTTP ${res.status}`, isError: true };
26
+ buffer = Buffer.from(await res.arrayBuffer());
27
+ } else if (input.file_path) {
28
+ buffer = fs.readFileSync(String(input.file_path));
29
+ } else {
30
+ return { content: 'Error: file_path or url required', isError: true };
31
+ }
32
+
33
+ // Basic PDF text extraction — find text between BT/ET markers and decode
34
+ const content = buffer.toString('latin1');
35
+ const textParts: string[] = [];
36
+
37
+ // Extract text from stream objects
38
+ const streamRegex = /stream\r?\n([\s\S]*?)\r?\nendstream/g;
39
+ let match: RegExpExecArray | null;
40
+ while ((match = streamRegex.exec(content)) !== null) {
41
+ const stream = match[1];
42
+ // Extract text shown with Tj or TJ operators
43
+ const tjRegex = /\(([^)]*)\)\s*Tj/g;
44
+ let tjMatch: RegExpExecArray | null;
45
+ while ((tjMatch = tjRegex.exec(stream)) !== null) {
46
+ textParts.push(tjMatch[1]);
47
+ }
48
+ }
49
+
50
+ const text = textParts.join(' ').replace(/\\n/g, '\n').replace(/\\\(/g, '(').replace(/\\\)/g, ')');
51
+ if (!text.trim()) return { content: '(No extractable text found — PDF may use compressed streams. Consider using a dedicated PDF library.)' };
52
+
53
+ return { content: text.slice(0, maxLen), metadata: { pages_approx: (content.match(/\/Type\s*\/Page[^s]/g) || []).length } };
54
+ } catch (err) {
55
+ return { content: `PDF error: ${(err as Error).message}`, isError: true };
56
+ }
57
+ },
58
+ };
@@ -1,65 +1,65 @@
1
- import type { MCPTool, MCPToolResult } from '../mcp';
2
-
3
- export const SlackTool: MCPTool = {
4
- name: 'slack',
5
- description: 'Send messages to Slack channels, list channels, or search messages. Requires SLACK_WEBHOOK_URL or SLACK_BOT_TOKEN env var.',
6
- inputSchema: {
7
- type: 'object',
8
- properties: {
9
- action: { type: 'string', enum: ['send_message', 'list_channels', 'search'], description: 'Action to perform' },
10
- channel: { type: 'string', description: 'Channel name or ID (for send_message)' },
11
- text: { type: 'string', description: 'Message text (for send_message) or search query (for search)' },
12
- },
13
- required: ['action'],
14
- },
15
-
16
- async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
17
- const action = String(input.action ?? '');
18
- const token = process.env.SLACK_BOT_TOKEN;
19
- const webhookUrl = process.env.SLACK_WEBHOOK_URL;
20
-
21
- try {
22
- if (action === 'send_message') {
23
- if (!input.text) return { content: 'Error: text is required', isError: true };
24
- if (webhookUrl) {
25
- const res = await fetch(webhookUrl, {
26
- method: 'POST',
27
- headers: { 'Content-Type': 'application/json' },
28
- body: JSON.stringify({ channel: input.channel, text: input.text }),
29
- });
30
- return { content: `Message sent (status: ${res.status})` };
31
- }
32
- if (!token) return { content: 'Error: SLACK_BOT_TOKEN or SLACK_WEBHOOK_URL required', isError: true };
33
- const res = await fetch('https://slack.com/api/chat.postMessage', {
34
- method: 'POST',
35
- headers: { 'Authorization': `Bearer ${token}`, 'Content-Type': 'application/json' },
36
- body: JSON.stringify({ channel: input.channel, text: input.text }),
37
- });
38
- const data = await res.json() as Record<string, unknown>;
39
- return { content: data.ok ? 'Message sent' : `Error: ${data.error}`, isError: !data.ok };
40
- }
41
-
42
- if (action === 'list_channels') {
43
- if (!token) return { content: 'Error: SLACK_BOT_TOKEN required', isError: true };
44
- const res = await fetch('https://slack.com/api/conversations.list', {
45
- headers: { 'Authorization': `Bearer ${token}` },
46
- });
47
- const data = await res.json() as Record<string, unknown>;
48
- return { content: JSON.stringify(data, null, 2) };
49
- }
50
-
51
- if (action === 'search') {
52
- if (!token) return { content: 'Error: SLACK_BOT_TOKEN required', isError: true };
53
- const res = await fetch(`https://slack.com/api/search.messages?query=${encodeURIComponent(String(input.text ?? ''))}`, {
54
- headers: { 'Authorization': `Bearer ${token}` },
55
- });
56
- const data = await res.json() as Record<string, unknown>;
57
- return { content: JSON.stringify(data, null, 2) };
58
- }
59
-
60
- return { content: `Unknown action: ${action}`, isError: true };
61
- } catch (err) {
62
- return { content: `Slack error: ${(err as Error).message}`, isError: true };
63
- }
64
- },
65
- };
1
+ import type { MCPTool, MCPToolResult } from '../mcp';
2
+
3
+ export const SlackTool: MCPTool = {
4
+ name: 'slack',
5
+ description: 'Send messages to Slack channels, list channels, or search messages. Requires SLACK_WEBHOOK_URL or SLACK_BOT_TOKEN env var.',
6
+ inputSchema: {
7
+ type: 'object',
8
+ properties: {
9
+ action: { type: 'string', enum: ['send_message', 'list_channels', 'search'], description: 'Action to perform' },
10
+ channel: { type: 'string', description: 'Channel name or ID (for send_message)' },
11
+ text: { type: 'string', description: 'Message text (for send_message) or search query (for search)' },
12
+ },
13
+ required: ['action'],
14
+ },
15
+
16
+ async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
17
+ const action = String(input.action ?? '');
18
+ const token = process.env.SLACK_BOT_TOKEN;
19
+ const webhookUrl = process.env.SLACK_WEBHOOK_URL;
20
+
21
+ try {
22
+ if (action === 'send_message') {
23
+ if (!input.text) return { content: 'Error: text is required', isError: true };
24
+ if (webhookUrl) {
25
+ const res = await fetch(webhookUrl, {
26
+ method: 'POST',
27
+ headers: { 'Content-Type': 'application/json' },
28
+ body: JSON.stringify({ channel: input.channel, text: input.text }),
29
+ });
30
+ return { content: `Message sent (status: ${res.status})` };
31
+ }
32
+ if (!token) return { content: 'Error: SLACK_BOT_TOKEN or SLACK_WEBHOOK_URL required', isError: true };
33
+ const res = await fetch('https://slack.com/api/chat.postMessage', {
34
+ method: 'POST',
35
+ headers: { 'Authorization': `Bearer ${token}`, 'Content-Type': 'application/json' },
36
+ body: JSON.stringify({ channel: input.channel, text: input.text }),
37
+ });
38
+ const data = await res.json() as Record<string, unknown>;
39
+ return { content: data.ok ? 'Message sent' : `Error: ${data.error}`, isError: !data.ok };
40
+ }
41
+
42
+ if (action === 'list_channels') {
43
+ if (!token) return { content: 'Error: SLACK_BOT_TOKEN required', isError: true };
44
+ const res = await fetch('https://slack.com/api/conversations.list', {
45
+ headers: { 'Authorization': `Bearer ${token}` },
46
+ });
47
+ const data = await res.json() as Record<string, unknown>;
48
+ return { content: JSON.stringify(data, null, 2) };
49
+ }
50
+
51
+ if (action === 'search') {
52
+ if (!token) return { content: 'Error: SLACK_BOT_TOKEN required', isError: true };
53
+ const res = await fetch(`https://slack.com/api/search.messages?query=${encodeURIComponent(String(input.text ?? ''))}`, {
54
+ headers: { 'Authorization': `Bearer ${token}` },
55
+ });
56
+ const data = await res.json() as Record<string, unknown>;
57
+ return { content: JSON.stringify(data, null, 2) };
58
+ }
59
+
60
+ return { content: `Unknown action: ${action}`, isError: true };
61
+ } catch (err) {
62
+ return { content: `Slack error: ${(err as Error).message}`, isError: true };
63
+ }
64
+ },
65
+ };
@@ -1,49 +1,49 @@
1
- import type { MCPTool, MCPToolResult } from '../mcp';
2
-
3
- export const SummarizerTool: MCPTool = {
4
- name: 'summarizer',
5
- description: 'Summarize long text using an LLM API. Requires OPENAI_API_KEY or LLM_API_URL env var.',
6
- inputSchema: {
7
- type: 'object',
8
- properties: {
9
- text: { type: 'string', description: 'Text to summarize' },
10
- max_length: { type: 'number', description: 'Approximate max summary length in words (default: 200)' },
11
- style: { type: 'string', enum: ['brief', 'detailed', 'bullets'], description: 'Summary style (default: brief)' },
12
- },
13
- required: ['text'],
14
- },
15
-
16
- async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
17
- const text = String(input.text ?? '');
18
- if (!text) return { content: 'Error: text required', isError: true };
19
-
20
- const style = String(input.style ?? 'brief');
21
- const maxLen = Number(input.max_length ?? 200);
22
- const prompt = `Summarize the following text in a ${style} style, approximately ${maxLen} words:\n\n${text.slice(0, 15000)}`;
23
-
24
- try {
25
- const apiKey = process.env.OPENAI_API_KEY;
26
- const apiUrl = process.env.LLM_API_URL || 'https://api.openai.com/v1/chat/completions';
27
- if (!apiKey && apiUrl === 'https://api.openai.com/v1/chat/completions') {
28
- return { content: 'Error: OPENAI_API_KEY or LLM_API_URL required', isError: true };
29
- }
30
-
31
- const headers: Record<string, string> = { 'Content-Type': 'application/json' };
32
- if (apiKey) headers['Authorization'] = `Bearer ${apiKey}`;
33
-
34
- const res = await fetch(apiUrl, {
35
- method: 'POST', headers,
36
- body: JSON.stringify({
37
- model: process.env.LLM_MODEL || 'gpt-4o-mini',
38
- messages: [{ role: 'user', content: prompt }],
39
- max_tokens: maxLen * 3,
40
- }),
41
- });
42
- const data = await res.json() as { choices?: Array<{ message: { content: string } }> };
43
- const summary = data.choices?.[0]?.message?.content ?? 'No summary generated';
44
- return { content: summary };
45
- } catch (err) {
46
- return { content: `Summarizer error: ${(err as Error).message}`, isError: true };
47
- }
48
- },
49
- };
1
+ import type { MCPTool, MCPToolResult } from '../mcp';
2
+
3
+ export const SummarizerTool: MCPTool = {
4
+ name: 'summarizer',
5
+ description: 'Summarize long text using an LLM API. Requires OPENAI_API_KEY or LLM_API_URL env var.',
6
+ inputSchema: {
7
+ type: 'object',
8
+ properties: {
9
+ text: { type: 'string', description: 'Text to summarize' },
10
+ max_length: { type: 'number', description: 'Approximate max summary length in words (default: 200)' },
11
+ style: { type: 'string', enum: ['brief', 'detailed', 'bullets'], description: 'Summary style (default: brief)' },
12
+ },
13
+ required: ['text'],
14
+ },
15
+
16
+ async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
17
+ const text = String(input.text ?? '');
18
+ if (!text) return { content: 'Error: text required', isError: true };
19
+
20
+ const style = String(input.style ?? 'brief');
21
+ const maxLen = Number(input.max_length ?? 200);
22
+ const prompt = `Summarize the following text in a ${style} style, approximately ${maxLen} words:\n\n${text.slice(0, 15000)}`;
23
+
24
+ try {
25
+ const apiKey = process.env.OPENAI_API_KEY;
26
+ const apiUrl = process.env.LLM_API_URL || 'https://api.openai.com/v1/chat/completions';
27
+ if (!apiKey && apiUrl === 'https://api.openai.com/v1/chat/completions') {
28
+ return { content: 'Error: OPENAI_API_KEY or LLM_API_URL required', isError: true };
29
+ }
30
+
31
+ const headers: Record<string, string> = { 'Content-Type': 'application/json' };
32
+ if (apiKey) headers['Authorization'] = `Bearer ${apiKey}`;
33
+
34
+ const res = await fetch(apiUrl, {
35
+ method: 'POST', headers,
36
+ body: JSON.stringify({
37
+ model: process.env.LLM_MODEL || 'gpt-4o-mini',
38
+ messages: [{ role: 'user', content: prompt }],
39
+ max_tokens: maxLen * 3,
40
+ }),
41
+ });
42
+ const data = await res.json() as { choices?: Array<{ message: { content: string } }> };
43
+ const summary = data.choices?.[0]?.message?.content ?? 'No summary generated';
44
+ return { content: summary };
45
+ } catch (err) {
46
+ return { content: `Summarizer error: ${(err as Error).message}`, isError: true };
47
+ }
48
+ },
49
+ };