foliko 1.0.75 → 1.0.77

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 (89) hide show
  1. package/.claude/settings.local.json +159 -157
  2. package/.env.example +3 -1
  3. package/cli/bin/foliko.js +12 -12
  4. package/cli/src/commands/chat.js +143 -143
  5. package/cli/src/commands/list.js +93 -93
  6. package/cli/src/index.js +75 -75
  7. package/cli/src/ui/chat-ui.js +201 -201
  8. package/cli/src/utils/ansi.js +40 -40
  9. package/cli/src/utils/markdown.js +292 -292
  10. package/examples/ambient-example.js +194 -194
  11. package/examples/basic.js +115 -115
  12. package/examples/bootstrap.js +121 -121
  13. package/examples/mcp-example.js +56 -56
  14. package/examples/skill-example.js +49 -49
  15. package/examples/test-chat.js +137 -137
  16. package/examples/test-mcp.js +85 -85
  17. package/examples/test-reload.js +59 -59
  18. package/examples/test-telegram.js +50 -50
  19. package/examples/test-tg-bot.js +45 -45
  20. package/examples/test-tg-simple.js +47 -47
  21. package/examples/test-tg.js +62 -62
  22. package/examples/test-think.js +43 -43
  23. package/examples/test-web-plugin.js +103 -103
  24. package/examples/test-weixin-feishu.js +103 -103
  25. package/examples/workflow.js +158 -158
  26. package/package.json +81 -81
  27. package/plugins/ai-plugin.js +102 -102
  28. package/plugins/ambient-agent/EventWatcher.js +113 -113
  29. package/plugins/ambient-agent/ExplorerLoop.js +640 -640
  30. package/plugins/ambient-agent/GoalManager.js +197 -197
  31. package/plugins/ambient-agent/Reflector.js +95 -95
  32. package/plugins/ambient-agent/StateStore.js +90 -90
  33. package/plugins/ambient-agent/constants.js +101 -101
  34. package/plugins/ambient-agent/index.js +579 -579
  35. package/plugins/audit-plugin.js +187 -187
  36. package/plugins/default-plugins.js +662 -662
  37. package/plugins/email/constants.js +64 -64
  38. package/plugins/email/handlers.js +461 -461
  39. package/plugins/email/index.js +278 -278
  40. package/plugins/email/monitor.js +269 -269
  41. package/plugins/email/parser.js +138 -138
  42. package/plugins/email/reply.js +151 -151
  43. package/plugins/email/utils.js +124 -124
  44. package/plugins/feishu-plugin.js +481 -481
  45. package/plugins/file-system-plugin.js +826 -826
  46. package/plugins/install-plugin.js +199 -199
  47. package/plugins/python-executor-plugin.js +367 -367
  48. package/plugins/python-plugin-loader.js +481 -481
  49. package/plugins/rules-plugin.js +294 -294
  50. package/plugins/scheduler-plugin.js +691 -691
  51. package/plugins/session-plugin.js +369 -369
  52. package/plugins/shell-executor-plugin.js +197 -197
  53. package/plugins/storage-plugin.js +240 -240
  54. package/plugins/subagent-plugin.js +845 -845
  55. package/plugins/telegram-plugin.js +482 -482
  56. package/plugins/think-plugin.js +345 -345
  57. package/plugins/tools-plugin.js +196 -196
  58. package/plugins/web-plugin.js +606 -606
  59. package/plugins/weixin-plugin.js +545 -545
  60. package/src/capabilities/index.js +11 -11
  61. package/src/capabilities/skill-manager.js +609 -609
  62. package/src/capabilities/workflow-engine.js +1109 -1109
  63. package/src/core/agent-chat.js +882 -882
  64. package/src/core/agent.js +892 -892
  65. package/src/core/framework.js +465 -465
  66. package/src/core/index.js +19 -19
  67. package/src/core/plugin-base.js +219 -219
  68. package/src/core/plugin-manager.js +863 -863
  69. package/src/core/provider.js +114 -114
  70. package/src/core/sub-agent-config.js +264 -264
  71. package/src/core/system-prompt-builder.js +120 -120
  72. package/src/core/tool-registry.js +517 -517
  73. package/src/core/tool-router.js +297 -297
  74. package/src/executors/executor-base.js +58 -58
  75. package/src/executors/mcp-executor.js +741 -741
  76. package/src/index.js +25 -25
  77. package/src/utils/circuit-breaker.js +301 -301
  78. package/src/utils/error-boundary.js +363 -363
  79. package/src/utils/error.js +374 -374
  80. package/src/utils/event-emitter.js +97 -97
  81. package/src/utils/id.js +133 -133
  82. package/src/utils/index.js +217 -217
  83. package/src/utils/logger.js +181 -181
  84. package/src/utils/plugin-helpers.js +90 -90
  85. package/src/utils/retry.js +122 -122
  86. package/src/utils/sandbox.js +292 -292
  87. package/test/tool-registry-validation.test.js +218 -218
  88. package/website/script.js +136 -136
  89. package/foliko-1.0.75.tgz +0 -0
