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,181 +1,181 @@
1
- /**
2
- * Foliko Logger - 统一日志系统
3
- * 支持日志级别、命名空间、格式化输出
4
- */
5
-
6
- const LOG_LEVELS = {
7
- DEBUG: 0,
8
- INFO: 1,
9
- WARN: 2,
10
- ERROR: 3,
11
- NONE: 4,
12
- };
13
-
14
- const LEVEL_NAMES = ['DEBUG', 'INFO', 'WARN', 'ERROR'];
15
-
16
- class Logger {
17
- /**
18
- * @param {Object} options
19
- * @param {string} options.namespace - 日志命名空间
20
- * @param {number} options.level - 日志级别 (0-4)
21
- * @param {boolean} options.enableTimestamp - 是否显示时间戳
22
- * @param {boolean} options.enableColors - 是否使用颜色
23
- */
24
- constructor(options = {}) {
25
- this.namespace = options.namespace || 'app';
26
- this.level = options.level ?? LOG_LEVELS.INFO;
27
- this.enableTimestamp = options.enableTimestamp !== false;
28
- this.enableColors = options.enableColors !== false;
29
-
30
- // 颜色代码
31
- this.colors = {
32
- debug: '\x1b[36m', // 青色
33
- info: '\x1b[32m', // 绿色
34
- warn: '\x1b[33m', // 黄色
35
- error: '\x1b[31m', // 红色
36
- reset: '\x1b[0m',
37
- dim: '\x1b[2m', // 灰色
38
- };
39
- }
40
-
41
- /**
42
- * 创建子日志器
43
- * @param {string} namespace
44
- * @returns {Logger}
45
- */
46
- child(namespace) {
47
- return new Logger({
48
- namespace: `${this.namespace}:${namespace}`,
49
- level: this.level,
50
- enableTimestamp: this.enableTimestamp,
51
- enableColors: this.enableColors,
52
- });
53
- }
54
-
55
- /**
56
- * 设置日志级别
57
- * @param {string|number} level
58
- */
59
- setLevel(level) {
60
- if (typeof level === 'string') {
61
- this.level = LOG_LEVELS[level.toUpperCase()] ?? LOG_LEVELS.INFO;
62
- } else {
63
- this.level = level;
64
- }
65
- }
66
-
67
- /**
68
- * 格式化日志消息
69
- * @private
70
- */
71
- _format(level, levelName, args) {
72
- const color = this.colors[levelName.toLowerCase()] || '';
73
- const reset = this.colors.reset;
74
- const dim = this.colors.dim;
75
-
76
- const parts = [];
77
-
78
- // 命名空间
79
- parts.push(`${dim}[${this.namespace}]${reset}`);
80
-
81
- // 时间戳
82
- if (this.enableTimestamp) {
83
- const timestamp = new Date().toISOString().split('T')[1].slice(0, -1);
84
- parts.push(`${dim}${timestamp}${reset}`);
85
- }
86
-
87
- // 级别
88
- if (this.enableColors) {
89
- parts.push(`${color}${levelName.padEnd(5)}${reset}`);
90
- } else {
91
- parts.push(levelName.padEnd(5));
92
- }
93
-
94
- // 消息
95
- const message = args
96
- .map((arg) => {
97
- if (arg instanceof Error) {
98
- return `${arg.message}\n${arg.stack}`;
99
- }
100
- if (typeof arg === 'object') {
101
- try {
102
- return JSON.stringify(arg, null, 2);
103
- } catch {
104
- return String(arg);
105
- }
106
- }
107
- return String(arg);
108
- })
109
- .join(' ');
110
-
111
- parts.push(message);
112
- return parts.join(' ');
113
- }
114
-
115
- /**
116
- * 调试日志
117
- * @param {...any} args
118
- */
119
- debug(...args) {
120
- if (this.level <= LOG_LEVELS.DEBUG) {
121
- console.debug(this._format('debug', 'DEBUG', args));
122
- }
123
- }
124
-
125
- /**
126
- * 信息日志
127
- * @param {...any} args
128
- */
129
- info(...args) {
130
- if (this.level <= LOG_LEVELS.INFO) {
131
- console.log(this._format('info', 'INFO', args));
132
- }
133
- }
134
-
135
- /**
136
- * 警告日志
137
- * @param {...any} args
138
- */
139
- warn(...args) {
140
- if (this.level <= LOG_LEVELS.WARN) {
141
- console.warn(this._format('warn', 'WARN', args));
142
- }
143
- }
144
-
145
- /**
146
- * 错误日志
147
- * @param {...any} args
148
- */
149
- error(...args) {
150
- if (this.level <= LOG_LEVELS.ERROR) {
151
- console.error(this._format('error', 'ERROR', args));
152
- }
153
- }
154
-
155
- /**
156
- * 性能计时开始
157
- * @param {string} label
158
- * @returns {function} 结束计时函数
159
- */
160
- timer(label) {
161
- const start = process.hrtime.bigint();
162
- return () => {
163
- const end = process.hrtime.bigint();
164
- const ms = Number(end - start) / 1_000_000;
165
- this.debug(`${label}: ${ms.toFixed(2)}ms`);
166
- };
167
- }
168
- }
169
-
170
- // 全局日志器实例
171
- const globalLogger = new Logger({
172
- namespace: 'foliko',
173
- level: process.env.LOG_LEVEL ? LOG_LEVELS[process.env.LOG_LEVEL.toUpperCase()] : LOG_LEVELS.INFO,
174
- });
175
-
176
- // 导出
177
- module.exports = {
178
- Logger,
179
- logger: globalLogger,
180
- LOG_LEVELS,
181
- };
1
+ /**
2
+ * Foliko Logger - 统一日志系统
3
+ * 支持日志级别、命名空间、格式化输出
4
+ */
5
+
6
+ const LOG_LEVELS = {
7
+ DEBUG: 0,
8
+ INFO: 1,
9
+ WARN: 2,
10
+ ERROR: 3,
11
+ NONE: 4,
12
+ };
13
+
14
+ const LEVEL_NAMES = ['DEBUG', 'INFO', 'WARN', 'ERROR'];
15
+
16
+ class Logger {
17
+ /**
18
+ * @param {Object} options
19
+ * @param {string} options.namespace - 日志命名空间
20
+ * @param {number} options.level - 日志级别 (0-4)
21
+ * @param {boolean} options.enableTimestamp - 是否显示时间戳
22
+ * @param {boolean} options.enableColors - 是否使用颜色
23
+ */
24
+ constructor(options = {}) {
25
+ this.namespace = options.namespace || 'app';
26
+ this.level = options.level ?? LOG_LEVELS.INFO;
27
+ this.enableTimestamp = options.enableTimestamp !== false;
28
+ this.enableColors = options.enableColors !== false;
29
+
30
+ // 颜色代码
31
+ this.colors = {
32
+ debug: '\x1b[36m', // 青色
33
+ info: '\x1b[32m', // 绿色
34
+ warn: '\x1b[33m', // 黄色
35
+ error: '\x1b[31m', // 红色
36
+ reset: '\x1b[0m',
37
+ dim: '\x1b[2m', // 灰色
38
+ };
39
+ }
40
+
41
+ /**
42
+ * 创建子日志器
43
+ * @param {string} namespace
44
+ * @returns {Logger}
45
+ */
46
+ child(namespace) {
47
+ return new Logger({
48
+ namespace: `${this.namespace}:${namespace}`,
49
+ level: this.level,
50
+ enableTimestamp: this.enableTimestamp,
51
+ enableColors: this.enableColors,
52
+ });
53
+ }
54
+
55
+ /**
56
+ * 设置日志级别
57
+ * @param {string|number} level
58
+ */
59
+ setLevel(level) {
60
+ if (typeof level === 'string') {
61
+ this.level = LOG_LEVELS[level.toUpperCase()] ?? LOG_LEVELS.INFO;
62
+ } else {
63
+ this.level = level;
64
+ }
65
+ }
66
+
67
+ /**
68
+ * 格式化日志消息
69
+ * @private
70
+ */
71
+ _format(level, levelName, args) {
72
+ const color = this.colors[levelName.toLowerCase()] || '';
73
+ const reset = this.colors.reset;
74
+ const dim = this.colors.dim;
75
+
76
+ const parts = [];
77
+
78
+ // 命名空间
79
+ parts.push(`${dim}[${this.namespace}]${reset}`);
80
+
81
+ // 时间戳
82
+ if (this.enableTimestamp) {
83
+ const timestamp = new Date().toISOString().split('T')[1].slice(0, -1);
84
+ parts.push(`${dim}${timestamp}${reset}`);
85
+ }
86
+
87
+ // 级别
88
+ if (this.enableColors) {
89
+ parts.push(`${color}${levelName.padEnd(5)}${reset}`);
90
+ } else {
91
+ parts.push(levelName.padEnd(5));
92
+ }
93
+
94
+ // 消息
95
+ const message = args
96
+ .map((arg) => {
97
+ if (arg instanceof Error) {
98
+ return `${arg.message}\n${arg.stack}`;
99
+ }
100
+ if (typeof arg === 'object') {
101
+ try {
102
+ return JSON.stringify(arg, null, 2);
103
+ } catch {
104
+ return String(arg);
105
+ }
106
+ }
107
+ return String(arg);
108
+ })
109
+ .join(' ');
110
+
111
+ parts.push(message);
112
+ return parts.join(' ');
113
+ }
114
+
115
+ /**
116
+ * 调试日志
117
+ * @param {...any} args
118
+ */
119
+ debug(...args) {
120
+ if (this.level <= LOG_LEVELS.DEBUG) {
121
+ console.debug(this._format('debug', 'DEBUG', args));
122
+ }
123
+ }
124
+
125
+ /**
126
+ * 信息日志
127
+ * @param {...any} args
128
+ */
129
+ info(...args) {
130
+ if (this.level <= LOG_LEVELS.INFO) {
131
+ console.log(this._format('info', 'INFO', args));
132
+ }
133
+ }
134
+
135
+ /**
136
+ * 警告日志
137
+ * @param {...any} args
138
+ */
139
+ warn(...args) {
140
+ if (this.level <= LOG_LEVELS.WARN) {
141
+ console.warn(this._format('warn', 'WARN', args));
142
+ }
143
+ }
144
+
145
+ /**
146
+ * 错误日志
147
+ * @param {...any} args
148
+ */
149
+ error(...args) {
150
+ if (this.level <= LOG_LEVELS.ERROR) {
151
+ console.error(this._format('error', 'ERROR', args));
152
+ }
153
+ }
154
+
155
+ /**
156
+ * 性能计时开始
157
+ * @param {string} label
158
+ * @returns {function} 结束计时函数
159
+ */
160
+ timer(label) {
161
+ const start = process.hrtime.bigint();
162
+ return () => {
163
+ const end = process.hrtime.bigint();
164
+ const ms = Number(end - start) / 1_000_000;
165
+ this.debug(`${label}: ${ms.toFixed(2)}ms`);
166
+ };
167
+ }
168
+ }
169
+
170
+ // 全局日志器实例
171
+ const globalLogger = new Logger({
172
+ namespace: 'foliko',
173
+ level: process.env.LOG_LEVEL ? LOG_LEVELS[process.env.LOG_LEVEL.toUpperCase()] : LOG_LEVELS.INFO,
174
+ });
175
+
176
+ // 导出
177
+ module.exports = {
178
+ Logger,
179
+ logger: globalLogger,
180
+ LOG_LEVELS,
181
+ };
@@ -1,90 +1,90 @@
1
- /**
2
- * Plugin Helpers - 插件相关的辅助函数
3
- * 提供插件路径解析和扫描功能,供 PluginManager 和 DefaultPlugins 共用
4
- */
5
-
6
- const fs = require('fs');
7
- const path = require('path');
8
- const { safeJsonParse } = require('./index');
9
-
10
- /**
11
- * 解析插件路径
12
- * 支持两种结构:
13
- * 1. 文件夹结构: .agent/plugins/my-plugin/index.js
14
- * 2. 单文件结构: .agent/plugins/my-plugin.js
15
- * @param {string} pluginsDir - 插件目录
16
- * @param {string} name - 插件名称
17
- * @param {Object} options - 选项
18
- * @param {Object} options.logger - 日志器(可选)
19
- * @returns {{path: string, type: 'folder'|'file'}|null} 插件路径和类型
20
- */
21
- function resolvePluginPath(pluginsDir, name, options = {}) {
22
- const logger = options.logger;
23
- const folderPath = path.join(pluginsDir, name);
24
- const filePath = path.join(pluginsDir, `${name}.js`);
25
-
26
- // 文件夹优先
27
- if (fs.existsSync(folderPath) && fs.statSync(folderPath).isDirectory()) {
28
- const pkgPath = path.join(folderPath, 'package.json');
29
- if (fs.existsSync(pkgPath)) {
30
- try {
31
- const pkg = safeJsonParse(fs.readFileSync(pkgPath, 'utf-8'), {});
32
- const main = pkg.main || 'index.js';
33
- const mainPath = path.join(folderPath, main);
34
- if (fs.existsSync(mainPath)) {
35
- return { path: mainPath, type: 'folder' };
36
- }
37
- } catch (err) {
38
- logger?.warn(`Failed to parse package.json for ${name}:`, err.message);
39
- }
40
- }
41
- // 默认加载 index.js
42
- const indexPath = path.join(folderPath, 'index.js');
43
- if (fs.existsSync(indexPath)) {
44
- return { path: indexPath, type: 'folder' };
45
- }
46
- logger?.warn(`No entry point found for plugin folder: ${name}`);
47
- return null;
48
- }
49
-
50
- // 单文件回退
51
- if (fs.existsSync(filePath)) {
52
- return { path: filePath, type: 'file' };
53
- }
54
-
55
- return null;
56
- }
57
-
58
- /**
59
- * 扫描插件目录,返回所有插件名称
60
- * @param {string} pluginsDir - 插件目录
61
- * @returns {string[]} 插件名称列表
62
- */
63
- function scanPluginNames(pluginsDir) {
64
- if (!fs.existsSync(pluginsDir)) {
65
- return [];
66
- }
67
-
68
- const names = new Set();
69
- const entries = fs.readdirSync(pluginsDir, { withFileTypes: true });
70
-
71
- for (const entry of entries) {
72
- if (entry.isDirectory()) {
73
- // 文件夹插件
74
- names.add(entry.name);
75
- } else if (entry.isFile() && entry.name.endsWith('.js')) {
76
- // 单文件插件(排除与文件夹同名的)
77
- const baseName = entry.name.replace(/\.js$/, '');
78
- if (!names.has(baseName)) {
79
- names.add(baseName);
80
- }
81
- }
82
- }
83
-
84
- return Array.from(names);
85
- }
86
-
87
- module.exports = {
88
- resolvePluginPath,
89
- scanPluginNames,
90
- };
1
+ /**
2
+ * Plugin Helpers - 插件相关的辅助函数
3
+ * 提供插件路径解析和扫描功能,供 PluginManager 和 DefaultPlugins 共用
4
+ */
5
+
6
+ const fs = require('fs');
7
+ const path = require('path');
8
+ const { safeJsonParse } = require('./index');
9
+
10
+ /**
11
+ * 解析插件路径
12
+ * 支持两种结构:
13
+ * 1. 文件夹结构: .agent/plugins/my-plugin/index.js
14
+ * 2. 单文件结构: .agent/plugins/my-plugin.js
15
+ * @param {string} pluginsDir - 插件目录
16
+ * @param {string} name - 插件名称
17
+ * @param {Object} options - 选项
18
+ * @param {Object} options.logger - 日志器(可选)
19
+ * @returns {{path: string, type: 'folder'|'file'}|null} 插件路径和类型
20
+ */
21
+ function resolvePluginPath(pluginsDir, name, options = {}) {
22
+ const logger = options.logger;
23
+ const folderPath = path.join(pluginsDir, name);
24
+ const filePath = path.join(pluginsDir, `${name}.js`);
25
+
26
+ // 文件夹优先
27
+ if (fs.existsSync(folderPath) && fs.statSync(folderPath).isDirectory()) {
28
+ const pkgPath = path.join(folderPath, 'package.json');
29
+ if (fs.existsSync(pkgPath)) {
30
+ try {
31
+ const pkg = safeJsonParse(fs.readFileSync(pkgPath, 'utf-8'), {});
32
+ const main = pkg.main || 'index.js';
33
+ const mainPath = path.join(folderPath, main);
34
+ if (fs.existsSync(mainPath)) {
35
+ return { path: mainPath, type: 'folder' };
36
+ }
37
+ } catch (err) {
38
+ logger?.warn(`Failed to parse package.json for ${name}:`, err.message);
39
+ }
40
+ }
41
+ // 默认加载 index.js
42
+ const indexPath = path.join(folderPath, 'index.js');
43
+ if (fs.existsSync(indexPath)) {
44
+ return { path: indexPath, type: 'folder' };
45
+ }
46
+ logger?.warn(`No entry point found for plugin folder: ${name}`);
47
+ return null;
48
+ }
49
+
50
+ // 单文件回退
51
+ if (fs.existsSync(filePath)) {
52
+ return { path: filePath, type: 'file' };
53
+ }
54
+
55
+ return null;
56
+ }
57
+
58
+ /**
59
+ * 扫描插件目录,返回所有插件名称
60
+ * @param {string} pluginsDir - 插件目录
61
+ * @returns {string[]} 插件名称列表
62
+ */
63
+ function scanPluginNames(pluginsDir) {
64
+ if (!fs.existsSync(pluginsDir)) {
65
+ return [];
66
+ }
67
+
68
+ const names = new Set();
69
+ const entries = fs.readdirSync(pluginsDir, { withFileTypes: true });
70
+
71
+ for (const entry of entries) {
72
+ if (entry.isDirectory()) {
73
+ // 文件夹插件
74
+ names.add(entry.name);
75
+ } else if (entry.isFile() && entry.name.endsWith('.js')) {
76
+ // 单文件插件(排除与文件夹同名的)
77
+ const baseName = entry.name.replace(/\.js$/, '');
78
+ if (!names.has(baseName)) {
79
+ names.add(baseName);
80
+ }
81
+ }
82
+ }
83
+
84
+ return Array.from(names);
85
+ }
86
+
87
+ module.exports = {
88
+ resolvePluginPath,
89
+ scanPluginNames,
90
+ };