nolo-cli 0.1.10 → 0.1.12

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 (232) hide show
  1. package/README.md +0 -32
  2. package/agentRuntimeCommands.ts +1 -1
  3. package/client/compactDialog.ts +2 -5
  4. package/commandRegistry.ts +2 -2
  5. package/machineCommands.ts +28 -3
  6. package/package.json +5 -25
  7. package/ai/agent/_executeModel.ts +0 -118
  8. package/ai/agent/agentSlice.ts +0 -525
  9. package/ai/agent/appWorkingMemory.ts +0 -126
  10. package/ai/agent/avatarUtils.ts +0 -24
  11. package/ai/agent/buildEditingContext.ts +0 -373
  12. package/ai/agent/buildSystemPrompt.ts +0 -532
  13. package/ai/agent/cleanAgentMessages.ts +0 -140
  14. package/ai/agent/cliChatClient.ts +0 -119
  15. package/ai/agent/contextCompiler.ts +0 -107
  16. package/ai/agent/contextLayerContract.ts +0 -44
  17. package/ai/agent/createAgentSchema.ts +0 -234
  18. package/ai/agent/executeToolCall.ts +0 -58
  19. package/ai/agent/fetchAgentContexts.ts +0 -42
  20. package/ai/agent/generatePrompt.ts +0 -3
  21. package/ai/agent/getFullChatContextKeys.ts +0 -168
  22. package/ai/agent/hooks/fetchPublicAgents.ts +0 -133
  23. package/ai/agent/hooks/useAgentConfig.ts +0 -61
  24. package/ai/agent/hooks/useAgentDialog.ts +0 -35
  25. package/ai/agent/hooks/useAgentFormValidation.ts +0 -202
  26. package/ai/agent/hooks/usePublicAgents.ts +0 -473
  27. package/ai/agent/persistMessageWithFixedId.ts +0 -37
  28. package/ai/agent/planSlice.ts +0 -259
  29. package/ai/agent/referenceUtils.ts +0 -229
  30. package/ai/agent/runAgentBackground.ts +0 -238
  31. package/ai/agent/runAgentClientLoop.ts +0 -138
  32. package/ai/agent/runtimeGuidance.ts +0 -97
  33. package/ai/agent/runtimeServerBase.ts +0 -37
  34. package/ai/agent/server/fetchPublicAgents.ts +0 -128
  35. package/ai/agent/startParallelAgentStreams.ts +0 -424
  36. package/ai/agent/startupProtocol.ts +0 -53
  37. package/ai/agent/streamAgentChatTurn.ts +0 -1278
  38. package/ai/agent/streamAgentChatTurnUtils.ts +0 -738
  39. package/ai/agent/types.ts +0 -71
  40. package/ai/agent/utils/imageOutput.ts +0 -33
  41. package/ai/agent/utils/sortUtils.ts +0 -250
  42. package/ai/agent/web/referencePickerUtils.ts +0 -146
  43. package/ai/ai.locale.ts +0 -1079
  44. package/ai/chat/accumulateToolCallChunks.ts +0 -95
  45. package/ai/chat/fetchUtils.native.ts +0 -276
  46. package/ai/chat/fetchUtils.ts +0 -153
  47. package/ai/chat/parseApiError.ts +0 -64
  48. package/ai/chat/parseMultilineSSE.ts +0 -95
  49. package/ai/chat/sendOpenAICompletionsRequest.native.ts +0 -682
  50. package/ai/chat/sendOpenAICompletionsRequest.ts +0 -703
  51. package/ai/chat/sendOpenAIResponseRequest.ts +0 -491
  52. package/ai/chat/shouldUseServerProxy.ts +0 -18
  53. package/ai/chat/sseClient.native.ts +0 -91
  54. package/ai/chat/sseClient.ts +0 -67
  55. package/ai/chat/streamReader.native.ts +0 -31
  56. package/ai/chat/streamReader.ts +0 -62
  57. package/ai/chat/updateTotalUsage.ts +0 -72
  58. package/ai/context/buildReferenceContext.ts +0 -437
  59. package/ai/context/calculateContextUsage.ts +0 -133
  60. package/ai/context/retention.ts +0 -165
  61. package/ai/context/tokenUtils.ts +0 -78
  62. package/ai/index.ts +0 -1
  63. package/ai/llm/calculateGeminiImageTokens.ts +0 -57
  64. package/ai/llm/deepinfra.ts +0 -28
  65. package/ai/llm/fireworks.ts +0 -50
  66. package/ai/llm/generateRequestBody.ts +0 -165
  67. package/ai/llm/getModelContextWindow.ts +0 -84
  68. package/ai/llm/getNoloKey.ts +0 -31
  69. package/ai/llm/getPricing.ts +0 -199
  70. package/ai/llm/hooks/useModelPricing.ts +0 -75
  71. package/ai/llm/imagePricing.ts +0 -40
  72. package/ai/llm/isResponseAPIModel.ts +0 -13
  73. package/ai/llm/mimo.ts +0 -71
  74. package/ai/llm/mistral.ts +0 -22
  75. package/ai/llm/modelAvatar.ts +0 -427
  76. package/ai/llm/models.ts +0 -45
  77. package/ai/llm/openrouterModels.ts +0 -269
  78. package/ai/llm/providers.ts +0 -306
  79. package/ai/llm/reasoningModels.ts +0 -28
  80. package/ai/llm/types.ts +0 -59
  81. package/ai/llm/usageRequestOptions.ts +0 -59
  82. package/ai/memory/capture.ts +0 -148
  83. package/ai/memory/consolidate.ts +0 -104
  84. package/ai/memory/delete.ts +0 -147
  85. package/ai/memory/overlay.ts +0 -84
  86. package/ai/memory/query.ts +0 -38
  87. package/ai/memory/queryShared.ts +0 -160
  88. package/ai/memory/rank.ts +0 -105
  89. package/ai/memory/recentRelationshipRecap.ts +0 -249
  90. package/ai/memory/remember.ts +0 -167
  91. package/ai/memory/runtime.ts +0 -76
  92. package/ai/memory/store.ts +0 -20
  93. package/ai/memory/storeShared.ts +0 -76
  94. package/ai/memory/types.ts +0 -46
  95. package/ai/memory/understanding.ts +0 -349
  96. package/ai/memory/understandingGreeting.ts +0 -264
  97. package/ai/messages/type.ts +0 -20
  98. package/ai/policy/personalizationDialog.ts +0 -333
  99. package/ai/policy/runtimePolicy.ts +0 -440
  100. package/ai/policy/selfUpdateFields.ts +0 -48
  101. package/ai/policy/types.ts +0 -64
  102. package/ai/skills/referenceRuntime.ts +0 -274
  103. package/ai/skills/skillDiagnostics.ts +0 -251
  104. package/ai/skills/skillDocBuilder.ts +0 -139
  105. package/ai/skills/skillDocProtocol.ts +0 -434
  106. package/ai/skills/skillReferenceSummary.ts +0 -63
  107. package/ai/skills/skillSummaryMarker.ts +0 -26
  108. package/ai/token/calculatePrice.ts +0 -544
  109. package/ai/token/db.ts +0 -98
  110. package/ai/token/externalToolCost.ts +0 -330
  111. package/ai/token/hooks/useRecords.ts +0 -65
  112. package/ai/token/missingUsageEstimate.ts +0 -42
  113. package/ai/token/modelUsageQuery.ts +0 -252
  114. package/ai/token/normalizeUsage.ts +0 -84
  115. package/ai/token/openaiImageGenerationUsage.ts +0 -56
  116. package/ai/token/prepareTokenUsageData.ts +0 -88
  117. package/ai/token/query.ts +0 -88
  118. package/ai/token/queryUserTokens.ts +0 -59
  119. package/ai/token/resolveBillingTarget.ts +0 -52
  120. package/ai/token/saveTokenRecord.ts +0 -53
  121. package/ai/token/serverDialogProjection.ts +0 -78
  122. package/ai/token/serverTokenWriter.ts +0 -143
  123. package/ai/token/stats.ts +0 -21
  124. package/ai/token/tokenThunks.ts +0 -24
  125. package/ai/token/types.ts +0 -93
  126. package/ai/tools/agent/agentTools.ts +0 -176
  127. package/ai/tools/agent/agentUpdateShared.ts +0 -311
  128. package/ai/tools/agent/callAgentTool.ts +0 -139
  129. package/ai/tools/agent/createAgentTool.ts +0 -512
  130. package/ai/tools/agent/createDialogTool.ts +0 -69
  131. package/ai/tools/agent/createSkillAgentTool.ts +0 -62
  132. package/ai/tools/agent/parallelBudget.ts +0 -221
  133. package/ai/tools/agent/presets/appBuilderPreset.ts +0 -145
  134. package/ai/tools/agent/runLlmTool.ts +0 -96
  135. package/ai/tools/agent/runStreamingAgentTool.ts +0 -73
  136. package/ai/tools/agent/skillAgentArgs.ts +0 -106
  137. package/ai/tools/agent/skillAgentPreset.ts +0 -89
  138. package/ai/tools/agent/streamParallelAgentsTool.ts +0 -122
  139. package/ai/tools/agent/updateAgentTool.ts +0 -96
  140. package/ai/tools/agent/updateSelfTool.ts +0 -113
  141. package/ai/tools/amazonProductScraperTool.ts +0 -86
  142. package/ai/tools/apifyActorClient.ts +0 -45
  143. package/ai/tools/appEditGuard.ts +0 -372
  144. package/ai/tools/appReadSnapshot.ts +0 -153
  145. package/ai/tools/appTools.ts +0 -1549
  146. package/ai/tools/applyEditTool.ts +0 -256
  147. package/ai/tools/applyLineEditsTool.ts +0 -312
  148. package/ai/tools/browserTools/click.ts +0 -33
  149. package/ai/tools/browserTools/closeSession.ts +0 -29
  150. package/ai/tools/browserTools/common.ts +0 -27
  151. package/ai/tools/browserTools/openSession.ts +0 -48
  152. package/ai/tools/browserTools/readContent.ts +0 -38
  153. package/ai/tools/browserTools/selectOption.ts +0 -46
  154. package/ai/tools/browserTools/typeText.ts +0 -42
  155. package/ai/tools/category/createCategoryTool.ts +0 -66
  156. package/ai/tools/category/queryContentsByCategoryTool.ts +0 -69
  157. package/ai/tools/category/updateContentCategoryTool.ts +0 -75
  158. package/ai/tools/cfBrowserTools.ts +0 -319
  159. package/ai/tools/cfSpeechToTextTool.ts +0 -49
  160. package/ai/tools/checkEnvTool.ts +0 -65
  161. package/ai/tools/cloudflareCrawlTool.ts +0 -289
  162. package/ai/tools/codeSearchTool.ts +0 -111
  163. package/ai/tools/codeTools.ts +0 -101
  164. package/ai/tools/createDocTool.ts +0 -132
  165. package/ai/tools/createPlanTool.ts +0 -999
  166. package/ai/tools/createSkillDocTool.ts +0 -155
  167. package/ai/tools/createWorkflowTool.ts +0 -154
  168. package/ai/tools/deepseekOcrTool.ts +0 -34
  169. package/ai/tools/delayTool.ts +0 -31
  170. package/ai/tools/deleteSpacesTool.ts +0 -325
  171. package/ai/tools/deleteSpacesToolModel.ts +0 -159
  172. package/ai/tools/devReloadUtils.ts +0 -29
  173. package/ai/tools/dialogMessageSearch.ts +0 -137
  174. package/ai/tools/doctorSkillTool.ts +0 -72
  175. package/ai/tools/ecommerceScraperTool.ts +0 -86
  176. package/ai/tools/emailTools.ts +0 -549
  177. package/ai/tools/evalSkillTool.ts +0 -92
  178. package/ai/tools/exaSearchTool.ts +0 -64
  179. package/ai/tools/execBashTool.ts +0 -379
  180. package/ai/tools/executeSqlTool.ts +0 -192
  181. package/ai/tools/fetchWebpageSupport.ts +0 -309
  182. package/ai/tools/fetchWebpageTool.ts +0 -84
  183. package/ai/tools/geminiImagePreviewTool.ts +0 -361
  184. package/ai/tools/generateDocxTool.ts +0 -215
  185. package/ai/tools/googleSearchScraperTool.ts +0 -106
  186. package/ai/tools/importDataTool.ts +0 -133
  187. package/ai/tools/importSkillTool.ts +0 -162
  188. package/ai/tools/index.ts +0 -1858
  189. package/ai/tools/listFilesTool.ts +0 -82
  190. package/ai/tools/listUserSpacesTool.ts +0 -113
  191. package/ai/tools/modelUsageTools.ts +0 -142
  192. package/ai/tools/olmOcrTool.ts +0 -34
  193. package/ai/tools/openaiImageTool.ts +0 -218
  194. package/ai/tools/paddleOcrTool.ts +0 -34
  195. package/ai/tools/prepareTools.ts +0 -23
  196. package/ai/tools/readDocTool.ts +0 -84
  197. package/ai/tools/readFileTool.ts +0 -211
  198. package/ai/tools/readTool.ts +0 -163
  199. package/ai/tools/readXPostTool.ts +0 -233
  200. package/ai/tools/rememberMemoryTool.ts +0 -84
  201. package/ai/tools/remotionVideoTool.ts +0 -151
  202. package/ai/tools/searchDialogMessagesTool.ts +0 -222
  203. package/ai/tools/searchRepoTool.ts +0 -115
  204. package/ai/tools/searchWorkspaceTool.ts +0 -259
  205. package/ai/tools/skillFollowup.ts +0 -86
  206. package/ai/tools/surfWeatherTool.ts +0 -169
  207. package/ai/tools/table/addTableRowTool.ts +0 -217
  208. package/ai/tools/table/createTableTool.ts +0 -315
  209. package/ai/tools/table/rowTools.ts +0 -366
  210. package/ai/tools/table/schemaTools.ts +0 -244
  211. package/ai/tools/table/shareTableTool.ts +0 -148
  212. package/ai/tools/table/toolShared.ts +0 -129
  213. package/ai/tools/toolApiClient.ts +0 -198
  214. package/ai/tools/toolNameAliases.ts +0 -57
  215. package/ai/tools/toolResultError.ts +0 -42
  216. package/ai/tools/toolRunSlice.ts +0 -303
  217. package/ai/tools/toolSchemaCompatibility.ts +0 -53
  218. package/ai/tools/toolVisibility.ts +0 -4
  219. package/ai/tools/types.ts +0 -20
  220. package/ai/tools/uiAskChoiceTool.ts +0 -104
  221. package/ai/tools/updateContentTitleTool.ts +0 -84
  222. package/ai/tools/updateDocTool.ts +0 -105
  223. package/ai/tools/updateUserPreferenceProfileTool.ts +0 -145
  224. package/ai/tools/whisperTool.ts +0 -77
  225. package/ai/tools/writeFileTool.ts +0 -210
  226. package/ai/tools/youtubeScraperTool.ts +0 -116
  227. package/ai/tools/ziweiChartTool.ts +0 -678
  228. package/ai/types.ts +0 -55
  229. package/ai/workflow/workflowExecutor.ts +0 -323
  230. package/ai/workflow/workflowSlice.ts +0 -73
  231. package/ai/workflow/workflowTypes.ts +0 -106
  232. package/connector-experimental/index.ts +0 -5
