foliko 1.0.80 → 1.0.81

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 (235) hide show
  1. package/.agent/agents/code-assistant.json +14 -0
  2. package/.agent/agents/email-assistant.json +14 -0
  3. package/.agent/agents/file-assistant.json +15 -0
  4. package/.agent/agents/system-assistant.json +15 -0
  5. package/.agent/agents/web-assistant.json +12 -0
  6. package/.agent/data/ambient/goals.json +50 -0
  7. package/.agent/data/ambient/memories.json +7 -0
  8. package/.agent/data/default.json +15 -31894
  9. package/.agent/data/plugins-state.json +146 -181
  10. package/.agent/data/scheduler/tasks.json +1 -0
  11. package/.agent/mcp_config.json +1 -0
  12. package/.agent/package.json +8 -0
  13. package/.agent/plugins/__pycache__/test_plugin.cpython-312.pyc +0 -0
  14. package/.agent/plugins/system-info/index.js +387 -0
  15. package/.agent/plugins/system-info/package.json +4 -0
  16. package/.agent/plugins/system-info/test.js +40 -0
  17. package/.agent/plugins/test_plugin.py +304 -0
  18. package/.agent/plugins.json +14 -5
  19. package/.agent/python-scripts/test_sample.py +24 -0
  20. package/.agent/skills/sysinfo/SKILL.md +38 -0
  21. package/.agent/skills/sysinfo/system-info.sh +130 -0
  22. package/.agent/skills/workflow/SKILL.md +324 -0
  23. package/.agent/workflows/email-digest.json +50 -0
  24. package/.agent/workflows/file-backup.json +21 -0
  25. package/.agent/workflows/get-ip-notify.json +32 -0
  26. package/.agent/workflows/news-aggregator.json +93 -0
  27. package/.agent/workflows/news-dashboard-v2.json +94 -0
  28. package/.agent/workflows/notification-batch.json +32 -0
  29. package/.claude/settings.local.json +171 -171
  30. package/.env.example +56 -56
  31. package/cli/bin/foliko.js +12 -12
  32. package/cli/src/commands/chat.js +143 -143
  33. package/cli/src/commands/list.js +93 -93
  34. package/cli/src/index.js +75 -75
  35. package/cli/src/ui/chat-ui.js +201 -201
  36. package/cli/src/utils/ansi.js +40 -40
  37. package/cli/src/utils/markdown.js +292 -292
  38. package/examples/ambient-example.js +194 -194
  39. package/examples/basic.js +115 -115
  40. package/examples/bootstrap.js +121 -121
  41. package/examples/mcp-example.js +56 -56
  42. package/examples/skill-example.js +49 -49
  43. package/examples/test-chat.js +137 -137
  44. package/examples/test-mcp.js +85 -85
  45. package/examples/test-reload.js +59 -59
  46. package/examples/test-telegram.js +50 -50
  47. package/examples/test-tg-bot.js +45 -45
  48. package/examples/test-tg-simple.js +47 -47
  49. package/examples/test-tg.js +62 -62
  50. package/examples/test-think.js +43 -43
  51. package/examples/test-web-plugin.js +103 -103
  52. package/examples/test-weixin-feishu.js +103 -103
  53. package/examples/workflow.js +158 -158
  54. package/package.json +83 -83
  55. package/plugins/ai-plugin.js +102 -102
  56. package/plugins/ambient-agent/EventWatcher.js +113 -113
  57. package/plugins/ambient-agent/ExplorerLoop.js +640 -640
  58. package/plugins/ambient-agent/GoalManager.js +197 -197
  59. package/plugins/ambient-agent/Reflector.js +95 -95
  60. package/plugins/ambient-agent/StateStore.js +90 -90
  61. package/plugins/ambient-agent/constants.js +101 -101
  62. package/plugins/ambient-agent/index.js +579 -579
  63. package/plugins/audit-plugin.js +187 -187
  64. package/plugins/default-plugins.js +548 -548
  65. package/plugins/email/constants.js +64 -64
  66. package/plugins/email/handlers.js +461 -461
  67. package/plugins/email/index.js +278 -278
  68. package/plugins/email/monitor.js +269 -269
  69. package/plugins/email/parser.js +138 -138
  70. package/plugins/email/reply.js +151 -151
  71. package/plugins/email/utils.js +124 -124
  72. package/plugins/extension-executor-plugin.js +326 -326
  73. package/plugins/feishu-plugin.js +481 -481
  74. package/plugins/file-system-plugin.js +920 -877
  75. package/plugins/gate-trading.js +747 -747
  76. package/plugins/install-plugin.js +199 -199
  77. package/plugins/python-executor-plugin.js +367 -367
  78. package/plugins/python-plugin-loader.js +651 -651
  79. package/plugins/rules-plugin.js +294 -294
  80. package/plugins/scheduler-plugin.js +691 -691
  81. package/plugins/session-plugin.js +494 -494
  82. package/plugins/shell-executor-plugin.js +197 -197
  83. package/plugins/storage-plugin.js +263 -263
  84. package/plugins/subagent-plugin.js +845 -845
  85. package/plugins/telegram-plugin.js +482 -482
  86. package/plugins/think-plugin.js +345 -345
  87. package/plugins/tools-plugin.js +196 -196
  88. package/plugins/web-plugin.js +637 -637
  89. package/plugins/weixin-plugin.js +545 -545
  90. package/skills/find-skills/AGENTS.md +162 -162
  91. package/skills/find-skills/SKILL.md +133 -133
  92. package/skills/foliko-dev/SKILL.md +563 -583
  93. package/skills/python-plugin-dev/SKILL.md +238 -238
  94. package/src/capabilities/index.js +11 -11
  95. package/src/capabilities/skill-manager.js +609 -609
  96. package/src/capabilities/workflow-engine.js +1109 -1109
  97. package/src/core/agent-chat.js +141 -134
  98. package/src/core/agent.js +958 -958
  99. package/src/core/framework.js +465 -465
  100. package/src/core/index.js +19 -19
  101. package/src/core/plugin-base.js +262 -262
  102. package/src/core/plugin-manager.js +863 -863
  103. package/src/core/provider.js +114 -114
  104. package/src/core/sub-agent-config.js +264 -264
  105. package/src/core/system-prompt-builder.js +120 -120
  106. package/src/core/tool-registry.js +517 -517
  107. package/src/core/tool-router.js +297 -297
  108. package/src/executors/executor-base.js +58 -58
  109. package/src/executors/mcp-executor.js +845 -845
  110. package/src/index.js +25 -25
  111. package/src/utils/circuit-breaker.js +301 -301
  112. package/src/utils/error-boundary.js +363 -363
  113. package/src/utils/error.js +374 -374
  114. package/src/utils/event-emitter.js +97 -97
  115. package/src/utils/id.js +133 -133
  116. package/src/utils/index.js +217 -217
  117. package/src/utils/logger.js +181 -181
  118. package/src/utils/plugin-helpers.js +90 -90
  119. package/src/utils/retry.js +122 -122
  120. package/src/utils/sandbox.js +292 -292
  121. package/test/tool-registry-validation.test.js +218 -218
  122. package/website/script.js +136 -136
  123. package/.agent/.shared/ui-ux-pro-max/data/charts.csv +0 -26
  124. package/.agent/.shared/ui-ux-pro-max/data/colors.csv +0 -97
  125. package/.agent/.shared/ui-ux-pro-max/data/icons.csv +0 -101
  126. package/.agent/.shared/ui-ux-pro-max/data/landing.csv +0 -31
  127. package/.agent/.shared/ui-ux-pro-max/data/products.csv +0 -97
  128. package/.agent/.shared/ui-ux-pro-max/data/prompts.csv +0 -24
  129. package/.agent/.shared/ui-ux-pro-max/data/react-performance.csv +0 -45
  130. package/.agent/.shared/ui-ux-pro-max/data/stacks/flutter.csv +0 -53
  131. package/.agent/.shared/ui-ux-pro-max/data/stacks/html-tailwind.csv +0 -56
  132. package/.agent/.shared/ui-ux-pro-max/data/stacks/jetpack-compose.csv +0 -53
  133. package/.agent/.shared/ui-ux-pro-max/data/stacks/nextjs.csv +0 -53
  134. package/.agent/.shared/ui-ux-pro-max/data/stacks/nuxt-ui.csv +0 -51
  135. package/.agent/.shared/ui-ux-pro-max/data/stacks/nuxtjs.csv +0 -59
  136. package/.agent/.shared/ui-ux-pro-max/data/stacks/react-native.csv +0 -52
  137. package/.agent/.shared/ui-ux-pro-max/data/stacks/react.csv +0 -54
  138. package/.agent/.shared/ui-ux-pro-max/data/stacks/shadcn.csv +0 -61
  139. package/.agent/.shared/ui-ux-pro-max/data/stacks/svelte.csv +0 -54
  140. package/.agent/.shared/ui-ux-pro-max/data/stacks/swiftui.csv +0 -51
  141. package/.agent/.shared/ui-ux-pro-max/data/stacks/vue.csv +0 -50
  142. package/.agent/.shared/ui-ux-pro-max/data/styles.csv +0 -59
  143. package/.agent/.shared/ui-ux-pro-max/data/typography.csv +0 -58
  144. package/.agent/.shared/ui-ux-pro-max/data/ui-reasoning.csv +0 -101
  145. package/.agent/.shared/ui-ux-pro-max/data/ux-guidelines.csv +0 -100
  146. package/.agent/.shared/ui-ux-pro-max/data/web-interface.csv +0 -31
  147. package/.agent/.shared/ui-ux-pro-max/scripts/__pycache__/core.cpython-313.pyc +0 -0
  148. package/.agent/.shared/ui-ux-pro-max/scripts/__pycache__/design_system.cpython-313.pyc +0 -0
  149. package/.agent/.shared/ui-ux-pro-max/scripts/core.py +0 -258
  150. package/.agent/.shared/ui-ux-pro-max/scripts/design_system.py +0 -1067
  151. package/.agent/.shared/ui-ux-pro-max/scripts/search.py +0 -106
  152. package/.agent/ARCHITECTURE.md +0 -288
  153. package/.agent/agents/ambient-agent.md +0 -57
  154. package/.agent/agents/debugger.md +0 -55
  155. package/.agent/agents/email-assistant.md +0 -49
  156. package/.agent/agents/file-manager.md +0 -42
  157. package/.agent/agents/python-developer.md +0 -60
  158. package/.agent/agents/scheduler.md +0 -59
  159. package/.agent/agents/web-developer.md +0 -45
  160. package/.agent/mcp_config_updated.json +0 -12
  161. package/.agent/rules/GEMINI.md +0 -273
  162. package/.agent/rules/allow-rule.md +0 -77
  163. package/.agent/rules/log-rule.md +0 -83
  164. package/.agent/rules/security-rule.md +0 -93
  165. package/.agent/scripts/auto_preview.py +0 -148
  166. package/.agent/scripts/checklist.py +0 -217
  167. package/.agent/scripts/session_manager.py +0 -120
  168. package/.agent/scripts/verify_all.py +0 -327
  169. package/.agent/skills/api-patterns/SKILL.md +0 -81
  170. package/.agent/skills/api-patterns/api-style.md +0 -42
  171. package/.agent/skills/api-patterns/auth.md +0 -24
  172. package/.agent/skills/api-patterns/documentation.md +0 -26
  173. package/.agent/skills/api-patterns/graphql.md +0 -41
  174. package/.agent/skills/api-patterns/rate-limiting.md +0 -31
  175. package/.agent/skills/api-patterns/response.md +0 -37
  176. package/.agent/skills/api-patterns/rest.md +0 -40
  177. package/.agent/skills/api-patterns/scripts/api_validator.py +0 -211
  178. package/.agent/skills/api-patterns/security-testing.md +0 -122
  179. package/.agent/skills/api-patterns/trpc.md +0 -41
  180. package/.agent/skills/api-patterns/versioning.md +0 -22
  181. package/.agent/skills/app-builder/SKILL.md +0 -75
  182. package/.agent/skills/app-builder/agent-coordination.md +0 -71
  183. package/.agent/skills/app-builder/feature-building.md +0 -53
  184. package/.agent/skills/app-builder/project-detection.md +0 -34
  185. package/.agent/skills/app-builder/scaffolding.md +0 -118
  186. package/.agent/skills/app-builder/tech-stack.md +0 -40
  187. package/.agent/skills/app-builder/templates/SKILL.md +0 -39
  188. package/.agent/skills/app-builder/templates/astro-static/TEMPLATE.md +0 -76
  189. package/.agent/skills/app-builder/templates/chrome-extension/TEMPLATE.md +0 -92
  190. package/.agent/skills/app-builder/templates/cli-tool/TEMPLATE.md +0 -88
  191. package/.agent/skills/app-builder/templates/electron-desktop/TEMPLATE.md +0 -88
  192. package/.agent/skills/app-builder/templates/express-api/TEMPLATE.md +0 -83
  193. package/.agent/skills/app-builder/templates/flutter-app/TEMPLATE.md +0 -90
  194. package/.agent/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +0 -90
  195. package/.agent/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +0 -122
  196. package/.agent/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +0 -122
  197. package/.agent/skills/app-builder/templates/nextjs-static/TEMPLATE.md +0 -169
  198. package/.agent/skills/app-builder/templates/nuxt-app/TEMPLATE.md +0 -134
  199. package/.agent/skills/app-builder/templates/python-fastapi/TEMPLATE.md +0 -83
  200. package/.agent/skills/app-builder/templates/react-native-app/TEMPLATE.md +0 -119
  201. package/.agent/skills/architecture/SKILL.md +0 -55
  202. package/.agent/skills/architecture/context-discovery.md +0 -43
  203. package/.agent/skills/architecture/examples.md +0 -94
  204. package/.agent/skills/architecture/pattern-selection.md +0 -68
  205. package/.agent/skills/architecture/patterns-reference.md +0 -50
  206. package/.agent/skills/architecture/trade-off-analysis.md +0 -77
  207. package/.agent/skills/clean-code/SKILL.md +0 -201
  208. package/.agent/skills/doc.md +0 -177
  209. package/.agent/skills/frontend-design/SKILL.md +0 -418
  210. package/.agent/skills/frontend-design/animation-guide.md +0 -331
  211. package/.agent/skills/frontend-design/color-system.md +0 -311
  212. package/.agent/skills/frontend-design/decision-trees.md +0 -418
  213. package/.agent/skills/frontend-design/motion-graphics.md +0 -306
  214. package/.agent/skills/frontend-design/scripts/accessibility_checker.py +0 -183
  215. package/.agent/skills/frontend-design/scripts/ux_audit.py +0 -722
  216. package/.agent/skills/frontend-design/typography-system.md +0 -345
  217. package/.agent/skills/frontend-design/ux-psychology.md +0 -1116
  218. package/.agent/skills/frontend-design/visual-effects.md +0 -383
  219. package/.agent/skills/i18n-localization/SKILL.md +0 -154
  220. package/.agent/skills/i18n-localization/scripts/i18n_checker.py +0 -241
  221. package/.agent/skills/mcp-builder/SKILL.md +0 -176
  222. package/.agent/skills/web-design-guidelines/SKILL.md +0 -57
  223. package/.agent/workflows/brainstorm.md +0 -113
  224. package/.agent/workflows/create.md +0 -59
  225. package/.agent/workflows/debug.md +0 -103
  226. package/.agent/workflows/deploy.md +0 -176
  227. package/.agent/workflows/enhance.md +0 -63
  228. package/.agent/workflows/orchestrate.md +0 -237
  229. package/.agent/workflows/plan.md +0 -89
  230. package/.agent/workflows/preview.md +0 -81
  231. package/.agent/workflows/simple-test.md +0 -42
  232. package/.agent/workflows/status.md +0 -86
  233. package/.agent/workflows/structured-orchestrate.md +0 -180
  234. package/.agent/workflows/test.md +0 -144
  235. package/.agent/workflows/ui-ux-pro-max.md +0 -296
