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
|
@@ -0,0 +1,548 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* This file is part of the NocoBase (R) project.
|
|
3
|
+
* Copyright (c) 2020-2024 NocoBase Co., Ltd.
|
|
4
|
+
* Authors: NocoBase Team.
|
|
5
|
+
*
|
|
6
|
+
* This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
|
|
7
|
+
* For more information, please refer to: https://www.nocobase.com/agreement.
|
|
8
|
+
*/
|
|
9
|
+
|
|
10
|
+
import { AsyncLocalStorage } from 'node:async_hooks';
|
|
11
|
+
import { createHash } from 'node:crypto';
|
|
12
|
+
import type { Database, Filter, Model, Transaction } from '@nocobase/database';
|
|
13
|
+
import { z } from 'zod';
|
|
14
|
+
import { read } from '../utils/record-utils';
|
|
15
|
+
import { resolveUserDepartment } from './DepartmentAttribution';
|
|
16
|
+
|
|
17
|
+
const settingsSchema = z
|
|
18
|
+
.object({
|
|
19
|
+
instruction: z.string().max(50000).optional(),
|
|
20
|
+
systemPrompt: z.string().max(50000).nullable().optional(),
|
|
21
|
+
allowedModels: z.array(z.string().min(1).max(355)).max(200).optional(),
|
|
22
|
+
allow: z.boolean().optional(),
|
|
23
|
+
maxMonthlyTokens: z.number().int().nonnegative().nullable().optional(),
|
|
24
|
+
maxMonthlyCost: z.number().finite().nonnegative().nullable().optional(),
|
|
25
|
+
})
|
|
26
|
+
.strict();
|
|
27
|
+
|
|
28
|
+
export type GovernanceSettings = z.infer<typeof settingsSchema>;
|
|
29
|
+
export type GovernanceScope = 'department' | 'user' | 'employee';
|
|
30
|
+
type RecordValue = Model | Record<string, unknown>;
|
|
31
|
+
type ActivePolicy = {
|
|
32
|
+
id: number;
|
|
33
|
+
scope: GovernanceScope;
|
|
34
|
+
scopeId: string;
|
|
35
|
+
employeeUsername: string | null;
|
|
36
|
+
modelKey: string | null;
|
|
37
|
+
version: number;
|
|
38
|
+
versionId: number;
|
|
39
|
+
settings: GovernanceSettings;
|
|
40
|
+
};
|
|
41
|
+
|
|
42
|
+
const managedWrites = new AsyncLocalStorage<boolean>();
|
|
43
|
+
|
|
44
|
+
export function isManagedPromptWrite() {
|
|
45
|
+
return managedWrites.getStore() === true;
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
function idValue(value: unknown, _label: string): number {
|
|
49
|
+
const id = Number(value);
|
|
50
|
+
if (!Number.isSafeInteger(id) || id <= 0) throw new Error('Invalid governance identifier.');
|
|
51
|
+
return id;
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
function requiredText(value: unknown, _label: string, maxLength: number) {
|
|
55
|
+
if (typeof value !== 'string' || !value.trim() || value.trim().length > maxLength) {
|
|
56
|
+
throw new Error('Invalid governance text value.');
|
|
57
|
+
}
|
|
58
|
+
return value.trim();
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
function safeSettings(value: unknown, scope: GovernanceScope) {
|
|
62
|
+
const result = settingsSchema.safeParse(value);
|
|
63
|
+
if (!result.success) throw new Error('Invalid governance settings.');
|
|
64
|
+
const settings = result.data;
|
|
65
|
+
if (scope !== 'employee' && settings.systemPrompt !== undefined) {
|
|
66
|
+
throw new Error('A system prompt can only be configured for an employee policy.');
|
|
67
|
+
}
|
|
68
|
+
return settings;
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
function plain(row: RecordValue): Record<string, unknown> {
|
|
72
|
+
if ('toJSON' in row && typeof row.toJSON === 'function') return row.toJSON() as Record<string, unknown>;
|
|
73
|
+
return row as Record<string, unknown>;
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
function policyScope(value: unknown): GovernanceScope {
|
|
77
|
+
if (value === 'department' || value === 'user' || value === 'employee') return value;
|
|
78
|
+
throw new Error('Policy scope is invalid.');
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
export class AgentGovernanceService {
|
|
82
|
+
constructor(private readonly db: Database) {}
|
|
83
|
+
|
|
84
|
+
async list(input: { page?: unknown; pageSize?: unknown; scope?: unknown; scopeId?: unknown }) {
|
|
85
|
+
const page = Math.max(1, Math.trunc(Number(input.page) || 1));
|
|
86
|
+
const pageSize = Math.min(100, Math.max(1, Math.trunc(Number(input.pageSize) || 20)));
|
|
87
|
+
const filter: Record<string, unknown> = {};
|
|
88
|
+
if (input.scope) filter.scope = policyScope(input.scope);
|
|
89
|
+
if (input.scopeId) filter.scopeId = requiredText(input.scopeId, 'Scope id', 200);
|
|
90
|
+
const policies = this.db.getRepository('agentGovernancePolicies');
|
|
91
|
+
const [rows, count] = await Promise.all([
|
|
92
|
+
policies.find({
|
|
93
|
+
filter: filter as Filter,
|
|
94
|
+
sort: ['-updatedAt', '-id'],
|
|
95
|
+
limit: pageSize,
|
|
96
|
+
offset: (page - 1) * pageSize,
|
|
97
|
+
}),
|
|
98
|
+
policies.count({ filter: filter as Filter }),
|
|
99
|
+
]);
|
|
100
|
+
const versions = this.db.getRepository('agentGovernancePolicyVersions');
|
|
101
|
+
const data = await Promise.all(
|
|
102
|
+
rows.map(async (row: Model) => {
|
|
103
|
+
const policyId = idValue(read(row, 'id'), 'Policy id');
|
|
104
|
+
const currentVersionId = read(row, 'currentVersionId');
|
|
105
|
+
const [current, draft] = await Promise.all([
|
|
106
|
+
currentVersionId ? versions.findOne({ filterByTk: idValue(currentVersionId, 'Version id') }) : null,
|
|
107
|
+
versions.findOne({ filter: { policyId, status: 'draft' }, sort: ['-version'] }),
|
|
108
|
+
]);
|
|
109
|
+
return { ...plain(row), currentVersion: current ? plain(current) : null, draft: draft ? plain(draft) : null };
|
|
110
|
+
}),
|
|
111
|
+
);
|
|
112
|
+
return { data, meta: { count, page, pageSize } };
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
async listVersions(policyId: unknown) {
|
|
116
|
+
const id = idValue(policyId, 'Policy id');
|
|
117
|
+
return this.db.getRepository('agentGovernancePolicyVersions').find({
|
|
118
|
+
filter: { policyId: id },
|
|
119
|
+
sort: ['-version'],
|
|
120
|
+
limit: 500,
|
|
121
|
+
});
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
async saveDraft(input: Record<string, unknown>, actorId: number) {
|
|
125
|
+
const scope = policyScope(input.scope);
|
|
126
|
+
const rawScopeId = requiredText(input.scopeId, 'Scope id', 200);
|
|
127
|
+
let scopeId = rawScopeId;
|
|
128
|
+
if (scope === 'user') scopeId = String(idValue(rawScopeId, 'Scope id'));
|
|
129
|
+
if (scope === 'department') {
|
|
130
|
+
if (!/^[1-9]\d{0,18}$/.test(rawScopeId) || BigInt(rawScopeId) > 9223372036854775807n) {
|
|
131
|
+
throw new Error('Department id is invalid.');
|
|
132
|
+
}
|
|
133
|
+
scopeId = BigInt(rawScopeId).toString();
|
|
134
|
+
}
|
|
135
|
+
let employeeUsername = input.employeeUsername ? requiredText(input.employeeUsername, 'Employee', 100) : null;
|
|
136
|
+
const modelKey = input.modelKey ? requiredText(input.modelKey, 'Model key', 355) : null;
|
|
137
|
+
if (scope === 'employee' && employeeUsername && employeeUsername !== scopeId) {
|
|
138
|
+
throw new Error('Employee policy scope does not match its employee selector.');
|
|
139
|
+
}
|
|
140
|
+
if (scope === 'employee') employeeUsername = null;
|
|
141
|
+
if (modelKey && (modelKey.indexOf(':') < 1 || modelKey.endsWith(':'))) {
|
|
142
|
+
throw new Error('Model key must include the LLM service and model.');
|
|
143
|
+
}
|
|
144
|
+
const settings = safeSettings(input.settings ?? {}, scope);
|
|
145
|
+
if (modelKey && (settings.instruction || settings.systemPrompt !== undefined)) {
|
|
146
|
+
throw new Error('A model-specific policy cannot change a persistent prompt.');
|
|
147
|
+
}
|
|
148
|
+
const key = `v1:${createHash('sha256')
|
|
149
|
+
.update(JSON.stringify([scope, scopeId, employeeUsername, modelKey]))
|
|
150
|
+
.digest('hex')}`;
|
|
151
|
+
return this.db.sequelize.transaction(async (transaction: Transaction) => {
|
|
152
|
+
const policies = this.db.getRepository('agentGovernancePolicies');
|
|
153
|
+
let policy = await policies.findOne({ filter: { policyKey: key }, transaction, lock: transaction.LOCK.UPDATE });
|
|
154
|
+
if (!policy) {
|
|
155
|
+
const targetCollection = scope === 'employee' ? 'aiEmployees' : scope === 'user' ? 'users' : 'departments';
|
|
156
|
+
if (!this.db.hasCollection(targetCollection)) throw new Error('Policy scope is unavailable.');
|
|
157
|
+
const target = await this.db.getRepository(targetCollection).findOne({
|
|
158
|
+
...(scope === 'employee' ? { filter: { username: scopeId } } : { filterByTk: scopeId }),
|
|
159
|
+
transaction,
|
|
160
|
+
});
|
|
161
|
+
if (!target) throw new Error('Policy scope does not exist.');
|
|
162
|
+
policy = await policies.create({
|
|
163
|
+
values: { policyKey: key, scope, scopeId, employeeUsername, modelKey },
|
|
164
|
+
transaction,
|
|
165
|
+
});
|
|
166
|
+
if (scope === 'employee' && !modelKey) {
|
|
167
|
+
const original = read(target, 'about');
|
|
168
|
+
const baseline = await this.db.getRepository('agentGovernancePolicyVersions').create({
|
|
169
|
+
values: {
|
|
170
|
+
policyId: read(policy, 'id'),
|
|
171
|
+
version: 1,
|
|
172
|
+
status: 'published',
|
|
173
|
+
settings: { systemPrompt: typeof original === 'string' ? original : null },
|
|
174
|
+
publishedById: actorId,
|
|
175
|
+
publishedAt: new Date(),
|
|
176
|
+
},
|
|
177
|
+
transaction,
|
|
178
|
+
});
|
|
179
|
+
await policies.update({
|
|
180
|
+
filterByTk: idValue(read(policy, 'id'), 'Policy id'),
|
|
181
|
+
values: { currentVersionId: idValue(read(baseline, 'id'), 'Version id') },
|
|
182
|
+
transaction,
|
|
183
|
+
});
|
|
184
|
+
}
|
|
185
|
+
}
|
|
186
|
+
const policyId = idValue(read(policy, 'id'), 'Policy id');
|
|
187
|
+
const versions = this.db.getRepository('agentGovernancePolicyVersions');
|
|
188
|
+
const latest = await versions.findOne({ filter: { policyId }, sort: ['-version'], transaction });
|
|
189
|
+
if (latest && read(latest, 'status') === 'draft') {
|
|
190
|
+
const versionId = idValue(read(latest, 'id'), 'Version id');
|
|
191
|
+
const revision = idValue(read(latest, 'revision') ?? 1, 'Revision') + 1;
|
|
192
|
+
await versions.update({ filterByTk: versionId, values: { settings, revision }, transaction });
|
|
193
|
+
await this.audit({ action: 'saveDraft', actorId, policyId, versionId }, transaction);
|
|
194
|
+
return { policyId, version: await versions.findOne({ filterByTk: versionId, transaction }) };
|
|
195
|
+
}
|
|
196
|
+
const version = latest ? idValue(read(latest, 'version'), 'Version') + 1 : 1;
|
|
197
|
+
const draft = await versions.create({ values: { policyId, version, status: 'draft', settings }, transaction });
|
|
198
|
+
await this.audit(
|
|
199
|
+
{ action: 'saveDraft', actorId, policyId, versionId: idValue(read(draft, 'id'), 'Version id') },
|
|
200
|
+
transaction,
|
|
201
|
+
);
|
|
202
|
+
return {
|
|
203
|
+
policyId,
|
|
204
|
+
version: draft,
|
|
205
|
+
};
|
|
206
|
+
});
|
|
207
|
+
}
|
|
208
|
+
|
|
209
|
+
async publish(
|
|
210
|
+
policyIdValue: unknown,
|
|
211
|
+
actorId: number,
|
|
212
|
+
options: { rollbackVersion?: unknown; versionId?: unknown; revision?: unknown },
|
|
213
|
+
) {
|
|
214
|
+
const policyId = idValue(policyIdValue, 'Policy id');
|
|
215
|
+
return this.db.sequelize.transaction(async (transaction: Transaction) => {
|
|
216
|
+
const policies = this.db.getRepository('agentGovernancePolicies');
|
|
217
|
+
const versions = this.db.getRepository('agentGovernancePolicyVersions');
|
|
218
|
+
const policy = await policies.findOne({ filterByTk: policyId, transaction, lock: transaction.LOCK.UPDATE });
|
|
219
|
+
if (!policy) throw new Error('Policy does not exist.');
|
|
220
|
+
const scope = policyScope(read(policy, 'scope'));
|
|
221
|
+
let version = await versions.findOne({ filter: { policyId, status: 'draft' }, sort: ['-version'], transaction });
|
|
222
|
+
if (options.rollbackVersion !== undefined) {
|
|
223
|
+
const target = await versions.findOne({
|
|
224
|
+
filter: { policyId, version: idValue(options.rollbackVersion, 'Version'), status: 'published' },
|
|
225
|
+
transaction,
|
|
226
|
+
});
|
|
227
|
+
if (!target) throw new Error('Published policy version does not exist.');
|
|
228
|
+
const latest = await versions.findOne({ filter: { policyId }, sort: ['-version'], transaction });
|
|
229
|
+
version = await versions.create({
|
|
230
|
+
values: {
|
|
231
|
+
policyId,
|
|
232
|
+
version: idValue(read(latest, 'version'), 'Version') + 1,
|
|
233
|
+
status: 'draft',
|
|
234
|
+
settings: read(target, 'settings'),
|
|
235
|
+
},
|
|
236
|
+
transaction,
|
|
237
|
+
});
|
|
238
|
+
}
|
|
239
|
+
if (!version) throw new Error('Policy has no draft to publish.');
|
|
240
|
+
if (
|
|
241
|
+
options.rollbackVersion === undefined &&
|
|
242
|
+
(idValue(read(version, 'id'), 'Version id') !== idValue(options.versionId, 'Version id') ||
|
|
243
|
+
idValue(read(version, 'revision') ?? 1, 'Revision') !== idValue(options.revision, 'Revision'))
|
|
244
|
+
) {
|
|
245
|
+
throw new Error('The policy draft changed. Refresh it before publishing.');
|
|
246
|
+
}
|
|
247
|
+
const settings = safeSettings(read(version, 'settings'), scope);
|
|
248
|
+
if (scope === 'employee' && !read(policy, 'modelKey')) {
|
|
249
|
+
const username = requiredText(read(policy, 'scopeId'), 'Employee', 100);
|
|
250
|
+
const employees = this.db.getRepository('aiEmployees');
|
|
251
|
+
const employee = await employees.findOne({ filter: { username }, transaction, lock: transaction.LOCK.UPDATE });
|
|
252
|
+
if (!employee) throw new Error('AI employee does not exist.');
|
|
253
|
+
if (settings.systemPrompt !== undefined) {
|
|
254
|
+
await employees.update({ filter: { username }, values: { about: settings.systemPrompt }, transaction });
|
|
255
|
+
} else {
|
|
256
|
+
const currentPrompt = read(employee, 'about');
|
|
257
|
+
settings.systemPrompt = typeof currentPrompt === 'string' ? currentPrompt : null;
|
|
258
|
+
}
|
|
259
|
+
}
|
|
260
|
+
const versionId = idValue(read(version, 'id'), 'Version id');
|
|
261
|
+
await versions.update({
|
|
262
|
+
filterByTk: versionId,
|
|
263
|
+
values: { status: 'published', settings, publishedById: actorId, publishedAt: new Date() },
|
|
264
|
+
transaction,
|
|
265
|
+
});
|
|
266
|
+
await policies.update({ filterByTk: policyId, values: { currentVersionId: versionId }, transaction });
|
|
267
|
+
await this.audit(
|
|
268
|
+
{ action: options.rollbackVersion === undefined ? 'publish' : 'rollback', actorId, policyId, versionId },
|
|
269
|
+
transaction,
|
|
270
|
+
);
|
|
271
|
+
return { policyId, version: await versions.findOne({ filterByTk: versionId, transaction }) };
|
|
272
|
+
});
|
|
273
|
+
}
|
|
274
|
+
|
|
275
|
+
async preview(input: { userId: unknown; employeeUsername: unknown; modelKey?: unknown }, transaction?: Transaction) {
|
|
276
|
+
const userId = idValue(input.userId, 'User id');
|
|
277
|
+
const employeeUsername = requiredText(input.employeeUsername, 'Employee', 100);
|
|
278
|
+
const users = this.db.getRepository('users');
|
|
279
|
+
const user = await users.findOne({ filterByTk: userId, transaction });
|
|
280
|
+
if (!user) throw new Error('User does not exist.');
|
|
281
|
+
const employee = await this.db
|
|
282
|
+
.getRepository('aiEmployees')
|
|
283
|
+
.findOne({ filter: { username: employeeUsername }, transaction });
|
|
284
|
+
if (!employee) throw new Error('AI employee does not exist.');
|
|
285
|
+
const department = await resolveUserDepartment(this.db, userId, transaction);
|
|
286
|
+
const modelKey = input.modelKey ? requiredText(input.modelKey, 'Model key', 355) : undefined;
|
|
287
|
+
const policies = await this.activePolicies(
|
|
288
|
+
userId,
|
|
289
|
+
employeeUsername,
|
|
290
|
+
department.departmentId,
|
|
291
|
+
transaction,
|
|
292
|
+
modelKey,
|
|
293
|
+
);
|
|
294
|
+
const settings = read(employee, 'chatSettings');
|
|
295
|
+
const promptMode =
|
|
296
|
+
settings && typeof settings === 'object' && 'systemPromptMode' in settings
|
|
297
|
+
? String(settings.systemPromptMode || 'default')
|
|
298
|
+
: 'default';
|
|
299
|
+
const instructions = policies.map((policy) => policy.settings.instruction?.trim()).filter(Boolean);
|
|
300
|
+
const instruction = instructions.join('\n\n');
|
|
301
|
+
const bindings = this.db.getRepository('agentGovernancePromptBindings');
|
|
302
|
+
const binding = await bindings.findOne({ filter: { userId, employeeUsername }, transaction });
|
|
303
|
+
const native = await this.db.getRepository('usersAiEmployees').findOne({
|
|
304
|
+
filter: { userId, aiEmployee: employeeUsername },
|
|
305
|
+
transaction,
|
|
306
|
+
});
|
|
307
|
+
const original = binding ? read(binding, 'originalPrompt') : read(native, 'prompt');
|
|
308
|
+
const originalPrompt = typeof original === 'string' ? original : null;
|
|
309
|
+
const currentPrompt = read(native, 'prompt');
|
|
310
|
+
const nativePromptHash = native
|
|
311
|
+
? createHash('sha256')
|
|
312
|
+
.update(typeof currentPrompt === 'string' ? currentPrompt : '')
|
|
313
|
+
.digest('hex')
|
|
314
|
+
: null;
|
|
315
|
+
const conflict = Boolean(binding && (!native || nativePromptHash !== read(binding, 'contentHash')));
|
|
316
|
+
const projectedPrompt = [instruction, originalPrompt].filter(Boolean).join('\n\n');
|
|
317
|
+
const warnings: string[] = [];
|
|
318
|
+
if (promptMode !== 'default') warnings.push('governance.promptModeUnsupported');
|
|
319
|
+
if (department.status !== 'resolved') warnings.push('governance.departmentUnavailable');
|
|
320
|
+
if (!instruction) warnings.push('governance.noInstruction');
|
|
321
|
+
if (
|
|
322
|
+
policies.some(
|
|
323
|
+
(policy) =>
|
|
324
|
+
policy.scope === 'employee' &&
|
|
325
|
+
policy.settings.systemPrompt !== undefined &&
|
|
326
|
+
(read(employee, 'about') ?? null) !== policy.settings.systemPrompt,
|
|
327
|
+
)
|
|
328
|
+
) {
|
|
329
|
+
warnings.push('governance.employeePromptChanged');
|
|
330
|
+
}
|
|
331
|
+
if (policies.some((policy) => policy.settings.maxMonthlyTokens != null || policy.settings.maxMonthlyCost != null)) {
|
|
332
|
+
warnings.push('governance.observedQuotaOnly');
|
|
333
|
+
}
|
|
334
|
+
return {
|
|
335
|
+
userId,
|
|
336
|
+
employeeUsername,
|
|
337
|
+
departmentId: department.departmentId,
|
|
338
|
+
departmentStatus: department.status,
|
|
339
|
+
instruction,
|
|
340
|
+
policies,
|
|
341
|
+
promptMode,
|
|
342
|
+
warnings,
|
|
343
|
+
managed: Boolean(binding),
|
|
344
|
+
originalPrompt,
|
|
345
|
+
projectedPrompt,
|
|
346
|
+
nativePromptHash,
|
|
347
|
+
conflict,
|
|
348
|
+
};
|
|
349
|
+
}
|
|
350
|
+
|
|
351
|
+
async activePolicies(
|
|
352
|
+
userId: number,
|
|
353
|
+
employeeUsername: string,
|
|
354
|
+
departmentId: string | number | null,
|
|
355
|
+
transaction?: Transaction,
|
|
356
|
+
modelKey?: string,
|
|
357
|
+
includeAllModels = false,
|
|
358
|
+
): Promise<ActivePolicy[]> {
|
|
359
|
+
const targets = [
|
|
360
|
+
{ scope: 'employee', scopeId: employeeUsername },
|
|
361
|
+
{ scope: 'user', scopeId: String(userId) },
|
|
362
|
+
];
|
|
363
|
+
if (departmentId != null) targets.splice(1, 0, { scope: 'department', scopeId: String(departmentId) });
|
|
364
|
+
const rows = await this.db.getRepository('agentGovernancePolicies').find({
|
|
365
|
+
filter: { $or: targets, currentVersionId: { $ne: null } },
|
|
366
|
+
transaction,
|
|
367
|
+
});
|
|
368
|
+
const versions = this.db.getRepository('agentGovernancePolicyVersions');
|
|
369
|
+
const result: ActivePolicy[] = [];
|
|
370
|
+
for (const row of rows) {
|
|
371
|
+
const selector = read(row, 'employeeUsername');
|
|
372
|
+
if (selector && selector !== employeeUsername) continue;
|
|
373
|
+
const policyModel = read(row, 'modelKey');
|
|
374
|
+
if (policyModel && !includeAllModels && policyModel !== modelKey) continue;
|
|
375
|
+
const versionId = idValue(read(row, 'currentVersionId'), 'Version id');
|
|
376
|
+
const version = await versions.findOne({ filterByTk: versionId, transaction });
|
|
377
|
+
if (
|
|
378
|
+
!version ||
|
|
379
|
+
read(version, 'status') !== 'published' ||
|
|
380
|
+
Number(read(version, 'policyId')) !== Number(read(row, 'id'))
|
|
381
|
+
) {
|
|
382
|
+
throw new Error('Published governance policy is unavailable.');
|
|
383
|
+
}
|
|
384
|
+
const scope = policyScope(read(row, 'scope'));
|
|
385
|
+
result.push({
|
|
386
|
+
id: idValue(read(row, 'id'), 'Policy id'),
|
|
387
|
+
scope,
|
|
388
|
+
scopeId: String(read(row, 'scopeId')),
|
|
389
|
+
employeeUsername: typeof selector === 'string' ? selector : null,
|
|
390
|
+
modelKey: typeof policyModel === 'string' ? policyModel : null,
|
|
391
|
+
version: idValue(read(version, 'version'), 'Version'),
|
|
392
|
+
versionId,
|
|
393
|
+
settings: safeSettings(read(version, 'settings'), scope),
|
|
394
|
+
});
|
|
395
|
+
}
|
|
396
|
+
const order: Record<GovernanceScope, number> = { employee: 0, department: 1, user: 2 };
|
|
397
|
+
return result.sort((a, b) => order[a.scope] - order[b.scope] || a.id - b.id);
|
|
398
|
+
}
|
|
399
|
+
|
|
400
|
+
async apply(input: { userId: unknown; employeeUsername: unknown }, actorId: number) {
|
|
401
|
+
return this.db.sequelize.transaction(async (transaction: Transaction) => {
|
|
402
|
+
const userId = idValue(input.userId, 'User id');
|
|
403
|
+
const employeeUsername = requiredText(input.employeeUsername, 'Employee', 100);
|
|
404
|
+
await this.db.getRepository('users').findOne({ filterByTk: userId, transaction, lock: transaction.LOCK.UPDATE });
|
|
405
|
+
const preview = await this.preview({ userId, employeeUsername }, transaction);
|
|
406
|
+
if (preview.promptMode !== 'default')
|
|
407
|
+
throw new Error('Managed instructions require the default system prompt mode.');
|
|
408
|
+
if (!preview.instruction) throw new Error('No published instruction applies to this user and employee.');
|
|
409
|
+
const natives = this.db.getRepository('usersAiEmployees');
|
|
410
|
+
const bindings = this.db.getRepository('agentGovernancePromptBindings');
|
|
411
|
+
const filter = { userId, aiEmployee: employeeUsername };
|
|
412
|
+
const existing = await natives.findOne({ filter, transaction, lock: transaction.LOCK.UPDATE });
|
|
413
|
+
const binding = await bindings.findOne({
|
|
414
|
+
filter: { userId, employeeUsername },
|
|
415
|
+
transaction,
|
|
416
|
+
lock: transaction.LOCK.UPDATE,
|
|
417
|
+
});
|
|
418
|
+
if (binding) {
|
|
419
|
+
const currentPrompt = read(existing, 'prompt');
|
|
420
|
+
const currentHash = createHash('sha256')
|
|
421
|
+
.update(typeof currentPrompt === 'string' ? currentPrompt : '')
|
|
422
|
+
.digest('hex');
|
|
423
|
+
if (!existing || currentHash !== read(binding, 'contentHash')) {
|
|
424
|
+
throw new Error('Managed prompt changed outside governance. Review it before applying.');
|
|
425
|
+
}
|
|
426
|
+
}
|
|
427
|
+
const originalPrompt = binding ? read(binding, 'originalPrompt') : read(existing, 'prompt');
|
|
428
|
+
const originalRowExisted = binding ? Boolean(read(binding, 'originalRowExisted')) : Boolean(existing);
|
|
429
|
+
const projectedPrompt = [preview.instruction, typeof originalPrompt === 'string' ? originalPrompt : null]
|
|
430
|
+
.filter(Boolean)
|
|
431
|
+
.join('\n\n');
|
|
432
|
+
await managedWrites.run(true, async () => {
|
|
433
|
+
if (existing) await natives.update({ filter, values: { prompt: projectedPrompt }, transaction });
|
|
434
|
+
else await natives.create({ values: { ...filter, prompt: projectedPrompt, sort: null }, transaction });
|
|
435
|
+
});
|
|
436
|
+
const values = {
|
|
437
|
+
userId,
|
|
438
|
+
employeeUsername,
|
|
439
|
+
originalPrompt: typeof originalPrompt === 'string' ? originalPrompt : null,
|
|
440
|
+
originalRowExisted,
|
|
441
|
+
contentHash: createHash('sha256').update(projectedPrompt).digest('hex'),
|
|
442
|
+
policyVersions: preview.policies
|
|
443
|
+
.filter((policy) => policy.settings.instruction?.trim())
|
|
444
|
+
.map((policy) => ({ id: policy.id, versionId: policy.versionId })),
|
|
445
|
+
departmentId: preview.departmentId == null ? null : String(preview.departmentId),
|
|
446
|
+
appliedById: actorId,
|
|
447
|
+
appliedAt: new Date(),
|
|
448
|
+
};
|
|
449
|
+
if (binding)
|
|
450
|
+
await bindings.update({ filterByTk: idValue(read(binding, 'id'), 'Binding id'), values, transaction });
|
|
451
|
+
else await bindings.create({ values, transaction });
|
|
452
|
+
await this.audit(
|
|
453
|
+
{ action: 'apply', actorId, userId, employeeUsername, departmentId: preview.departmentId },
|
|
454
|
+
transaction,
|
|
455
|
+
);
|
|
456
|
+
return { ...preview, managed: true, projectedPrompt };
|
|
457
|
+
});
|
|
458
|
+
}
|
|
459
|
+
|
|
460
|
+
async restore(input: { userId: unknown; employeeUsername: unknown }, actorId: number) {
|
|
461
|
+
return this.db.sequelize.transaction(async (transaction: Transaction) => {
|
|
462
|
+
const userId = idValue(input.userId, 'User id');
|
|
463
|
+
const employeeUsername = requiredText(input.employeeUsername, 'Employee', 100);
|
|
464
|
+
await this.db.getRepository('users').findOne({ filterByTk: userId, transaction, lock: transaction.LOCK.UPDATE });
|
|
465
|
+
const bindings = this.db.getRepository('agentGovernancePromptBindings');
|
|
466
|
+
const binding = await bindings.findOne({
|
|
467
|
+
filter: { userId, employeeUsername },
|
|
468
|
+
transaction,
|
|
469
|
+
lock: transaction.LOCK.UPDATE,
|
|
470
|
+
});
|
|
471
|
+
if (!binding) return { restored: false };
|
|
472
|
+
const natives = this.db.getRepository('usersAiEmployees');
|
|
473
|
+
const filter = { userId, aiEmployee: employeeUsername };
|
|
474
|
+
const existing = await natives.findOne({ filter, transaction, lock: transaction.LOCK.UPDATE });
|
|
475
|
+
if (!existing) {
|
|
476
|
+
await bindings.destroy({ filterByTk: idValue(read(binding, 'id'), 'Binding id'), transaction });
|
|
477
|
+
await this.audit(
|
|
478
|
+
{ action: 'restoreOrphan', actorId, userId, employeeUsername, departmentId: read(binding, 'departmentId') },
|
|
479
|
+
transaction,
|
|
480
|
+
);
|
|
481
|
+
return { restored: false, orphaned: true };
|
|
482
|
+
}
|
|
483
|
+
const current = read(existing, 'prompt');
|
|
484
|
+
const hash = createHash('sha256')
|
|
485
|
+
.update(typeof current === 'string' ? current : '')
|
|
486
|
+
.digest('hex');
|
|
487
|
+
if (hash !== read(binding, 'contentHash'))
|
|
488
|
+
throw new Error('Managed prompt changed outside governance. Review it before restoring.');
|
|
489
|
+
await managedWrites.run(true, async () => {
|
|
490
|
+
if (read(binding, 'originalRowExisted')) {
|
|
491
|
+
await natives.update({ filter, values: { prompt: read(binding, 'originalPrompt') ?? null }, transaction });
|
|
492
|
+
} else {
|
|
493
|
+
// Preserve any settings added to the association after projection, including fields from other plugins.
|
|
494
|
+
const ignored = new Set(['id', 'userId', 'aiEmployee', 'prompt', 'createdAt', 'updatedAt']);
|
|
495
|
+
const additionalValues = Object.entries(plain(existing)).some(
|
|
496
|
+
([key, value]) => !ignored.has(key) && value != null,
|
|
497
|
+
);
|
|
498
|
+
if (additionalValues) await natives.update({ filter, values: { prompt: null }, transaction });
|
|
499
|
+
else await natives.destroy({ filter, transaction });
|
|
500
|
+
}
|
|
501
|
+
});
|
|
502
|
+
await bindings.destroy({ filterByTk: idValue(read(binding, 'id'), 'Binding id'), transaction });
|
|
503
|
+
await this.audit(
|
|
504
|
+
{ action: 'restore', actorId, userId, employeeUsername, departmentId: read(binding, 'departmentId') },
|
|
505
|
+
transaction,
|
|
506
|
+
);
|
|
507
|
+
return { restored: true };
|
|
508
|
+
});
|
|
509
|
+
}
|
|
510
|
+
|
|
511
|
+
async release(input: { userId: unknown; employeeUsername: unknown; expectedHash: unknown }, actorId: number) {
|
|
512
|
+
return this.db.sequelize.transaction(async (transaction: Transaction) => {
|
|
513
|
+
const userId = idValue(input.userId, 'User id');
|
|
514
|
+
const employeeUsername = requiredText(input.employeeUsername, 'Employee', 100);
|
|
515
|
+
await this.db.getRepository('users').findOne({ filterByTk: userId, transaction, lock: transaction.LOCK.UPDATE });
|
|
516
|
+
const bindings = this.db.getRepository('agentGovernancePromptBindings');
|
|
517
|
+
const binding = await bindings.findOne({
|
|
518
|
+
filter: { userId, employeeUsername },
|
|
519
|
+
transaction,
|
|
520
|
+
lock: transaction.LOCK.UPDATE,
|
|
521
|
+
});
|
|
522
|
+
if (!binding) return { released: false };
|
|
523
|
+
const native = await this.db.getRepository('usersAiEmployees').findOne({
|
|
524
|
+
filter: { userId, aiEmployee: employeeUsername },
|
|
525
|
+
transaction,
|
|
526
|
+
lock: transaction.LOCK.UPDATE,
|
|
527
|
+
});
|
|
528
|
+
const current = read(native, 'prompt');
|
|
529
|
+
const actualHash = native
|
|
530
|
+
? createHash('sha256')
|
|
531
|
+
.update(typeof current === 'string' ? current : '')
|
|
532
|
+
.digest('hex')
|
|
533
|
+
: null;
|
|
534
|
+
if (input.expectedHash !== actualHash)
|
|
535
|
+
throw new Error('The native instruction changed. Refresh before releasing it.');
|
|
536
|
+
await bindings.destroy({ filterByTk: idValue(read(binding, 'id'), 'Binding id'), transaction });
|
|
537
|
+
await this.audit(
|
|
538
|
+
{ action: 'release', actorId, userId, employeeUsername, departmentId: read(binding, 'departmentId') },
|
|
539
|
+
transaction,
|
|
540
|
+
);
|
|
541
|
+
return { released: true };
|
|
542
|
+
});
|
|
543
|
+
}
|
|
544
|
+
|
|
545
|
+
private async audit(values: Record<string, unknown>, transaction: Transaction) {
|
|
546
|
+
await this.db.getRepository('agentGovernanceAuditEvents').create({ values, transaction });
|
|
547
|
+
}
|
|
548
|
+
}
|