package/ai/tools/index.ts DELETED
@@ -1,1858 +0,0 @@
1
- // 文件路径: ai/tools/index.ts
2
-
3
- /* ==================================================================
4
- * 所有 Tool 的统一注册与描述 (最终版:单一事实来源)
5
- * ==================================================================
6
- *
7
- * 如何使用:
8
- * 1. 为你的工具创建一个新文件 (例如 `myNewTool.ts`)。
9
- * 2. 在该文件中,导出函数的 schema 和 executor 函数。
10
- * 3. 在下面的 `toolDefinitions` 数组中,添加一个新的对象来定义你的工具
11
- * (或在对应分组文件中添加,然后在此汇总)。
12
- *
13
- * 此文件会自动生成 toolRegistry, toolExecutors, toolDescriptions,
14
- * 以及 toolDefinitionsByName。
15
- *
16
- * ================================================================== */
17
-
18
- // ---------- 1. 导入所有工具的 Schema 和 Executor ----------
19
- // 计划与编排
20
- import {
21
- createWorkflowFunctionSchema,
22
- createWorkflowFunc,
23
- } from "./createWorkflowTool";
24
- import { delayFunctionSchema, delayFunc } from "./delayTool";
25
- import {
26
- createScheduledTaskFunc,
27
- createScheduledTaskFunctionSchema,
28
- notifyUserFunc,
29
- notifyUserFunctionSchema,
30
- queryModelUsageFunc,
31
- queryModelUsageFunctionSchema,
32
- } from "./modelUsageTools";
33
-
34
- // Agent 相关工具的 schema(用于 patch enum),具体定义移到 agentTools.ts
35
- import { createAgentToolFunctionSchema } from "./agent/createAgentTool";
36
- import { updateAgentToolFunctionSchema } from "./agent/updateAgentTool";
37
-
38
- // 内容管理
39
- import { createDocFunctionSchema, createDocFunc } from "./createDocTool";
40
- import {
41
- createSkillDocFunctionSchema,
42
- createSkillDocFunc,
43
- } from "./createSkillDocTool";
44
- import { doctorSkillFunctionSchema, doctorSkillFunc } from "./doctorSkillTool";
45
- import { evalSkillFunctionSchema, evalSkillFunc } from "./evalSkillTool";
46
- import { importSkillFunctionSchema, importSkillFunc } from "./importSkillTool";
47
- import {
48
- readDocFunctionSchema,
49
- readDocFunc,
50
- readPageFunctionSchema,
51
- readPageFunc,
52
- } from "./readDocTool";
53
-
54
- // 分类相关工具集中在 ./category 文件夹
55
- import {
56
- createCategoryFunctionSchema,
57
- createCategoryFunc,
58
- } from "./category/createCategoryTool";
59
- import {
60
- updateContentCategoryFunctionSchema,
61
- updateContentCategoryFunc,
62
- } from "./category/updateContentCategoryTool";
63
- import {
64
- queryContentsByCategoryFunctionSchema,
65
- queryContentsByCategoryFunc,
66
- } from "./category/queryContentsByCategoryTool";
67
-
68
- // 数据操作
69
- import { importDataFunctionSchema, importDataFunc } from "./importDataTool";
70
- import { executeSqlFunctionSchema, executeSqlFunc } from "./executeSqlTool";
71
- import { readFunctionSchema, readFunc } from "./readTool";
72
- import {
73
- listUserSpacesFunctionSchema,
74
- listUserSpacesFunc,
75
- } from "./listUserSpacesTool";
76
- import {
77
- deleteSpacesFunctionSchema,
78
- deleteSpacesFunc,
79
- deleteSpacesPreviewFunc,
80
- } from "./deleteSpacesTool";
81
- import {
82
- emailArchiveFunc,
83
- emailArchiveFunctionSchema,
84
- emailExtractVerificationFunc,
85
- emailExtractVerificationFunctionSchema,
86
- emailProvisionIdentityFunc,
87
- emailProvisionIdentityFunctionSchema,
88
- emailReadFunc,
89
- emailReadFunctionSchema,
90
- emailSearchFunc,
91
- emailSearchFunctionSchema,
92
- emailSendFunc,
93
- emailSendFunctionSchema,
94
- emailUpdateTagsFunc,
95
- emailUpdateTagsFunctionSchema,
96
- emailWaitForFunc,
97
- emailWaitForFunctionSchema,
98
- } from "./emailTools";
99
- // ✅ 在当前表中新增一行的工具
100
- import {
101
- addTableRowFunctionSchema,
102
- addTableRowFunc,
103
- } from "./table/addTableRowTool";
104
- import {
105
- createTableFunctionSchema,
106
- createTableFunc,
107
- } from "./table/createTableTool";
108
- import {
109
- shareTableFunctionSchema,
110
- shareTableFunc,
111
- } from "./table/shareTableTool";
112
- import {
113
- addTableRowsFunctionSchema,
114
- addTableRowsFunc,
115
- deleteTableRowFunctionSchema,
116
- deleteTableRowFunc,
117
- deleteTableRowsFunctionSchema,
118
- deleteTableRowsFunc,
119
- queryTableRowsFunctionSchema,
120
- queryTableRowsFunc,
121
- updateTableRowFunctionSchema,
122
- updateTableRowFunc,
123
- updateTableRowsFunctionSchema,
124
- updateTableRowsFunc,
125
- } from "./table/rowTools";
126
- import {
127
- addTableColumnFunctionSchema,
128
- addTableColumnFunc,
129
- deleteTableColumnFunctionSchema,
130
- deleteTableColumnFunc,
131
- renameTableColumnFunctionSchema,
132
- renameTableColumnFunc,
133
- renameTableColumnLabelFunctionSchema,
134
- renameTableColumnLabelFunc,
135
- renameTableFunctionSchema,
136
- renameTableFunc,
137
- } from "./table/schemaTools";
138
-
139
- // 网络与智能
140
- import {
141
- fetchWebpageFunctionSchema,
142
- fetchWebpageFunc,
143
- } from "./fetchWebpageTool";
144
- import {
145
- readXPostFunctionSchema,
146
- readXPostFunc,
147
- } from "./readXPostTool";
148
- import {
149
- surfWeatherFunctionSchema,
150
- surfWeatherFunc,
151
- } from "./surfWeatherTool";
152
-
153
- import {
154
- browser_closeSession_Schema,
155
- browser_closeSession_Func,
156
- } from "./browserTools/closeSession";
157
- import {
158
- browser_openSession_Schema,
159
- browser_openSession_Func,
160
- } from "./browserTools/openSession";
161
- import {
162
- browser_selectOption_Schema,
163
- browser_selectOption_Func,
164
- } from "./browserTools/selectOption";
165
- import {
166
- browser_click_Schema,
167
- browser_click_Func,
168
- } from "./browserTools/click";
169
- import {
170
- browser_typeText_Schema,
171
- browser_typeText_Func,
172
- } from "./browserTools/typeText";
173
- import {
174
- browser_readContent_Schema,
175
- browser_readContent_Func,
176
- } from "./browserTools/readContent";
177
- import {
178
- exaSearchSchema,
179
- exaSearchFunc,
180
- } from "./exaSearchTool";
181
- import {
182
- paddleOcrSchema,
183
- paddleOcrFunc,
184
- } from "./paddleOcrTool";
185
- import {
186
- olmOcrSchema,
187
- olmOcrFunc,
188
- } from "./olmOcrTool";
189
- import {
190
- whisperTurboSchema,
191
- whisperTurboFunc,
192
- whisperV3Schema,
193
- whisperV3Func,
194
- } from "./whisperTool";
195
-
196
-
197
-
198
-
199
- // ✅ generateDocx 工具(前端生成并下载 DOCX)
200
- import {
201
- generateDocxFunctionSchema,
202
- generateDocxFunc,
203
- } from "./generateDocxTool";
204
-
205
- // ✅ Google Search Scraper (Apify)
206
- import {
207
- googleSearchScraperFunctionSchema,
208
- googleSearchScraperFunc,
209
- } from "./googleSearchScraperTool";
210
-
211
- // ✅ Cloudflare Browser Rendering 爬取工具
212
- import {
213
- cloudflareCrawlFunctionSchema,
214
- cloudflareCrawlFunc,
215
- cloudflareCrawlStatusFunctionSchema,
216
- cloudflareCrawlStatusFunc,
217
- } from "./cloudflareCrawlTool";
218
-
219
- // ✅ Apify / 抓取相关工具
220
- import {
221
- youtubeScraperFunctionSchema,
222
- youtubeScraperFunc,
223
- } from "./youtubeScraperTool";
224
- import {
225
- ecommerceScraperFunctionSchema,
226
- ecommerceScraperFunc,
227
- } from "./ecommerceScraperTool";
228
- import {
229
- amazonProductScraperFunctionSchema,
230
- amazonProductScraperFunc,
231
- } from "./amazonProductScraperTool";
232
-
233
- // ✅ 多模态:Gemini 图片(2.5 Flash 文生图 / 3 Pro 编辑)
234
- import {
235
- geminiFlashImageFunctionSchema,
236
- geminiFlashImageFunc,
237
- geminiProImagePreviewFunctionSchema,
238
- geminiProImagePreviewFunc,
239
- } from "./geminiImagePreviewTool";
240
- import {
241
- openAIGptImageFunctionSchema,
242
- openAIGptImageFunc,
243
- } from "./openaiImageTool";
244
- import {
245
- remotionRenderVideoFunctionSchema,
246
- remotionRenderVideoFunc,
247
- } from "./remotionVideoTool";
248
- import { uiAskChoiceFunc, uiAskChoiceFunctionSchema } from "./uiAskChoiceTool";
249
- import {
250
- rememberMemoryFunc,
251
- rememberMemoryFunctionSchema,
252
- } from "./rememberMemoryTool";
253
- import { execBashFunctionSchema, execBashFunc, execShellFunctionSchema, execShellFunc } from "./execBashTool";
254
- import { checkEnvFunctionSchema, checkEnvFunc } from "./checkEnvTool";
255
-
256
- import { agentToolDefinitions } from "./agent/agentTools";
257
- import { codeToolDefinitions } from "./codeTools";
258
- import {
259
- cfScreenshotFunctionSchema,
260
- cfScreenshotFunc,
261
- cfGetMarkdownFunctionSchema,
262
- cfGetMarkdownFunc,
263
- cfGeneratePDFFunctionSchema,
264
- cfGeneratePDFFunc,
265
- cfExtractJSONFunctionSchema,
266
- cfExtractJSONFunc,
267
- } from "./cfBrowserTools";
268
- import {
269
- appPreflightFunctionSchema,
270
- appPreflightFunc,
271
- appDeployFunctionSchema,
272
- appDeployFunc,
273
- appListFunctionSchema,
274
- appListFunc,
275
- appDeleteFunctionSchema,
276
- appDeleteFunc,
277
- appReadFunctionSchema,
278
- appReadFunc,
279
- } from "./appTools";
280
- import {
281
- cfSpeechToTextFunctionSchema,
282
- cfSpeechToTextFunc,
283
- } from "./cfSpeechToTextTool";
284
- import {
285
- updateContentTitleTool,
286
- updateContentTitleFunc,
287
- } from "./updateContentTitleTool";
288
- import {
289
- searchAllSpacesFunc,
290
- searchAllSpacesFunctionSchema,
291
- searchWorkspaceFunctionSchema,
292
- searchWorkspaceFunc,
293
- } from "./searchWorkspaceTool";
294
- import {
295
- searchDialogMessagesFunc,
296
- searchDialogMessagesFunctionSchema,
297
- } from "./searchDialogMessagesTool";
298
- import {
299
- updateDocFunctionSchema,
300
- updateDocFunc,
301
- } from "./updateDocTool";
302
- import {
303
- updateUserPreferenceProfileFunctionSchema,
304
- updateUserPreferenceProfileFunc,
305
- } from "./updateUserPreferenceProfileTool";
306
- import {
307
- ziweiChartFunctionSchema,
308
- ziweiChartFunc,
309
- } from "./ziweiChartTool";
310
-
311
-
312
- // ---------- 2. 定义工具规范接口 ----------
313
-
314
- export type ToolBehavior = "orchestrator" | "data" | "action" | "answer";
315
- export type ToolCapability =
316
- | "knowledge_capture"
317
- | "space_context"
318
- | "self_evolution"
319
- | "web_access"
320
- | "browser_automation"
321
- | "code_edit"
322
- | "app_deploy"
323
- | "general";
324
- export type ToolRiskLevel = "low" | "medium" | "high";
325
- export type ToolCostLevel = "low" | "medium" | "high";
326
- export type ToolConsentMode = "auto" | "ask" | "blocked";
327
-
328
- // 交互模式:
329
- // - auto: 直接执行
330
- // - confirm: 需要用户确认后才执行(危险操作)
331
- // - authorize: 需要用户授权后才执行(权限/敏感资源)
332
- export type ToolInteraction = "auto" | "confirm" | "authorize";
333
-
334
- /**
335
- * 前端分组用:
336
- * - general: 普通
337
- * - agent : Agent / 应用相关
338
- * - content: 内容与页面
339
- * - media : 多媒体(生成图片 / 生成视频等)
340
- * - data : 数据操作
341
- */
342
- export type ToolUiGroup = "general" | "agent" | "content" | "media" | "data";
343
-
344
- /**
345
- * 分组元信息:
346
- * - id: 分组 ID(与 ToolUiGroup 一致)
347
- * - label: 默认中文标题(前端可直接用,也可以自己做 i18n 映射)
348
- * - order: 分组显示顺序(从小到大)
349
- * - fallbackCategories:
350
- * 当某个工具没有显式指定 uiGroup 时,可以根据工具的 category 使用兜底分组。
351
- */
352
- export interface ToolGroupMeta {
353
- id: ToolUiGroup;
354
- label: string;
355
- order: number;
356
- fallbackCategories?: string[];
357
- }
358
-
359
- /**
360
- * 单一事实来源:所有分组配置
361
- * 以后增加 / 修改分组,只需要改这里一处。
362
- */
363
- export const TOOL_GROUP_META: ToolGroupMeta[] = [
364
- {
365
- id: "general",
366
- label: "普通",
367
- order: 0,
368
- },
369
- {
370
- id: "agent",
371
- label: "Agent / 应用",
372
- order: 1,
373
- },
374
- {
375
- id: "content",
376
- label: "内容与页面",
377
- order: 2,
378
- fallbackCategories: ["内容管理"],
379
- },
380
- {
381
- id: "media",
382
- label: "多媒体生成",
383
- order: 3,
384
- fallbackCategories: ["多媒体生成"],
385
- },
386
- {
387
- id: "data",
388
- label: "数据操作",
389
- order: 4,
390
- fallbackCategories: ["数据操作"],
391
- },
392
- ];
393
-
394
- export interface ToolDefinition {
395
- id: string; // 唯一ID (camelCase)
396
- schema: any; // 提供给 LLM 的函数 Schema
397
-
398
- executor: (
399
- args: any,
400
- thunkApi: any,
401
- context?: { parentMessageId: string; signal?: AbortSignal; toolRunId?: string }
402
- ) => Promise<any>;
403
-
404
- /**
405
- * ✅ 新增:预览执行(无副作用)
406
- * - 仅当 interaction 为 confirm/authorize 时会被调用
407
- * - 用于生成 “待确认/待授权” 阶段的 tool message content(预览输出)
408
- */
409
- previewExecutor?: (
410
- args: any,
411
- thunkApi: any,
412
- context?: { parentMessageId: string; signal?: AbortSignal; toolRunId?: string }
413
- ) => Promise<any>;
414
-
415
- description: {
416
- name: string;
417
- description: string;
418
- category: string;
419
- };
420
-
421
- behavior?: ToolBehavior; // 工具在系统中的角色
422
- capability?: ToolCapability; // 用户策略与预算主要按 capability 生效
423
- interaction?: ToolInteraction; // 不写默认 "auto"
424
- uiGroup?: ToolUiGroup; // 前端展示分组,不写默认 "general"
425
- riskLevel?: ToolRiskLevel;
426
- costLevel?: ToolCostLevel;
427
- defaultConsent?: ToolConsentMode;
428
-
429
- /**
430
- * ✅ 新增:是否支持取消(未来 executeToolRun 传 signal 后即可实现)
431
- * - 现在先作为 UI/能力标记预留,不影响 DB 结构
432
- */
433
- cancelable?: boolean;
434
-
435
- /**
436
- * ✅ 新增:授权相关元信息预留(未来可扩展,不强制使用)
437
- * - 现在不实现授权策略,仅留接口,避免未来改 DB/大改代码
438
- */
439
- auth?: {
440
- kind: "domain" | "resource" | "scopes";
441
- scopeHint?: string; // 给 UI/日志的提示
442
- };
443
- }
444
-
445
- /**
446
- * 能力分级定义 (Capability Tiers)
447
- */
448
- export const TOOL_PACKS = {
449
- // L1 - 核心:交互 + 记忆读写 + 自我更新,所有 Agent 必有
450
- CORE: ["ui_ask_choice", "rememberMemory", "read", "searchDialogMessages", "createDoc", "updateDoc", "search_workspace", "search_all_spaces", "updateSelf", "queryModelUsage", "createScheduledTask", "notifyUser"],
451
- // L2 - 联网搜索:配置了 tools 的 Agent 默认加,纯 QA bot 不加
452
- LIGHT_WEB: ["exa_search", "read_x_post"],
453
- // L3 - 深度浏览器:全套复杂网页交互
454
- FULL_BROWSER: [
455
- "browser_openSession",
456
- "browser_closeSession",
457
- "browser_click",
458
- "browser_typeText",
459
- "browser_readContent",
460
- "browser_selectOption",
461
- "fetchWebpage",
462
- ],
463
- };
464
-
465
- /* ==================================================================
466
- * 2.1 toolquery 工具:帮助模型发现可用工具
467
- * ================================================================== */
468
-
469
- export const toolQueryFunctionSchema = {
470
- name: "toolquery",
471
- description:
472
- "根据当前任务描述,列出系统中可能有用的工具。适合在不确定可用工具时先调用本函数。",
473
- parameters: {
474
- type: "object",
475
- properties: {
476
- task: {
477
- type: "string",
478
- description: "用户当前的任务或需求描述。",
479
- },
480
- top_k: {
481
- type: "number",
482
- description: "最多返回多少个候选工具(默认 5)。",
483
- default: 5,
484
- },
485
- },
486
- required: ["task"],
487
- },
488
- };
489
-
490
- export async function toolQueryFunc(args: any): Promise<{
491
- rawData: any;
492
- displayData: string;
493
- }> {
494
- const { task, top_k } = args || {};
495
- const query = String(task || "").trim();
496
- const topK = typeof top_k === "number" && top_k > 0 && top_k < 50 ? top_k : 5;
497
-
498
- if (!query) {
499
- const msg = "toolquery 需要提供 task 描述,比如:'分析数据库相关的工具'。";
500
- return { rawData: [], displayData: msg };
501
- }
502
-
503
- const lowered = query.toLowerCase();
504
-
505
- const candidates = toolDefinitions
506
- .filter((tool) => tool.id !== "toolquery")
507
- .map((tool) => {
508
- const { description, behavior } = tool;
509
- const haystack =
510
- `${description.name} ${description.description} ${description.category} ${behavior || ""}`.toLowerCase();
511
- const score = haystack.includes(lowered) ? 1 : 0;
512
- return { tool, score };
513
- })
514
- .filter((item) => item.score > 0)
515
- .slice(0, topK);
516
-
517
- const rawData = candidates.map(({ tool }) => ({
518
- name: tool.schema.name,
519
- id: tool.id,
520
- description: tool.description.description,
521
- category: tool.description.category,
522
- behavior: tool.behavior ?? null,
523
- }));
524
-
525
- let displayData: string;
526
-
527
- if (rawData.length === 0) {
528
- displayData =
529
- `根据当前描述暂时没有找到明显匹配的工具。\n` +
530
- `你可以尝试:\n` +
531
- `- 换一种更具体的说法描述任务\n` +
532
- `- 直接选择你认为合适的工具调用`;
533
- } else {
534
- displayData =
535
- `根据你的任务描述,我找到了 ${rawData.length} 个可能有用的工具:\n\n` +
536
- rawData
537
- .map((t: any, idx: number) => {
538
- const behaviorLabel = t.behavior ? `,类型:${t.behavior}` : "";
539
- return `${idx + 1}. \`${t.name}\`(${t.category}${behaviorLabel})\n - ${t.description}`;
540
- })
541
- .join("\n");
542
- }
543
-
544
- return { rawData, displayData };
545
- }
546
-
547
- /* ==================================================================
548
- * 3. [核心] 单一事实来源:在此处定义所有工具
549
- * ================================================================== */
550
-
551
- // 这里保留“非 Agent / 非代码”的工具定义,
552
- // Agent 工具在 agentTools.ts,代码相关工具在 codeTools.ts。
553
- const baseToolDefinitions: ToolDefinition[] = [
554
- {
555
- id: "uiAskChoice",
556
- schema: uiAskChoiceFunctionSchema,
557
- executor: uiAskChoiceFunc,
558
- description: {
559
- name: "ui_ask_choice",
560
- description:
561
- "向用户提出一个带多个选项的问题,让界面展示按钮供用户选择。",
562
- category: "交互 / UI",
563
- },
564
- behavior: "answer",
565
- },
566
- {
567
- id: "rememberMemory",
568
- schema: rememberMemoryFunctionSchema,
569
- executor: rememberMemoryFunc,
570
- description: {
571
- name: "rememberMemory",
572
- description: "将值得长期保留的用户偏好或空间共识写入一条 episodic memory。",
573
- category: "记忆 / 长期上下文",
574
- },
575
- behavior: "action",
576
- },
577
- {
578
- id: "updateUserPreferenceProfile",
579
- schema: updateUserPreferenceProfileFunctionSchema,
580
- executor: updateUserPreferenceProfileFunc,
581
- description: {
582
- name: "updateUserPreferenceProfile",
583
- description: "保存用户的语气、知识沉淀、空间读取等个性化偏好设置。",
584
- category: "用户设置 / 个性化",
585
- },
586
- behavior: "action",
587
- },
588
- {
589
- id: "ziweiChart",
590
- schema: ziweiChartFunctionSchema,
591
- executor: ziweiChartFunc,
592
- description: {
593
- name: "ziweiChart",
594
- description: "生成紫微斗数本命盘,并输出可读的十二宫文字盘。",
595
- category: "命理 / 排盘",
596
- },
597
- behavior: "answer",
598
- capability: "general",
599
- uiGroup: "general",
600
- riskLevel: "low",
601
- costLevel: "low",
602
- defaultConsent: "auto",
603
- },
604
-
605
- // --- 计划与编排(不含 Agent 专用) ---
606
- {
607
- id: "createWorkflow",
608
- schema: createWorkflowFunctionSchema,
609
- executor: createWorkflowFunc,
610
- description: {
611
- name: "createWorkflow",
612
- description:
613
- "当执行路径已知时,定义并执行一个多步骤 workflow。引擎自动运行,无需每步调用 LLM,大幅节省 token。",
614
- category: "计划与编排",
615
- },
616
- behavior: "orchestrator",
617
- },
618
- {
619
- id: "toolquery",
620
- schema: toolQueryFunctionSchema,
621
- executor: toolQueryFunc,
622
- description: {
623
- name: "toolquery",
624
- description:
625
- "根据任务描述列出可能有用的工具,帮助你选择合适的工具链。",
626
- category: "计划与编排",
627
- },
628
- behavior: "answer",
629
- },
630
- {
631
- id: "delay",
632
- schema: delayFunctionSchema,
633
- executor: delayFunc,
634
- description: {
635
- name: "delay",
636
- description:
637
- "让计划暂停一小段时间(毫秒),用于节流批量操作(例如连续下载多个文件)。",
638
- category: "计划与编排",
639
- },
640
- behavior: "action",
641
- },
642
- {
643
- id: "queryModelUsage",
644
- schema: queryModelUsageFunctionSchema,
645
- executor: queryModelUsageFunc,
646
- description: {
647
- name: "queryModelUsage",
648
- description:
649
- "查询模型/API 用量与费用,带用户/管理员权限限制,可用于每日用量告警。",
650
- category: "计费 / 用量",
651
- },
652
- behavior: "answer",
653
- uiGroup: "general",
654
- capability: "general",
655
- riskLevel: "low",
656
- costLevel: "low",
657
- defaultConsent: "auto",
658
- },
659
- {
660
- id: "createScheduledTask",
661
- schema: createScheduledTaskFunctionSchema,
662
- executor: createScheduledTaskFunc,
663
- description: {
664
- name: "createScheduledTask",
665
- description:
666
- "创建由 agent 执行的 cron 定时任务,可选择创建后立即试运行一次。",
667
- category: "计划与编排",
668
- },
669
- behavior: "action",
670
- uiGroup: "general",
671
- capability: "general",
672
- riskLevel: "medium",
673
- costLevel: "low",
674
- defaultConsent: "ask",
675
- },
676
- {
677
- id: "notifyUser",
678
- schema: notifyUserFunctionSchema,
679
- executor: notifyUserFunc,
680
- description: {
681
- name: "notifyUser",
682
- description: "发送站内通知给当前用户,用于告警和任务结果提醒。",
683
- category: "通知",
684
- },
685
- behavior: "action",
686
- uiGroup: "general",
687
- capability: "general",
688
- riskLevel: "low",
689
- costLevel: "low",
690
- defaultConsent: "auto",
691
- },
692
-
693
- // --- 内容管理 ---
694
- {
695
- id: "createDoc",
696
- schema: createDocFunctionSchema,
697
- executor: createDocFunc,
698
- description: {
699
- name: "createDoc",
700
- description: "在当前空间中创建新页面",
701
- category: "内容管理",
702
- },
703
- behavior: "action",
704
- uiGroup: "content",
705
- capability: "knowledge_capture",
706
- riskLevel: "medium",
707
- costLevel: "medium",
708
- defaultConsent: "ask",
709
- },
710
- {
711
- id: "createSkillDoc",
712
- schema: createSkillDocFunctionSchema,
713
- executor: createSkillDocFunc,
714
- description: {
715
- name: "createSkillDoc",
716
- description: "创建带 skill-config / eval-config 协议块的本地 skill 文档。",
717
- category: "内容管理",
718
- },
719
- behavior: "action",
720
- uiGroup: "content",
721
- capability: "knowledge_capture",
722
- riskLevel: "medium",
723
- costLevel: "medium",
724
- defaultConsent: "ask",
725
- },
726
- {
727
- id: "doctorSkill",
728
- schema: doctorSkillFunctionSchema,
729
- executor: doctorSkillFunc,
730
- description: {
731
- name: "doctorSkill",
732
- description: "诊断 skill 文档协议、工具绑定和常见问题。",
733
- category: "内容管理",
734
- },
735
- behavior: "answer",
736
- uiGroup: "content",
737
- capability: "knowledge_capture",
738
- riskLevel: "low",
739
- costLevel: "low",
740
- },
741
- {
742
- id: "evalSkill",
743
- schema: evalSkillFunctionSchema,
744
- executor: evalSkillFunc,
745
- description: {
746
- name: "evalSkill",
747
- description: "根据 eval-config 评估一个 skill 文档是否满足预期。",
748
- category: "内容管理",
749
- },
750
- behavior: "answer",
751
- uiGroup: "content",
752
- capability: "knowledge_capture",
753
- riskLevel: "low",
754
- costLevel: "low",
755
- },
756
- {
757
- id: "importSkill",
758
- schema: importSkillFunctionSchema,
759
- executor: importSkillFunc,
760
- description: {
761
- name: "importSkill",
762
- description: "导入外部 SKILL.md 或 Markdown skill 文档到当前空间。",
763
- category: "内容管理",
764
- },
765
- behavior: "action",
766
- uiGroup: "content",
767
- capability: "knowledge_capture",
768
- riskLevel: "medium",
769
- costLevel: "medium",
770
- defaultConsent: "ask",
771
- },
772
- {
773
- id: "readDoc",
774
- schema: readDocFunctionSchema,
775
- executor: readDocFunc,
776
- description: {
777
- name: "readDoc",
778
- description: "读取指定文档/页面的内容(Markdown 格式)",
779
- category: "内容管理",
780
- },
781
- behavior: "data",
782
- uiGroup: "content",
783
- capability: "space_context",
784
- riskLevel: "low",
785
- costLevel: "medium",
786
- },
787
- {
788
- id: "readPage",
789
- schema: readPageFunctionSchema,
790
- executor: readPageFunc,
791
- description: {
792
- name: "readPage",
793
- description: "读取指定页面的内容(Markdown 格式,兼容旧名称)",
794
- category: "内容管理",
795
- },
796
- behavior: "data",
797
- uiGroup: "content",
798
- capability: "space_context",
799
- riskLevel: "low",
800
- costLevel: "medium",
801
- },
802
- {
803
- id: "updateDoc",
804
- schema: updateDocFunctionSchema,
805
- executor: updateDocFunc,
806
- description: {
807
- name: "updateDoc",
808
- description: "更新指定页面/文档的内容。支持全量覆盖或在末尾追加内容。",
809
- category: "内容管理",
810
- },
811
- behavior: "action",
812
- uiGroup: "content",
813
- capability: "knowledge_capture",
814
- riskLevel: "medium",
815
- costLevel: "medium",
816
- defaultConsent: "ask",
817
- },
818
- {
819
- id: "searchWorkspace",
820
- schema: searchWorkspaceFunctionSchema,
821
- executor: searchWorkspaceFunc,
822
- description: {
823
- name: "search_workspace",
824
- description: "在当前空间(Workspace)中搜索页面、表格等内容。",
825
- category: "内容管理",
826
- },
827
- behavior: "data",
828
- uiGroup: "content",
829
- capability: "space_context",
830
- riskLevel: "low",
831
- costLevel: "low",
832
- },
833
- {
834
- id: "searchAllSpaces",
835
- schema: searchAllSpacesFunctionSchema,
836
- executor: searchAllSpacesFunc,
837
- description: {
838
- name: "search_all_spaces",
839
- description: "在你可访问的全部空间中搜索页面、表格等内容,并返回所属空间。",
840
- category: "内容管理",
841
- },
842
- behavior: "data",
843
- uiGroup: "content",
844
- capability: "space_context",
845
- riskLevel: "low",
846
- costLevel: "medium",
847
- },
848
- {
849
- id: "searchDialogMessages",
850
- schema: searchDialogMessagesFunctionSchema,
851
- executor: searchDialogMessagesFunc,
852
- description: {
853
- name: "searchDialogMessages",
854
- description: "在指定对话的原始消息中搜索文本,并返回命中的 messageId、角色、原文片段和邻近上下文。",
855
- category: "内容管理",
856
- },
857
- behavior: "data",
858
- uiGroup: "content",
859
- capability: "space_context",
860
- riskLevel: "low",
861
- costLevel: "low",
862
- },
863
- {
864
- id: "createCategory",
865
- schema: createCategoryFunctionSchema,
866
- executor: createCategoryFunc,
867
- description: {
868
- name: "createCategory",
869
- description: "在当前空间中创建新分类",
870
- category: "内容管理",
871
- },
872
- behavior: "action",
873
- uiGroup: "content",
874
- },
875
- {
876
- id: "updateContentCategory",
877
- schema: updateContentCategoryFunctionSchema,
878
- executor: updateContentCategoryFunc,
879
- description: {
880
- name: "updateContentCategory",
881
- description: "更新内容的分类",
882
- category: "内容管理",
883
- },
884
- behavior: "action",
885
- uiGroup: "content",
886
- },
887
- {
888
- id: "queryContentsByCategory",
889
- schema: queryContentsByCategoryFunctionSchema,
890
- executor: queryContentsByCategoryFunc,
891
- description: {
892
- name: "queryContentsByCategory",
893
- description: "查询分类下的所有内容",
894
- category: "内容管理",
895
- },
896
- behavior: "data",
897
- uiGroup: "content",
898
- },
899
-
900
- // --- 数据操作 ---
901
- {
902
- id: "createTable",
903
- schema: createTableFunctionSchema,
904
- executor: createTableFunc,
905
- description: {
906
- name: "createTable",
907
- description: "在当前租户下创建一张新的数据表,并定义字段结构。",
908
- category: "数据操作",
909
- },
910
- behavior: "action",
911
- uiGroup: "data",
912
- capability: "knowledge_capture",
913
- riskLevel: "medium",
914
- costLevel: "medium",
915
- defaultConsent: "ask",
916
- },
917
- {
918
- id: "shareTable",
919
- schema: shareTableFunctionSchema,
920
- executor: shareTableFunc,
921
- description: {
922
- name: "shareTable",
923
- description: "把表发布为可分享链接,可用于社区分享。",
924
- category: "数据操作",
925
- },
926
- behavior: "action",
927
- uiGroup: "data",
928
- riskLevel: "medium",
929
- costLevel: "low",
930
- defaultConsent: "ask",
931
- },
932
- {
933
- id: "importData",
934
- schema: importDataFunctionSchema,
935
- executor: importDataFunc,
936
- description: {
937
- name: "importData",
938
- description: "将用户上传的文件数据导入数据库表",
939
- category: "数据操作",
940
- },
941
- behavior: "data",
942
- uiGroup: "data",
943
- capability: "space_context",
944
- riskLevel: "low",
945
- costLevel: "medium",
946
- },
947
- {
948
- id: "executeSql",
949
- schema: executeSqlFunctionSchema,
950
- executor: executeSqlFunc,
951
- description: {
952
- name: "executeSql",
953
- description: "直接执行 SQL 语句",
954
- category: "数据操作",
955
- },
956
- behavior: "data",
957
- uiGroup: "data",
958
- },
959
- {
960
- id: "read",
961
- schema: readFunctionSchema,
962
- executor: readFunc,
963
- description: {
964
- name: "read",
965
- description:
966
- "根据指定的 dbKey 从本地/远程数据库读取一条记录,可选择本地优先或等待远程结果。",
967
- category: "数据操作",
968
- },
969
- behavior: "data",
970
- uiGroup: "data",
971
- },
972
- {
973
- id: "email_provision_identity",
974
- schema: emailProvisionIdentityFunctionSchema,
975
- executor: emailProvisionIdentityFunc,
976
- description: {
977
- name: "email_provision_identity",
978
- description: "为 agent 生成并绑定受控域名邮箱身份。",
979
- category: "数据操作",
980
- },
981
- behavior: "action",
982
- uiGroup: "data",
983
- riskLevel: "medium",
984
- costLevel: "low",
985
- defaultConsent: "ask",
986
- },
987
- {
988
- id: "email_send",
989
- schema: emailSendFunctionSchema,
990
- executor: emailSendFunc,
991
- description: {
992
- name: "email_send",
993
- description: "以 agent 已绑定邮箱身份发送邮件。",
994
- category: "数据操作",
995
- },
996
- behavior: "action",
997
- uiGroup: "data",
998
- riskLevel: "medium",
999
- costLevel: "low",
1000
- defaultConsent: "ask",
1001
- },
1002
- {
1003
- id: "email_wait_for",
1004
- schema: emailWaitForFunctionSchema,
1005
- executor: emailWaitForFunc,
1006
- description: {
1007
- name: "email_wait_for",
1008
- description: "等待符合条件的邮件到达。",
1009
- category: "数据操作",
1010
- },
1011
- behavior: "data",
1012
- uiGroup: "data",
1013
- riskLevel: "low",
1014
- costLevel: "low",
1015
- },
1016
- {
1017
- id: "email_extract_verification",
1018
- schema: emailExtractVerificationFunctionSchema,
1019
- executor: emailExtractVerificationFunc,
1020
- description: {
1021
- name: "email_extract_verification",
1022
- description: "从邮件中提取验证码和验证链接。",
1023
- category: "数据操作",
1024
- },
1025
- behavior: "data",
1026
- uiGroup: "data",
1027
- riskLevel: "low",
1028
- costLevel: "low",
1029
- },
1030
- {
1031
- id: "email_search",
1032
- schema: emailSearchFunctionSchema,
1033
- executor: emailSearchFunc,
1034
- description: {
1035
- name: "email_search",
1036
- description: "查询当前主体可访问的邮件列表。",
1037
- category: "数据操作",
1038
- },
1039
- behavior: "data",
1040
- uiGroup: "data",
1041
- riskLevel: "low",
1042
- costLevel: "low",
1043
- },
1044
- {
1045
- id: "email_read",
1046
- schema: emailReadFunctionSchema,
1047
- executor: emailReadFunc,
1048
- description: {
1049
- name: "email_read",
1050
- description: "读取一封邮件的完整内容。",
1051
- category: "数据操作",
1052
- },
1053
- behavior: "data",
1054
- uiGroup: "data",
1055
- riskLevel: "low",
1056
- costLevel: "low",
1057
- },
1058
- {
1059
- id: "email_update_tags",
1060
- schema: emailUpdateTagsFunctionSchema,
1061
- executor: emailUpdateTagsFunc,
1062
- description: {
1063
- name: "email_update_tags",
1064
- description: "替换一封邮件的 tags。",
1065
- category: "数据操作",
1066
- },
1067
- behavior: "action",
1068
- uiGroup: "data",
1069
- riskLevel: "medium",
1070
- costLevel: "low",
1071
- },
1072
- {
1073
- id: "email_archive",
1074
- schema: emailArchiveFunctionSchema,
1075
- executor: emailArchiveFunc,
1076
- description: {
1077
- name: "email_archive",
1078
- description: "把一封邮件移动到 archive mailbox。",
1079
- category: "数据操作",
1080
- },
1081
- behavior: "action",
1082
- uiGroup: "data",
1083
- riskLevel: "medium",
1084
- costLevel: "low",
1085
- },
1086
- {
1087
- id: "addTableRow",
1088
- schema: addTableRowFunctionSchema,
1089
- executor: addTableRowFunc,
1090
- description: {
1091
- name: "addTableRow",
1092
- description:
1093
- "在当前已打开的表中新增一行数据,通常由 AI 根据分析结果自动填充各列。",
1094
- category: "数据操作",
1095
- },
1096
- behavior: "action",
1097
- uiGroup: "data",
1098
- },
1099
- {
1100
- id: "queryTableRows",
1101
- schema: queryTableRowsFunctionSchema,
1102
- executor: queryTableRowsFunc,
1103
- description: {
1104
- name: "queryTableRows",
1105
- description: "查询指定表中的行,支持过滤、排序和分页。",
1106
- category: "数据操作",
1107
- },
1108
- behavior: "data",
1109
- uiGroup: "data",
1110
- },
1111
- {
1112
- id: "updateTableRow",
1113
- schema: updateTableRowFunctionSchema,
1114
- executor: updateTableRowFunc,
1115
- description: {
1116
- name: "updateTableRow",
1117
- description: "更新表中的单行数据。",
1118
- category: "数据操作",
1119
- },
1120
- behavior: "action",
1121
- uiGroup: "data",
1122
- },
1123
- {
1124
- id: "deleteTableRow",
1125
- schema: deleteTableRowFunctionSchema,
1126
- executor: deleteTableRowFunc,
1127
- description: {
1128
- name: "deleteTableRow",
1129
- description: "删除表中的单行数据。",
1130
- category: "数据操作",
1131
- },
1132
- behavior: "action",
1133
- uiGroup: "data",
1134
- },
1135
- {
1136
- id: "addTableRows",
1137
- schema: addTableRowsFunctionSchema,
1138
- executor: addTableRowsFunc,
1139
- description: {
1140
- name: "addTableRows",
1141
- description: "批量向表中新增多行数据。",
1142
- category: "数据操作",
1143
- },
1144
- behavior: "action",
1145
- uiGroup: "data",
1146
- },
1147
- {
1148
- id: "updateTableRows",
1149
- schema: updateTableRowsFunctionSchema,
1150
- executor: updateTableRowsFunc,
1151
- description: {
1152
- name: "updateTableRows",
1153
- description: "批量更新表中的多行数据。",
1154
- category: "数据操作",
1155
- },
1156
- behavior: "action",
1157
- uiGroup: "data",
1158
- },
1159
- {
1160
- id: "deleteTableRows",
1161
- schema: deleteTableRowsFunctionSchema,
1162
- executor: deleteTableRowsFunc,
1163
- description: {
1164
- name: "deleteTableRows",
1165
- description: "批量删除表中的多行数据。",
1166
- category: "数据操作",
1167
- },
1168
- behavior: "action",
1169
- uiGroup: "data",
1170
- },
1171
- {
1172
- id: "addTableColumn",
1173
- schema: addTableColumnFunctionSchema,
1174
- executor: addTableColumnFunc,
1175
- description: {
1176
- name: "addTableColumn",
1177
- description: "向表中新增字段。",
1178
- category: "数据操作",
1179
- },
1180
- behavior: "action",
1181
- uiGroup: "data",
1182
- },
1183
- {
1184
- id: "deleteTableColumn",
1185
- schema: deleteTableColumnFunctionSchema,
1186
- executor: deleteTableColumnFunc,
1187
- description: {
1188
- name: "deleteTableColumn",
1189
- description: "删除表中的字段,并同步清理现有行数据。",
1190
- category: "数据操作",
1191
- },
1192
- behavior: "action",
1193
- uiGroup: "data",
1194
- },
1195
- {
1196
- id: "renameTableColumn",
1197
- schema: renameTableColumnFunctionSchema,
1198
- executor: renameTableColumnFunc,
1199
- description: {
1200
- name: "renameTableColumn",
1201
- description: "修改表字段的 machine name,并迁移已有行数据。",
1202
- category: "数据操作",
1203
- },
1204
- behavior: "action",
1205
- uiGroup: "data",
1206
- },
1207
- {
1208
- id: "renameTableColumnLabel",
1209
- schema: renameTableColumnLabelFunctionSchema,
1210
- executor: renameTableColumnLabelFunc,
1211
- description: {
1212
- name: "renameTableColumnLabel",
1213
- description: "修改表字段的显示名。",
1214
- category: "数据操作",
1215
- },
1216
- behavior: "action",
1217
- uiGroup: "data",
1218
- },
1219
- {
1220
- id: "renameTable",
1221
- schema: renameTableFunctionSchema,
1222
- executor: renameTableFunc,
1223
- description: {
1224
- name: "renameTable",
1225
- description: "更新表的显示名称。",
1226
- category: "数据操作",
1227
- },
1228
- behavior: "action",
1229
- uiGroup: "data",
1230
- },
1231
- {
1232
- id: "updateContentTitle",
1233
- schema: updateContentTitleTool.function,
1234
- executor: updateContentTitleFunc as any,
1235
- description: {
1236
- name: "update_content_title",
1237
- description: "更新当前空间中某个内容的标题",
1238
- category: "内容管理",
1239
- },
1240
- behavior: "action",
1241
- uiGroup: "content",
1242
- },
1243
- // === Space 导航工具 ===
1244
- {
1245
- id: "listUserSpaces",
1246
- schema: listUserSpacesFunctionSchema,
1247
- executor: listUserSpacesFunc,
1248
- description: {
1249
- name: "listUserSpaces",
1250
- description:
1251
- "获取当前用户可访问的所有 Space 列表(概览),只返回 ID 和名称。",
1252
- category: "数据操作",
1253
- },
1254
- behavior: "data",
1255
- uiGroup: "data",
1256
- },
1257
- {
1258
- id: "deleteSpaces",
1259
- schema: deleteSpacesFunctionSchema,
1260
- executor: deleteSpacesFunc,
1261
- previewExecutor: deleteSpacesPreviewFunc,
1262
- description: {
1263
- name: "deleteSpaces",
1264
- description:
1265
- "按名称或 ID 删除当前用户拥有的 Space;先列出候选,用户确认后才删除 Space 壳和成员关系。",
1266
- category: "数据操作",
1267
- },
1268
- behavior: "action",
1269
- uiGroup: "data",
1270
- capability: "space_context",
1271
- interaction: "confirm",
1272
- riskLevel: "high",
1273
- costLevel: "low",
1274
- defaultConsent: "ask",
1275
- },
1276
-
1277
- // --- 网络与智能 ---
1278
- {
1279
- id: "fetchWebpage",
1280
- schema: fetchWebpageFunctionSchema,
1281
- executor: fetchWebpageFunc,
1282
- description: {
1283
- name: "fetchWebpage",
1284
- description: "访问网页并获取其内容",
1285
- category: "网络与智能",
1286
- },
1287
- behavior: "data",
1288
- },
1289
- {
1290
- id: "readXPost",
1291
- schema: readXPostFunctionSchema,
1292
- executor: readXPostFunc,
1293
- description: {
1294
- name: "read_x_post",
1295
- description:
1296
- "读取 X/Twitter status 链接的可见帖子正文和结构化数据,适合总结、解释或抽取用户给出的 X 帖子。",
1297
- category: "网络与智能",
1298
- },
1299
- behavior: "data",
1300
- capability: "web_access",
1301
- riskLevel: "low",
1302
- costLevel: "low",
1303
- defaultConsent: "auto",
1304
- cancelable: true,
1305
- },
1306
-
1307
- {
1308
- id: "surfWeather",
1309
- schema: surfWeatherFunctionSchema,
1310
- executor: surfWeatherFunc,
1311
- description: {
1312
- name: "surfWeather",
1313
- description:
1314
- "获取指定海岸位置的冲浪天气预报(浪高、涌浪、周期、浪向),判断是否适合冲浪。",
1315
- category: "网络与智能",
1316
- },
1317
- behavior: "data",
1318
- },
1319
-
1320
- // === Cloudflare Browser Rendering 爬取工具 ===
1321
- {
1322
- id: "cloudflareCrawl",
1323
- schema: cloudflareCrawlFunctionSchema,
1324
- executor: cloudflareCrawlFunc,
1325
- description: {
1326
- name: "cloudflareCrawl",
1327
- description:
1328
- "使用 Cloudflare Browser Rendering 爬取整个网站(支持 JS 渲染),一次调用可获取多页 Markdown 内容,适合站点级内容抓取。",
1329
- category: "网络与智能",
1330
- },
1331
- behavior: "data",
1332
- },
1333
- {
1334
- id: "cloudflareCrawlStatus",
1335
- schema: cloudflareCrawlStatusFunctionSchema,
1336
- executor: cloudflareCrawlStatusFunc,
1337
- description: {
1338
- name: "cloudflareCrawlStatus",
1339
- description: "查询 Cloudflare 爬取任务的当前状态和结果(配合 cloudflareCrawl wait=false 使用)。",
1340
- category: "网络与智能",
1341
- },
1342
- behavior: "data",
1343
- },
1344
-
1345
- // === Apify 抓取工具 ===
1346
- {
1347
- id: "googleSearchScraper",
1348
- schema: googleSearchScraperFunctionSchema,
1349
- executor: googleSearchScraperFunc,
1350
- description: {
1351
- name: "googleSearchScraper",
1352
- description: "抓取 Google 搜索结果(SERP),返回自然结果、广告、People Also Ask 等结构化数据。",
1353
- category: "网络与智能",
1354
- },
1355
- behavior: "data",
1356
- },
1357
- {
1358
- id: "youtubeScraper",
1359
- schema: youtubeScraperFunctionSchema,
1360
- executor: youtubeScraperFunc,
1361
- description: {
1362
- name: "youtubeScraper",
1363
- description:
1364
- "使用 Apify YouTube Scraper 抓取指定视频、频道或搜索结果的详细数据(支持字幕)。",
1365
- category: "网络与智能",
1366
- },
1367
- behavior: "data",
1368
- },
1369
- {
1370
- id: "ecommerceScraper",
1371
- schema: ecommerceScraperFunctionSchema,
1372
- executor: ecommerceScraperFunc,
1373
- description: {
1374
- name: "ecommerceScraper",
1375
- description:
1376
- "使用 Apify E-commerce Scraping Tool 抓取电商产品、评论和卖家信息。",
1377
- category: "网络与智能",
1378
- },
1379
- behavior: "data",
1380
- },
1381
- {
1382
- id: "amazonProductScraper",
1383
- schema: amazonProductScraperFunctionSchema,
1384
- executor: amazonProductScraperFunc,
1385
- description: {
1386
- name: "amazonProductScraper",
1387
- description:
1388
- "使用 Apify Amazon Product Scraper 抓取亚马逊商品和类目数据。",
1389
- category: "网络与智能",
1390
- },
1391
- behavior: "data",
1392
- },
1393
-
1394
- // 浏览器会话工具
1395
- {
1396
- id: "browserCloseSession",
1397
- schema: browser_closeSession_Schema,
1398
- executor: browser_closeSession_Func,
1399
- description: {
1400
- name: "browser_closeSession",
1401
- description: "关闭浏览器会话并释放服务器槽位。",
1402
- category: "网络与智能",
1403
- },
1404
- behavior: "action",
1405
- },
1406
- {
1407
- id: "browserOpenSession",
1408
- schema: browser_openSession_Schema,
1409
- executor: browser_openSession_Func,
1410
- description: {
1411
- name: "browser_openSession",
1412
- description: "打开一个新的浏览器会话并导航到 URL,返回会话ID",
1413
- category: "网络与智能",
1414
- },
1415
- behavior: "action",
1416
- },
1417
- {
1418
- id: "browserSelectOption",
1419
- schema: browser_selectOption_Schema,
1420
- executor: browser_selectOption_Func,
1421
- description: {
1422
- name: "browser_selectOption",
1423
- description: "在浏览器会话中选择一个下拉框选项",
1424
- category: "网络与智能",
1425
- },
1426
- behavior: "action",
1427
- },
1428
- {
1429
- id: "browserClick",
1430
- schema: browser_click_Schema,
1431
- executor: browser_click_Func,
1432
- description: {
1433
- name: "browser_click",
1434
- description: "在浏览器会话中点击指定元素 (例如按钮、链接)。",
1435
- category: "网络与智能",
1436
- },
1437
- behavior: "action",
1438
- },
1439
- {
1440
- id: "browserTypeText",
1441
- schema: browser_typeText_Schema,
1442
- executor: browser_typeText_Func,
1443
- description: {
1444
- name: "browser_typeText",
1445
- description: "在浏览器会话中向输入框填写文本 (可选回车)。",
1446
- category: "网络与智能",
1447
- },
1448
- behavior: "action",
1449
- },
1450
- {
1451
- id: "browserReadContent",
1452
- schema: browser_readContent_Schema,
1453
- executor: browser_readContent_Func,
1454
- description: {
1455
- name: "browser_readContent",
1456
- description: "读取当前浏览器页面或指定元素的可见文本内容。",
1457
- category: "网络与智能",
1458
- },
1459
- behavior: "data",
1460
- },
1461
- {
1462
- id: "exaSearch",
1463
- schema: exaSearchSchema,
1464
- executor: exaSearchFunc,
1465
- description: {
1466
- name: "exa_search",
1467
- description: "使用 Exa 神经网络搜索引擎获取高质量、结构化的网络信息(包含正文)。",
1468
- category: "网络与智能",
1469
- },
1470
- behavior: "data",
1471
- },
1472
- {
1473
- id: "paddleOcr",
1474
- schema: paddleOcrSchema,
1475
- executor: paddleOcrFunc,
1476
- description: {
1477
- name: "paddle_ocr",
1478
- description: "使用 PaddleOCR-VL-0.9B 进行图片文字识别,支持多语言、表格和公式。",
1479
- category: "网络与智能",
1480
- },
1481
- behavior: "data",
1482
- },
1483
- {
1484
- id: "olmOcr",
1485
- schema: olmOcrSchema,
1486
- executor: olmOcrFunc,
1487
- description: {
1488
- name: "olm_ocr",
1489
- description: "使用 olmOCR-2-7B-1025 进行图片文字识别,适合文档、论文等结构化文本的高质量识别。",
1490
- category: "网络与智能",
1491
- },
1492
- behavior: "data",
1493
- },
1494
- {
1495
- id: "whisperTurbo",
1496
- schema: whisperTurboSchema,
1497
- executor: whisperTurboFunc,
1498
- description: {
1499
- name: "whisper_turbo",
1500
- description: "使用 whisper-large-v3-turbo 快速转录音频为文字,支持多语言,速度快价格低。",
1501
- category: "音频与媒体",
1502
- },
1503
- behavior: "data",
1504
- },
1505
- {
1506
- id: "whisperV3",
1507
- schema: whisperV3Schema,
1508
- executor: whisperV3Func,
1509
- description: {
1510
- name: "whisper_v3",
1511
- description: "使用 whisper-large-v3 高精度转录音频,中文/多语言准确率更高,适合对质量要求严格的场景。",
1512
- category: "音频与媒体",
1513
- },
1514
- behavior: "data",
1515
- },
1516
-
1517
- // --- Cloudflare Browser Rendering ---
1518
-
1519
- {
1520
- id: "cfScreenshot",
1521
- schema: cfScreenshotFunctionSchema,
1522
- executor: cfScreenshotFunc,
1523
- description: {
1524
- name: "cfScreenshot",
1525
- description: "使用 Cloudflare Browser Rendering 对网页或 HTML 截图,支持全页截图和自定义视口。",
1526
- category: "网络与智能",
1527
- },
1528
- behavior: "data",
1529
- uiGroup: "general",
1530
- },
1531
- {
1532
- id: "cfGetMarkdown",
1533
- schema: cfGetMarkdownFunctionSchema,
1534
- executor: cfGetMarkdownFunc,
1535
- description: {
1536
- name: "cfGetMarkdown",
1537
- description: "使用 Cloudflare Browser Rendering 将网页转为 Markdown,支持 JS 渲染,速度快于多页爬取。",
1538
- category: "网络与智能",
1539
- },
1540
- behavior: "data",
1541
- uiGroup: "general",
1542
- },
1543
- {
1544
- id: "cfGeneratePDF",
1545
- schema: cfGeneratePDFFunctionSchema,
1546
- executor: cfGeneratePDFFunc,
1547
- description: {
1548
- name: "cfGeneratePDF",
1549
- description: "使用 Cloudflare Browser Rendering 将网页或 HTML 渲染为 PDF 文件,适合文档导出。",
1550
- category: "文档生成",
1551
- },
1552
- behavior: "action",
1553
- uiGroup: "general",
1554
- },
1555
- {
1556
- id: "cfExtractJSON",
1557
- schema: cfExtractJSONFunctionSchema,
1558
- executor: cfExtractJSONFunc,
1559
- description: {
1560
- name: "cfExtractJSON",
1561
- description: "使用 Cloudflare Browser Rendering + AI 从网页提取结构化 JSON 数据,用自然语言描述需要的字段。",
1562
- category: "网络与智能",
1563
- },
1564
- behavior: "data",
1565
- uiGroup: "general",
1566
- },
1567
- {
1568
- id: "appPreflight",
1569
- schema: appPreflightFunctionSchema,
1570
- executor: appPreflightFunc,
1571
- description: {
1572
- name: "appPreflight",
1573
- description: "在部署前检查应用结构、依赖、图标与常见构建问题。",
1574
- category: "应用部署",
1575
- },
1576
- behavior: "data",
1577
- uiGroup: "general",
1578
- },
1579
- {
1580
- id: "appDeploy",
1581
- schema: appDeployFunctionSchema,
1582
- executor: appDeployFunc,
1583
- description: {
1584
- name: "appDeploy",
1585
- description: "将 JavaScript/TypeScript 代码部署为平台托管的 Web 应用。",
1586
- category: "应用部署",
1587
- },
1588
- behavior: "data",
1589
- uiGroup: "general",
1590
- },
1591
- {
1592
- id: "appList",
1593
- schema: appListFunctionSchema,
1594
- executor: appListFunc,
1595
- description: {
1596
- name: "appList",
1597
- description: "列出当前用户已部署的所有应用,包括名称、appId 和访问 URL。",
1598
- category: "应用部署",
1599
- },
1600
- behavior: "data",
1601
- uiGroup: "general",
1602
- },
1603
- {
1604
- id: "appDelete",
1605
- schema: appDeleteFunctionSchema,
1606
- executor: appDeleteFunc,
1607
- description: {
1608
- name: "appDelete",
1609
- description: "删除一个已部署的应用,删除后 URL 立即失效。",
1610
- category: "应用部署",
1611
- },
1612
- behavior: "data",
1613
- uiGroup: "general",
1614
- },
1615
- {
1616
- id: "appRead",
1617
- schema: appReadFunctionSchema,
1618
- executor: appReadFunc,
1619
- description: {
1620
- name: "appRead",
1621
- description: "读取已部署应用的当前代码,修改应用前必须先调用此工具获取现有代码。",
1622
- category: "应用部署",
1623
- },
1624
- behavior: "data",
1625
- uiGroup: "general",
1626
- },
1627
- {
1628
- id: "cfSpeechToText",
1629
- schema: cfSpeechToTextFunctionSchema,
1630
- executor: cfSpeechToTextFunc,
1631
- description: {
1632
- name: "cfSpeechToText",
1633
- description: "使用 Cloudflare Workers AI (@cf/openai/whisper) 将音频文件转换为文字,支持多语言自动识别。",
1634
- category: "媒体处理",
1635
- },
1636
- behavior: "data",
1637
- uiGroup: "general",
1638
- },
1639
- {
1640
- id: "execBash",
1641
- schema: execBashFunctionSchema,
1642
- executor: execBashFunc,
1643
- description: {
1644
- name: "exec_bash",
1645
- description:
1646
- "通过后端 diff-server 的 /api/exec-bash 接口执行一条 bash 命令,仅用于本地开发调试。",
1647
- category: "网络与智能",
1648
- },
1649
- behavior: "action",
1650
- },
1651
- {
1652
- id: "execShell",
1653
- schema: execShellFunctionSchema,
1654
- executor: execShellFunc,
1655
- description: {
1656
- name: "exec_shell",
1657
- description:
1658
- "通过后端 shell 执行接口运行跨平台命令:Windows 优先 PowerShell,Linux/macOS 使用 bash,仅用于本地开发调试。",
1659
- category: "网络与智能",
1660
- },
1661
- behavior: "action",
1662
- },
1663
- {
1664
- id: "checkEnv",
1665
- schema: checkEnvFunctionSchema,
1666
- executor: checkEnvFunc,
1667
- description: {
1668
- name: "checkEnv",
1669
- description:
1670
- "执行环境检查(当前默认并支持 build),用于代码变更后的快速生效前验证。",
1671
- category: "网络与智能",
1672
- },
1673
- behavior: "action",
1674
- uiGroup: "data",
1675
- },
1676
-
1677
- // --- 多媒体生成 / 文档生成 ---
1678
-
1679
- {
1680
- id: "geminiFlashImage",
1681
- schema: geminiFlashImageFunctionSchema,
1682
- executor: geminiFlashImageFunc,
1683
- description: {
1684
- name: "geminiFlashImage",
1685
- description:
1686
- "使用 Gemini 2.5 Flash 模型,根据文字说明和可选输入图片生成图像,适合文生图和轻量编辑。",
1687
- category: "多媒体生成",
1688
- },
1689
- behavior: "action",
1690
- uiGroup: "media",
1691
- },
1692
- {
1693
- id: "geminiProImagePreview",
1694
- schema: geminiProImagePreviewFunctionSchema,
1695
- executor: geminiProImagePreviewFunc,
1696
- description: {
1697
- name: "geminiProImagePreview",
1698
- description:
1699
- "使用 Gemini 3 Pro Image Preview 模型,基于一张或多张输入图片进行复杂编辑和多图合成。",
1700
- category: "多媒体生成",
1701
- },
1702
- behavior: "action",
1703
- uiGroup: "media",
1704
- },
1705
- {
1706
- id: "openAIGptImage",
1707
- schema: openAIGptImageFunctionSchema,
1708
- executor: openAIGptImageFunc,
1709
- description: {
1710
- name: "openAIGptImage",
1711
- description:
1712
- "使用 OpenAI GPT Image 1.5 生成或编辑图片,适合项目页素材、海报、插画和改图。",
1713
- category: "多媒体生成",
1714
- },
1715
- behavior: "action",
1716
- uiGroup: "media",
1717
- },
1718
- {
1719
- id: "remotionRenderVideo",
1720
- schema: remotionRenderVideoFunctionSchema,
1721
- executor: remotionRenderVideoFunc,
1722
- description: {
1723
- name: "remotionRenderVideo",
1724
- description:
1725
- "使用平台内 Remotion 模板渲染手机传播视频或产品介绍视频,并保存为 MP4。",
1726
- category: "多媒体生成",
1727
- },
1728
- behavior: "action",
1729
- uiGroup: "media",
1730
- capability: "general",
1731
- riskLevel: "medium",
1732
- costLevel: "medium",
1733
- defaultConsent: "ask",
1734
- cancelable: true,
1735
- },
1736
- {
1737
- id: "generateDocx",
1738
- schema: generateDocxFunctionSchema,
1739
- executor: generateDocxFunc,
1740
- description: {
1741
- name: "generateDocx",
1742
- description:
1743
- "在浏览器端根据指定 DOCX 模板 URL 和变量生成文档,并触发下载。",
1744
- category: "文档生成",
1745
- },
1746
- behavior: "action",
1747
- },
1748
- ];
1749
-
1750
- // 汇总所有工具定义:基础工具 + Agent 分组 + 代码分组
1751
- const toolDefinitions: ToolDefinition[] = [
1752
- ...baseToolDefinitions,
1753
- ...agentToolDefinitions,
1754
- ...codeToolDefinitions,
1755
- ];
1756
-
1757
- /* ==================================================================
1758
- * 3.1 动态为 createAgent / updateAgent 的 tools 字段补 enum
1759
- * ================================================================== */
1760
-
1761
- // 所有函数工具的 schema.name 列表
1762
- const ALL_TOOL_FUNCTION_NAMES: string[] = toolDefinitions
1763
- .map((tool) => tool.schema?.name)
1764
- .filter((name): name is string => Boolean(name));
1765
-
1766
- // Agent 可用的工具名:保留 ui_ask_choice,排除 toolquery 和默认开启的浏览器/搜索工具
1767
- const AGENT_AVAILABLE_TOOL_NAMES = ALL_TOOL_FUNCTION_NAMES.filter(
1768
- (name) =>
1769
- name !== "toolquery" &&
1770
- !name.startsWith("browser_") &&
1771
- name !== "exa_search"
1772
- );
1773
-
1774
- // 给 createAgent / updateAgent 的 tools 参数 items 动态挂 enum
1775
- export const patchAgentToolSchemas = () => {
1776
- try {
1777
- const createAgentToolsProp =
1778
- createAgentToolFunctionSchema?.parameters?.properties?.tools;
1779
- if (createAgentToolsProp?.items && !(createAgentToolsProp.items as any).enum) {
1780
- (createAgentToolsProp.items as any).enum = AGENT_AVAILABLE_TOOL_NAMES;
1781
- }
1782
-
1783
- const updateAgentToolsProp =
1784
- updateAgentToolFunctionSchema?.parameters?.properties?.tools;
1785
- if (updateAgentToolsProp?.items && !(updateAgentToolsProp.items as any).enum) {
1786
- (updateAgentToolsProp.items as any).enum = AGENT_AVAILABLE_TOOL_NAMES;
1787
- }
1788
- } catch {
1789
- // 静默失败即可,不影响其他工具
1790
- }
1791
- };
1792
-
1793
- patchAgentToolSchemas();
1794
-
1795
- /* ==================================================================
1796
- * 4. 程序化生成所需的各个对象
1797
- * ================================================================== */
1798
-
1799
- export const toolRegistry: Record<string, any> = toolDefinitions.reduce(
1800
- (acc, tool) => {
1801
- acc[tool.schema.name] = { type: "function", function: tool.schema };
1802
- return acc;
1803
- },
1804
- {} as Record<string, any>
1805
- );
1806
-
1807
- export const toolExecutors: Record<string, ToolDefinition["executor"]> =
1808
- toolDefinitions.reduce(
1809
- (acc, tool) => {
1810
- acc[tool.schema.name] = tool.executor;
1811
- return acc;
1812
- },
1813
- {} as Record<string, ToolDefinition["executor"]>
1814
- );
1815
-
1816
- export const toolDescriptions: Record<string, ToolDefinition["description"]> =
1817
- toolDefinitions.reduce(
1818
- (acc, tool) => {
1819
- acc[tool.schema.name] = tool.description;
1820
- return acc;
1821
- },
1822
- {} as Record<string, ToolDefinition["description"]>
1823
- );
1824
-
1825
- export const toolDefinitionsByName: Record<string, ToolDefinition> =
1826
- toolDefinitions.reduce(
1827
- (acc, tool) => {
1828
- acc[tool.schema.name] = tool;
1829
- return acc;
1830
- },
1831
- {} as Record<string, ToolDefinition>
1832
- );
1833
-
1834
- /* ==================================================================
1835
- * 5. 工具查找辅助函数
1836
- * ================================================================== */
1837
- const normalizeToolName = (name: string): string =>
1838
- name.replace(/[-_]/g, "").toLowerCase();
1839
-
1840
- export const findToolExecutor = (
1841
- rawName: string
1842
- ): {
1843
- executor: ToolDefinition["executor"];
1844
- canonicalName: string;
1845
- } => {
1846
- const normalizedRawName = normalizeToolName(rawName);
1847
- const canonicalName = Object.keys(toolExecutors).find(
1848
- (key) => normalizeToolName(key) === normalizedRawName
1849
- );
1850
-
1851
- if (canonicalName && toolExecutors[canonicalName]) {
1852
- return {
1853
- executor: toolExecutors[canonicalName],
1854
- canonicalName,
1855
- };
1856
- }
1857
- throw new Error(`执行器未找到:未知工具 "${rawName}"`);
1858
- };