@@ -1,264 +1,264 @@
1
- /**
2
- * SubAgent 配置管理
3
- * 负责读取、解析和缓存 .agent/agents/ 目录下的 md 文件
4
- * 类似 SkillManager 的工作方式
5
- */
6
-
7
- const fs = require('fs');
8
- const path = require('path');
9
-
10
- /**
11
- * 解析 YAML frontmatter
12
- */
13
- function parseFrontmatter(content) {
14
- const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
15
- if (!match) return null;
16
-
17
- const frontmatter = {};
18
- const lines = match[1].split('\n');
19
- let currentKey = null;
20
-
21
- for (const line of lines) {
22
- // 处理 metadata 嵌套
23
- if (currentKey === 'metadata') {
24
- if (line.match(/^ {2}[a-zA-Z]/)) {
25
- const colonIndex = line.indexOf(':');
26
- if (colonIndex > 0) {
27
- const key = line.substring(2, colonIndex).trim();
28
- const value = line
29
- .substring(colonIndex + 1)
30
- .trim()
31
- .replace(/^["']|["']$/g, '');
32
- frontmatter[currentKey][key] = value;
33
- continue;
34
- }
35
- } else if (line.match(/^[a-zA-Z]/)) {
36
- currentKey = null;
37
- continue;
38
- }
39
- }
40
-
41
- const colonIndex = line.indexOf(':');
42
- if (colonIndex === -1) continue;
43
-
44
- const key = line.substring(0, colonIndex).trim();
45
- let value = line.substring(colonIndex + 1).trim();
46
-
47
- // 移除引号
48
- if (
49
- (value.startsWith('"') && value.endsWith('"')) ||
50
- (value.startsWith("'") && value.endsWith("'"))
51
- ) {
52
- value = value.slice(1, -1);
53
- }
54
-
55
- if (key === 'metadata') {
56
- currentKey = 'metadata';
57
- frontmatter.metadata = {};
58
- } else if (key === 'allowed-tools') {
59
- frontmatter[key] = value
60
- .split(',')
61
- .map((v) => v.trim())
62
- .filter(Boolean);
63
- } else if (key === 'skills') {
64
- frontmatter[key] = value
65
- .split(',')
66
- .map((v) => v.trim())
67
- .filter(Boolean);
68
- } else if (key === 'tools') {
69
- frontmatter[key] = value
70
- .split(',')
71
- .map((v) => v.trim())
72
- .filter(Boolean);
73
- } else {
74
- frontmatter[key] = value;
75
- }
76
- }
77
-
78
- return frontmatter;
79
- }
80
-
81
- /**
82
- * 移除 frontmatter,只保留正文内容
83
- */
84
- function stripFrontmatter(content) {
85
- return content.replace(/^---\r?\n[\s\S]*?\r?\n---\r?\n/, '');
86
- }
87
-
88
- class SubAgentConfig {
89
- constructor(name, filePath) {
90
- this.name = name;
91
- this.filePath = filePath;
92
- this._frontmatter = null;
93
- this._content = null;
94
- this._loaded = false;
95
- }
96
-
97
- /**
98
- * 加载并解析 md 文件
99
- */
100
- load() {
101
- if (this._loaded) return;
102
-
103
- try {
104
- const content = fs.readFileSync(this.filePath, 'utf-8');
105
- this._frontmatter = parseFrontmatter(content);
106
- this._content = stripFrontmatter(content);
107
- this._loaded = true;
108
- } catch (e) {
109
- console.warn(`[SubAgentConfig] Failed to load ${this.filePath}:`, e.message);
110
- this._frontmatter = {};
111
- this._content = '';
112
- this._loaded = true;
113
- }
114
- }
115
-
116
- /**
117
- * 获取 frontmatter 中的值
118
- */
119
- get(key, defaultValue = null) {
120
- this.load();
121
- return this._frontmatter?.[key] ?? defaultValue;
122
- }
123
-
124
- /**
125
- * 获取名称
126
- */
127
- getName() {
128
- return this.get('name', this.name);
129
- }
130
-
131
- /**
132
- * 获取描述
133
- */
134
- getDescription() {
135
- return this.get('description', '');
136
- }
137
-
138
- /**
139
- * 获取技能列表
140
- */
141
- getSkills() {
142
- return this.get('skills', []);
143
- }
144
-
145
- /**
146
- * 获取工具列表
147
- */
148
- getTools() {
149
- return this.get('tools', []);
150
- }
151
-
152
- /**
153
- * 获取模型配置
154
- */
155
- getModel() {
156
- return this.get('model', 'inherit');
157
- }
158
-
159
- /**
160
- * 获取完整内容(用于构建系统提示词)
161
- */
162
- getContent() {
163
- this.load();
164
- return this._content || '';
165
- }
166
-
167
- /**
168
- * 获取完整的系统提示词(frontmatter + 内容)
169
- */
170
- getSystemPrompt() {
171
- this.load();
172
- const desc = this.getDescription();
173
- const content = this._content || '';
174
-
175
- // 构建系统提示词
176
- let prompt = `# ${this.getName()}`;
177
- if (desc) {
178
- prompt += `\n\n${desc}`;
179
- }
180
- if (content.trim()) {
181
- prompt += `\n\n${content.trim()}`;
182
- }
183
- return prompt;
184
- }
185
-
186
- /**
187
- * 检查是否有效
188
- */
189
- isValid() {
190
- this.load();
191
- return this._loaded && this._frontmatter !== null;
192
- }
193
- }
194
-
195
- /**
196
- * SubAgent 配置管理器
197
- * 管理目录下所有子代理配置的加载和缓存
198
- */
199
- class SubAgentConfigManager {
200
- constructor(agentsDir) {
201
- this.agentsDir = agentsDir;
202
- this._configs = new Map(); // name -> SubAgentConfig
203
- }
204
-
205
- /**
206
- * 加载目录下所有子代理配置
207
- */
208
- loadAll() {
209
- if (!fs.existsSync(this.agentsDir)) {
210
- return;
211
- }
212
-
213
- const entries = fs.readdirSync(this.agentsDir, { withFileTypes: true });
214
- for (const entry of entries) {
215
- if (entry.isFile() && entry.name.endsWith('.md')) {
216
- const name = entry.name.replace('.md', '');
217
- const filePath = path.join(this.agentsDir, entry.name);
218
-
219
- if (!this._configs.has(name)) {
220
- this._configs.set(name, new SubAgentConfig(name, filePath));
221
- }
222
- }
223
- }
224
- }
225
-
226
- /**
227
- * 刷新配置(清除后重新加载)
228
- */
229
- refresh() {
230
- this._configs.clear();
231
- this.loadAll();
232
- }
233
-
234
- /**
235
- * 获取某个子代理配置
236
- */
237
- get(name) {
238
- return this._configs.get(name) || null;
239
- }
240
-
241
- /**
242
- * 获取所有配置
243
- */
244
- getAll() {
245
- return Array.from(this._configs.values());
246
- }
247
-
248
- /**
249
- * 获取所有有效配置
250
- */
251
- getValidConfigs() {
252
- return this.getAll().filter((c) => c.isValid());
253
- }
254
-
255
- /**
256
- * 重新加载
257
- */
258
- reload() {
259
- this._configs.clear();
260
- this.loadAll();
261
- }
262
- }
263
-
264
- module.exports = { SubAgentConfig, SubAgentConfigManager, parseFrontmatter, stripFrontmatter };
1
+ /**
2
+ * SubAgent 配置管理
3
+ * 负责读取、解析和缓存 .agent/agents/ 目录下的 md 文件
4
+ * 类似 SkillManager 的工作方式
5
+ */
6
+
7
+ const fs = require('fs');
8
+ const path = require('path');
9
+
10
+ /**
11
+ * 解析 YAML frontmatter
12
+ */
13
+ function parseFrontmatter(content) {
14
+ const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
15
+ if (!match) return null;
16
+
17
+ const frontmatter = {};
18
+ const lines = match[1].split('\n');
19
+ let currentKey = null;
20
+
21
+ for (const line of lines) {
22
+ // 处理 metadata 嵌套
23
+ if (currentKey === 'metadata') {
24
+ if (line.match(/^ {2}[a-zA-Z]/)) {
25
+ const colonIndex = line.indexOf(':');
26
+ if (colonIndex > 0) {
27
+ const key = line.substring(2, colonIndex).trim();
28
+ const value = line
29
+ .substring(colonIndex + 1)
30
+ .trim()
31
+ .replace(/^["']|["']$/g, '');
32
+ frontmatter[currentKey][key] = value;
33
+ continue;
34
+ }
35
+ } else if (line.match(/^[a-zA-Z]/)) {
36
+ currentKey = null;
37
+ continue;
38
+ }
39
+ }
40
+
41
+ const colonIndex = line.indexOf(':');
42
+ if (colonIndex === -1) continue;
43
+
44
+ const key = line.substring(0, colonIndex).trim();
45
+ let value = line.substring(colonIndex + 1).trim();
46
+
47
+ // 移除引号
48
+ if (
49
+ (value.startsWith('"') && value.endsWith('"')) ||
50
+ (value.startsWith("'") && value.endsWith("'"))
51
+ ) {
52
+ value = value.slice(1, -1);
53
+ }
54
+
55
+ if (key === 'metadata') {
56
+ currentKey = 'metadata';
57
+ frontmatter.metadata = {};
58
+ } else if (key === 'allowed-tools') {
59
+ frontmatter[key] = value
60
+ .split(',')
61
+ .map((v) => v.trim())
62
+ .filter(Boolean);
63
+ } else if (key === 'skills') {
64
+ frontmatter[key] = value
65
+ .split(',')
66
+ .map((v) => v.trim())
67
+ .filter(Boolean);
68
+ } else if (key === 'tools') {
69
+ frontmatter[key] = value
70
+ .split(',')
71
+ .map((v) => v.trim())
72
+ .filter(Boolean);
73
+ } else {
74
+ frontmatter[key] = value;
75
+ }
76
+ }
77
+
78
+ return frontmatter;
79
+ }
80
+
81
+ /**
82
+ * 移除 frontmatter,只保留正文内容
83
+ */
84
+ function stripFrontmatter(content) {
85
+ return content.replace(/^---\r?\n[\s\S]*?\r?\n---\r?\n/, '');
86
+ }
87
+
88
+ class SubAgentConfig {
89
+ constructor(name, filePath) {
90
+ this.name = name;
91
+ this.filePath = filePath;
92
+ this._frontmatter = null;
93
+ this._content = null;
94
+ this._loaded = false;
95
+ }
96
+
97
+ /**
98
+ * 加载并解析 md 文件
99
+ */
100
+ load() {
101
+ if (this._loaded) return;
102
+
103
+ try {
104
+ const content = fs.readFileSync(this.filePath, 'utf-8');
105
+ this._frontmatter = parseFrontmatter(content);
106
+ this._content = stripFrontmatter(content);
107
+ this._loaded = true;
108
+ } catch (e) {
109
+ console.warn(`[SubAgentConfig] Failed to load ${this.filePath}:`, e.message);
110
+ this._frontmatter = {};
111
+ this._content = '';
112
+ this._loaded = true;
113
+ }
114
+ }
115
+
116
+ /**
117
+ * 获取 frontmatter 中的值
118
+ */
119
+ get(key, defaultValue = null) {
120
+ this.load();
121
+ return this._frontmatter?.[key] ?? defaultValue;
122
+ }
123
+
124
+ /**
125
+ * 获取名称
126
+ */
127
+ getName() {
128
+ return this.get('name', this.name);
129
+ }
130
+
131
+ /**
132
+ * 获取描述
133
+ */
134
+ getDescription() {
135
+ return this.get('description', '');
136
+ }
137
+
138
+ /**
139
+ * 获取技能列表
140
+ */
141
+ getSkills() {
142
+ return this.get('skills', []);
143
+ }
144
+
145
+ /**
146
+ * 获取工具列表
147
+ */
148
+ getTools() {
149
+ return this.get('tools', []);
150
+ }
151
+
152
+ /**
153
+ * 获取模型配置
154
+ */
155
+ getModel() {
156
+ return this.get('model', 'inherit');
157
+ }
158
+
159
+ /**
160
+ * 获取完整内容(用于构建系统提示词)
161
+ */
162
+ getContent() {
163
+ this.load();
164
+ return this._content || '';
165
+ }
166
+
167
+ /**
168
+ * 获取完整的系统提示词(frontmatter + 内容)
169
+ */
170
+ getSystemPrompt() {
171
+ this.load();
172
+ const desc = this.getDescription();
173
+ const content = this._content || '';
174
+
175
+ // 构建系统提示词
176
+ let prompt = `# ${this.getName()}`;
177
+ if (desc) {
178
+ prompt += `\n\n${desc}`;
179
+ }
180
+ if (content.trim()) {
181
+ prompt += `\n\n${content.trim()}`;
182
+ }
183
+ return prompt;
184
+ }
185
+
186
+ /**
187
+ * 检查是否有效
188
+ */
189
+ isValid() {
190
+ this.load();
191
+ return this._loaded && this._frontmatter !== null;
192
+ }
193
+ }
194
+
195
+ /**
196
+ * SubAgent 配置管理器
197
+ * 管理目录下所有子代理配置的加载和缓存
198
+ */
199
+ class SubAgentConfigManager {
200
+ constructor(agentsDir) {
201
+ this.agentsDir = agentsDir;
202
+ this._configs = new Map(); // name -> SubAgentConfig
203
+ }
204
+
205
+ /**
206
+ * 加载目录下所有子代理配置
207
+ */
208
+ loadAll() {
209
+ if (!fs.existsSync(this.agentsDir)) {
210
+ return;
211
+ }
212
+
213
+ const entries = fs.readdirSync(this.agentsDir, { withFileTypes: true });
214
+ for (const entry of entries) {
215
+ if (entry.isFile() && entry.name.endsWith('.md')) {
216
+ const name = entry.name.replace('.md', '');
217
+ const filePath = path.join(this.agentsDir, entry.name);
218
+
219
+ if (!this._configs.has(name)) {
220
+ this._configs.set(name, new SubAgentConfig(name, filePath));
221
+ }
222
+ }
223
+ }
224
+ }
225
+
226
+ /**
227
+ * 刷新配置(清除后重新加载)
228
+ */
229
+ refresh() {
230
+ this._configs.clear();
231
+ this.loadAll();
232
+ }
233
+
234
+ /**
235
+ * 获取某个子代理配置
236
+ */
237
+ get(name) {
238
+ return this._configs.get(name) || null;
239
+ }
240
+
241
+ /**
242
+ * 获取所有配置
243
+ */
244
+ getAll() {
245
+ return Array.from(this._configs.values());
246
+ }
247
+
248
+ /**
249
+ * 获取所有有效配置
250
+ */
251
+ getValidConfigs() {
252
+ return this.getAll().filter((c) => c.isValid());
253
+ }
254
+
255
+ /**
256
+ * 重新加载
257
+ */
258
+ reload() {
259
+ this._configs.clear();
260
+ this.loadAll();
261
+ }
262
+ }
263
+
264
+ module.exports = { SubAgentConfig, SubAgentConfigManager, parseFrontmatter, stripFrontmatter };