@@ -1,97 +1,97 @@
1
- /**
2
- * EventEmitter 事件发射器
3
- * 简单的事件总线实现
4
- */
5
-
6
- class EventEmitter {
7
- constructor() {
8
- this._events = new Map();
9
- }
10
-
11
- /**
12
- * 监听事件
13
- * @param {string} event - 事件名
14
- * @param {Function} handler - 处理函数
15
- * @returns {this}
16
- */
17
- on(event, handler) {
18
- if (!this._events.has(event)) {
19
- this._events.set(event, new Set());
20
- }
21
- this._events.get(event).add(handler);
22
- return this;
23
- }
24
-
25
- /**
26
- * 监听一次性事件
27
- * @param {string} event - 事件名
28
- * @param {Function} handler - 处理函数
29
- * @returns {this}
30
- */
31
- once(event, handler) {
32
- const wrapper = (...args) => {
33
- handler(...args);
34
- this.off(event, wrapper);
35
- };
36
- return this.on(event, wrapper);
37
- }
38
-
39
- /**
40
- * 取消监听
41
- * @param {string} event - 事件名
42
- * @param {Function} handler - 处理函数
43
- * @returns {this}
44
- */
45
- off(event, handler) {
46
- const handlers = this._events.get(event);
47
- if (handlers) {
48
- handlers.delete(handler);
49
- }
50
- return this;
51
- }
52
-
53
- /**
54
- * 触发事件
55
- * @param {string} event - 事件名
56
- * @param {...any} args - 参数
57
- * @returns {this}
58
- */
59
- emit(event, ...args) {
60
- const handlers = this._events.get(event);
61
- if (handlers) {
62
- for (const handler of handlers) {
63
- try {
64
- handler(...args);
65
- } catch (err) {
66
- // EventEmitter error: Error in handler for '${event}':`, err)
67
- }
68
- }
69
- }
70
- return this;
71
- }
72
-
73
- /**
74
- * 移除所有监听器
75
- * @param {string} [event] - 可选,指定事件名
76
- * @returns {this}
77
- */
78
- removeAllListeners(event) {
79
- if (event) {
80
- this._events.delete(event);
81
- } else {
82
- this._events.clear();
83
- }
84
- return this;
85
- }
86
-
87
- /**
88
- * 获取监听器数量
89
- * @param {string} event - 事件名
90
- * @returns {number}
91
- */
92
- listenerCount(event) {
93
- return this._events.get(event)?.size || 0;
94
- }
95
- }
96
-
97
- module.exports = { EventEmitter };
1
+ /**
2
+ * EventEmitter 事件发射器
3
+ * 简单的事件总线实现
4
+ */
5
+
6
+ class EventEmitter {
7
+ constructor() {
8
+ this._events = new Map();
9
+ }
10
+
11
+ /**
12
+ * 监听事件
13
+ * @param {string} event - 事件名
14
+ * @param {Function} handler - 处理函数
15
+ * @returns {this}
16
+ */
17
+ on(event, handler) {
18
+ if (!this._events.has(event)) {
19
+ this._events.set(event, new Set());
20
+ }
21
+ this._events.get(event).add(handler);
22
+ return this;
23
+ }
24
+
25
+ /**
26
+ * 监听一次性事件
27
+ * @param {string} event - 事件名
28
+ * @param {Function} handler - 处理函数
29
+ * @returns {this}
30
+ */
31
+ once(event, handler) {
32
+ const wrapper = (...args) => {
33
+ handler(...args);
34
+ this.off(event, wrapper);
35
+ };
36
+ return this.on(event, wrapper);
37
+ }
38
+
39
+ /**
40
+ * 取消监听
41
+ * @param {string} event - 事件名
42
+ * @param {Function} handler - 处理函数
43
+ * @returns {this}
44
+ */
45
+ off(event, handler) {
46
+ const handlers = this._events.get(event);
47
+ if (handlers) {
48
+ handlers.delete(handler);
49
+ }
50
+ return this;
51
+ }
52
+
53
+ /**
54
+ * 触发事件
55
+ * @param {string} event - 事件名
56
+ * @param {...any} args - 参数
57
+ * @returns {this}
58
+ */
59
+ emit(event, ...args) {
60
+ const handlers = this._events.get(event);
61
+ if (handlers) {
62
+ for (const handler of handlers) {
63
+ try {
64
+ handler(...args);
65
+ } catch (err) {
66
+ // EventEmitter error: Error in handler for '${event}':`, err)
67
+ }
68
+ }
69
+ }
70
+ return this;
71
+ }
72
+
73
+ /**
74
+ * 移除所有监听器
75
+ * @param {string} [event] - 可选,指定事件名
76
+ * @returns {this}
77
+ */
78
+ removeAllListeners(event) {
79
+ if (event) {
80
+ this._events.delete(event);
81
+ } else {
82
+ this._events.clear();
83
+ }
84
+ return this;
85
+ }
86
+
87
+ /**
88
+ * 获取监听器数量
89
+ * @param {string} event - 事件名
90
+ * @returns {number}
91
+ */
92
+ listenerCount(event) {
93
+ return this._events.get(event)?.size || 0;
94
+ }
95
+ }
96
+
97
+ module.exports = { EventEmitter };
package/src/utils/id.js CHANGED
@@ -1,133 +1,133 @@
1
- /**
2
- * Foliko ID 生成器 - 统一 ID 生成
3
- * 支持 UUID、ULID、雪花ID、自定义前缀
4
- */
5
-
6
- const crypto = require('crypto');
7
-
8
- /**
9
- * 生成标准 UUID v4
10
- * @returns {string}
11
- */
12
- function uuid() {
13
- if (crypto.randomUUID) {
14
- return crypto.randomUUID();
15
- }
16
- // 回退实现 (Node.js < 14.17)
17
- return ([1e7] + -1e3 + -4e3 + -8e3 + -1e11).replace(/[018]/g, (c) =>
18
- (c ^ (crypto.randomBytes(1)[0] & (15 >> (c / 4)))).toString(16)
19
- );
20
- }
21
-
22
- /**
23
- * 生成带前缀的 UUID
24
- * @param {string} prefix - 前缀,如 'agent', 'session', 'task'
25
- * @returns {string}
26
- */
27
- function prefixedId(prefix = 'id') {
28
- return `${prefix}_${uuid()}`;
29
- }
30
-
31
- /**
32
- * 生成短 ID (无连字符)
33
- * @param {number} length - 长度,默认 12
34
- * @returns {string}
35
- */
36
- function shortId(length = 12) {
37
- return uuid().replace(/-/g, '').slice(0, length);
38
- }
39
-
40
- /**
41
- * 生成雪花 ID (Twitter Snowflake 简化版)
42
- * @returns {string}
43
- */
44
- let snowflakeEpoch = 1609459200000; // 2021-01-01
45
- let snowflakeSequence = 0;
46
- let snowflakeLastTime = 0;
47
-
48
- function snowflake() {
49
- const now = Date.now();
50
-
51
- if (now === snowflakeLastTime) {
52
- snowflakeSequence = (snowflakeSequence + 1) & 4095;
53
- } else {
54
- snowflakeSequence = 0;
55
- snowflakeLastTime = now;
56
- }
57
-
58
- const timestamp = now - snowflakeEpoch;
59
- const workerId = 1;
60
-
61
- const id = (BigInt(timestamp) << 22n) | (BigInt(workerId) << 12n) | BigInt(snowflakeSequence);
62
-
63
- return id.toString();
64
- }
65
-
66
- /**
67
- * 生成任务 ID (向后兼容原有格式)
68
- * @param {string} [prefix] - 可选前缀
69
- * @returns {string}
70
- */
71
- function taskId(prefix) {
72
- const suffix = crypto.randomBytes(8).toString('base64url');
73
- return prefix ? `${prefix}_${suffix}` : suffix;
74
- }
75
-
76
- /**
77
- * 生成目标 ID (向后兼容原有格式)
78
- * @returns {string}
79
- */
80
- function goalId() {
81
- const random = crypto.randomBytes(8).toString('base64url');
82
- return `goal_${Date.now()}_${random}`;
83
- }
84
-
85
- /**
86
- * 生成会话 ID (向后兼容原有格式)
87
- * @returns {string}
88
- */
89
- function sessionId() {
90
- const random = crypto.randomBytes(8).toString('base64url');
91
- return `session_${Date.now()}_${random}`;
92
- }
93
-
94
- /**
95
- * 生成邮箱消息 ID
96
- * @returns {string}
97
- */
98
- function messageId() {
99
- const timestamp = Date.now();
100
- const random = crypto.randomBytes(10).toString('base64url');
101
- return `<${timestamp}.${random}@foliko>`;
102
- }
103
-
104
- /**
105
- * 生成规则 ID
106
- * @returns {string}
107
- */
108
- function ruleId() {
109
- const random = crypto.randomBytes(8).toString('base64url');
110
- return `rule_${Date.now()}_${random}`;
111
- }
112
-
113
- /**
114
- * 重置雪花 ID 计数器 (用于测试)
115
- */
116
- function resetSnowflake() {
117
- snowflakeSequence = 0;
118
- snowflakeLastTime = 0;
119
- }
120
-
121
- // 导出所有函数
122
- module.exports = {
123
- uuid,
124
- prefixedId,
125
- shortId,
126
- snowflake,
127
- taskId,
128
- goalId,
129
- sessionId,
130
- messageId,
131
- ruleId,
132
- resetSnowflake,
133
- };
1
+ /**
2
+ * Foliko ID 生成器 - 统一 ID 生成
3
+ * 支持 UUID、ULID、雪花ID、自定义前缀
4
+ */
5
+
6
+ const crypto = require('crypto');
7
+
8
+ /**
9
+ * 生成标准 UUID v4
10
+ * @returns {string}
11
+ */
12
+ function uuid() {
13
+ if (crypto.randomUUID) {
14
+ return crypto.randomUUID();
15
+ }
16
+ // 回退实现 (Node.js < 14.17)
17
+ return ([1e7] + -1e3 + -4e3 + -8e3 + -1e11).replace(/[018]/g, (c) =>
18
+ (c ^ (crypto.randomBytes(1)[0] & (15 >> (c / 4)))).toString(16)
19
+ );
20
+ }
21
+
22
+ /**
23
+ * 生成带前缀的 UUID
24
+ * @param {string} prefix - 前缀,如 'agent', 'session', 'task'
25
+ * @returns {string}
26
+ */
27
+ function prefixedId(prefix = 'id') {
28
+ return `${prefix}_${uuid()}`;
29
+ }
30
+
31
+ /**
32
+ * 生成短 ID (无连字符)
33
+ * @param {number} length - 长度,默认 12
34
+ * @returns {string}
35
+ */
36
+ function shortId(length = 12) {
37
+ return uuid().replace(/-/g, '').slice(0, length);
38
+ }
39
+
40
+ /**
41
+ * 生成雪花 ID (Twitter Snowflake 简化版)
42
+ * @returns {string}
43
+ */
44
+ let snowflakeEpoch = 1609459200000; // 2021-01-01
45
+ let snowflakeSequence = 0;
46
+ let snowflakeLastTime = 0;
47
+
48
+ function snowflake() {
49
+ const now = Date.now();
50
+
51
+ if (now === snowflakeLastTime) {
52
+ snowflakeSequence = (snowflakeSequence + 1) & 4095;
53
+ } else {
54
+ snowflakeSequence = 0;
55
+ snowflakeLastTime = now;
56
+ }
57
+
58
+ const timestamp = now - snowflakeEpoch;
59
+ const workerId = 1;
60
+
61
+ const id = (BigInt(timestamp) << 22n) | (BigInt(workerId) << 12n) | BigInt(snowflakeSequence);
62
+
63
+ return id.toString();
64
+ }
65
+
66
+ /**
67
+ * 生成任务 ID (向后兼容原有格式)
68
+ * @param {string} [prefix] - 可选前缀
69
+ * @returns {string}
70
+ */
71
+ function taskId(prefix) {
72
+ const suffix = crypto.randomBytes(8).toString('base64url');
73
+ return prefix ? `${prefix}_${suffix}` : suffix;
74
+ }
75
+
76
+ /**
77
+ * 生成目标 ID (向后兼容原有格式)
78
+ * @returns {string}
79
+ */
80
+ function goalId() {
81
+ const random = crypto.randomBytes(8).toString('base64url');
82
+ return `goal_${Date.now()}_${random}`;
83
+ }
84
+
85
+ /**
86
+ * 生成会话 ID (向后兼容原有格式)
87
+ * @returns {string}
88
+ */
89
+ function sessionId() {
90
+ const random = crypto.randomBytes(8).toString('base64url');
91
+ return `session_${Date.now()}_${random}`;
92
+ }
93
+
94
+ /**
95
+ * 生成邮箱消息 ID
96
+ * @returns {string}
97
+ */
98
+ function messageId() {
99
+ const timestamp = Date.now();
100
+ const random = crypto.randomBytes(10).toString('base64url');
101
+ return `<${timestamp}.${random}@foliko>`;
102
+ }
103
+
104
+ /**
105
+ * 生成规则 ID
106
+ * @returns {string}
107
+ */
108
+ function ruleId() {
109
+ const random = crypto.randomBytes(8).toString('base64url');
110
+ return `rule_${Date.now()}_${random}`;
111
+ }
112
+
113
+ /**
114
+ * 重置雪花 ID 计数器 (用于测试)
115
+ */
116
+ function resetSnowflake() {
117
+ snowflakeSequence = 0;
118
+ snowflakeLastTime = 0;
119
+ }
120
+
121
+ // 导出所有函数
122
+ module.exports = {
123
+ uuid,
124
+ prefixedId,
125
+ shortId,
126
+ snowflake,
127
+ taskId,
128
+ goalId,
129
+ sessionId,
130
+ messageId,
131
+ ruleId,
132
+ resetSnowflake,
133
+ };