plugin-agent-orchestrator 1.1.8 → 1.2.0

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 (413) hide show
  1. package/README.md +207 -204
  2. package/client-v2.d.ts +2 -2
  3. package/client-v2.js +1 -1
  4. package/client.d.ts +2 -2
  5. package/client.js +1 -1
  6. package/dist/client/117.2e4cb0477da3db1f.js +10 -0
  7. package/dist/client/253.93deb9e0192e76a5.js +10 -0
  8. package/dist/client/325.8f7f509bdb35e142.js +10 -0
  9. package/dist/client/404.498d2d9516dd1dce.js +10 -0
  10. package/dist/client/418.6f01da17774a5a25.js +10 -0
  11. package/dist/client/53.774ff07505d521fa.js +10 -0
  12. package/dist/client/619.e342b0fa467d39ca.js +10 -0
  13. package/dist/client/627.fdd60bcc0f3a9cf6.js +10 -0
  14. package/dist/client/652.477e21bfff67bc1c.js +10 -0
  15. package/dist/client/981.e0546ffc34afedcd.js +10 -0
  16. package/dist/client/993.5d04b510835ab0d2.js +10 -0
  17. package/dist/client/index.js +1 -1
  18. package/dist/client-v2/117.ccf43ae8631f7d74.js +10 -0
  19. package/dist/client-v2/214.cdf76752053a8990.js +10 -0
  20. package/dist/client-v2/253.1198df22f5baf304.js +10 -0
  21. package/dist/client-v2/264.78887ff88f969467.js +10 -0
  22. package/dist/client-v2/325.fafe5a6e83ba9cb3.js +10 -0
  23. package/dist/client-v2/404.9ba964c28a151c81.js +10 -0
  24. package/dist/client-v2/{41.3deb9e57a0f64fc4.js → 41.b28cf7a675a603d1.js} +1 -1
  25. package/dist/client-v2/418.55b6b28cda8bb5f3.js +10 -0
  26. package/dist/client-v2/{53.349fff8db80b19d4.js → 53.282081f97e4308c6.js} +1 -1
  27. package/dist/client-v2/{619.0a2144aaffefe018.js → 619.8c03913873785fb6.js} +1 -1
  28. package/dist/client-v2/627.e16f4a0dd596c3e6.js +10 -0
  29. package/dist/client-v2/652.1a48364774d5383a.js +10 -0
  30. package/dist/client-v2/{70.ffff2997c10fd4b0.js → 70.9166ed70906d041f.js} +1 -1
  31. package/dist/client-v2/{981.e4a1f41cfc94a856.js → 981.a81521f0296c7db8.js} +1 -1
  32. package/dist/client-v2/993.ca5b28f1e2b4c1ef.js +10 -0
  33. package/dist/client-v2/index.js +1 -1
  34. package/dist/externalVersion.js +10 -7
  35. package/dist/locale/en-US.json +229 -1
  36. package/dist/locale/zh-CN.json +229 -1
  37. package/dist/node_modules/adm-zip/adm-zip.js +1 -1
  38. package/dist/node_modules/adm-zip/package.json +1 -1
  39. package/dist/node_modules/ajv/package.json +1 -1
  40. package/dist/node_modules/zod/index.cjs +1 -1
  41. package/dist/node_modules/zod/package.json +1 -1
  42. package/dist/server/collections/agent-execution-spans.js +145 -6
  43. package/dist/server/collections/agent-governance-audit-events.js +47 -0
  44. package/dist/server/collections/agent-governance-policies.js +47 -0
  45. package/dist/server/collections/agent-governance-policy-versions.js +48 -0
  46. package/dist/server/collections/agent-governance-prompt-bindings.js +50 -0
  47. package/dist/server/collections/agent-loop-runs.js +23 -5
  48. package/dist/server/migrations/20261110000000-add-usage-pricing-snapshots.js +117 -0
  49. package/dist/server/migrations/20261110010000-add-usage-department-attribution.js +54 -0
  50. package/dist/server/plugin.js +114 -33
  51. package/dist/server/resources/agent-governance.js +192 -0
  52. package/dist/server/resources/agent-harness-profile.js +11 -3
  53. package/dist/server/resources/agent-monitor.js +109 -339
  54. package/dist/server/resources/agent-usage.js +423 -0
  55. package/dist/server/resources/native-monitor-format.js +179 -0
  56. package/dist/server/resources/tracing.js +35 -12
  57. package/dist/server/services/AgentGovernanceService.js +500 -0
  58. package/dist/server/services/DepartmentAttribution.js +65 -0
  59. package/dist/server/services/ExecutionSpanService.js +96 -3
  60. package/dist/server/services/GovernanceAdmission.js +211 -0
  61. package/dist/server/services/HarnessCapabilities.js +118 -0
  62. package/dist/server/services/LoopBudgetService.js +29 -11
  63. package/dist/server/services/LoopRunRepository.js +15 -6
  64. package/dist/server/services/LoopRunStateMachine.js +18 -7
  65. package/dist/server/services/LoopTriggerService.js +1 -1
  66. package/dist/server/services/LoopWorkerService.js +66 -32
  67. package/dist/server/services/ManagedPromptProtection.js +99 -0
  68. package/dist/server/services/NativeAgentMonitorSyncService.js +584 -0
  69. package/dist/server/services/NativeSubAgentObserver.js +141 -508
  70. package/dist/server/services/NativeUsageAttribution.js +97 -0
  71. package/dist/server/services/TokenTracker.js +787 -104
  72. package/dist/server/services/TracingRetentionPolicy.js +66 -0
  73. package/dist/server/services/VerificationService.js +18 -8
  74. package/dist/server/skill-hub/sandbox-config.json +6 -6
  75. package/dist/server/utils/ensure-indexes.js +14 -5
  76. package/package.json +63 -53
  77. package/server.d.ts +2 -2
  78. package/server.js +1 -1
  79. package/src/client/AgentRunsTab.tsx +2 -2
  80. package/src/client/ApprovalsTab.tsx +2 -2
  81. package/src/client/HarnessProfilesTab.tsx +2 -2
  82. package/src/client/OrchestratorSettings.tsx +152 -152
  83. package/src/client/SkillPages.tsx +41 -0
  84. package/src/client/__tests__/embedded-settings.test.tsx +232 -0
  85. package/src/client/hooks/useRunEventStream.ts +76 -76
  86. package/src/client/index.tsx +2 -2
  87. package/src/client/plugin.tsx +76 -33
  88. package/src/client/skill-hub/components/ExecutionHistory.tsx +200 -200
  89. package/src/client/skill-hub/components/GitSkillImport.tsx +562 -562
  90. package/src/client/skill-hub/components/LoopSettings.tsx +331 -331
  91. package/src/client/skill-hub/components/SkillEditor.tsx +460 -460
  92. package/src/client/skill-hub/components/SkillManager.tsx +194 -194
  93. package/src/client/skill-hub/components/SkillMetrics.tsx +162 -162
  94. package/src/client/skill-hub/components/SkillTestPanel.tsx +141 -141
  95. package/src/client/skill-hub/index.tsx +6 -6
  96. package/src/client/skill-hub/locale.ts +16 -16
  97. package/src/client/skill-hub/tools/InteractionSchemasProvider.tsx +132 -132
  98. package/src/client/skill-hub/tools/SkillHubCard.tsx +104 -104
  99. package/src/client/skill-hub/tools/loopTemplates.ts +52 -52
  100. package/src/client/skill-hub/tools/registerSkillLoopCards.ts +71 -71
  101. package/src/client/skill-hub/utils/jsonFields.ts +41 -41
  102. package/src/client-v2/__tests__/embedded-settings.test.tsx +193 -0
  103. package/src/client-v2/components/AIEmployeeSelect.tsx +47 -47
  104. package/src/client-v2/components/AIEmployeesContext.tsx +97 -97
  105. package/src/client-v2/components/AgentBindingsTab.tsx +269 -269
  106. package/src/client-v2/components/AgentRunsTab.tsx +92 -83
  107. package/src/client-v2/components/ApprovalsTab.tsx +337 -337
  108. package/src/client-v2/components/EmployeeGovernanceTab.tsx +702 -0
  109. package/src/client-v2/components/HarnessProfilesTab.tsx +704 -541
  110. package/src/client-v2/components/KnowledgeAccessTab.tsx +116 -116
  111. package/src/client-v2/components/RetrievalTraceTab.tsx +162 -162
  112. package/src/client-v2/components/UsageGovernanceTab.tsx +386 -0
  113. package/src/client-v2/index.tsx +1 -1
  114. package/src/client-v2/pages/AgentBindingsPage.tsx +22 -13
  115. package/src/client-v2/pages/ApprovalsPage.tsx +19 -10
  116. package/src/client-v2/pages/EmployeeGovernancePage.tsx +22 -0
  117. package/src/client-v2/pages/ExecutionHistoryPage.tsx +19 -10
  118. package/src/client-v2/pages/HarnessProfilesPage.tsx +19 -10
  119. package/src/client-v2/pages/KnowledgeAccessPage.tsx +19 -10
  120. package/src/client-v2/pages/LoopSettingsPage.tsx +19 -10
  121. package/src/client-v2/pages/MemoryInspectorPage.tsx +22 -13
  122. package/src/client-v2/pages/RetrievalTracePage.tsx +19 -10
  123. package/src/client-v2/pages/RulesPage.tsx +22 -13
  124. package/src/client-v2/pages/SkillDefinitionsPage.tsx +19 -10
  125. package/src/client-v2/pages/SkillMetricsPage.tsx +19 -10
  126. package/src/client-v2/pages/TracingPage.tsx +22 -13
  127. package/src/client-v2/pages/UsageGovernancePage.tsx +22 -0
  128. package/src/client-v2/plugin.tsx +139 -111
  129. package/src/client-v2/skill-hub/components/ExecutionHistory.tsx +196 -196
  130. package/src/client-v2/skill-hub/components/FileLinkList.tsx +37 -37
  131. package/src/client-v2/skill-hub/components/GitSkillImport.tsx +539 -539
  132. package/src/client-v2/skill-hub/components/LoopSettings.tsx +331 -331
  133. package/src/client-v2/skill-hub/components/SkillEditor.tsx +453 -453
  134. package/src/client-v2/skill-hub/components/SkillManager.tsx +191 -174
  135. package/src/client-v2/skill-hub/components/SkillMetrics.tsx +162 -162
  136. package/src/client-v2/skill-hub/components/SkillTestPanel.tsx +135 -135
  137. package/src/client-v2/skill-hub/locale.ts +13 -13
  138. package/src/client-v2/skill-hub/tools/InteractionSchemasProvider.tsx +62 -0
  139. package/src/client-v2/skill-hub/tools/SkillHubCard.tsx +104 -0
  140. package/src/client-v2/skill-hub/tools/__tests__/interactions.test.ts +110 -0
  141. package/src/client-v2/skill-hub/tools/interactions.ts +128 -0
  142. package/src/client-v2/skill-hub/tools/loopTemplates.ts +52 -52
  143. package/src/client-v2/skill-hub/utils/jsonFields.ts +41 -41
  144. package/src/client-v2/utils/jsonFields.ts +41 -41
  145. package/src/index.ts +2 -2
  146. package/src/locale/en-US.json +229 -1
  147. package/src/locale/zh-CN.json +229 -1
  148. package/src/server/__tests__/agent-execution-context.test.ts +18 -18
  149. package/src/server/__tests__/agent-governance.integration.test.ts +392 -0
  150. package/src/server/__tests__/agent-knowledge-insights.test.ts +123 -123
  151. package/src/server/__tests__/agent-monitor-acl.integration.test.ts +274 -0
  152. package/src/server/__tests__/agent-registry-service.test.ts +147 -147
  153. package/src/server/__tests__/agent-runtime-lifecycle.test.ts +46 -46
  154. package/src/server/__tests__/agent-usage-report.integration.test.ts +342 -0
  155. package/src/server/__tests__/code-validator.test.ts +63 -63
  156. package/src/server/__tests__/external-rag-search.test.ts +107 -107
  157. package/src/server/__tests__/harness-capabilities.test.ts +95 -0
  158. package/src/server/__tests__/harness-compiler.test.ts +214 -214
  159. package/src/server/__tests__/harness-profile-service.test.ts +167 -167
  160. package/src/server/__tests__/harness-runtime-policy.test.ts +293 -293
  161. package/src/server/__tests__/harness-tool-plan.test.ts +182 -172
  162. package/src/server/__tests__/input-schema-validator.test.ts +26 -26
  163. package/src/server/__tests__/loop-approval-decision.test.ts +577 -512
  164. package/src/server/__tests__/loop-approval-expiry.test.ts +258 -258
  165. package/src/server/__tests__/loop-budget-service.test.ts +36 -0
  166. package/src/server/__tests__/loop-pattern-schema.test.ts +73 -73
  167. package/src/server/__tests__/loop-run-repository.test.ts +32 -0
  168. package/src/server/__tests__/loop-run-state-machine.test.ts +101 -101
  169. package/src/server/__tests__/loop-trigger-service.test.ts +192 -148
  170. package/src/server/__tests__/loop-worker-claim.test.ts +72 -9
  171. package/src/server/__tests__/loop-worker-execution.test.ts +382 -317
  172. package/src/server/__tests__/native-agent-monitor-sync.test.ts +350 -0
  173. package/src/server/__tests__/native-sub-agent-observer.test.ts +470 -662
  174. package/src/server/__tests__/native-usage-attribution.integration.test.ts +175 -0
  175. package/src/server/__tests__/skill-access-service.test.ts +64 -64
  176. package/src/server/__tests__/skill-execute.test.ts +70 -70
  177. package/src/server/__tests__/skill-execution-task-policy.test.ts +140 -140
  178. package/src/server/__tests__/skill-sandbox-worker-mode.test.ts +15 -15
  179. package/src/server/__tests__/skill-settings.test.ts +63 -63
  180. package/src/server/__tests__/skill-tool-name.test.ts +23 -23
  181. package/src/server/__tests__/token-tracker.test.ts +639 -0
  182. package/src/server/__tests__/tool-loop-detection.test.ts +276 -276
  183. package/src/server/__tests__/tracing-retention-policy.test.ts +37 -0
  184. package/src/server/__tests__/usage-ledger.integration.test.ts +194 -0
  185. package/src/server/collections/agent-execution-spans.ts +393 -245
  186. package/src/server/collections/agent-governance-audit-events.ts +26 -0
  187. package/src/server/collections/agent-governance-policies.ts +26 -0
  188. package/src/server/collections/agent-governance-policy-versions.ts +27 -0
  189. package/src/server/collections/agent-governance-prompt-bindings.ts +29 -0
  190. package/src/server/collections/agent-loop-action-approvals.ts +39 -39
  191. package/src/server/collections/agent-loop-runs.ts +396 -369
  192. package/src/server/collections/agent-loop-steps.ts +220 -220
  193. package/src/server/collections/agent-memory-contexts.ts +95 -95
  194. package/src/server/collections/orchestrator-config.ts +87 -87
  195. package/src/server/collections/orchestrator-logs.ts +116 -116
  196. package/src/server/collections/skill-definitions.ts +159 -159
  197. package/src/server/collections/skill-executions.ts +154 -154
  198. package/src/server/collections/skill-loop-configs.ts +65 -65
  199. package/src/server/collections/skill-metrics.ts +36 -36
  200. package/src/server/collections/skill-registry-installations.ts +41 -41
  201. package/src/server/collections/skill-worker-configs.ts +86 -86
  202. package/src/server/index.ts +1 -1
  203. package/src/server/migrations/20260423000000-add-progress-fields.ts +50 -50
  204. package/src/server/migrations/20260425000000-add-interaction-schema.ts +37 -37
  205. package/src/server/migrations/20260427000000-add-tracing-detail-fields.ts +41 -41
  206. package/src/server/migrations/20260427000001-change-other-json-to-text.ts +61 -61
  207. package/src/server/migrations/20260524001000-add-plan-approval-and-harness-profiles.ts +145 -145
  208. package/src/server/migrations/20260601000000-add-token-fields.ts +89 -89
  209. package/src/server/migrations/20260615000000-normalize-ai-employee-tool-bindings.ts +39 -39
  210. package/src/server/migrations/20260621000000-native-policy-profile-defaults.ts +190 -190
  211. package/src/server/migrations/20260727000000-remove-unused-knowledge-scopes.ts +25 -25
  212. package/src/server/migrations/20260727010000-backfill-skill-tool-names.ts +45 -45
  213. package/src/server/migrations/20261110000000-add-usage-pricing-snapshots.ts +117 -0
  214. package/src/server/migrations/20261110010000-add-usage-department-attribution.ts +35 -0
  215. package/src/server/plugin.ts +674 -573
  216. package/src/server/resources/agent-governance.ts +168 -0
  217. package/src/server/resources/agent-harness-profile.ts +110 -94
  218. package/src/server/resources/agent-knowledge-insights.ts +306 -306
  219. package/src/server/resources/agent-loop-approval.ts +84 -84
  220. package/src/server/resources/agent-loop-events-stream.ts +108 -108
  221. package/src/server/resources/agent-loop.ts +252 -252
  222. package/src/server/resources/agent-monitor.ts +215 -482
  223. package/src/server/resources/agent-usage.ts +420 -0
  224. package/src/server/resources/native-monitor-format.ts +157 -0
  225. package/src/server/resources/tracing.ts +303 -267
  226. package/src/server/services/AgentExecutionContext.ts +23 -23
  227. package/src/server/services/AgentGovernanceService.ts +548 -0
  228. package/src/server/services/AgentMemoryContextService.ts +344 -344
  229. package/src/server/services/AgentRegistryService.ts +220 -220
  230. package/src/server/services/AgentRuntimeLifecycle.ts +64 -64
  231. package/src/server/services/CodeValidator.ts +238 -238
  232. package/src/server/services/DepartmentAttribution.ts +54 -0
  233. package/src/server/services/DurableCircuitBreakerService.ts +235 -235
  234. package/src/server/services/ExecutionSpanService.ts +278 -146
  235. package/src/server/services/FileManager.ts +159 -159
  236. package/src/server/services/GovernanceAdmission.ts +239 -0
  237. package/src/server/services/HarnessCapabilities.ts +119 -0
  238. package/src/server/services/HarnessCompiler.ts +170 -170
  239. package/src/server/services/HarnessProfileService.ts +235 -235
  240. package/src/server/services/HarnessSchema.ts +194 -194
  241. package/src/server/services/InputSchemaValidator.ts +44 -44
  242. package/src/server/services/LoopBudgetService.ts +332 -271
  243. package/src/server/services/LoopControlService.ts +120 -120
  244. package/src/server/services/LoopPatternSchema.ts +231 -231
  245. package/src/server/services/LoopPatternService.ts +171 -171
  246. package/src/server/services/LoopRunRepository.ts +350 -332
  247. package/src/server/services/LoopRunStateMachine.ts +545 -525
  248. package/src/server/services/LoopSchedulerService.ts +195 -195
  249. package/src/server/services/LoopTriggerService.ts +169 -159
  250. package/src/server/services/LoopWorkerService.ts +986 -912
  251. package/src/server/services/ManagedPromptProtection.ts +88 -0
  252. package/src/server/services/NativeAgentMonitorSyncService.ts +691 -0
  253. package/src/server/services/NativeSubAgentObserver.ts +331 -757
  254. package/src/server/services/NativeUsageAttribution.ts +98 -0
  255. package/src/server/services/PathLockService.ts +317 -317
  256. package/src/server/services/PluginAiRuntimeAdapter.ts +387 -387
  257. package/src/server/services/RunEventBus.ts +58 -58
  258. package/src/server/services/SandboxRunner.ts +492 -492
  259. package/src/server/services/SkillAccessService.ts +175 -175
  260. package/src/server/services/SkillManager.ts +585 -585
  261. package/src/server/services/SkillRepositoryService.ts +236 -236
  262. package/src/server/services/TokenTracker.ts +1158 -287
  263. package/src/server/services/ToolLoopDetectionService.ts +210 -210
  264. package/src/server/services/TracingRetentionPolicy.ts +56 -0
  265. package/src/server/services/VerificationSchema.ts +31 -31
  266. package/src/server/services/VerificationService.ts +332 -313
  267. package/src/server/services/WorkerEnvManager.ts +198 -198
  268. package/src/server/services/__tests__/SkillRepositoryService.test.ts +33 -33
  269. package/src/server/services/harness-runtime-policy.ts +134 -134
  270. package/src/server/services/pythonGuardTemplate.ts +87 -87
  271. package/src/server/services/sandboxCapabilities.ts +348 -348
  272. package/src/server/skill-hub/actions/__tests__/git-import.test.ts +563 -563
  273. package/src/server/skill-hub/actions/git-import.ts +936 -936
  274. package/src/server/skill-hub/mcp/McpController.ts +107 -107
  275. package/src/server/skill-hub/middlewares/git-import-request-method-policy.ts +51 -51
  276. package/src/server/skill-hub/plugin.ts +1232 -1232
  277. package/src/server/skill-hub/sandbox-config.json +6 -6
  278. package/src/server/skill-hub/services/RegistrySkillInstallationService.ts +281 -281
  279. package/src/server/skill-hub/services/__tests__/RegistrySkillInstallationService.test.ts +295 -295
  280. package/src/server/skill-hub/tasks/SkillExecutionTask.ts +568 -568
  281. package/src/server/skill-hub/utils/json-fields.ts +57 -57
  282. package/src/server/tools/delegate-task.ts +30 -30
  283. package/src/server/tools/external-rag-search.ts +329 -329
  284. package/src/server/tools/skill-execute.ts +216 -216
  285. package/src/server/types.ts +21 -21
  286. package/src/server/utils/ai-manager.ts +24 -24
  287. package/src/server/utils/ctx-utils.ts +132 -132
  288. package/src/server/utils/ensure-indexes.ts +119 -96
  289. package/src/server/utils/ha-lock.ts +80 -80
  290. package/src/server/utils/loop-pattern-context.ts +84 -84
  291. package/src/server/utils/record-utils.ts +19 -19
  292. package/src/server/utils/skill-settings.ts +135 -135
  293. package/src/server/utils/skill-tool-name.ts +58 -58
  294. package/dist/client-v2/117.7565cff57c39318a.js +0 -10
  295. package/dist/client-v2/214.106635011859dede.js +0 -10
  296. package/dist/client-v2/253.59577b40d9875be0.js +0 -10
  297. package/dist/client-v2/264.7ed8bee71fa5935c.js +0 -10
  298. package/dist/client-v2/418.41ed200e7d6da332.js +0 -10
  299. package/dist/client-v2/794.a67a2614405ba627.js +0 -10
  300. package/dist/client-v2/993.b0688fdc5ccb000a.js +0 -10
  301. package/dist/node_modules/simple-git/dist/cjs/index.js +0 -7399
  302. package/dist/node_modules/simple-git/dist/esm/index.js +0 -4745
  303. package/dist/node_modules/simple-git/dist/esm/package.json +0 -3
  304. package/dist/node_modules/simple-git/dist/src/lib/api.d.ts +0 -13
  305. package/dist/node_modules/simple-git/dist/src/lib/args/log-format.d.ts +0 -9
  306. package/dist/node_modules/simple-git/dist/src/lib/errors/git-construct-error.d.ts +0 -15
  307. package/dist/node_modules/simple-git/dist/src/lib/errors/git-error.d.ts +0 -30
  308. package/dist/node_modules/simple-git/dist/src/lib/errors/git-plugin-error.d.ts +0 -7
  309. package/dist/node_modules/simple-git/dist/src/lib/errors/git-response-error.d.ts +0 -32
  310. package/dist/node_modules/simple-git/dist/src/lib/errors/task-configuration-error.d.ts +0 -12
  311. package/dist/node_modules/simple-git/dist/src/lib/git-factory.d.ts +0 -15
  312. package/dist/node_modules/simple-git/dist/src/lib/git-logger.d.ts +0 -21
  313. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-branch-delete.d.ts +0 -5
  314. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-branch.d.ts +0 -2
  315. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-commit.d.ts +0 -2
  316. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-diff-summary.d.ts +0 -3
  317. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-fetch.d.ts +0 -2
  318. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-list-log-summary.d.ts +0 -6
  319. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-merge.d.ts +0 -11
  320. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-move.d.ts +0 -2
  321. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-pull.d.ts +0 -6
  322. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-push.d.ts +0 -4
  323. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-remote-messages.d.ts +0 -5
  324. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-remote-objects.d.ts +0 -3
  325. package/dist/node_modules/simple-git/dist/src/lib/plugins/abort-plugin.d.ts +0 -3
  326. package/dist/node_modules/simple-git/dist/src/lib/plugins/block-unsafe-operations-plugin.d.ts +0 -3
  327. package/dist/node_modules/simple-git/dist/src/lib/plugins/command-config-prefixing-plugin.d.ts +0 -2
  328. package/dist/node_modules/simple-git/dist/src/lib/plugins/completion-detection.plugin.d.ts +0 -3
  329. package/dist/node_modules/simple-git/dist/src/lib/plugins/custom-binary.plugin.d.ts +0 -3
  330. package/dist/node_modules/simple-git/dist/src/lib/plugins/error-detection.plugin.d.ts +0 -7
  331. package/dist/node_modules/simple-git/dist/src/lib/plugins/index.d.ts +0 -11
  332. package/dist/node_modules/simple-git/dist/src/lib/plugins/plugin-store.d.ts +0 -11
  333. package/dist/node_modules/simple-git/dist/src/lib/plugins/progress-monitor-plugin.d.ts +0 -3
  334. package/dist/node_modules/simple-git/dist/src/lib/plugins/simple-git-plugin.d.ts +0 -48
  335. package/dist/node_modules/simple-git/dist/src/lib/plugins/spawn-options-plugin.d.ts +0 -3
  336. package/dist/node_modules/simple-git/dist/src/lib/plugins/suffix-paths.plugin.d.ts +0 -2
  337. package/dist/node_modules/simple-git/dist/src/lib/plugins/timout-plugin.d.ts +0 -3
  338. package/dist/node_modules/simple-git/dist/src/lib/responses/BranchDeleteSummary.d.ts +0 -12
  339. package/dist/node_modules/simple-git/dist/src/lib/responses/BranchSummary.d.ts +0 -14
  340. package/dist/node_modules/simple-git/dist/src/lib/responses/CheckIgnore.d.ts +0 -4
  341. package/dist/node_modules/simple-git/dist/src/lib/responses/CleanSummary.d.ts +0 -9
  342. package/dist/node_modules/simple-git/dist/src/lib/responses/ConfigList.d.ts +0 -13
  343. package/dist/node_modules/simple-git/dist/src/lib/responses/DiffSummary.d.ts +0 -10
  344. package/dist/node_modules/simple-git/dist/src/lib/responses/FileStatusSummary.d.ts +0 -9
  345. package/dist/node_modules/simple-git/dist/src/lib/responses/GetRemoteSummary.d.ts +0 -11
  346. package/dist/node_modules/simple-git/dist/src/lib/responses/InitSummary.d.ts +0 -9
  347. package/dist/node_modules/simple-git/dist/src/lib/responses/MergeSummary.d.ts +0 -16
  348. package/dist/node_modules/simple-git/dist/src/lib/responses/PullSummary.d.ts +0 -25
  349. package/dist/node_modules/simple-git/dist/src/lib/responses/StatusSummary.d.ts +0 -19
  350. package/dist/node_modules/simple-git/dist/src/lib/responses/TagList.d.ts +0 -7
  351. package/dist/node_modules/simple-git/dist/src/lib/runners/git-executor-chain.d.ts +0 -25
  352. package/dist/node_modules/simple-git/dist/src/lib/runners/git-executor.d.ts +0 -14
  353. package/dist/node_modules/simple-git/dist/src/lib/runners/promise-wrapped.d.ts +0 -2
  354. package/dist/node_modules/simple-git/dist/src/lib/runners/scheduler.d.ts +0 -11
  355. package/dist/node_modules/simple-git/dist/src/lib/runners/tasks-pending-queue.d.ts +0 -23
  356. package/dist/node_modules/simple-git/dist/src/lib/simple-git-api.d.ts +0 -20
  357. package/dist/node_modules/simple-git/dist/src/lib/task-callback.d.ts +0 -2
  358. package/dist/node_modules/simple-git/dist/src/lib/tasks/apply-patch.d.ts +0 -3
  359. package/dist/node_modules/simple-git/dist/src/lib/tasks/branch.d.ts +0 -7
  360. package/dist/node_modules/simple-git/dist/src/lib/tasks/change-working-directory.d.ts +0 -2
  361. package/dist/node_modules/simple-git/dist/src/lib/tasks/check-ignore.d.ts +0 -2
  362. package/dist/node_modules/simple-git/dist/src/lib/tasks/check-is-repo.d.ts +0 -9
  363. package/dist/node_modules/simple-git/dist/src/lib/tasks/checkout.d.ts +0 -2
  364. package/dist/node_modules/simple-git/dist/src/lib/tasks/clean.d.ts +0 -25
  365. package/dist/node_modules/simple-git/dist/src/lib/tasks/clone.d.ts +0 -9
  366. package/dist/node_modules/simple-git/dist/src/lib/tasks/commit.d.ts +0 -4
  367. package/dist/node_modules/simple-git/dist/src/lib/tasks/config.d.ts +0 -8
  368. package/dist/node_modules/simple-git/dist/src/lib/tasks/count-objects.d.ts +0 -12
  369. package/dist/node_modules/simple-git/dist/src/lib/tasks/diff-name-status.d.ts +0 -12
  370. package/dist/node_modules/simple-git/dist/src/lib/tasks/diff.d.ts +0 -5
  371. package/dist/node_modules/simple-git/dist/src/lib/tasks/fetch.d.ts +0 -4
  372. package/dist/node_modules/simple-git/dist/src/lib/tasks/first-commit.d.ts +0 -2
  373. package/dist/node_modules/simple-git/dist/src/lib/tasks/grep.d.ts +0 -12
  374. package/dist/node_modules/simple-git/dist/src/lib/tasks/hash-object.d.ts +0 -5
  375. package/dist/node_modules/simple-git/dist/src/lib/tasks/init.d.ts +0 -3
  376. package/dist/node_modules/simple-git/dist/src/lib/tasks/log.d.ts +0 -32
  377. package/dist/node_modules/simple-git/dist/src/lib/tasks/merge.d.ts +0 -4
  378. package/dist/node_modules/simple-git/dist/src/lib/tasks/move.d.ts +0 -3
  379. package/dist/node_modules/simple-git/dist/src/lib/tasks/pull.d.ts +0 -3
  380. package/dist/node_modules/simple-git/dist/src/lib/tasks/push.d.ts +0 -9
  381. package/dist/node_modules/simple-git/dist/src/lib/tasks/remote.d.ts +0 -8
  382. package/dist/node_modules/simple-git/dist/src/lib/tasks/reset.d.ts +0 -11
  383. package/dist/node_modules/simple-git/dist/src/lib/tasks/show.d.ts +0 -2
  384. package/dist/node_modules/simple-git/dist/src/lib/tasks/stash-list.d.ts +0 -4
  385. package/dist/node_modules/simple-git/dist/src/lib/tasks/status.d.ts +0 -3
  386. package/dist/node_modules/simple-git/dist/src/lib/tasks/sub-module.d.ts +0 -5
  387. package/dist/node_modules/simple-git/dist/src/lib/tasks/tag.d.ts +0 -18
  388. package/dist/node_modules/simple-git/dist/src/lib/tasks/task.d.ts +0 -14
  389. package/dist/node_modules/simple-git/dist/src/lib/tasks/version.d.ts +0 -9
  390. package/dist/node_modules/simple-git/dist/src/lib/types/handlers.d.ts +0 -21
  391. package/dist/node_modules/simple-git/dist/src/lib/types/index.d.ts +0 -136
  392. package/dist/node_modules/simple-git/dist/src/lib/types/tasks.d.ts +0 -19
  393. package/dist/node_modules/simple-git/dist/src/lib/utils/argument-filters.d.ts +0 -14
  394. package/dist/node_modules/simple-git/dist/src/lib/utils/exit-codes.d.ts +0 -10
  395. package/dist/node_modules/simple-git/dist/src/lib/utils/git-output-streams.d.ts +0 -7
  396. package/dist/node_modules/simple-git/dist/src/lib/utils/index.d.ts +0 -8
  397. package/dist/node_modules/simple-git/dist/src/lib/utils/line-parser.d.ts +0 -15
  398. package/dist/node_modules/simple-git/dist/src/lib/utils/simple-git-options.d.ts +0 -2
  399. package/dist/node_modules/simple-git/dist/src/lib/utils/task-options.d.ts +0 -13
  400. package/dist/node_modules/simple-git/dist/src/lib/utils/task-parser.d.ts +0 -5
  401. package/dist/node_modules/simple-git/dist/src/lib/utils/util.d.ts +0 -47
  402. package/dist/node_modules/simple-git/dist/typings/errors.d.ts +0 -5
  403. package/dist/node_modules/simple-git/dist/typings/index.d.ts +0 -14
  404. package/dist/node_modules/simple-git/dist/typings/response.d.ts +0 -556
  405. package/dist/node_modules/simple-git/dist/typings/simple-git.d.ts +0 -1033
  406. package/dist/node_modules/simple-git/dist/typings/types.d.ts +0 -22
  407. package/dist/node_modules/simple-git/node_modules/debug/package.json +0 -64
  408. package/dist/node_modules/simple-git/node_modules/debug/src/browser.js +0 -272
  409. package/dist/node_modules/simple-git/node_modules/debug/src/common.js +0 -292
  410. package/dist/node_modules/simple-git/node_modules/debug/src/index.js +0 -10
  411. package/dist/node_modules/simple-git/node_modules/debug/src/node.js +0 -263
  412. package/dist/node_modules/simple-git/package.json +0 -1
  413. package/dist/node_modules/simple-git/promise.js +0 -17
