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.
- package/README.md +207 -204
- package/client-v2.d.ts +2 -2
- package/client-v2.js +1 -1
- package/client.d.ts +2 -2
- package/client.js +1 -1
- package/dist/client/117.2e4cb0477da3db1f.js +10 -0
- package/dist/client/253.93deb9e0192e76a5.js +10 -0
- package/dist/client/325.8f7f509bdb35e142.js +10 -0
- package/dist/client/404.498d2d9516dd1dce.js +10 -0
- package/dist/client/418.6f01da17774a5a25.js +10 -0
- package/dist/client/53.774ff07505d521fa.js +10 -0
- package/dist/client/619.e342b0fa467d39ca.js +10 -0
- package/dist/client/627.fdd60bcc0f3a9cf6.js +10 -0
- package/dist/client/652.477e21bfff67bc1c.js +10 -0
- package/dist/client/981.e0546ffc34afedcd.js +10 -0
- package/dist/client/993.5d04b510835ab0d2.js +10 -0
- package/dist/client/index.js +1 -1
- package/dist/client-v2/117.ccf43ae8631f7d74.js +10 -0
- package/dist/client-v2/214.cdf76752053a8990.js +10 -0
- package/dist/client-v2/253.1198df22f5baf304.js +10 -0
- package/dist/client-v2/264.78887ff88f969467.js +10 -0
- package/dist/client-v2/325.fafe5a6e83ba9cb3.js +10 -0
- package/dist/client-v2/404.9ba964c28a151c81.js +10 -0
- package/dist/client-v2/{41.3deb9e57a0f64fc4.js → 41.b28cf7a675a603d1.js} +1 -1
- package/dist/client-v2/418.55b6b28cda8bb5f3.js +10 -0
- package/dist/client-v2/{53.349fff8db80b19d4.js → 53.282081f97e4308c6.js} +1 -1
- package/dist/client-v2/{619.0a2144aaffefe018.js → 619.8c03913873785fb6.js} +1 -1
- package/dist/client-v2/627.e16f4a0dd596c3e6.js +10 -0
- package/dist/client-v2/652.1a48364774d5383a.js +10 -0
- package/dist/client-v2/{70.ffff2997c10fd4b0.js → 70.9166ed70906d041f.js} +1 -1
- package/dist/client-v2/{981.e4a1f41cfc94a856.js → 981.a81521f0296c7db8.js} +1 -1
- package/dist/client-v2/993.ca5b28f1e2b4c1ef.js +10 -0
- package/dist/client-v2/index.js +1 -1
- package/dist/externalVersion.js +10 -7
- package/dist/locale/en-US.json +229 -1
- package/dist/locale/zh-CN.json +229 -1
- package/dist/node_modules/adm-zip/adm-zip.js +1 -1
- package/dist/node_modules/adm-zip/package.json +1 -1
- package/dist/node_modules/ajv/package.json +1 -1
- package/dist/node_modules/zod/index.cjs +1 -1
- package/dist/node_modules/zod/package.json +1 -1
- package/dist/server/collections/agent-execution-spans.js +145 -6
- package/dist/server/collections/agent-governance-audit-events.js +47 -0
- package/dist/server/collections/agent-governance-policies.js +47 -0
- package/dist/server/collections/agent-governance-policy-versions.js +48 -0
- package/dist/server/collections/agent-governance-prompt-bindings.js +50 -0
- package/dist/server/collections/agent-loop-runs.js +23 -5
- package/dist/server/migrations/20261110000000-add-usage-pricing-snapshots.js +117 -0
- package/dist/server/migrations/20261110010000-add-usage-department-attribution.js +54 -0
- package/dist/server/plugin.js +114 -33
- package/dist/server/resources/agent-governance.js +192 -0
- package/dist/server/resources/agent-harness-profile.js +11 -3
- package/dist/server/resources/agent-monitor.js +109 -339
- package/dist/server/resources/agent-usage.js +423 -0
- package/dist/server/resources/native-monitor-format.js +179 -0
- package/dist/server/resources/tracing.js +35 -12
- package/dist/server/services/AgentGovernanceService.js +500 -0
- package/dist/server/services/DepartmentAttribution.js +65 -0
- package/dist/server/services/ExecutionSpanService.js +96 -3
- package/dist/server/services/GovernanceAdmission.js +211 -0
- package/dist/server/services/HarnessCapabilities.js +118 -0
- package/dist/server/services/LoopBudgetService.js +29 -11
- package/dist/server/services/LoopRunRepository.js +15 -6
- package/dist/server/services/LoopRunStateMachine.js +18 -7
- package/dist/server/services/LoopTriggerService.js +1 -1
- package/dist/server/services/LoopWorkerService.js +66 -32
- package/dist/server/services/ManagedPromptProtection.js +99 -0
- package/dist/server/services/NativeAgentMonitorSyncService.js +584 -0
- package/dist/server/services/NativeSubAgentObserver.js +141 -508
- package/dist/server/services/NativeUsageAttribution.js +97 -0
- package/dist/server/services/TokenTracker.js +787 -104
- package/dist/server/services/TracingRetentionPolicy.js +66 -0
- package/dist/server/services/VerificationService.js +18 -8
- package/dist/server/skill-hub/sandbox-config.json +6 -6
- package/dist/server/utils/ensure-indexes.js +14 -5
- package/package.json +63 -53
- package/server.d.ts +2 -2
- package/server.js +1 -1
- package/src/client/AgentRunsTab.tsx +2 -2
- package/src/client/ApprovalsTab.tsx +2 -2
- package/src/client/HarnessProfilesTab.tsx +2 -2
- package/src/client/OrchestratorSettings.tsx +152 -152
- package/src/client/SkillPages.tsx +41 -0
- package/src/client/__tests__/embedded-settings.test.tsx +232 -0
- package/src/client/hooks/useRunEventStream.ts +76 -76
- package/src/client/index.tsx +2 -2
- package/src/client/plugin.tsx +76 -33
- package/src/client/skill-hub/components/ExecutionHistory.tsx +200 -200
- package/src/client/skill-hub/components/GitSkillImport.tsx +562 -562
- package/src/client/skill-hub/components/LoopSettings.tsx +331 -331
- package/src/client/skill-hub/components/SkillEditor.tsx +460 -460
- package/src/client/skill-hub/components/SkillManager.tsx +194 -194
- package/src/client/skill-hub/components/SkillMetrics.tsx +162 -162
- package/src/client/skill-hub/components/SkillTestPanel.tsx +141 -141
- package/src/client/skill-hub/index.tsx +6 -6
- package/src/client/skill-hub/locale.ts +16 -16
- package/src/client/skill-hub/tools/InteractionSchemasProvider.tsx +132 -132
- package/src/client/skill-hub/tools/SkillHubCard.tsx +104 -104
- package/src/client/skill-hub/tools/loopTemplates.ts +52 -52
- package/src/client/skill-hub/tools/registerSkillLoopCards.ts +71 -71
- package/src/client/skill-hub/utils/jsonFields.ts +41 -41
- package/src/client-v2/__tests__/embedded-settings.test.tsx +193 -0
- package/src/client-v2/components/AIEmployeeSelect.tsx +47 -47
- package/src/client-v2/components/AIEmployeesContext.tsx +97 -97
- package/src/client-v2/components/AgentBindingsTab.tsx +269 -269
- package/src/client-v2/components/AgentRunsTab.tsx +92 -83
- package/src/client-v2/components/ApprovalsTab.tsx +337 -337
- package/src/client-v2/components/EmployeeGovernanceTab.tsx +702 -0
- package/src/client-v2/components/HarnessProfilesTab.tsx +704 -541
- package/src/client-v2/components/KnowledgeAccessTab.tsx +116 -116
- package/src/client-v2/components/RetrievalTraceTab.tsx +162 -162
- package/src/client-v2/components/UsageGovernanceTab.tsx +386 -0
- package/src/client-v2/index.tsx +1 -1
- package/src/client-v2/pages/AgentBindingsPage.tsx +22 -13
- package/src/client-v2/pages/ApprovalsPage.tsx +19 -10
- package/src/client-v2/pages/EmployeeGovernancePage.tsx +22 -0
- package/src/client-v2/pages/ExecutionHistoryPage.tsx +19 -10
- package/src/client-v2/pages/HarnessProfilesPage.tsx +19 -10
- package/src/client-v2/pages/KnowledgeAccessPage.tsx +19 -10
- package/src/client-v2/pages/LoopSettingsPage.tsx +19 -10
- package/src/client-v2/pages/MemoryInspectorPage.tsx +22 -13
- package/src/client-v2/pages/RetrievalTracePage.tsx +19 -10
- package/src/client-v2/pages/RulesPage.tsx +22 -13
- package/src/client-v2/pages/SkillDefinitionsPage.tsx +19 -10
- package/src/client-v2/pages/SkillMetricsPage.tsx +19 -10
- package/src/client-v2/pages/TracingPage.tsx +22 -13
- package/src/client-v2/pages/UsageGovernancePage.tsx +22 -0
- package/src/client-v2/plugin.tsx +139 -111
- package/src/client-v2/skill-hub/components/ExecutionHistory.tsx +196 -196
- package/src/client-v2/skill-hub/components/FileLinkList.tsx +37 -37
- package/src/client-v2/skill-hub/components/GitSkillImport.tsx +539 -539
- package/src/client-v2/skill-hub/components/LoopSettings.tsx +331 -331
- package/src/client-v2/skill-hub/components/SkillEditor.tsx +453 -453
- package/src/client-v2/skill-hub/components/SkillManager.tsx +191 -174
- package/src/client-v2/skill-hub/components/SkillMetrics.tsx +162 -162
- package/src/client-v2/skill-hub/components/SkillTestPanel.tsx +135 -135
- package/src/client-v2/skill-hub/locale.ts +13 -13
- package/src/client-v2/skill-hub/tools/InteractionSchemasProvider.tsx +62 -0
- package/src/client-v2/skill-hub/tools/SkillHubCard.tsx +104 -0
- package/src/client-v2/skill-hub/tools/__tests__/interactions.test.ts +110 -0
- package/src/client-v2/skill-hub/tools/interactions.ts +128 -0
- package/src/client-v2/skill-hub/tools/loopTemplates.ts +52 -52
- package/src/client-v2/skill-hub/utils/jsonFields.ts +41 -41
- package/src/client-v2/utils/jsonFields.ts +41 -41
- package/src/index.ts +2 -2
- package/src/locale/en-US.json +229 -1
- package/src/locale/zh-CN.json +229 -1
- package/src/server/__tests__/agent-execution-context.test.ts +18 -18
- package/src/server/__tests__/agent-governance.integration.test.ts +392 -0
- package/src/server/__tests__/agent-knowledge-insights.test.ts +123 -123
- package/src/server/__tests__/agent-monitor-acl.integration.test.ts +274 -0
- package/src/server/__tests__/agent-registry-service.test.ts +147 -147
- package/src/server/__tests__/agent-runtime-lifecycle.test.ts +46 -46
- package/src/server/__tests__/agent-usage-report.integration.test.ts +342 -0
- package/src/server/__tests__/code-validator.test.ts +63 -63
- package/src/server/__tests__/external-rag-search.test.ts +107 -107
- package/src/server/__tests__/harness-capabilities.test.ts +95 -0
- package/src/server/__tests__/harness-compiler.test.ts +214 -214
- package/src/server/__tests__/harness-profile-service.test.ts +167 -167
- package/src/server/__tests__/harness-runtime-policy.test.ts +293 -293
- package/src/server/__tests__/harness-tool-plan.test.ts +182 -172
- package/src/server/__tests__/input-schema-validator.test.ts +26 -26
- package/src/server/__tests__/loop-approval-decision.test.ts +577 -512
- package/src/server/__tests__/loop-approval-expiry.test.ts +258 -258
- package/src/server/__tests__/loop-budget-service.test.ts +36 -0
- package/src/server/__tests__/loop-pattern-schema.test.ts +73 -73
- package/src/server/__tests__/loop-run-repository.test.ts +32 -0
- package/src/server/__tests__/loop-run-state-machine.test.ts +101 -101
- package/src/server/__tests__/loop-trigger-service.test.ts +192 -148
- package/src/server/__tests__/loop-worker-claim.test.ts +72 -9
- package/src/server/__tests__/loop-worker-execution.test.ts +382 -317
- package/src/server/__tests__/native-agent-monitor-sync.test.ts +350 -0
- package/src/server/__tests__/native-sub-agent-observer.test.ts +470 -662
- package/src/server/__tests__/native-usage-attribution.integration.test.ts +175 -0
- package/src/server/__tests__/skill-access-service.test.ts +64 -64
- package/src/server/__tests__/skill-execute.test.ts +70 -70
- package/src/server/__tests__/skill-execution-task-policy.test.ts +140 -140
- package/src/server/__tests__/skill-sandbox-worker-mode.test.ts +15 -15
- package/src/server/__tests__/skill-settings.test.ts +63 -63
- package/src/server/__tests__/skill-tool-name.test.ts +23 -23
- package/src/server/__tests__/token-tracker.test.ts +639 -0
- package/src/server/__tests__/tool-loop-detection.test.ts +276 -276
- package/src/server/__tests__/tracing-retention-policy.test.ts +37 -0
- package/src/server/__tests__/usage-ledger.integration.test.ts +194 -0
- package/src/server/collections/agent-execution-spans.ts +393 -245
- package/src/server/collections/agent-governance-audit-events.ts +26 -0
- package/src/server/collections/agent-governance-policies.ts +26 -0
- package/src/server/collections/agent-governance-policy-versions.ts +27 -0
- package/src/server/collections/agent-governance-prompt-bindings.ts +29 -0
- package/src/server/collections/agent-loop-action-approvals.ts +39 -39
- package/src/server/collections/agent-loop-runs.ts +396 -369
- package/src/server/collections/agent-loop-steps.ts +220 -220
- package/src/server/collections/agent-memory-contexts.ts +95 -95
- package/src/server/collections/orchestrator-config.ts +87 -87
- package/src/server/collections/orchestrator-logs.ts +116 -116
- package/src/server/collections/skill-definitions.ts +159 -159
- package/src/server/collections/skill-executions.ts +154 -154
- package/src/server/collections/skill-loop-configs.ts +65 -65
- package/src/server/collections/skill-metrics.ts +36 -36
- package/src/server/collections/skill-registry-installations.ts +41 -41
- package/src/server/collections/skill-worker-configs.ts +86 -86
- package/src/server/index.ts +1 -1
- package/src/server/migrations/20260423000000-add-progress-fields.ts +50 -50
- package/src/server/migrations/20260425000000-add-interaction-schema.ts +37 -37
- package/src/server/migrations/20260427000000-add-tracing-detail-fields.ts +41 -41
- package/src/server/migrations/20260427000001-change-other-json-to-text.ts +61 -61
- package/src/server/migrations/20260524001000-add-plan-approval-and-harness-profiles.ts +145 -145
- package/src/server/migrations/20260601000000-add-token-fields.ts +89 -89
- package/src/server/migrations/20260615000000-normalize-ai-employee-tool-bindings.ts +39 -39
- package/src/server/migrations/20260621000000-native-policy-profile-defaults.ts +190 -190
- package/src/server/migrations/20260727000000-remove-unused-knowledge-scopes.ts +25 -25
- package/src/server/migrations/20260727010000-backfill-skill-tool-names.ts +45 -45
- package/src/server/migrations/20261110000000-add-usage-pricing-snapshots.ts +117 -0
- package/src/server/migrations/20261110010000-add-usage-department-attribution.ts +35 -0
- package/src/server/plugin.ts +674 -573
- package/src/server/resources/agent-governance.ts +168 -0
- package/src/server/resources/agent-harness-profile.ts +110 -94
- package/src/server/resources/agent-knowledge-insights.ts +306 -306
- package/src/server/resources/agent-loop-approval.ts +84 -84
- package/src/server/resources/agent-loop-events-stream.ts +108 -108
- package/src/server/resources/agent-loop.ts +252 -252
- package/src/server/resources/agent-monitor.ts +215 -482
- package/src/server/resources/agent-usage.ts +420 -0
- package/src/server/resources/native-monitor-format.ts +157 -0
- package/src/server/resources/tracing.ts +303 -267
- package/src/server/services/AgentExecutionContext.ts +23 -23
- package/src/server/services/AgentGovernanceService.ts +548 -0
- package/src/server/services/AgentMemoryContextService.ts +344 -344
- package/src/server/services/AgentRegistryService.ts +220 -220
- package/src/server/services/AgentRuntimeLifecycle.ts +64 -64
- package/src/server/services/CodeValidator.ts +238 -238
- package/src/server/services/DepartmentAttribution.ts +54 -0
- package/src/server/services/DurableCircuitBreakerService.ts +235 -235
- package/src/server/services/ExecutionSpanService.ts +278 -146
- package/src/server/services/FileManager.ts +159 -159
- package/src/server/services/GovernanceAdmission.ts +239 -0
- package/src/server/services/HarnessCapabilities.ts +119 -0
- package/src/server/services/HarnessCompiler.ts +170 -170
- package/src/server/services/HarnessProfileService.ts +235 -235
- package/src/server/services/HarnessSchema.ts +194 -194
- package/src/server/services/InputSchemaValidator.ts +44 -44
- package/src/server/services/LoopBudgetService.ts +332 -271
- package/src/server/services/LoopControlService.ts +120 -120
- package/src/server/services/LoopPatternSchema.ts +231 -231
- package/src/server/services/LoopPatternService.ts +171 -171
- package/src/server/services/LoopRunRepository.ts +350 -332
- package/src/server/services/LoopRunStateMachine.ts +545 -525
- package/src/server/services/LoopSchedulerService.ts +195 -195
- package/src/server/services/LoopTriggerService.ts +169 -159
- package/src/server/services/LoopWorkerService.ts +986 -912
- package/src/server/services/ManagedPromptProtection.ts +88 -0
- package/src/server/services/NativeAgentMonitorSyncService.ts +691 -0
- package/src/server/services/NativeSubAgentObserver.ts +331 -757
- package/src/server/services/NativeUsageAttribution.ts +98 -0
- package/src/server/services/PathLockService.ts +317 -317
- package/src/server/services/PluginAiRuntimeAdapter.ts +387 -387
- package/src/server/services/RunEventBus.ts +58 -58
- package/src/server/services/SandboxRunner.ts +492 -492
- package/src/server/services/SkillAccessService.ts +175 -175
- package/src/server/services/SkillManager.ts +585 -585
- package/src/server/services/SkillRepositoryService.ts +236 -236
- package/src/server/services/TokenTracker.ts +1158 -287
- package/src/server/services/ToolLoopDetectionService.ts +210 -210
- package/src/server/services/TracingRetentionPolicy.ts +56 -0
- package/src/server/services/VerificationSchema.ts +31 -31
- package/src/server/services/VerificationService.ts +332 -313
- package/src/server/services/WorkerEnvManager.ts +198 -198
- package/src/server/services/__tests__/SkillRepositoryService.test.ts +33 -33
- package/src/server/services/harness-runtime-policy.ts +134 -134
- package/src/server/services/pythonGuardTemplate.ts +87 -87
- package/src/server/services/sandboxCapabilities.ts +348 -348
- package/src/server/skill-hub/actions/__tests__/git-import.test.ts +563 -563
- package/src/server/skill-hub/actions/git-import.ts +936 -936
- package/src/server/skill-hub/mcp/McpController.ts +107 -107
- package/src/server/skill-hub/middlewares/git-import-request-method-policy.ts +51 -51
- package/src/server/skill-hub/plugin.ts +1232 -1232
- package/src/server/skill-hub/sandbox-config.json +6 -6
- package/src/server/skill-hub/services/RegistrySkillInstallationService.ts +281 -281
- package/src/server/skill-hub/services/__tests__/RegistrySkillInstallationService.test.ts +295 -295
- package/src/server/skill-hub/tasks/SkillExecutionTask.ts +568 -568
- package/src/server/skill-hub/utils/json-fields.ts +57 -57
- package/src/server/tools/delegate-task.ts +30 -30
- package/src/server/tools/external-rag-search.ts +329 -329
- package/src/server/tools/skill-execute.ts +216 -216
- package/src/server/types.ts +21 -21
- package/src/server/utils/ai-manager.ts +24 -24
- package/src/server/utils/ctx-utils.ts +132 -132
- package/src/server/utils/ensure-indexes.ts +119 -96
- package/src/server/utils/ha-lock.ts +80 -80
- package/src/server/utils/loop-pattern-context.ts +84 -84
- package/src/server/utils/record-utils.ts +19 -19
- package/src/server/utils/skill-settings.ts +135 -135
- package/src/server/utils/skill-tool-name.ts +58 -58
- package/dist/client-v2/117.7565cff57c39318a.js +0 -10
- package/dist/client-v2/214.106635011859dede.js +0 -10
- package/dist/client-v2/253.59577b40d9875be0.js +0 -10
- package/dist/client-v2/264.7ed8bee71fa5935c.js +0 -10
- package/dist/client-v2/418.41ed200e7d6da332.js +0 -10
- package/dist/client-v2/794.a67a2614405ba627.js +0 -10
- package/dist/client-v2/993.b0688fdc5ccb000a.js +0 -10
- package/dist/node_modules/simple-git/dist/cjs/index.js +0 -7399
- package/dist/node_modules/simple-git/dist/esm/index.js +0 -4745
- package/dist/node_modules/simple-git/dist/esm/package.json +0 -3
- package/dist/node_modules/simple-git/dist/src/lib/api.d.ts +0 -13
- package/dist/node_modules/simple-git/dist/src/lib/args/log-format.d.ts +0 -9
- package/dist/node_modules/simple-git/dist/src/lib/errors/git-construct-error.d.ts +0 -15
- package/dist/node_modules/simple-git/dist/src/lib/errors/git-error.d.ts +0 -30
- package/dist/node_modules/simple-git/dist/src/lib/errors/git-plugin-error.d.ts +0 -7
- package/dist/node_modules/simple-git/dist/src/lib/errors/git-response-error.d.ts +0 -32
- package/dist/node_modules/simple-git/dist/src/lib/errors/task-configuration-error.d.ts +0 -12
- package/dist/node_modules/simple-git/dist/src/lib/git-factory.d.ts +0 -15
- package/dist/node_modules/simple-git/dist/src/lib/git-logger.d.ts +0 -21
- package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-branch-delete.d.ts +0 -5
- package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-branch.d.ts +0 -2
- package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-commit.d.ts +0 -2
- package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-diff-summary.d.ts +0 -3
- package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-fetch.d.ts +0 -2
- package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-list-log-summary.d.ts +0 -6
- package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-merge.d.ts +0 -11
- package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-move.d.ts +0 -2
- package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-pull.d.ts +0 -6
- package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-push.d.ts +0 -4
- package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-remote-messages.d.ts +0 -5
- package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-remote-objects.d.ts +0 -3
- package/dist/node_modules/simple-git/dist/src/lib/plugins/abort-plugin.d.ts +0 -3
- package/dist/node_modules/simple-git/dist/src/lib/plugins/block-unsafe-operations-plugin.d.ts +0 -3
- package/dist/node_modules/simple-git/dist/src/lib/plugins/command-config-prefixing-plugin.d.ts +0 -2
- package/dist/node_modules/simple-git/dist/src/lib/plugins/completion-detection.plugin.d.ts +0 -3
- package/dist/node_modules/simple-git/dist/src/lib/plugins/custom-binary.plugin.d.ts +0 -3
- package/dist/node_modules/simple-git/dist/src/lib/plugins/error-detection.plugin.d.ts +0 -7
- package/dist/node_modules/simple-git/dist/src/lib/plugins/index.d.ts +0 -11
- package/dist/node_modules/simple-git/dist/src/lib/plugins/plugin-store.d.ts +0 -11
- package/dist/node_modules/simple-git/dist/src/lib/plugins/progress-monitor-plugin.d.ts +0 -3
- package/dist/node_modules/simple-git/dist/src/lib/plugins/simple-git-plugin.d.ts +0 -48
- package/dist/node_modules/simple-git/dist/src/lib/plugins/spawn-options-plugin.d.ts +0 -3
- package/dist/node_modules/simple-git/dist/src/lib/plugins/suffix-paths.plugin.d.ts +0 -2
- package/dist/node_modules/simple-git/dist/src/lib/plugins/timout-plugin.d.ts +0 -3
- package/dist/node_modules/simple-git/dist/src/lib/responses/BranchDeleteSummary.d.ts +0 -12
- package/dist/node_modules/simple-git/dist/src/lib/responses/BranchSummary.d.ts +0 -14
- package/dist/node_modules/simple-git/dist/src/lib/responses/CheckIgnore.d.ts +0 -4
- package/dist/node_modules/simple-git/dist/src/lib/responses/CleanSummary.d.ts +0 -9
- package/dist/node_modules/simple-git/dist/src/lib/responses/ConfigList.d.ts +0 -13
- package/dist/node_modules/simple-git/dist/src/lib/responses/DiffSummary.d.ts +0 -10
- package/dist/node_modules/simple-git/dist/src/lib/responses/FileStatusSummary.d.ts +0 -9
- package/dist/node_modules/simple-git/dist/src/lib/responses/GetRemoteSummary.d.ts +0 -11
- package/dist/node_modules/simple-git/dist/src/lib/responses/InitSummary.d.ts +0 -9
- package/dist/node_modules/simple-git/dist/src/lib/responses/MergeSummary.d.ts +0 -16
- package/dist/node_modules/simple-git/dist/src/lib/responses/PullSummary.d.ts +0 -25
- package/dist/node_modules/simple-git/dist/src/lib/responses/StatusSummary.d.ts +0 -19
- package/dist/node_modules/simple-git/dist/src/lib/responses/TagList.d.ts +0 -7
- package/dist/node_modules/simple-git/dist/src/lib/runners/git-executor-chain.d.ts +0 -25
- package/dist/node_modules/simple-git/dist/src/lib/runners/git-executor.d.ts +0 -14
- package/dist/node_modules/simple-git/dist/src/lib/runners/promise-wrapped.d.ts +0 -2
- package/dist/node_modules/simple-git/dist/src/lib/runners/scheduler.d.ts +0 -11
- package/dist/node_modules/simple-git/dist/src/lib/runners/tasks-pending-queue.d.ts +0 -23
- package/dist/node_modules/simple-git/dist/src/lib/simple-git-api.d.ts +0 -20
- package/dist/node_modules/simple-git/dist/src/lib/task-callback.d.ts +0 -2
- package/dist/node_modules/simple-git/dist/src/lib/tasks/apply-patch.d.ts +0 -3
- package/dist/node_modules/simple-git/dist/src/lib/tasks/branch.d.ts +0 -7
- package/dist/node_modules/simple-git/dist/src/lib/tasks/change-working-directory.d.ts +0 -2
- package/dist/node_modules/simple-git/dist/src/lib/tasks/check-ignore.d.ts +0 -2
- package/dist/node_modules/simple-git/dist/src/lib/tasks/check-is-repo.d.ts +0 -9
- package/dist/node_modules/simple-git/dist/src/lib/tasks/checkout.d.ts +0 -2
- package/dist/node_modules/simple-git/dist/src/lib/tasks/clean.d.ts +0 -25
- package/dist/node_modules/simple-git/dist/src/lib/tasks/clone.d.ts +0 -9
- package/dist/node_modules/simple-git/dist/src/lib/tasks/commit.d.ts +0 -4
- package/dist/node_modules/simple-git/dist/src/lib/tasks/config.d.ts +0 -8
- package/dist/node_modules/simple-git/dist/src/lib/tasks/count-objects.d.ts +0 -12
- package/dist/node_modules/simple-git/dist/src/lib/tasks/diff-name-status.d.ts +0 -12
- package/dist/node_modules/simple-git/dist/src/lib/tasks/diff.d.ts +0 -5
- package/dist/node_modules/simple-git/dist/src/lib/tasks/fetch.d.ts +0 -4
- package/dist/node_modules/simple-git/dist/src/lib/tasks/first-commit.d.ts +0 -2
- package/dist/node_modules/simple-git/dist/src/lib/tasks/grep.d.ts +0 -12
- package/dist/node_modules/simple-git/dist/src/lib/tasks/hash-object.d.ts +0 -5
- package/dist/node_modules/simple-git/dist/src/lib/tasks/init.d.ts +0 -3
- package/dist/node_modules/simple-git/dist/src/lib/tasks/log.d.ts +0 -32
- package/dist/node_modules/simple-git/dist/src/lib/tasks/merge.d.ts +0 -4
- package/dist/node_modules/simple-git/dist/src/lib/tasks/move.d.ts +0 -3
- package/dist/node_modules/simple-git/dist/src/lib/tasks/pull.d.ts +0 -3
- package/dist/node_modules/simple-git/dist/src/lib/tasks/push.d.ts +0 -9
- package/dist/node_modules/simple-git/dist/src/lib/tasks/remote.d.ts +0 -8
- package/dist/node_modules/simple-git/dist/src/lib/tasks/reset.d.ts +0 -11
- package/dist/node_modules/simple-git/dist/src/lib/tasks/show.d.ts +0 -2
- package/dist/node_modules/simple-git/dist/src/lib/tasks/stash-list.d.ts +0 -4
- package/dist/node_modules/simple-git/dist/src/lib/tasks/status.d.ts +0 -3
- package/dist/node_modules/simple-git/dist/src/lib/tasks/sub-module.d.ts +0 -5
- package/dist/node_modules/simple-git/dist/src/lib/tasks/tag.d.ts +0 -18
- package/dist/node_modules/simple-git/dist/src/lib/tasks/task.d.ts +0 -14
- package/dist/node_modules/simple-git/dist/src/lib/tasks/version.d.ts +0 -9
- package/dist/node_modules/simple-git/dist/src/lib/types/handlers.d.ts +0 -21
- package/dist/node_modules/simple-git/dist/src/lib/types/index.d.ts +0 -136
- package/dist/node_modules/simple-git/dist/src/lib/types/tasks.d.ts +0 -19
- package/dist/node_modules/simple-git/dist/src/lib/utils/argument-filters.d.ts +0 -14
- package/dist/node_modules/simple-git/dist/src/lib/utils/exit-codes.d.ts +0 -10
- package/dist/node_modules/simple-git/dist/src/lib/utils/git-output-streams.d.ts +0 -7
- package/dist/node_modules/simple-git/dist/src/lib/utils/index.d.ts +0 -8
- package/dist/node_modules/simple-git/dist/src/lib/utils/line-parser.d.ts +0 -15
- package/dist/node_modules/simple-git/dist/src/lib/utils/simple-git-options.d.ts +0 -2
- package/dist/node_modules/simple-git/dist/src/lib/utils/task-options.d.ts +0 -13
- package/dist/node_modules/simple-git/dist/src/lib/utils/task-parser.d.ts +0 -5
- package/dist/node_modules/simple-git/dist/src/lib/utils/util.d.ts +0 -47
- package/dist/node_modules/simple-git/dist/typings/errors.d.ts +0 -5
- package/dist/node_modules/simple-git/dist/typings/index.d.ts +0 -14
- package/dist/node_modules/simple-git/dist/typings/response.d.ts +0 -556
- package/dist/node_modules/simple-git/dist/typings/simple-git.d.ts +0 -1033
- package/dist/node_modules/simple-git/dist/typings/types.d.ts +0 -22
- package/dist/node_modules/simple-git/node_modules/debug/package.json +0 -64
- package/dist/node_modules/simple-git/node_modules/debug/src/browser.js +0 -272
- package/dist/node_modules/simple-git/node_modules/debug/src/common.js +0 -292
- package/dist/node_modules/simple-git/node_modules/debug/src/index.js +0 -10
- package/dist/node_modules/simple-git/node_modules/debug/src/node.js +0 -263
- package/dist/node_modules/simple-git/package.json +0 -1
- 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
|
+
}
|