foliko 1.0.75 → 1.0.76

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/.claude/settings.local.json +159 -157
  2. package/cli/bin/foliko.js +12 -12
  3. package/cli/src/commands/chat.js +143 -143
  4. package/cli/src/commands/list.js +93 -93
  5. package/cli/src/index.js +75 -75
  6. package/cli/src/ui/chat-ui.js +201 -201
  7. package/cli/src/utils/ansi.js +40 -40
  8. package/cli/src/utils/markdown.js +292 -292
  9. package/examples/ambient-example.js +194 -194
  10. package/examples/basic.js +115 -115
  11. package/examples/bootstrap.js +121 -121
  12. package/examples/mcp-example.js +56 -56
  13. package/examples/skill-example.js +49 -49
  14. package/examples/test-chat.js +137 -137
  15. package/examples/test-mcp.js +85 -85
  16. package/examples/test-reload.js +59 -59
  17. package/examples/test-telegram.js +50 -50
  18. package/examples/test-tg-bot.js +45 -45
  19. package/examples/test-tg-simple.js +47 -47
  20. package/examples/test-tg.js +62 -62
  21. package/examples/test-think.js +43 -43
  22. package/examples/test-web-plugin.js +103 -103
  23. package/examples/test-weixin-feishu.js +103 -103
  24. package/examples/workflow.js +158 -158
  25. package/package.json +1 -1
  26. package/plugins/ai-plugin.js +102 -102
  27. package/plugins/ambient-agent/EventWatcher.js +113 -113
  28. package/plugins/ambient-agent/ExplorerLoop.js +640 -640
  29. package/plugins/ambient-agent/GoalManager.js +197 -197
  30. package/plugins/ambient-agent/Reflector.js +95 -95
  31. package/plugins/ambient-agent/StateStore.js +90 -90
  32. package/plugins/ambient-agent/constants.js +101 -101
  33. package/plugins/ambient-agent/index.js +579 -579
  34. package/plugins/audit-plugin.js +187 -187
  35. package/plugins/default-plugins.js +662 -662
  36. package/plugins/email/constants.js +64 -64
  37. package/plugins/email/handlers.js +461 -461
  38. package/plugins/email/index.js +278 -278
  39. package/plugins/email/monitor.js +269 -269
  40. package/plugins/email/parser.js +138 -138
  41. package/plugins/email/reply.js +151 -151
  42. package/plugins/email/utils.js +124 -124
  43. package/plugins/feishu-plugin.js +481 -481
  44. package/plugins/file-system-plugin.js +826 -826
  45. package/plugins/install-plugin.js +199 -199
  46. package/plugins/python-executor-plugin.js +367 -367
  47. package/plugins/python-plugin-loader.js +481 -481
  48. package/plugins/rules-plugin.js +294 -294
  49. package/plugins/scheduler-plugin.js +691 -691
  50. package/plugins/session-plugin.js +369 -369
  51. package/plugins/shell-executor-plugin.js +197 -197
  52. package/plugins/storage-plugin.js +240 -240
  53. package/plugins/subagent-plugin.js +845 -845
  54. package/plugins/telegram-plugin.js +482 -482
  55. package/plugins/think-plugin.js +345 -345
  56. package/plugins/tools-plugin.js +196 -196
  57. package/plugins/web-plugin.js +606 -606
  58. package/plugins/weixin-plugin.js +545 -545
  59. package/src/capabilities/index.js +11 -11
  60. package/src/capabilities/skill-manager.js +609 -609
  61. package/src/capabilities/workflow-engine.js +1109 -1109
  62. package/src/core/agent-chat.js +882 -882
  63. package/src/core/agent.js +892 -892
  64. package/src/core/framework.js +465 -465
  65. package/src/core/index.js +19 -19
  66. package/src/core/plugin-base.js +219 -219
  67. package/src/core/plugin-manager.js +863 -863
  68. package/src/core/provider.js +114 -114
  69. package/src/core/sub-agent-config.js +264 -264
  70. package/src/core/system-prompt-builder.js +120 -120
  71. package/src/core/tool-registry.js +517 -517
  72. package/src/core/tool-router.js +297 -297
  73. package/src/executors/executor-base.js +58 -58
  74. package/src/executors/mcp-executor.js +741 -741
  75. package/src/index.js +25 -25
  76. package/src/utils/circuit-breaker.js +301 -301
  77. package/src/utils/error-boundary.js +363 -363
  78. package/src/utils/error.js +374 -374
  79. package/src/utils/event-emitter.js +97 -97
  80. package/src/utils/id.js +133 -133
  81. package/src/utils/index.js +217 -217
  82. package/src/utils/logger.js +181 -181
  83. package/src/utils/plugin-helpers.js +90 -90
  84. package/src/utils/retry.js +122 -122
  85. package/src/utils/sandbox.js +292 -292
  86. package/test/tool-registry-validation.test.js +218 -218
  87. package/website/script.js +136 -136
  88. 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
+ };