@@ -1,329 +1,329 @@
1
- import { z } from 'zod';
2
-
3
- const TOOL_NAME = 'external_rag_search';
4
- const MAX_CONTENT_LENGTH = 4000;
5
- const MAX_METADATA_VALUE_LENGTH = 500;
6
- const METADATA_FIELDS = [
7
- 'id',
8
- 'title',
9
- 'filename',
10
- 'fileName',
11
- 'name',
12
- 'source',
13
- 'url',
14
- 'fileUrl',
15
- 'sourceUrl',
16
- 'collection',
17
- 'collectionName',
18
- 'recordId',
19
- 'rowId',
20
- 'documentId',
21
- 'docId',
22
- 'fileId',
23
- 'page',
24
- 'pageNumber',
25
- 'chunkIndex',
26
- ] as const;
27
-
28
- type RecordLike = Record<string, unknown>;
29
-
30
- type Repository = {
31
- findOne?: (options: RecordLike) => Promise<unknown>;
32
- };
33
-
34
- type ToolContext = {
35
- app?: {
36
- pm?: {
37
- get?: (name: string) => unknown;
38
- };
39
- };
40
- db?: {
41
- getRepository?: (name: string) => Repository | undefined;
42
- };
43
- state?: RecordLike;
44
- _currentAIEmployee?: unknown;
45
- };
46
-
47
- type ToolRuntime = {
48
- toolCallId?: string;
49
- };
50
-
51
- type ResolvedAgent = {
52
- username: string;
53
- knowledgeBaseIds: string[];
54
- };
55
-
56
- function truncate(value: unknown, max = MAX_CONTENT_LENGTH) {
57
- const text = typeof value === 'string' ? value : value == null ? '' : String(value);
58
- return text.length > max ? `${text.slice(0, max)}...` : text;
59
- }
60
-
61
- function firstString(...values: unknown[]) {
62
- for (const value of values) {
63
- if (typeof value === 'string' && value.trim()) {
64
- return value.trim();
65
- }
66
- if (typeof value === 'number' && Number.isFinite(value)) {
67
- return String(value);
68
- }
69
- }
70
- return undefined;
71
- }
72
-
73
- function toRecord(value: unknown): RecordLike {
74
- return value && typeof value === 'object' && !Array.isArray(value) ? (value as RecordLike) : {};
75
- }
76
-
77
- function readModelValue(record: unknown, key: string): unknown {
78
- const model = record as { get?: (name: string) => unknown; [key: string]: unknown };
79
- return typeof model?.get === 'function' ? model.get(key) : model?.[key];
80
- }
81
-
82
- function toPlain(record: unknown): RecordLike {
83
- const model = record as { toJSON?: () => unknown };
84
- return toRecord(typeof model?.toJSON === 'function' ? model.toJSON() : record);
85
- }
86
-
87
- function sanitizeMetadata(value: unknown): RecordLike {
88
- const metadata = toRecord(value);
89
- return Object.fromEntries(
90
- METADATA_FIELDS.flatMap((key) => {
91
- const field = metadata[key];
92
- if (typeof field === 'string') {
93
- return [[key, truncate(field, MAX_METADATA_VALUE_LENGTH)]];
94
- }
95
- if (typeof field === 'number' || typeof field === 'boolean') {
96
- return [[key, field]];
97
- }
98
- return [];
99
- }),
100
- );
101
- }
102
-
103
- function normalizeResult(result: unknown) {
104
- const record = toRecord(result);
105
- const metadata = sanitizeMetadata(record.metadata);
106
- const sourceId = firstString(
107
- record.id,
108
- metadata.id,
109
- metadata.sourceId,
110
- metadata.documentId,
111
- metadata.docId,
112
- metadata.fileId,
113
- metadata.recordId,
114
- );
115
- const filename = firstString(metadata.filename, metadata.fileName, metadata.name, metadata.title, metadata.source);
116
-
117
- return {
118
- content: truncate(record.content),
119
- score: Number(record.rerankScore ?? record.score ?? record.vectorScore ?? 0),
120
- knowledgeBaseId: record.knowledgeBaseId,
121
- knowledgeBaseName: record.knowledgeBaseName,
122
- source: {
123
- id: sourceId,
124
- filename,
125
- url: firstString(metadata.url, metadata.fileUrl, metadata.sourceUrl),
126
- collection: firstString(metadata.collection, metadata.collectionName),
127
- recordId: firstString(metadata.recordId, metadata.rowId),
128
- },
129
- metadata,
130
- };
131
- }
132
-
133
- function getContextAgentUsername(ctx: ToolContext): string | undefined {
134
- const direct = ctx._currentAIEmployee ?? ctx.state?.currentAIEmployee;
135
- if (typeof direct === 'string' && direct.trim()) {
136
- return direct.trim();
137
- }
138
- const employee = toRecord(direct);
139
- return firstString(employee.username, employee.name);
140
- }
141
-
142
- async function resolveAgentFromToolCall(ctx: ToolContext, runtime?: ToolRuntime): Promise<string | undefined> {
143
- const direct = getContextAgentUsername(ctx);
144
- if (direct) {
145
- return direct;
146
- }
147
-
148
- const toolCallId = runtime?.toolCallId;
149
- if (!toolCallId) {
150
- return undefined;
151
- }
152
-
153
- const toolMessage = await ctx.db?.getRepository?.('aiToolMessages')?.findOne?.({
154
- filter: { toolCallId },
155
- });
156
- const sessionId = firstString(readModelValue(toolMessage, 'sessionId'));
157
- if (!sessionId) {
158
- return undefined;
159
- }
160
-
161
- const conversation = await ctx.db?.getRepository?.('aiConversations')?.findOne?.({
162
- filter: { sessionId },
163
- });
164
- return firstString(readModelValue(conversation, 'aiEmployeeUsername'));
165
- }
166
-
167
- function readKnowledgeBaseIds(employee: unknown): string[] {
168
- const settings = toRecord(readModelValue(employee, 'knowledgeBase'));
169
- // NocoBase currently persists this setting as `knowledgeBaseIds`; early
170
- // orchestrator configurations used `knowledgeBaseKeys`. Prefer the legacy
171
- // value when it is populated, but fall back to the current field so either
172
- // configuration can enforce the same retrieval boundary.
173
- const legacyIds = settings.knowledgeBaseKeys;
174
- const ids = Array.isArray(legacyIds) && legacyIds.length ? legacyIds : settings.knowledgeBaseIds;
175
- return Array.isArray(ids)
176
- ? Array.from(
177
- new Set(
178
- ids.filter((id): id is string | number => typeof id === 'string' || typeof id === 'number').map(String),
179
- ),
180
- )
181
- : [];
182
- }
183
-
184
- async function resolveAgent(ctx: ToolContext, runtime?: ToolRuntime): Promise<ResolvedAgent | undefined> {
185
- const username = await resolveAgentFromToolCall(ctx, runtime);
186
- if (!username) {
187
- return undefined;
188
- }
189
-
190
- const employee = await ctx.db?.getRepository?.('aiEmployees')?.findOne?.({
191
- filter: { username },
192
- });
193
- if (!employee) {
194
- return undefined;
195
- }
196
-
197
- return {
198
- username,
199
- knowledgeBaseIds: readKnowledgeBaseIds(employee),
200
- };
201
- }
202
-
203
- function withAgentIdentity(ctx: ToolContext, username: string): ToolContext {
204
- const scoped = Object.create(ctx) as ToolContext;
205
- const employee = { username };
206
- scoped._currentAIEmployee = employee;
207
- scoped.state = {
208
- ...(ctx.state ?? {}),
209
- currentAIEmployee: employee,
210
- };
211
- return scoped;
212
- }
213
-
214
- export function createExternalRagSearchTool(plugin: any) {
215
- return {
216
- scope: 'CUSTOM' as const,
217
- execution: 'backend' as const,
218
- defaultPermission: 'ALLOW' as const,
219
-
220
- introduction: {
221
- title: 'External RAG Search',
222
- about:
223
- 'Search NocoBase knowledge bases through plugin-knowledge-base, including EXTERNAL_RAG services that own chunking, embedding, and retrieval.',
224
- },
225
-
226
- definition: {
227
- name: TOOL_NAME,
228
- description: `Search configured knowledge bases for relevant context. Use this before answering questions that require documents, files, or datasource-backed knowledge.
229
-
230
- The search may be served by an external RAG service. Results include content plus source identifiers such as id, filename, collection, and recordId when the external service provides them.`,
231
- schema: z.object({
232
- query: z.string().min(1).describe('Natural-language search query.'),
233
- knowledgeBaseIds: z
234
- .array(z.string().min(1))
235
- .optional()
236
- .describe(
237
- 'Optional list of NocoBase knowledge base IDs to search. If omitted, all accessible KBs are searched.',
238
- ),
239
- topK: z.number().int().min(1).max(20).optional().describe('Maximum results to return. Default 5, max 20.'),
240
- scoreThreshold: z
241
- .number()
242
- .min(0)
243
- .max(1)
244
- .optional()
245
- .describe('Minimum relevance score. Default is controlled by plugin-knowledge-base.'),
246
- }),
247
- },
248
-
249
- invoke: async (
250
- ctx: ToolContext,
251
- args: { query?: string; knowledgeBaseIds?: string[]; topK?: number; scoreThreshold?: number },
252
- runtime?: ToolRuntime,
253
- ) => {
254
- const query = typeof args?.query === 'string' ? args.query.trim() : '';
255
- if (!query) {
256
- return { status: 'error' as const, content: 'Missing required field: query.' };
257
- }
258
-
259
- const agent = await resolveAgent(ctx, runtime);
260
- if (!agent) {
261
- return {
262
- status: 'error' as const,
263
- content: 'Unable to determine the requesting AI Employee. Knowledge base search is denied.',
264
- };
265
- }
266
- if (!agent.knowledgeBaseIds.length) {
267
- return {
268
- status: 'error' as const,
269
- content: `AI Employee "${agent.username}" has no assigned knowledge bases.`,
270
- };
271
- }
272
-
273
- const requestedIds = Array.isArray(args.knowledgeBaseIds) ? args.knowledgeBaseIds.map(String) : undefined;
274
- const unauthorizedIds = requestedIds?.filter((id) => !agent.knowledgeBaseIds.includes(id)) ?? [];
275
- if (unauthorizedIds.length) {
276
- return {
277
- status: 'error' as const,
278
- content: `Knowledge base IDs are not assigned to AI Employee "${agent.username}": ${unauthorizedIds.join(
279
- ', ',
280
- )}.`,
281
- };
282
- }
283
-
284
- const kbPlugin = ctx.app?.pm?.get?.('plugin-knowledge-base') as
285
- | {
286
- searchKnowledgeBases?: (
287
- requestContext: ToolContext,
288
- searchQuery: string,
289
- options: {
290
- knowledgeBaseIds: string[];
291
- topK?: number;
292
- scoreThreshold?: number;
293
- rerank: boolean;
294
- },
295
- ) => Promise<unknown[]>;
296
- }
297
- | undefined;
298
- if (!kbPlugin?.searchKnowledgeBases) {
299
- return {
300
- status: 'error' as const,
301
- content: 'plugin-knowledge-base is not installed or does not expose searchKnowledgeBases().',
302
- };
303
- }
304
-
305
- try {
306
- const results = await kbPlugin.searchKnowledgeBases(withAgentIdentity(ctx, agent.username), query, {
307
- knowledgeBaseIds: requestedIds ?? agent.knowledgeBaseIds,
308
- topK: args.topK,
309
- scoreThreshold: args.scoreThreshold,
310
- rerank: true,
311
- });
312
-
313
- return {
314
- status: 'success' as const,
315
- content: JSON.stringify({
316
- query,
317
- results: results.map(normalizeResult),
318
- }),
319
- };
320
- } catch (error: unknown) {
321
- plugin.app.log?.error?.('[AgentOrchestrator] external_rag_search failed', error);
322
- return {
323
- status: 'error' as const,
324
- content: `External RAG search failed: ${error instanceof Error ? error.message : String(error)}`,
325
- };
326
- }
327
- },
328
- };
329
- }
1
+ import { z } from 'zod';
2
+
3
+ const TOOL_NAME = 'external_rag_search';
4
+ const MAX_CONTENT_LENGTH = 4000;
5
+ const MAX_METADATA_VALUE_LENGTH = 500;
6
+ const METADATA_FIELDS = [
7
+ 'id',
8
+ 'title',
9
+ 'filename',
10
+ 'fileName',
11
+ 'name',
12
+ 'source',
13
+ 'url',
14
+ 'fileUrl',
15
+ 'sourceUrl',
16
+ 'collection',
17
+ 'collectionName',
18
+ 'recordId',
19
+ 'rowId',
20
+ 'documentId',
21
+ 'docId',
22
+ 'fileId',
23
+ 'page',
24
+ 'pageNumber',
25
+ 'chunkIndex',
26
+ ] as const;
27
+
28
+ type RecordLike = Record<string, unknown>;
29
+
30
+ type Repository = {
31
+ findOne?: (options: RecordLike) => Promise<unknown>;
32
+ };
33
+
34
+ type ToolContext = {
35
+ app?: {
36
+ pm?: {
37
+ get?: (name: string) => unknown;
38
+ };
39
+ };
40
+ db?: {
41
+ getRepository?: (name: string) => Repository | undefined;
42
+ };
43
+ state?: RecordLike;
44
+ _currentAIEmployee?: unknown;
45
+ };
46
+
47
+ type ToolRuntime = {
48
+ toolCallId?: string;
49
+ };
50
+
51
+ type ResolvedAgent = {
52
+ username: string;
53
+ knowledgeBaseIds: string[];
54
+ };
55
+
56
+ function truncate(value: unknown, max = MAX_CONTENT_LENGTH) {
57
+ const text = typeof value === 'string' ? value : value == null ? '' : String(value);
58
+ return text.length > max ? `${text.slice(0, max)}...` : text;
59
+ }
60
+
61
+ function firstString(...values: unknown[]) {
62
+ for (const value of values) {
63
+ if (typeof value === 'string' && value.trim()) {
64
+ return value.trim();
65
+ }
66
+ if (typeof value === 'number' && Number.isFinite(value)) {
67
+ return String(value);
68
+ }
69
+ }
70
+ return undefined;
71
+ }
72
+
73
+ function toRecord(value: unknown): RecordLike {
74
+ return value && typeof value === 'object' && !Array.isArray(value) ? (value as RecordLike) : {};
75
+ }
76
+
77
+ function readModelValue(record: unknown, key: string): unknown {
78
+ const model = record as { get?: (name: string) => unknown; [key: string]: unknown };
79
+ return typeof model?.get === 'function' ? model.get(key) : model?.[key];
80
+ }
81
+
82
+ function toPlain(record: unknown): RecordLike {
83
+ const model = record as { toJSON?: () => unknown };
84
+ return toRecord(typeof model?.toJSON === 'function' ? model.toJSON() : record);
85
+ }
86
+
87
+ function sanitizeMetadata(value: unknown): RecordLike {
88
+ const metadata = toRecord(value);
89
+ return Object.fromEntries(
90
+ METADATA_FIELDS.flatMap((key) => {
91
+ const field = metadata[key];
92
+ if (typeof field === 'string') {
93
+ return [[key, truncate(field, MAX_METADATA_VALUE_LENGTH)]];
94
+ }
95
+ if (typeof field === 'number' || typeof field === 'boolean') {
96
+ return [[key, field]];
97
+ }
98
+ return [];
99
+ }),
100
+ );
101
+ }
102
+
103
+ function normalizeResult(result: unknown) {
104
+ const record = toRecord(result);
105
+ const metadata = sanitizeMetadata(record.metadata);
106
+ const sourceId = firstString(
107
+ record.id,
108
+ metadata.id,
109
+ metadata.sourceId,
110
+ metadata.documentId,
111
+ metadata.docId,
112
+ metadata.fileId,
113
+ metadata.recordId,
114
+ );
115
+ const filename = firstString(metadata.filename, metadata.fileName, metadata.name, metadata.title, metadata.source);
116
+
117
+ return {
118
+ content: truncate(record.content),
119
+ score: Number(record.rerankScore ?? record.score ?? record.vectorScore ?? 0),
120
+ knowledgeBaseId: record.knowledgeBaseId,
121
+ knowledgeBaseName: record.knowledgeBaseName,
122
+ source: {
123
+ id: sourceId,
124
+ filename,
125
+ url: firstString(metadata.url, metadata.fileUrl, metadata.sourceUrl),
126
+ collection: firstString(metadata.collection, metadata.collectionName),
127
+ recordId: firstString(metadata.recordId, metadata.rowId),
128
+ },
129
+ metadata,
130
+ };
131
+ }
132
+
133
+ function getContextAgentUsername(ctx: ToolContext): string | undefined {
134
+ const direct = ctx._currentAIEmployee ?? ctx.state?.currentAIEmployee;
135
+ if (typeof direct === 'string' && direct.trim()) {
136
+ return direct.trim();
137
+ }
138
+ const employee = toRecord(direct);
139
+ return firstString(employee.username, employee.name);
140
+ }
141
+
142
+ async function resolveAgentFromToolCall(ctx: ToolContext, runtime?: ToolRuntime): Promise<string | undefined> {
143
+ const direct = getContextAgentUsername(ctx);
144
+ if (direct) {
145
+ return direct;
146
+ }
147
+
148
+ const toolCallId = runtime?.toolCallId;
149
+ if (!toolCallId) {
150
+ return undefined;
151
+ }
152
+
153
+ const toolMessage = await ctx.db?.getRepository?.('aiToolMessages')?.findOne?.({
154
+ filter: { toolCallId },
155
+ });
156
+ const sessionId = firstString(readModelValue(toolMessage, 'sessionId'));
157
+ if (!sessionId) {
158
+ return undefined;
159
+ }
160
+
161
+ const conversation = await ctx.db?.getRepository?.('aiConversations')?.findOne?.({
162
+ filter: { sessionId },
163
+ });
164
+ return firstString(readModelValue(conversation, 'aiEmployeeUsername'));
165
+ }
166
+
167
+ function readKnowledgeBaseIds(employee: unknown): string[] {
168
+ const settings = toRecord(readModelValue(employee, 'knowledgeBase'));
169
+ // NocoBase currently persists this setting as `knowledgeBaseIds`; early
170
+ // orchestrator configurations used `knowledgeBaseKeys`. Prefer the legacy
171
+ // value when it is populated, but fall back to the current field so either
172
+ // configuration can enforce the same retrieval boundary.
173
+ const legacyIds = settings.knowledgeBaseKeys;
174
+ const ids = Array.isArray(legacyIds) && legacyIds.length ? legacyIds : settings.knowledgeBaseIds;
175
+ return Array.isArray(ids)
176
+ ? Array.from(
177
+ new Set(
178
+ ids.filter((id): id is string | number => typeof id === 'string' || typeof id === 'number').map(String),
179
+ ),
180
+ )
181
+ : [];
182
+ }
183
+
184
+ async function resolveAgent(ctx: ToolContext, runtime?: ToolRuntime): Promise<ResolvedAgent | undefined> {
185
+ const username = await resolveAgentFromToolCall(ctx, runtime);
186
+ if (!username) {
187
+ return undefined;
188
+ }
189
+
190
+ const employee = await ctx.db?.getRepository?.('aiEmployees')?.findOne?.({
191
+ filter: { username },
192
+ });
193
+ if (!employee) {
194
+ return undefined;
195
+ }
196
+
197
+ return {
198
+ username,
199
+ knowledgeBaseIds: readKnowledgeBaseIds(employee),
200
+ };
201
+ }
202
+
203
+ function withAgentIdentity(ctx: ToolContext, username: string): ToolContext {
204
+ const scoped = Object.create(ctx) as ToolContext;
205
+ const employee = { username };
206
+ scoped._currentAIEmployee = employee;
207
+ scoped.state = {
208
+ ...(ctx.state ?? {}),
209
+ currentAIEmployee: employee,
210
+ };
211
+ return scoped;
212
+ }
213
+
214
+ export function createExternalRagSearchTool(plugin: any) {
215
+ return {
216
+ scope: 'CUSTOM' as const,
217
+ execution: 'backend' as const,
218
+ defaultPermission: 'ALLOW' as const,
219
+
220
+ introduction: {
221
+ title: 'External RAG Search',
222
+ about:
223
+ 'Search NocoBase knowledge bases through plugin-knowledge-base, including EXTERNAL_RAG services that own chunking, embedding, and retrieval.',
224
+ },
225
+
226
+ definition: {
227
+ name: TOOL_NAME,
228
+ description: `Search configured knowledge bases for relevant context. Use this before answering questions that require documents, files, or datasource-backed knowledge.
229
+
230
+ The search may be served by an external RAG service. Results include content plus source identifiers such as id, filename, collection, and recordId when the external service provides them.`,
231
+ schema: z.object({
232
+ query: z.string().min(1).describe('Natural-language search query.'),
233
+ knowledgeBaseIds: z
234
+ .array(z.string().min(1))
235
+ .optional()
236
+ .describe(
237
+ 'Optional list of NocoBase knowledge base IDs to search. If omitted, all accessible KBs are searched.',
238
+ ),
239
+ topK: z.number().int().min(1).max(20).optional().describe('Maximum results to return. Default 5, max 20.'),
240
+ scoreThreshold: z
241
+ .number()
242
+ .min(0)
243
+ .max(1)
244
+ .optional()
245
+ .describe('Minimum relevance score. Default is controlled by plugin-knowledge-base.'),
246
+ }),
247
+ },
248
+
249
+ invoke: async (
250
+ ctx: ToolContext,
251
+ args: { query?: string; knowledgeBaseIds?: string[]; topK?: number; scoreThreshold?: number },
252
+ runtime?: ToolRuntime,
253
+ ) => {
254
+ const query = typeof args?.query === 'string' ? args.query.trim() : '';
255
+ if (!query) {
256
+ return { status: 'error' as const, content: 'Missing required field: query.' };
257
+ }
258
+
259
+ const agent = await resolveAgent(ctx, runtime);
260
+ if (!agent) {
261
+ return {
262
+ status: 'error' as const,
263
+ content: 'Unable to determine the requesting AI Employee. Knowledge base search is denied.',
264
+ };
265
+ }
266
+ if (!agent.knowledgeBaseIds.length) {
267
+ return {
268
+ status: 'error' as const,
269
+ content: `AI Employee "${agent.username}" has no assigned knowledge bases.`,
270
+ };
271
+ }
272
+
273
+ const requestedIds = Array.isArray(args.knowledgeBaseIds) ? args.knowledgeBaseIds.map(String) : undefined;
274
+ const unauthorizedIds = requestedIds?.filter((id) => !agent.knowledgeBaseIds.includes(id)) ?? [];
275
+ if (unauthorizedIds.length) {
276
+ return {
277
+ status: 'error' as const,
278
+ content: `Knowledge base IDs are not assigned to AI Employee "${agent.username}": ${unauthorizedIds.join(
279
+ ', ',
280
+ )}.`,
281
+ };
282
+ }
283
+
284
+ const kbPlugin = ctx.app?.pm?.get?.('plugin-knowledge-base') as
285
+ | {
286
+ searchKnowledgeBases?: (
287
+ requestContext: ToolContext,
288
+ searchQuery: string,
289
+ options: {
290
+ knowledgeBaseIds: string[];
291
+ topK?: number;
292
+ scoreThreshold?: number;
293
+ rerank: boolean;
294
+ },
295
+ ) => Promise<unknown[]>;
296
+ }
297
+ | undefined;
298
+ if (!kbPlugin?.searchKnowledgeBases) {
299
+ return {
300
+ status: 'error' as const,
301
+ content: 'plugin-knowledge-base is not installed or does not expose searchKnowledgeBases().',
302
+ };
303
+ }
304
+
305
+ try {
306
+ const results = await kbPlugin.searchKnowledgeBases(withAgentIdentity(ctx, agent.username), query, {
307
+ knowledgeBaseIds: requestedIds ?? agent.knowledgeBaseIds,
308
+ topK: args.topK,
309
+ scoreThreshold: args.scoreThreshold,
310
+ rerank: true,
311
+ });
312
+
313
+ return {
314
+ status: 'success' as const,
315
+ content: JSON.stringify({
316
+ query,
317
+ results: results.map(normalizeResult),
318
+ }),
319
+ };
320
+ } catch (error: unknown) {
321
+ plugin.app.log?.error?.('[AgentOrchestrator] external_rag_search failed', error);
322
+ return {
323
+ status: 'error' as const,
324
+ content: `External RAG search failed: ${error instanceof Error ? error.message : String(error)}`,
325
+ };
326
+ }
327
+ },
328
+ };
329
+ }