plugin-agent-orchestrator 1.1.8 → 1.2.1
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/LICENSE +201 -0
- 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.6c69b6a87751dd18.js +10 -0
- package/dist/client/253.52f62e1bc0e9520a.js +10 -0
- package/dist/client/325.8f7f509bdb35e142.js +10 -0
- package/dist/client/404.86593f98c9768ed5.js +10 -0
- package/dist/client/453.fa2d169576262213.js +10 -0
- package/dist/client/53.567db3ae078650c6.js +10 -0
- package/dist/client/619.01713281e5e951d3.js +10 -0
- package/dist/client/652.69da1598312b3a3f.js +10 -0
- package/dist/client/773.648965568ff476f9.js +10 -0
- package/dist/client/981.37e7aeecdb1ef6fa.js +10 -0
- package/dist/client/993.ac89f3852990918d.js +10 -0
- package/dist/client/index.js +1 -1
- package/dist/client-v2/117.c982d79ff68738f5.js +10 -0
- package/dist/client-v2/214.94c4257bf2838577.js +10 -0
- package/dist/client-v2/253.8e19956d2a44dfb8.js +10 -0
- package/dist/client-v2/264.80e8e358c8c6c2e5.js +10 -0
- package/dist/client-v2/325.fafe5a6e83ba9cb3.js +10 -0
- package/dist/client-v2/404.ab032b79c95dab6f.js +10 -0
- package/dist/client-v2/{41.3deb9e57a0f64fc4.js → 41.cd5610fcf7446127.js} +1 -1
- package/dist/client-v2/453.42c6d70628d56cc2.js +10 -0
- package/dist/client-v2/{53.349fff8db80b19d4.js → 53.37c08089a648f89a.js} +1 -1
- package/dist/client-v2/{619.0a2144aaffefe018.js → 619.6e9618550101e819.js} +1 -1
- package/dist/client-v2/652.eeba4e0c38367321.js +10 -0
- package/dist/client-v2/{70.ffff2997c10fd4b0.js → 70.332698e53eb59677.js} +1 -1
- package/dist/client-v2/773.4de2ba5acb07318c.js +10 -0
- package/dist/client-v2/981.76060f466e6f7c11.js +10 -0
- package/dist/client-v2/993.f8cdb5172566ce75.js +10 -0
- package/dist/client-v2/index.js +1 -1
- package/dist/externalVersion.js +13 -7
- package/dist/locale/en-US.json +308 -1
- package/dist/locale/vi-VN.json +5 -1
- package/dist/locale/zh-CN.json +308 -1
- package/dist/node_modules/acorn/LICENSE +21 -0
- package/dist/node_modules/acorn/bin/acorn +4 -0
- package/dist/node_modules/acorn/dist/acorn.d.mts +857 -0
- package/dist/node_modules/acorn/dist/acorn.d.ts +857 -0
- package/dist/node_modules/acorn/dist/acorn.js +1 -0
- package/dist/node_modules/acorn/dist/bin.js +90 -0
- package/dist/node_modules/acorn/package.json +1 -0
- package/dist/node_modules/acorn-walk/LICENSE +21 -0
- package/dist/node_modules/acorn-walk/dist/walk.d.mts +177 -0
- package/dist/node_modules/acorn-walk/dist/walk.d.ts +177 -0
- package/dist/node_modules/acorn-walk/dist/walk.js +1 -0
- package/dist/node_modules/acorn-walk/node_modules/.bin/acorn +15 -0
- package/dist/node_modules/acorn-walk/node_modules/.bin/acorn.cmd +7 -0
- package/dist/node_modules/acorn-walk/node_modules/acorn/bin/acorn +4 -0
- package/dist/node_modules/acorn-walk/node_modules/acorn/dist/acorn.d.mts +866 -0
- package/dist/node_modules/acorn-walk/node_modules/acorn/dist/acorn.d.ts +866 -0
- package/dist/node_modules/acorn-walk/node_modules/acorn/dist/acorn.js +6174 -0
- package/dist/node_modules/acorn-walk/node_modules/acorn/dist/bin.js +90 -0
- package/dist/node_modules/acorn-walk/node_modules/acorn/package.json +50 -0
- package/dist/node_modules/acorn-walk/package.json +1 -0
- 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-auto-approval-checkpoints.js +47 -0
- package/dist/server/collections/agent-execution-spans.js +148 -9
- 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-hierarchy-invocations.js +59 -0
- package/dist/server/collections/agent-loop-runs.js +23 -5
- package/dist/server/collections/agent-routing-graph-locks.js +40 -0
- package/dist/server/collections/agent-session-auto-approvals.js +45 -0
- package/dist/server/collections/orchestrator-config.js +17 -0
- 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/migrations/20261119000000-widen-native-employee-identifiers.js +59 -0
- package/dist/server/plugin.js +169 -33
- package/dist/server/resources/agent-auto-approval.js +80 -0
- 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/hierarchical-routing.js +60 -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/AutoApprovalCheckpoint.js +133 -0
- package/dist/server/services/CodeValidator.js +8 -4
- package/dist/server/services/DepartmentAttribution.js +65 -0
- package/dist/server/services/ExecutionSpanService.js +96 -3
- package/dist/server/services/GovernanceAdmission.js +271 -0
- package/dist/server/services/HarnessCapabilities.js +118 -0
- package/dist/server/services/HarnessCompiler.js +3 -0
- package/dist/server/services/HarnessSchema.js +13 -1
- package/dist/server/services/HierarchicalAgentRuntime.js +925 -0
- package/dist/server/services/HierarchyEnrollmentGuard.js +216 -0
- package/dist/server/services/HierarchyInvocationJournal.js +157 -0
- package/dist/server/services/HierarchyRequestCancellation.js +150 -0
- package/dist/server/services/LoopBudgetService.js +29 -11
- package/dist/server/services/LoopRunRepository.js +16 -7
- package/dist/server/services/LoopRunStateMachine.js +20 -9
- package/dist/server/services/LoopTriggerService.js +1 -1
- package/dist/server/services/LoopWorkerService.js +71 -37
- 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/PluginAiRuntimeAdapter.js +107 -9
- package/dist/server/services/RoutingBindingRepository.js +156 -0
- package/dist/server/services/RoutingBindingValidation.js +161 -0
- package/dist/server/services/SandboxRunner.js +19 -0
- package/dist/server/services/SessionAutoApproval.js +173 -0
- package/dist/server/services/TokenTracker.js +787 -104
- package/dist/server/services/TracingRetentionPolicy.js +66 -0
- package/dist/server/services/VerificationService.js +20 -10
- package/dist/server/skill-hub/plugin.js +17 -0
- package/dist/server/skill-hub/sandbox-config.json +6 -6
- package/dist/server/skill-hub/services/RegistrySkillInstallationService.js +2 -2
- package/dist/server/skill-hub/services/registry-node-package.js +191 -0
- package/dist/server/skill-hub/tasks/SkillExecutionTask.js +21 -6
- package/dist/server/tools/skill-execute.js +1 -0
- package/dist/server/utils/ensure-indexes.js +15 -5
- package/package.json +66 -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 +34 -0
- package/src/client/__tests__/embedded-settings.test.tsx +225 -0
- package/src/client/hooks/useRunEventStream.ts +76 -76
- package/src/client/index.tsx +2 -2
- package/src/client/plugin.tsx +71 -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 +147 -132
- package/src/client/skill-hub/tools/SkillHubCard.tsx +110 -104
- package/src/client/skill-hub/tools/__tests__/skill-hub-card.test.tsx +255 -0
- package/src/client/skill-hub/tools/loopTemplates.ts +52 -52
- package/src/client/skill-hub/tools/registerSkillLoopCards.ts +80 -71
- package/src/client/skill-hub/utils/jsonFields.ts +41 -41
- package/src/client-v2/__tests__/embedded-settings.test.tsx +202 -0
- package/src/client-v2/__tests__/hierarchical-routing-settings.test.tsx +350 -0
- package/src/client-v2/auto-approval/AutoApprovalBridge.tsx +513 -0
- package/src/client-v2/auto-approval/AutoApprovalProvider.tsx +399 -0
- package/src/client-v2/auto-approval/__tests__/session-auto-approval.test.tsx +1676 -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 +541 -269
- package/src/client-v2/components/AgentRunsTab.tsx +85 -83
- package/src/client-v2/components/ApprovalsTab.tsx +337 -337
- package/src/client-v2/components/EmployeeGovernanceTab.tsx +695 -0
- package/src/client-v2/components/HarnessProfilesTab.tsx +700 -541
- package/src/client-v2/components/HarnessSettingsForm.tsx +221 -0
- 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 +379 -0
- package/src/client-v2/index.tsx +1 -1
- package/src/client-v2/pages/AgentBindingsPage.tsx +15 -13
- package/src/client-v2/pages/ApprovalsPage.tsx +12 -10
- package/src/client-v2/pages/EmployeeGovernancePage.tsx +15 -0
- package/src/client-v2/pages/ExecutionHistoryPage.tsx +12 -10
- package/src/client-v2/pages/HarnessProfilesPage.tsx +12 -10
- package/src/client-v2/pages/KnowledgeAccessPage.tsx +12 -10
- package/src/client-v2/pages/LoopSettingsPage.tsx +12 -10
- package/src/client-v2/pages/MemoryInspectorPage.tsx +15 -13
- package/src/client-v2/pages/RetrievalTracePage.tsx +12 -10
- package/src/client-v2/pages/RulesPage.tsx +15 -13
- package/src/client-v2/pages/SkillDefinitionsPage.tsx +12 -10
- package/src/client-v2/pages/SkillMetricsPage.tsx +12 -10
- package/src/client-v2/pages/TracingPage.tsx +15 -13
- package/src/client-v2/pages/UsageGovernancePage.tsx +15 -0
- package/src/client-v2/plugin.tsx +134 -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 +126 -0
- package/src/client-v2/skill-hub/tools/interactions.ts +137 -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 +308 -1
- package/src/locale/vi-VN.json +5 -1
- package/src/locale/zh-CN.json +308 -1
- package/src/server/__tests__/agent-execution-context.test.ts +18 -18
- package/src/server/__tests__/agent-governance.integration.test.ts +385 -0
- package/src/server/__tests__/agent-knowledge-insights.test.ts +123 -123
- package/src/server/__tests__/agent-monitor-acl.integration.test.ts +267 -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 +335 -0
- package/src/server/__tests__/auto-approval-checkpoint.integration.test.ts +295 -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 +88 -0
- package/src/server/__tests__/harness-compiler.test.ts +278 -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 +175 -172
- package/src/server/__tests__/hierarchical-routing.integration.test.ts +2318 -0
- package/src/server/__tests__/hierarchy-invocation-journal.integration.test.ts +119 -0
- package/src/server/__tests__/input-schema-validator.test.ts +26 -26
- package/src/server/__tests__/loop-approval-decision.test.ts +624 -512
- package/src/server/__tests__/loop-approval-expiry.test.ts +258 -258
- package/src/server/__tests__/loop-budget-service.test.ts +29 -0
- package/src/server/__tests__/loop-pattern-schema.test.ts +73 -73
- package/src/server/__tests__/loop-run-repository.test.ts +25 -0
- package/src/server/__tests__/loop-run-state-machine.test.ts +101 -101
- package/src/server/__tests__/loop-trigger-service.test.ts +185 -148
- package/src/server/__tests__/loop-worker-claim.test.ts +110 -10
- package/src/server/__tests__/loop-worker-execution.test.ts +375 -317
- package/src/server/__tests__/native-agent-monitor-sync.test.ts +343 -0
- package/src/server/__tests__/native-hierarchy-probe.integration.test.ts +527 -0
- package/src/server/__tests__/native-sub-agent-observer.test.ts +463 -662
- package/src/server/__tests__/native-usage-attribution.integration.test.ts +168 -0
- package/src/server/__tests__/plugin-ai-runtime-adapter.test.ts +403 -0
- package/src/server/__tests__/registry-node-package.test.ts +299 -0
- package/src/server/__tests__/routing-binding-graph.integration.test.ts +217 -0
- package/src/server/__tests__/routing-binding-validation.test.ts +256 -0
- package/src/server/__tests__/session-auto-approval.integration.test.ts +329 -0
- package/src/server/__tests__/skill-access-service.test.ts +64 -64
- package/src/server/__tests__/skill-execute.test.ts +81 -70
- package/src/server/__tests__/skill-execution-task-policy.test.ts +140 -140
- package/src/server/__tests__/skill-review-guard.test.ts +171 -0
- 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 +632 -0
- package/src/server/__tests__/tool-loop-detection.test.ts +276 -276
- package/src/server/__tests__/tracing-retention-policy.test.ts +30 -0
- package/src/server/__tests__/usage-ledger.integration.test.ts +187 -0
- package/src/server/collections/agent-auto-approval-checkpoints.ts +18 -0
- package/src/server/collections/agent-execution-spans.ts +386 -245
- package/src/server/collections/agent-governance-audit-events.ts +19 -0
- package/src/server/collections/agent-governance-policies.ts +19 -0
- package/src/server/collections/agent-governance-policy-versions.ts +20 -0
- package/src/server/collections/agent-governance-prompt-bindings.ts +22 -0
- package/src/server/collections/agent-hierarchy-invocations.ts +30 -0
- package/src/server/collections/agent-loop-action-approvals.ts +39 -39
- package/src/server/collections/agent-loop-runs.ts +389 -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/agent-routing-graph-locks.ts +11 -0
- package/src/server/collections/agent-session-auto-approvals.ts +16 -0
- package/src/server/collections/orchestrator-config.ts +113 -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 +110 -0
- package/src/server/migrations/20261110010000-add-usage-department-attribution.ts +28 -0
- package/src/server/migrations/20261119000000-widen-native-employee-identifiers.ts +37 -0
- package/src/server/plugin.ts +724 -573
- package/src/server/resources/agent-auto-approval.ts +51 -0
- package/src/server/resources/agent-governance.ts +161 -0
- package/src/server/resources/agent-harness-profile.ts +103 -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 +208 -482
- package/src/server/resources/agent-usage.ts +413 -0
- package/src/server/resources/hierarchical-routing.ts +39 -0
- package/src/server/resources/native-monitor-format.ts +150 -0
- package/src/server/resources/tracing.ts +296 -267
- package/src/server/services/AgentExecutionContext.ts +23 -23
- package/src/server/services/AgentGovernanceService.ts +541 -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/AutoApprovalCheckpoint.ts +140 -0
- package/src/server/services/CodeValidator.ts +257 -238
- package/src/server/services/DepartmentAttribution.ts +47 -0
- package/src/server/services/DurableCircuitBreakerService.ts +235 -235
- package/src/server/services/ExecutionSpanService.ts +271 -146
- package/src/server/services/FileManager.ts +159 -159
- package/src/server/services/GovernanceAdmission.ts +314 -0
- package/src/server/services/HarnessCapabilities.ts +112 -0
- package/src/server/services/HarnessCompiler.ts +182 -170
- package/src/server/services/HarnessProfileService.ts +235 -235
- package/src/server/services/HarnessSchema.ts +224 -194
- package/src/server/services/HierarchicalAgentRuntime.ts +1052 -0
- package/src/server/services/HierarchyEnrollmentGuard.ts +211 -0
- package/src/server/services/HierarchyInvocationJournal.ts +172 -0
- package/src/server/services/HierarchyRequestCancellation.ts +132 -0
- package/src/server/services/InputSchemaValidator.ts +44 -44
- package/src/server/services/LoopBudgetService.ts +325 -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 +343 -332
- package/src/server/services/LoopRunStateMachine.ts +538 -525
- package/src/server/services/LoopSchedulerService.ts +195 -195
- package/src/server/services/LoopTriggerService.ts +162 -159
- package/src/server/services/LoopWorkerService.ts +975 -912
- package/src/server/services/ManagedPromptProtection.ts +81 -0
- package/src/server/services/NativeAgentMonitorSyncService.ts +684 -0
- package/src/server/services/NativeSubAgentObserver.ts +324 -757
- package/src/server/services/NativeUsageAttribution.ts +91 -0
- package/src/server/services/PathLockService.ts +317 -317
- package/src/server/services/PluginAiRuntimeAdapter.ts +518 -387
- package/src/server/services/RoutingBindingRepository.ts +146 -0
- package/src/server/services/RoutingBindingValidation.ts +161 -0
- package/src/server/services/RunEventBus.ts +58 -58
- package/src/server/services/SandboxRunner.ts +526 -492
- package/src/server/services/SessionAutoApproval.ts +167 -0
- 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 +1151 -287
- package/src/server/services/ToolLoopDetectionService.ts +210 -210
- package/src/server/services/TracingRetentionPolicy.ts +49 -0
- package/src/server/services/VerificationSchema.ts +31 -31
- package/src/server/services/VerificationService.ts +325 -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 +1272 -1232
- package/src/server/skill-hub/sandbox-config.json +6 -6
- package/src/server/skill-hub/services/RegistrySkillInstallationService.ts +291 -281
- package/src/server/skill-hub/services/__tests__/RegistrySkillInstallationService.test.ts +295 -295
- package/src/server/skill-hub/services/registry-node-package.ts +191 -0
- package/src/server/skill-hub/tasks/SkillExecutionTask.ts +597 -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 +226 -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 +113 -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/981.e4a1f41cfc94a856.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,541 @@
|
|
|
1
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
2
|
+
|
|
3
|
+
import { AsyncLocalStorage } from 'node:async_hooks';
|
|
4
|
+
import { createHash } from 'node:crypto';
|
|
5
|
+
import type { Database, Filter, Model, Transaction } from '@nocobase/database';
|
|
6
|
+
import { z } from 'zod';
|
|
7
|
+
import { read } from '../utils/record-utils';
|
|
8
|
+
import { resolveUserDepartment } from './DepartmentAttribution';
|
|
9
|
+
|
|
10
|
+
const settingsSchema = z
|
|
11
|
+
.object({
|
|
12
|
+
instruction: z.string().max(50000).optional(),
|
|
13
|
+
systemPrompt: z.string().max(50000).nullable().optional(),
|
|
14
|
+
allowedModels: z.array(z.string().min(1).max(355)).max(200).optional(),
|
|
15
|
+
allow: z.boolean().optional(),
|
|
16
|
+
maxMonthlyTokens: z.number().int().nonnegative().nullable().optional(),
|
|
17
|
+
maxMonthlyCost: z.number().finite().nonnegative().nullable().optional(),
|
|
18
|
+
})
|
|
19
|
+
.strict();
|
|
20
|
+
|
|
21
|
+
export type GovernanceSettings = z.infer<typeof settingsSchema>;
|
|
22
|
+
export type GovernanceScope = 'department' | 'user' | 'employee';
|
|
23
|
+
type RecordValue = Model | Record<string, unknown>;
|
|
24
|
+
type ActivePolicy = {
|
|
25
|
+
id: number;
|
|
26
|
+
scope: GovernanceScope;
|
|
27
|
+
scopeId: string;
|
|
28
|
+
employeeUsername: string | null;
|
|
29
|
+
modelKey: string | null;
|
|
30
|
+
version: number;
|
|
31
|
+
versionId: number;
|
|
32
|
+
settings: GovernanceSettings;
|
|
33
|
+
};
|
|
34
|
+
|
|
35
|
+
const managedWrites = new AsyncLocalStorage<boolean>();
|
|
36
|
+
|
|
37
|
+
export function isManagedPromptWrite() {
|
|
38
|
+
return managedWrites.getStore() === true;
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
function idValue(value: unknown, _label: string): number {
|
|
42
|
+
const id = Number(value);
|
|
43
|
+
if (!Number.isSafeInteger(id) || id <= 0) throw new Error('Invalid governance identifier.');
|
|
44
|
+
return id;
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
function requiredText(value: unknown, _label: string, maxLength: number) {
|
|
48
|
+
if (typeof value !== 'string' || !value.trim() || value.trim().length > maxLength) {
|
|
49
|
+
throw new Error('Invalid governance text value.');
|
|
50
|
+
}
|
|
51
|
+
return value.trim();
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
function safeSettings(value: unknown, scope: GovernanceScope) {
|
|
55
|
+
const result = settingsSchema.safeParse(value);
|
|
56
|
+
if (!result.success) throw new Error('Invalid governance settings.');
|
|
57
|
+
const settings = result.data;
|
|
58
|
+
if (scope !== 'employee' && settings.systemPrompt !== undefined) {
|
|
59
|
+
throw new Error('A system prompt can only be configured for an employee policy.');
|
|
60
|
+
}
|
|
61
|
+
return settings;
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
function plain(row: RecordValue): Record<string, unknown> {
|
|
65
|
+
if ('toJSON' in row && typeof row.toJSON === 'function') return row.toJSON() as Record<string, unknown>;
|
|
66
|
+
return row as Record<string, unknown>;
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
function policyScope(value: unknown): GovernanceScope {
|
|
70
|
+
if (value === 'department' || value === 'user' || value === 'employee') return value;
|
|
71
|
+
throw new Error('Policy scope is invalid.');
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
export class AgentGovernanceService {
|
|
75
|
+
constructor(private readonly db: Database) {}
|
|
76
|
+
|
|
77
|
+
async list(input: { page?: unknown; pageSize?: unknown; scope?: unknown; scopeId?: unknown }) {
|
|
78
|
+
const page = Math.max(1, Math.trunc(Number(input.page) || 1));
|
|
79
|
+
const pageSize = Math.min(100, Math.max(1, Math.trunc(Number(input.pageSize) || 20)));
|
|
80
|
+
const filter: Record<string, unknown> = {};
|
|
81
|
+
if (input.scope) filter.scope = policyScope(input.scope);
|
|
82
|
+
if (input.scopeId) filter.scopeId = requiredText(input.scopeId, 'Scope id', 200);
|
|
83
|
+
const policies = this.db.getRepository('agentGovernancePolicies');
|
|
84
|
+
const [rows, count] = await Promise.all([
|
|
85
|
+
policies.find({
|
|
86
|
+
filter: filter as Filter,
|
|
87
|
+
sort: ['-updatedAt', '-id'],
|
|
88
|
+
limit: pageSize,
|
|
89
|
+
offset: (page - 1) * pageSize,
|
|
90
|
+
}),
|
|
91
|
+
policies.count({ filter: filter as Filter }),
|
|
92
|
+
]);
|
|
93
|
+
const versions = this.db.getRepository('agentGovernancePolicyVersions');
|
|
94
|
+
const data = await Promise.all(
|
|
95
|
+
rows.map(async (row: Model) => {
|
|
96
|
+
const policyId = idValue(read(row, 'id'), 'Policy id');
|
|
97
|
+
const currentVersionId = read(row, 'currentVersionId');
|
|
98
|
+
const [current, draft] = await Promise.all([
|
|
99
|
+
currentVersionId ? versions.findOne({ filterByTk: idValue(currentVersionId, 'Version id') }) : null,
|
|
100
|
+
versions.findOne({ filter: { policyId, status: 'draft' }, sort: ['-version'] }),
|
|
101
|
+
]);
|
|
102
|
+
return { ...plain(row), currentVersion: current ? plain(current) : null, draft: draft ? plain(draft) : null };
|
|
103
|
+
}),
|
|
104
|
+
);
|
|
105
|
+
return { data, meta: { count, page, pageSize } };
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
async listVersions(policyId: unknown) {
|
|
109
|
+
const id = idValue(policyId, 'Policy id');
|
|
110
|
+
return this.db.getRepository('agentGovernancePolicyVersions').find({
|
|
111
|
+
filter: { policyId: id },
|
|
112
|
+
sort: ['-version'],
|
|
113
|
+
limit: 500,
|
|
114
|
+
});
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
async saveDraft(input: Record<string, unknown>, actorId: number) {
|
|
118
|
+
const scope = policyScope(input.scope);
|
|
119
|
+
const rawScopeId = requiredText(input.scopeId, 'Scope id', 200);
|
|
120
|
+
let scopeId = rawScopeId;
|
|
121
|
+
if (scope === 'user') scopeId = String(idValue(rawScopeId, 'Scope id'));
|
|
122
|
+
if (scope === 'department') {
|
|
123
|
+
if (!/^[1-9]\d{0,18}$/.test(rawScopeId) || BigInt(rawScopeId) > 9223372036854775807n) {
|
|
124
|
+
throw new Error('Department id is invalid.');
|
|
125
|
+
}
|
|
126
|
+
scopeId = BigInt(rawScopeId).toString();
|
|
127
|
+
}
|
|
128
|
+
let employeeUsername = input.employeeUsername ? requiredText(input.employeeUsername, 'Employee', 100) : null;
|
|
129
|
+
const modelKey = input.modelKey ? requiredText(input.modelKey, 'Model key', 355) : null;
|
|
130
|
+
if (scope === 'employee' && employeeUsername && employeeUsername !== scopeId) {
|
|
131
|
+
throw new Error('Employee policy scope does not match its employee selector.');
|
|
132
|
+
}
|
|
133
|
+
if (scope === 'employee') employeeUsername = null;
|
|
134
|
+
if (modelKey && (modelKey.indexOf(':') < 1 || modelKey.endsWith(':'))) {
|
|
135
|
+
throw new Error('Model key must include the LLM service and model.');
|
|
136
|
+
}
|
|
137
|
+
const settings = safeSettings(input.settings ?? {}, scope);
|
|
138
|
+
if (modelKey && (settings.instruction || settings.systemPrompt !== undefined)) {
|
|
139
|
+
throw new Error('A model-specific policy cannot change a persistent prompt.');
|
|
140
|
+
}
|
|
141
|
+
const key = `v1:${createHash('sha256')
|
|
142
|
+
.update(JSON.stringify([scope, scopeId, employeeUsername, modelKey]))
|
|
143
|
+
.digest('hex')}`;
|
|
144
|
+
return this.db.sequelize.transaction(async (transaction: Transaction) => {
|
|
145
|
+
const policies = this.db.getRepository('agentGovernancePolicies');
|
|
146
|
+
let policy = await policies.findOne({ filter: { policyKey: key }, transaction, lock: transaction.LOCK.UPDATE });
|
|
147
|
+
if (!policy) {
|
|
148
|
+
const targetCollection = scope === 'employee' ? 'aiEmployees' : scope === 'user' ? 'users' : 'departments';
|
|
149
|
+
if (!this.db.hasCollection(targetCollection)) throw new Error('Policy scope is unavailable.');
|
|
150
|
+
const target = await this.db.getRepository(targetCollection).findOne({
|
|
151
|
+
...(scope === 'employee' ? { filter: { username: scopeId } } : { filterByTk: scopeId }),
|
|
152
|
+
transaction,
|
|
153
|
+
});
|
|
154
|
+
if (!target) throw new Error('Policy scope does not exist.');
|
|
155
|
+
policy = await policies.create({
|
|
156
|
+
values: { policyKey: key, scope, scopeId, employeeUsername, modelKey },
|
|
157
|
+
transaction,
|
|
158
|
+
});
|
|
159
|
+
if (scope === 'employee' && !modelKey) {
|
|
160
|
+
const original = read(target, 'about');
|
|
161
|
+
const baseline = await this.db.getRepository('agentGovernancePolicyVersions').create({
|
|
162
|
+
values: {
|
|
163
|
+
policyId: read(policy, 'id'),
|
|
164
|
+
version: 1,
|
|
165
|
+
status: 'published',
|
|
166
|
+
settings: { systemPrompt: typeof original === 'string' ? original : null },
|
|
167
|
+
publishedById: actorId,
|
|
168
|
+
publishedAt: new Date(),
|
|
169
|
+
},
|
|
170
|
+
transaction,
|
|
171
|
+
});
|
|
172
|
+
await policies.update({
|
|
173
|
+
filterByTk: idValue(read(policy, 'id'), 'Policy id'),
|
|
174
|
+
values: { currentVersionId: idValue(read(baseline, 'id'), 'Version id') },
|
|
175
|
+
transaction,
|
|
176
|
+
});
|
|
177
|
+
}
|
|
178
|
+
}
|
|
179
|
+
const policyId = idValue(read(policy, 'id'), 'Policy id');
|
|
180
|
+
const versions = this.db.getRepository('agentGovernancePolicyVersions');
|
|
181
|
+
const latest = await versions.findOne({ filter: { policyId }, sort: ['-version'], transaction });
|
|
182
|
+
if (latest && read(latest, 'status') === 'draft') {
|
|
183
|
+
const versionId = idValue(read(latest, 'id'), 'Version id');
|
|
184
|
+
const revision = idValue(read(latest, 'revision') ?? 1, 'Revision') + 1;
|
|
185
|
+
await versions.update({ filterByTk: versionId, values: { settings, revision }, transaction });
|
|
186
|
+
await this.audit({ action: 'saveDraft', actorId, policyId, versionId }, transaction);
|
|
187
|
+
return { policyId, version: await versions.findOne({ filterByTk: versionId, transaction }) };
|
|
188
|
+
}
|
|
189
|
+
const version = latest ? idValue(read(latest, 'version'), 'Version') + 1 : 1;
|
|
190
|
+
const draft = await versions.create({ values: { policyId, version, status: 'draft', settings }, transaction });
|
|
191
|
+
await this.audit(
|
|
192
|
+
{ action: 'saveDraft', actorId, policyId, versionId: idValue(read(draft, 'id'), 'Version id') },
|
|
193
|
+
transaction,
|
|
194
|
+
);
|
|
195
|
+
return {
|
|
196
|
+
policyId,
|
|
197
|
+
version: draft,
|
|
198
|
+
};
|
|
199
|
+
});
|
|
200
|
+
}
|
|
201
|
+
|
|
202
|
+
async publish(
|
|
203
|
+
policyIdValue: unknown,
|
|
204
|
+
actorId: number,
|
|
205
|
+
options: { rollbackVersion?: unknown; versionId?: unknown; revision?: unknown },
|
|
206
|
+
) {
|
|
207
|
+
const policyId = idValue(policyIdValue, 'Policy id');
|
|
208
|
+
return this.db.sequelize.transaction(async (transaction: Transaction) => {
|
|
209
|
+
const policies = this.db.getRepository('agentGovernancePolicies');
|
|
210
|
+
const versions = this.db.getRepository('agentGovernancePolicyVersions');
|
|
211
|
+
const policy = await policies.findOne({ filterByTk: policyId, transaction, lock: transaction.LOCK.UPDATE });
|
|
212
|
+
if (!policy) throw new Error('Policy does not exist.');
|
|
213
|
+
const scope = policyScope(read(policy, 'scope'));
|
|
214
|
+
let version = await versions.findOne({ filter: { policyId, status: 'draft' }, sort: ['-version'], transaction });
|
|
215
|
+
if (options.rollbackVersion !== undefined) {
|
|
216
|
+
const target = await versions.findOne({
|
|
217
|
+
filter: { policyId, version: idValue(options.rollbackVersion, 'Version'), status: 'published' },
|
|
218
|
+
transaction,
|
|
219
|
+
});
|
|
220
|
+
if (!target) throw new Error('Published policy version does not exist.');
|
|
221
|
+
const latest = await versions.findOne({ filter: { policyId }, sort: ['-version'], transaction });
|
|
222
|
+
version = await versions.create({
|
|
223
|
+
values: {
|
|
224
|
+
policyId,
|
|
225
|
+
version: idValue(read(latest, 'version'), 'Version') + 1,
|
|
226
|
+
status: 'draft',
|
|
227
|
+
settings: read(target, 'settings'),
|
|
228
|
+
},
|
|
229
|
+
transaction,
|
|
230
|
+
});
|
|
231
|
+
}
|
|
232
|
+
if (!version) throw new Error('Policy has no draft to publish.');
|
|
233
|
+
if (
|
|
234
|
+
options.rollbackVersion === undefined &&
|
|
235
|
+
(idValue(read(version, 'id'), 'Version id') !== idValue(options.versionId, 'Version id') ||
|
|
236
|
+
idValue(read(version, 'revision') ?? 1, 'Revision') !== idValue(options.revision, 'Revision'))
|
|
237
|
+
) {
|
|
238
|
+
throw new Error('The policy draft changed. Refresh it before publishing.');
|
|
239
|
+
}
|
|
240
|
+
const settings = safeSettings(read(version, 'settings'), scope);
|
|
241
|
+
if (scope === 'employee' && !read(policy, 'modelKey')) {
|
|
242
|
+
const username = requiredText(read(policy, 'scopeId'), 'Employee', 100);
|
|
243
|
+
const employees = this.db.getRepository('aiEmployees');
|
|
244
|
+
const employee = await employees.findOne({ filter: { username }, transaction, lock: transaction.LOCK.UPDATE });
|
|
245
|
+
if (!employee) throw new Error('AI employee does not exist.');
|
|
246
|
+
if (settings.systemPrompt !== undefined) {
|
|
247
|
+
await employees.update({ filter: { username }, values: { about: settings.systemPrompt }, transaction });
|
|
248
|
+
} else {
|
|
249
|
+
const currentPrompt = read(employee, 'about');
|
|
250
|
+
settings.systemPrompt = typeof currentPrompt === 'string' ? currentPrompt : null;
|
|
251
|
+
}
|
|
252
|
+
}
|
|
253
|
+
const versionId = idValue(read(version, 'id'), 'Version id');
|
|
254
|
+
await versions.update({
|
|
255
|
+
filterByTk: versionId,
|
|
256
|
+
values: { status: 'published', settings, publishedById: actorId, publishedAt: new Date() },
|
|
257
|
+
transaction,
|
|
258
|
+
});
|
|
259
|
+
await policies.update({ filterByTk: policyId, values: { currentVersionId: versionId }, transaction });
|
|
260
|
+
await this.audit(
|
|
261
|
+
{ action: options.rollbackVersion === undefined ? 'publish' : 'rollback', actorId, policyId, versionId },
|
|
262
|
+
transaction,
|
|
263
|
+
);
|
|
264
|
+
return { policyId, version: await versions.findOne({ filterByTk: versionId, transaction }) };
|
|
265
|
+
});
|
|
266
|
+
}
|
|
267
|
+
|
|
268
|
+
async preview(input: { userId: unknown; employeeUsername: unknown; modelKey?: unknown }, transaction?: Transaction) {
|
|
269
|
+
const userId = idValue(input.userId, 'User id');
|
|
270
|
+
const employeeUsername = requiredText(input.employeeUsername, 'Employee', 100);
|
|
271
|
+
const users = this.db.getRepository('users');
|
|
272
|
+
const user = await users.findOne({ filterByTk: userId, transaction });
|
|
273
|
+
if (!user) throw new Error('User does not exist.');
|
|
274
|
+
const employee = await this.db
|
|
275
|
+
.getRepository('aiEmployees')
|
|
276
|
+
.findOne({ filter: { username: employeeUsername }, transaction });
|
|
277
|
+
if (!employee) throw new Error('AI employee does not exist.');
|
|
278
|
+
const department = await resolveUserDepartment(this.db, userId, transaction);
|
|
279
|
+
const modelKey = input.modelKey ? requiredText(input.modelKey, 'Model key', 355) : undefined;
|
|
280
|
+
const policies = await this.activePolicies(
|
|
281
|
+
userId,
|
|
282
|
+
employeeUsername,
|
|
283
|
+
department.departmentId,
|
|
284
|
+
transaction,
|
|
285
|
+
modelKey,
|
|
286
|
+
);
|
|
287
|
+
const settings = read(employee, 'chatSettings');
|
|
288
|
+
const promptMode =
|
|
289
|
+
settings && typeof settings === 'object' && 'systemPromptMode' in settings
|
|
290
|
+
? String(settings.systemPromptMode || 'default')
|
|
291
|
+
: 'default';
|
|
292
|
+
const instructions = policies.map((policy) => policy.settings.instruction?.trim()).filter(Boolean);
|
|
293
|
+
const instruction = instructions.join('\n\n');
|
|
294
|
+
const bindings = this.db.getRepository('agentGovernancePromptBindings');
|
|
295
|
+
const binding = await bindings.findOne({ filter: { userId, employeeUsername }, transaction });
|
|
296
|
+
const native = await this.db.getRepository('usersAiEmployees').findOne({
|
|
297
|
+
filter: { userId, aiEmployee: employeeUsername },
|
|
298
|
+
transaction,
|
|
299
|
+
});
|
|
300
|
+
const original = binding ? read(binding, 'originalPrompt') : read(native, 'prompt');
|
|
301
|
+
const originalPrompt = typeof original === 'string' ? original : null;
|
|
302
|
+
const currentPrompt = read(native, 'prompt');
|
|
303
|
+
const nativePromptHash = native
|
|
304
|
+
? createHash('sha256')
|
|
305
|
+
.update(typeof currentPrompt === 'string' ? currentPrompt : '')
|
|
306
|
+
.digest('hex')
|
|
307
|
+
: null;
|
|
308
|
+
const conflict = Boolean(binding && (!native || nativePromptHash !== read(binding, 'contentHash')));
|
|
309
|
+
const projectedPrompt = [instruction, originalPrompt].filter(Boolean).join('\n\n');
|
|
310
|
+
const warnings: string[] = [];
|
|
311
|
+
if (promptMode !== 'default') warnings.push('governance.promptModeUnsupported');
|
|
312
|
+
if (department.status !== 'resolved') warnings.push('governance.departmentUnavailable');
|
|
313
|
+
if (!instruction) warnings.push('governance.noInstruction');
|
|
314
|
+
if (
|
|
315
|
+
policies.some(
|
|
316
|
+
(policy) =>
|
|
317
|
+
policy.scope === 'employee' &&
|
|
318
|
+
policy.settings.systemPrompt !== undefined &&
|
|
319
|
+
(read(employee, 'about') ?? null) !== policy.settings.systemPrompt,
|
|
320
|
+
)
|
|
321
|
+
) {
|
|
322
|
+
warnings.push('governance.employeePromptChanged');
|
|
323
|
+
}
|
|
324
|
+
if (policies.some((policy) => policy.settings.maxMonthlyTokens != null || policy.settings.maxMonthlyCost != null)) {
|
|
325
|
+
warnings.push('governance.observedQuotaOnly');
|
|
326
|
+
}
|
|
327
|
+
return {
|
|
328
|
+
userId,
|
|
329
|
+
employeeUsername,
|
|
330
|
+
departmentId: department.departmentId,
|
|
331
|
+
departmentStatus: department.status,
|
|
332
|
+
instruction,
|
|
333
|
+
policies,
|
|
334
|
+
promptMode,
|
|
335
|
+
warnings,
|
|
336
|
+
managed: Boolean(binding),
|
|
337
|
+
originalPrompt,
|
|
338
|
+
projectedPrompt,
|
|
339
|
+
nativePromptHash,
|
|
340
|
+
conflict,
|
|
341
|
+
};
|
|
342
|
+
}
|
|
343
|
+
|
|
344
|
+
async activePolicies(
|
|
345
|
+
userId: number,
|
|
346
|
+
employeeUsername: string,
|
|
347
|
+
departmentId: string | number | null,
|
|
348
|
+
transaction?: Transaction,
|
|
349
|
+
modelKey?: string,
|
|
350
|
+
includeAllModels = false,
|
|
351
|
+
): Promise<ActivePolicy[]> {
|
|
352
|
+
const targets = [
|
|
353
|
+
{ scope: 'employee', scopeId: employeeUsername },
|
|
354
|
+
{ scope: 'user', scopeId: String(userId) },
|
|
355
|
+
];
|
|
356
|
+
if (departmentId != null) targets.splice(1, 0, { scope: 'department', scopeId: String(departmentId) });
|
|
357
|
+
const rows = await this.db.getRepository('agentGovernancePolicies').find({
|
|
358
|
+
filter: { $or: targets, currentVersionId: { $ne: null } },
|
|
359
|
+
transaction,
|
|
360
|
+
});
|
|
361
|
+
const versions = this.db.getRepository('agentGovernancePolicyVersions');
|
|
362
|
+
const result: ActivePolicy[] = [];
|
|
363
|
+
for (const row of rows) {
|
|
364
|
+
const selector = read(row, 'employeeUsername');
|
|
365
|
+
if (selector && selector !== employeeUsername) continue;
|
|
366
|
+
const policyModel = read(row, 'modelKey');
|
|
367
|
+
if (policyModel && !includeAllModels && policyModel !== modelKey) continue;
|
|
368
|
+
const versionId = idValue(read(row, 'currentVersionId'), 'Version id');
|
|
369
|
+
const version = await versions.findOne({ filterByTk: versionId, transaction });
|
|
370
|
+
if (
|
|
371
|
+
!version ||
|
|
372
|
+
read(version, 'status') !== 'published' ||
|
|
373
|
+
Number(read(version, 'policyId')) !== Number(read(row, 'id'))
|
|
374
|
+
) {
|
|
375
|
+
throw new Error('Published governance policy is unavailable.');
|
|
376
|
+
}
|
|
377
|
+
const scope = policyScope(read(row, 'scope'));
|
|
378
|
+
result.push({
|
|
379
|
+
id: idValue(read(row, 'id'), 'Policy id'),
|
|
380
|
+
scope,
|
|
381
|
+
scopeId: String(read(row, 'scopeId')),
|
|
382
|
+
employeeUsername: typeof selector === 'string' ? selector : null,
|
|
383
|
+
modelKey: typeof policyModel === 'string' ? policyModel : null,
|
|
384
|
+
version: idValue(read(version, 'version'), 'Version'),
|
|
385
|
+
versionId,
|
|
386
|
+
settings: safeSettings(read(version, 'settings'), scope),
|
|
387
|
+
});
|
|
388
|
+
}
|
|
389
|
+
const order: Record<GovernanceScope, number> = { employee: 0, department: 1, user: 2 };
|
|
390
|
+
return result.sort((a, b) => order[a.scope] - order[b.scope] || a.id - b.id);
|
|
391
|
+
}
|
|
392
|
+
|
|
393
|
+
async apply(input: { userId: unknown; employeeUsername: unknown }, actorId: number) {
|
|
394
|
+
return this.db.sequelize.transaction(async (transaction: Transaction) => {
|
|
395
|
+
const userId = idValue(input.userId, 'User id');
|
|
396
|
+
const employeeUsername = requiredText(input.employeeUsername, 'Employee', 100);
|
|
397
|
+
await this.db.getRepository('users').findOne({ filterByTk: userId, transaction, lock: transaction.LOCK.UPDATE });
|
|
398
|
+
const preview = await this.preview({ userId, employeeUsername }, transaction);
|
|
399
|
+
if (preview.promptMode !== 'default')
|
|
400
|
+
throw new Error('Managed instructions require the default system prompt mode.');
|
|
401
|
+
if (!preview.instruction) throw new Error('No published instruction applies to this user and employee.');
|
|
402
|
+
const natives = this.db.getRepository('usersAiEmployees');
|
|
403
|
+
const bindings = this.db.getRepository('agentGovernancePromptBindings');
|
|
404
|
+
const filter = { userId, aiEmployee: employeeUsername };
|
|
405
|
+
const existing = await natives.findOne({ filter, transaction, lock: transaction.LOCK.UPDATE });
|
|
406
|
+
const binding = await bindings.findOne({
|
|
407
|
+
filter: { userId, employeeUsername },
|
|
408
|
+
transaction,
|
|
409
|
+
lock: transaction.LOCK.UPDATE,
|
|
410
|
+
});
|
|
411
|
+
if (binding) {
|
|
412
|
+
const currentPrompt = read(existing, 'prompt');
|
|
413
|
+
const currentHash = createHash('sha256')
|
|
414
|
+
.update(typeof currentPrompt === 'string' ? currentPrompt : '')
|
|
415
|
+
.digest('hex');
|
|
416
|
+
if (!existing || currentHash !== read(binding, 'contentHash')) {
|
|
417
|
+
throw new Error('Managed prompt changed outside governance. Review it before applying.');
|
|
418
|
+
}
|
|
419
|
+
}
|
|
420
|
+
const originalPrompt = binding ? read(binding, 'originalPrompt') : read(existing, 'prompt');
|
|
421
|
+
const originalRowExisted = binding ? Boolean(read(binding, 'originalRowExisted')) : Boolean(existing);
|
|
422
|
+
const projectedPrompt = [preview.instruction, typeof originalPrompt === 'string' ? originalPrompt : null]
|
|
423
|
+
.filter(Boolean)
|
|
424
|
+
.join('\n\n');
|
|
425
|
+
await managedWrites.run(true, async () => {
|
|
426
|
+
if (existing) await natives.update({ filter, values: { prompt: projectedPrompt }, transaction });
|
|
427
|
+
else await natives.create({ values: { ...filter, prompt: projectedPrompt, sort: null }, transaction });
|
|
428
|
+
});
|
|
429
|
+
const values = {
|
|
430
|
+
userId,
|
|
431
|
+
employeeUsername,
|
|
432
|
+
originalPrompt: typeof originalPrompt === 'string' ? originalPrompt : null,
|
|
433
|
+
originalRowExisted,
|
|
434
|
+
contentHash: createHash('sha256').update(projectedPrompt).digest('hex'),
|
|
435
|
+
policyVersions: preview.policies
|
|
436
|
+
.filter((policy) => policy.settings.instruction?.trim())
|
|
437
|
+
.map((policy) => ({ id: policy.id, versionId: policy.versionId })),
|
|
438
|
+
departmentId: preview.departmentId == null ? null : String(preview.departmentId),
|
|
439
|
+
appliedById: actorId,
|
|
440
|
+
appliedAt: new Date(),
|
|
441
|
+
};
|
|
442
|
+
if (binding)
|
|
443
|
+
await bindings.update({ filterByTk: idValue(read(binding, 'id'), 'Binding id'), values, transaction });
|
|
444
|
+
else await bindings.create({ values, transaction });
|
|
445
|
+
await this.audit(
|
|
446
|
+
{ action: 'apply', actorId, userId, employeeUsername, departmentId: preview.departmentId },
|
|
447
|
+
transaction,
|
|
448
|
+
);
|
|
449
|
+
return { ...preview, managed: true, projectedPrompt };
|
|
450
|
+
});
|
|
451
|
+
}
|
|
452
|
+
|
|
453
|
+
async restore(input: { userId: unknown; employeeUsername: unknown }, actorId: number) {
|
|
454
|
+
return this.db.sequelize.transaction(async (transaction: Transaction) => {
|
|
455
|
+
const userId = idValue(input.userId, 'User id');
|
|
456
|
+
const employeeUsername = requiredText(input.employeeUsername, 'Employee', 100);
|
|
457
|
+
await this.db.getRepository('users').findOne({ filterByTk: userId, transaction, lock: transaction.LOCK.UPDATE });
|
|
458
|
+
const bindings = this.db.getRepository('agentGovernancePromptBindings');
|
|
459
|
+
const binding = await bindings.findOne({
|
|
460
|
+
filter: { userId, employeeUsername },
|
|
461
|
+
transaction,
|
|
462
|
+
lock: transaction.LOCK.UPDATE,
|
|
463
|
+
});
|
|
464
|
+
if (!binding) return { restored: false };
|
|
465
|
+
const natives = this.db.getRepository('usersAiEmployees');
|
|
466
|
+
const filter = { userId, aiEmployee: employeeUsername };
|
|
467
|
+
const existing = await natives.findOne({ filter, transaction, lock: transaction.LOCK.UPDATE });
|
|
468
|
+
if (!existing) {
|
|
469
|
+
await bindings.destroy({ filterByTk: idValue(read(binding, 'id'), 'Binding id'), transaction });
|
|
470
|
+
await this.audit(
|
|
471
|
+
{ action: 'restoreOrphan', actorId, userId, employeeUsername, departmentId: read(binding, 'departmentId') },
|
|
472
|
+
transaction,
|
|
473
|
+
);
|
|
474
|
+
return { restored: false, orphaned: true };
|
|
475
|
+
}
|
|
476
|
+
const current = read(existing, 'prompt');
|
|
477
|
+
const hash = createHash('sha256')
|
|
478
|
+
.update(typeof current === 'string' ? current : '')
|
|
479
|
+
.digest('hex');
|
|
480
|
+
if (hash !== read(binding, 'contentHash'))
|
|
481
|
+
throw new Error('Managed prompt changed outside governance. Review it before restoring.');
|
|
482
|
+
await managedWrites.run(true, async () => {
|
|
483
|
+
if (read(binding, 'originalRowExisted')) {
|
|
484
|
+
await natives.update({ filter, values: { prompt: read(binding, 'originalPrompt') ?? null }, transaction });
|
|
485
|
+
} else {
|
|
486
|
+
// Preserve any settings added to the association after projection, including fields from other plugins.
|
|
487
|
+
const ignored = new Set(['id', 'userId', 'aiEmployee', 'prompt', 'createdAt', 'updatedAt']);
|
|
488
|
+
const additionalValues = Object.entries(plain(existing)).some(
|
|
489
|
+
([key, value]) => !ignored.has(key) && value != null,
|
|
490
|
+
);
|
|
491
|
+
if (additionalValues) await natives.update({ filter, values: { prompt: null }, transaction });
|
|
492
|
+
else await natives.destroy({ filter, transaction });
|
|
493
|
+
}
|
|
494
|
+
});
|
|
495
|
+
await bindings.destroy({ filterByTk: idValue(read(binding, 'id'), 'Binding id'), transaction });
|
|
496
|
+
await this.audit(
|
|
497
|
+
{ action: 'restore', actorId, userId, employeeUsername, departmentId: read(binding, 'departmentId') },
|
|
498
|
+
transaction,
|
|
499
|
+
);
|
|
500
|
+
return { restored: true };
|
|
501
|
+
});
|
|
502
|
+
}
|
|
503
|
+
|
|
504
|
+
async release(input: { userId: unknown; employeeUsername: unknown; expectedHash: unknown }, actorId: number) {
|
|
505
|
+
return this.db.sequelize.transaction(async (transaction: Transaction) => {
|
|
506
|
+
const userId = idValue(input.userId, 'User id');
|
|
507
|
+
const employeeUsername = requiredText(input.employeeUsername, 'Employee', 100);
|
|
508
|
+
await this.db.getRepository('users').findOne({ filterByTk: userId, transaction, lock: transaction.LOCK.UPDATE });
|
|
509
|
+
const bindings = this.db.getRepository('agentGovernancePromptBindings');
|
|
510
|
+
const binding = await bindings.findOne({
|
|
511
|
+
filter: { userId, employeeUsername },
|
|
512
|
+
transaction,
|
|
513
|
+
lock: transaction.LOCK.UPDATE,
|
|
514
|
+
});
|
|
515
|
+
if (!binding) return { released: false };
|
|
516
|
+
const native = await this.db.getRepository('usersAiEmployees').findOne({
|
|
517
|
+
filter: { userId, aiEmployee: employeeUsername },
|
|
518
|
+
transaction,
|
|
519
|
+
lock: transaction.LOCK.UPDATE,
|
|
520
|
+
});
|
|
521
|
+
const current = read(native, 'prompt');
|
|
522
|
+
const actualHash = native
|
|
523
|
+
? createHash('sha256')
|
|
524
|
+
.update(typeof current === 'string' ? current : '')
|
|
525
|
+
.digest('hex')
|
|
526
|
+
: null;
|
|
527
|
+
if (input.expectedHash !== actualHash)
|
|
528
|
+
throw new Error('The native instruction changed. Refresh before releasing it.');
|
|
529
|
+
await bindings.destroy({ filterByTk: idValue(read(binding, 'id'), 'Binding id'), transaction });
|
|
530
|
+
await this.audit(
|
|
531
|
+
{ action: 'release', actorId, userId, employeeUsername, departmentId: read(binding, 'departmentId') },
|
|
532
|
+
transaction,
|
|
533
|
+
);
|
|
534
|
+
return { released: true };
|
|
535
|
+
});
|
|
536
|
+
}
|
|
537
|
+
|
|
538
|
+
private async audit(values: Record<string, unknown>, transaction: Transaction) {
|
|
539
|
+
await this.db.getRepository('agentGovernanceAuditEvents').create({ values, transaction });
|
|
540
|
+
}
|
|
541
|
+
}
|