foliko 1.0.81 → 1.0.83

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 (88) hide show
  1. package/cli/bin/foliko.js +12 -12
  2. package/cli/src/commands/chat.js +143 -143
  3. package/cli/src/commands/list.js +93 -93
  4. package/cli/src/index.js +75 -75
  5. package/cli/src/ui/chat-ui.js +201 -201
  6. package/cli/src/utils/ansi.js +40 -40
  7. package/cli/src/utils/markdown.js +292 -292
  8. package/examples/ambient-example.js +194 -194
  9. package/examples/basic.js +115 -115
  10. package/examples/bootstrap.js +121 -121
  11. package/examples/mcp-example.js +56 -56
  12. package/examples/skill-example.js +49 -49
  13. package/examples/test-chat.js +137 -137
  14. package/examples/test-mcp.js +85 -85
  15. package/examples/test-reload.js +59 -59
  16. package/examples/test-telegram.js +50 -50
  17. package/examples/test-tg-bot.js +45 -45
  18. package/examples/test-tg-simple.js +47 -47
  19. package/examples/test-tg.js +62 -62
  20. package/examples/test-think.js +43 -43
  21. package/examples/test-web-plugin.js +103 -103
  22. package/examples/test-weixin-feishu.js +103 -103
  23. package/examples/workflow.js +158 -158
  24. package/package.json +83 -83
  25. package/plugins/ai-plugin.js +102 -102
  26. package/plugins/ambient-agent/EventWatcher.js +113 -113
  27. package/plugins/ambient-agent/ExplorerLoop.js +640 -640
  28. package/plugins/ambient-agent/GoalManager.js +197 -197
  29. package/plugins/ambient-agent/Reflector.js +95 -95
  30. package/plugins/ambient-agent/StateStore.js +90 -90
  31. package/plugins/ambient-agent/constants.js +101 -101
  32. package/plugins/ambient-agent/index.js +579 -579
  33. package/plugins/audit-plugin.js +187 -187
  34. package/plugins/default-plugins.js +548 -548
  35. package/plugins/email/constants.js +64 -64
  36. package/plugins/email/handlers.js +461 -461
  37. package/plugins/email/index.js +278 -278
  38. package/plugins/email/monitor.js +269 -269
  39. package/plugins/email/parser.js +138 -138
  40. package/plugins/email/reply.js +151 -151
  41. package/plugins/email/utils.js +124 -124
  42. package/plugins/extension-executor-plugin.js +326 -326
  43. package/plugins/feishu-plugin.js +481 -481
  44. package/plugins/file-system-plugin.js +920 -920
  45. package/plugins/gate-trading.js +747 -747
  46. package/plugins/install-plugin.js +199 -199
  47. package/plugins/python-executor-plugin.js +367 -367
  48. package/plugins/python-plugin-loader.js +651 -651
  49. package/plugins/rules-plugin.js +294 -294
  50. package/plugins/scheduler-plugin.js +691 -691
  51. package/plugins/session-plugin.js +494 -494
  52. package/plugins/shell-executor-plugin.js +197 -197
  53. package/plugins/storage-plugin.js +263 -263
  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 +637 -637
  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 +1 -1
  64. package/src/core/agent.js +958 -958
  65. package/src/core/framework.js +465 -465
  66. package/src/core/index.js +19 -19
  67. package/src/core/plugin-base.js +262 -262
  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 +845 -845
  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
@@ -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
+ };