plugin-agent-orchestrator 1.1.7 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (413) hide show
  1. package/README.md +207 -204
  2. package/client-v2.d.ts +2 -2
  3. package/client-v2.js +1 -1
  4. package/client.d.ts +2 -2
  5. package/client.js +1 -1
  6. package/dist/client/117.2e4cb0477da3db1f.js +10 -0
  7. package/dist/client/253.93deb9e0192e76a5.js +10 -0
  8. package/dist/client/325.8f7f509bdb35e142.js +10 -0
  9. package/dist/client/404.498d2d9516dd1dce.js +10 -0
  10. package/dist/client/418.6f01da17774a5a25.js +10 -0
  11. package/dist/client/53.774ff07505d521fa.js +10 -0
  12. package/dist/client/619.e342b0fa467d39ca.js +10 -0
  13. package/dist/client/627.fdd60bcc0f3a9cf6.js +10 -0
  14. package/dist/client/652.477e21bfff67bc1c.js +10 -0
  15. package/dist/client/981.e0546ffc34afedcd.js +10 -0
  16. package/dist/client/993.5d04b510835ab0d2.js +10 -0
  17. package/dist/client/index.js +1 -1
  18. package/dist/client-v2/117.ccf43ae8631f7d74.js +10 -0
  19. package/dist/client-v2/214.cdf76752053a8990.js +10 -0
  20. package/dist/client-v2/253.1198df22f5baf304.js +10 -0
  21. package/dist/client-v2/264.78887ff88f969467.js +10 -0
  22. package/dist/client-v2/325.fafe5a6e83ba9cb3.js +10 -0
  23. package/dist/client-v2/404.9ba964c28a151c81.js +10 -0
  24. package/dist/client-v2/{41.3deb9e57a0f64fc4.js → 41.b28cf7a675a603d1.js} +1 -1
  25. package/dist/client-v2/418.55b6b28cda8bb5f3.js +10 -0
  26. package/dist/client-v2/{53.349fff8db80b19d4.js → 53.282081f97e4308c6.js} +1 -1
  27. package/dist/client-v2/{619.0a2144aaffefe018.js → 619.8c03913873785fb6.js} +1 -1
  28. package/dist/client-v2/627.e16f4a0dd596c3e6.js +10 -0
  29. package/dist/client-v2/652.1a48364774d5383a.js +10 -0
  30. package/dist/client-v2/{70.ffff2997c10fd4b0.js → 70.9166ed70906d041f.js} +1 -1
  31. package/dist/client-v2/{981.e4a1f41cfc94a856.js → 981.a81521f0296c7db8.js} +1 -1
  32. package/dist/client-v2/993.ca5b28f1e2b4c1ef.js +10 -0
  33. package/dist/client-v2/index.js +1 -1
  34. package/dist/externalVersion.js +10 -7
  35. package/dist/locale/en-US.json +229 -1
  36. package/dist/locale/zh-CN.json +229 -1
  37. package/dist/node_modules/adm-zip/adm-zip.js +1 -1
  38. package/dist/node_modules/adm-zip/package.json +1 -1
  39. package/dist/node_modules/ajv/package.json +1 -1
  40. package/dist/node_modules/zod/index.cjs +1 -1
  41. package/dist/node_modules/zod/package.json +1 -1
  42. package/dist/server/collections/agent-execution-spans.js +145 -6
  43. package/dist/server/collections/agent-governance-audit-events.js +47 -0
  44. package/dist/server/collections/agent-governance-policies.js +47 -0
  45. package/dist/server/collections/agent-governance-policy-versions.js +48 -0
  46. package/dist/server/collections/agent-governance-prompt-bindings.js +50 -0
  47. package/dist/server/collections/agent-loop-runs.js +23 -5
  48. package/dist/server/migrations/20261110000000-add-usage-pricing-snapshots.js +117 -0
  49. package/dist/server/migrations/20261110010000-add-usage-department-attribution.js +54 -0
  50. package/dist/server/plugin.js +114 -33
  51. package/dist/server/resources/agent-governance.js +192 -0
  52. package/dist/server/resources/agent-harness-profile.js +11 -3
  53. package/dist/server/resources/agent-monitor.js +109 -339
  54. package/dist/server/resources/agent-usage.js +423 -0
  55. package/dist/server/resources/native-monitor-format.js +179 -0
  56. package/dist/server/resources/tracing.js +35 -12
  57. package/dist/server/services/AgentGovernanceService.js +500 -0
  58. package/dist/server/services/DepartmentAttribution.js +65 -0
  59. package/dist/server/services/ExecutionSpanService.js +96 -3
  60. package/dist/server/services/GovernanceAdmission.js +211 -0
  61. package/dist/server/services/HarnessCapabilities.js +118 -0
  62. package/dist/server/services/LoopBudgetService.js +29 -11
  63. package/dist/server/services/LoopRunRepository.js +15 -6
  64. package/dist/server/services/LoopRunStateMachine.js +18 -7
  65. package/dist/server/services/LoopTriggerService.js +1 -1
  66. package/dist/server/services/LoopWorkerService.js +66 -32
  67. package/dist/server/services/ManagedPromptProtection.js +99 -0
  68. package/dist/server/services/NativeAgentMonitorSyncService.js +584 -0
  69. package/dist/server/services/NativeSubAgentObserver.js +141 -508
  70. package/dist/server/services/NativeUsageAttribution.js +97 -0
  71. package/dist/server/services/TokenTracker.js +787 -104
  72. package/dist/server/services/TracingRetentionPolicy.js +66 -0
  73. package/dist/server/services/VerificationService.js +18 -8
  74. package/dist/server/skill-hub/sandbox-config.json +6 -6
  75. package/dist/server/utils/ensure-indexes.js +14 -5
  76. package/package.json +63 -53
  77. package/server.d.ts +2 -2
  78. package/server.js +1 -1
  79. package/src/client/AgentRunsTab.tsx +2 -2
  80. package/src/client/ApprovalsTab.tsx +2 -2
  81. package/src/client/HarnessProfilesTab.tsx +2 -2
  82. package/src/client/OrchestratorSettings.tsx +152 -152
  83. package/src/client/SkillPages.tsx +41 -0
  84. package/src/client/__tests__/embedded-settings.test.tsx +232 -0
  85. package/src/client/hooks/useRunEventStream.ts +76 -76
  86. package/src/client/index.tsx +2 -2
  87. package/src/client/plugin.tsx +76 -32
  88. package/src/client/skill-hub/components/ExecutionHistory.tsx +200 -200
  89. package/src/client/skill-hub/components/GitSkillImport.tsx +562 -562
  90. package/src/client/skill-hub/components/LoopSettings.tsx +331 -331
  91. package/src/client/skill-hub/components/SkillEditor.tsx +460 -460
  92. package/src/client/skill-hub/components/SkillManager.tsx +194 -194
  93. package/src/client/skill-hub/components/SkillMetrics.tsx +162 -162
  94. package/src/client/skill-hub/components/SkillTestPanel.tsx +141 -141
  95. package/src/client/skill-hub/index.tsx +6 -6
  96. package/src/client/skill-hub/locale.ts +16 -16
  97. package/src/client/skill-hub/tools/InteractionSchemasProvider.tsx +132 -132
  98. package/src/client/skill-hub/tools/SkillHubCard.tsx +104 -104
  99. package/src/client/skill-hub/tools/loopTemplates.ts +52 -52
  100. package/src/client/skill-hub/tools/registerSkillLoopCards.ts +71 -71
  101. package/src/client/skill-hub/utils/jsonFields.ts +41 -41
  102. package/src/client-v2/__tests__/embedded-settings.test.tsx +193 -0
  103. package/src/client-v2/components/AIEmployeeSelect.tsx +47 -47
  104. package/src/client-v2/components/AIEmployeesContext.tsx +97 -97
  105. package/src/client-v2/components/AgentBindingsTab.tsx +269 -269
  106. package/src/client-v2/components/AgentRunsTab.tsx +92 -83
  107. package/src/client-v2/components/ApprovalsTab.tsx +337 -337
  108. package/src/client-v2/components/EmployeeGovernanceTab.tsx +702 -0
  109. package/src/client-v2/components/HarnessProfilesTab.tsx +704 -541
  110. package/src/client-v2/components/KnowledgeAccessTab.tsx +116 -116
  111. package/src/client-v2/components/RetrievalTraceTab.tsx +162 -162
  112. package/src/client-v2/components/UsageGovernanceTab.tsx +386 -0
  113. package/src/client-v2/index.tsx +1 -1
  114. package/src/client-v2/pages/AgentBindingsPage.tsx +22 -13
  115. package/src/client-v2/pages/ApprovalsPage.tsx +19 -10
  116. package/src/client-v2/pages/EmployeeGovernancePage.tsx +22 -0
  117. package/src/client-v2/pages/ExecutionHistoryPage.tsx +19 -10
  118. package/src/client-v2/pages/HarnessProfilesPage.tsx +19 -10
  119. package/src/client-v2/pages/KnowledgeAccessPage.tsx +19 -10
  120. package/src/client-v2/pages/LoopSettingsPage.tsx +19 -10
  121. package/src/client-v2/pages/MemoryInspectorPage.tsx +22 -13
  122. package/src/client-v2/pages/RetrievalTracePage.tsx +19 -10
  123. package/src/client-v2/pages/RulesPage.tsx +22 -13
  124. package/src/client-v2/pages/SkillDefinitionsPage.tsx +19 -10
  125. package/src/client-v2/pages/SkillMetricsPage.tsx +19 -10
  126. package/src/client-v2/pages/TracingPage.tsx +22 -13
  127. package/src/client-v2/pages/UsageGovernancePage.tsx +22 -0
  128. package/src/client-v2/plugin.tsx +139 -99
  129. package/src/client-v2/skill-hub/components/ExecutionHistory.tsx +196 -196
  130. package/src/client-v2/skill-hub/components/FileLinkList.tsx +37 -37
  131. package/src/client-v2/skill-hub/components/GitSkillImport.tsx +539 -539
  132. package/src/client-v2/skill-hub/components/LoopSettings.tsx +331 -331
  133. package/src/client-v2/skill-hub/components/SkillEditor.tsx +453 -453
  134. package/src/client-v2/skill-hub/components/SkillManager.tsx +191 -174
  135. package/src/client-v2/skill-hub/components/SkillMetrics.tsx +162 -162
  136. package/src/client-v2/skill-hub/components/SkillTestPanel.tsx +135 -135
  137. package/src/client-v2/skill-hub/locale.ts +13 -13
  138. package/src/client-v2/skill-hub/tools/InteractionSchemasProvider.tsx +62 -0
  139. package/src/client-v2/skill-hub/tools/SkillHubCard.tsx +104 -0
  140. package/src/client-v2/skill-hub/tools/__tests__/interactions.test.ts +110 -0
  141. package/src/client-v2/skill-hub/tools/interactions.ts +128 -0
  142. package/src/client-v2/skill-hub/tools/loopTemplates.ts +52 -52
  143. package/src/client-v2/skill-hub/utils/jsonFields.ts +41 -41
  144. package/src/client-v2/utils/jsonFields.ts +41 -41
  145. package/src/index.ts +2 -2
  146. package/src/locale/en-US.json +229 -1
  147. package/src/locale/zh-CN.json +229 -1
  148. package/src/server/__tests__/agent-execution-context.test.ts +18 -18
  149. package/src/server/__tests__/agent-governance.integration.test.ts +392 -0
  150. package/src/server/__tests__/agent-knowledge-insights.test.ts +123 -123
  151. package/src/server/__tests__/agent-monitor-acl.integration.test.ts +274 -0
  152. package/src/server/__tests__/agent-registry-service.test.ts +147 -147
  153. package/src/server/__tests__/agent-runtime-lifecycle.test.ts +46 -46
  154. package/src/server/__tests__/agent-usage-report.integration.test.ts +342 -0
  155. package/src/server/__tests__/code-validator.test.ts +63 -63
  156. package/src/server/__tests__/external-rag-search.test.ts +107 -107
  157. package/src/server/__tests__/harness-capabilities.test.ts +95 -0
  158. package/src/server/__tests__/harness-compiler.test.ts +214 -214
  159. package/src/server/__tests__/harness-profile-service.test.ts +167 -167
  160. package/src/server/__tests__/harness-runtime-policy.test.ts +293 -293
  161. package/src/server/__tests__/harness-tool-plan.test.ts +182 -172
  162. package/src/server/__tests__/input-schema-validator.test.ts +26 -26
  163. package/src/server/__tests__/loop-approval-decision.test.ts +577 -512
  164. package/src/server/__tests__/loop-approval-expiry.test.ts +258 -258
  165. package/src/server/__tests__/loop-budget-service.test.ts +36 -0
  166. package/src/server/__tests__/loop-pattern-schema.test.ts +73 -73
  167. package/src/server/__tests__/loop-run-repository.test.ts +32 -0
  168. package/src/server/__tests__/loop-run-state-machine.test.ts +101 -101
  169. package/src/server/__tests__/loop-trigger-service.test.ts +192 -148
  170. package/src/server/__tests__/loop-worker-claim.test.ts +72 -9
  171. package/src/server/__tests__/loop-worker-execution.test.ts +382 -317
  172. package/src/server/__tests__/native-agent-monitor-sync.test.ts +350 -0
  173. package/src/server/__tests__/native-sub-agent-observer.test.ts +470 -662
  174. package/src/server/__tests__/native-usage-attribution.integration.test.ts +175 -0
  175. package/src/server/__tests__/skill-access-service.test.ts +64 -64
  176. package/src/server/__tests__/skill-execute.test.ts +70 -70
  177. package/src/server/__tests__/skill-execution-task-policy.test.ts +140 -140
  178. package/src/server/__tests__/skill-sandbox-worker-mode.test.ts +15 -15
  179. package/src/server/__tests__/skill-settings.test.ts +63 -63
  180. package/src/server/__tests__/skill-tool-name.test.ts +23 -23
  181. package/src/server/__tests__/token-tracker.test.ts +639 -0
  182. package/src/server/__tests__/tool-loop-detection.test.ts +276 -276
  183. package/src/server/__tests__/tracing-retention-policy.test.ts +37 -0
  184. package/src/server/__tests__/usage-ledger.integration.test.ts +194 -0
  185. package/src/server/collections/agent-execution-spans.ts +393 -245
  186. package/src/server/collections/agent-governance-audit-events.ts +26 -0
  187. package/src/server/collections/agent-governance-policies.ts +26 -0
  188. package/src/server/collections/agent-governance-policy-versions.ts +27 -0
  189. package/src/server/collections/agent-governance-prompt-bindings.ts +29 -0
  190. package/src/server/collections/agent-loop-action-approvals.ts +39 -39
  191. package/src/server/collections/agent-loop-runs.ts +396 -369
  192. package/src/server/collections/agent-loop-steps.ts +220 -220
  193. package/src/server/collections/agent-memory-contexts.ts +95 -95
  194. package/src/server/collections/orchestrator-config.ts +87 -87
  195. package/src/server/collections/orchestrator-logs.ts +116 -116
  196. package/src/server/collections/skill-definitions.ts +159 -159
  197. package/src/server/collections/skill-executions.ts +154 -154
  198. package/src/server/collections/skill-loop-configs.ts +65 -65
  199. package/src/server/collections/skill-metrics.ts +36 -36
  200. package/src/server/collections/skill-registry-installations.ts +41 -41
  201. package/src/server/collections/skill-worker-configs.ts +86 -86
  202. package/src/server/index.ts +1 -1
  203. package/src/server/migrations/20260423000000-add-progress-fields.ts +50 -50
  204. package/src/server/migrations/20260425000000-add-interaction-schema.ts +37 -37
  205. package/src/server/migrations/20260427000000-add-tracing-detail-fields.ts +41 -41
  206. package/src/server/migrations/20260427000001-change-other-json-to-text.ts +61 -61
  207. package/src/server/migrations/20260524001000-add-plan-approval-and-harness-profiles.ts +145 -145
  208. package/src/server/migrations/20260601000000-add-token-fields.ts +89 -89
  209. package/src/server/migrations/20260615000000-normalize-ai-employee-tool-bindings.ts +39 -39
  210. package/src/server/migrations/20260621000000-native-policy-profile-defaults.ts +190 -190
  211. package/src/server/migrations/20260727000000-remove-unused-knowledge-scopes.ts +25 -25
  212. package/src/server/migrations/20260727010000-backfill-skill-tool-names.ts +45 -45
  213. package/src/server/migrations/20261110000000-add-usage-pricing-snapshots.ts +117 -0
  214. package/src/server/migrations/20261110010000-add-usage-department-attribution.ts +35 -0
  215. package/src/server/plugin.ts +674 -573
  216. package/src/server/resources/agent-governance.ts +168 -0
  217. package/src/server/resources/agent-harness-profile.ts +110 -94
  218. package/src/server/resources/agent-knowledge-insights.ts +306 -306
  219. package/src/server/resources/agent-loop-approval.ts +84 -84
  220. package/src/server/resources/agent-loop-events-stream.ts +108 -108
  221. package/src/server/resources/agent-loop.ts +252 -252
  222. package/src/server/resources/agent-monitor.ts +215 -482
  223. package/src/server/resources/agent-usage.ts +420 -0
  224. package/src/server/resources/native-monitor-format.ts +157 -0
  225. package/src/server/resources/tracing.ts +303 -267
  226. package/src/server/services/AgentExecutionContext.ts +23 -23
  227. package/src/server/services/AgentGovernanceService.ts +548 -0
  228. package/src/server/services/AgentMemoryContextService.ts +344 -344
  229. package/src/server/services/AgentRegistryService.ts +220 -220
  230. package/src/server/services/AgentRuntimeLifecycle.ts +64 -64
  231. package/src/server/services/CodeValidator.ts +238 -238
  232. package/src/server/services/DepartmentAttribution.ts +54 -0
  233. package/src/server/services/DurableCircuitBreakerService.ts +235 -235
  234. package/src/server/services/ExecutionSpanService.ts +278 -146
  235. package/src/server/services/FileManager.ts +159 -159
  236. package/src/server/services/GovernanceAdmission.ts +239 -0
  237. package/src/server/services/HarnessCapabilities.ts +119 -0
  238. package/src/server/services/HarnessCompiler.ts +170 -170
  239. package/src/server/services/HarnessProfileService.ts +235 -235
  240. package/src/server/services/HarnessSchema.ts +194 -194
  241. package/src/server/services/InputSchemaValidator.ts +44 -44
  242. package/src/server/services/LoopBudgetService.ts +332 -271
  243. package/src/server/services/LoopControlService.ts +120 -120
  244. package/src/server/services/LoopPatternSchema.ts +231 -231
  245. package/src/server/services/LoopPatternService.ts +171 -171
  246. package/src/server/services/LoopRunRepository.ts +350 -332
  247. package/src/server/services/LoopRunStateMachine.ts +545 -525
  248. package/src/server/services/LoopSchedulerService.ts +195 -195
  249. package/src/server/services/LoopTriggerService.ts +169 -159
  250. package/src/server/services/LoopWorkerService.ts +986 -912
  251. package/src/server/services/ManagedPromptProtection.ts +88 -0
  252. package/src/server/services/NativeAgentMonitorSyncService.ts +691 -0
  253. package/src/server/services/NativeSubAgentObserver.ts +331 -757
  254. package/src/server/services/NativeUsageAttribution.ts +98 -0
  255. package/src/server/services/PathLockService.ts +317 -317
  256. package/src/server/services/PluginAiRuntimeAdapter.ts +387 -387
  257. package/src/server/services/RunEventBus.ts +58 -58
  258. package/src/server/services/SandboxRunner.ts +492 -492
  259. package/src/server/services/SkillAccessService.ts +175 -175
  260. package/src/server/services/SkillManager.ts +585 -585
  261. package/src/server/services/SkillRepositoryService.ts +236 -236
  262. package/src/server/services/TokenTracker.ts +1158 -287
  263. package/src/server/services/ToolLoopDetectionService.ts +210 -210
  264. package/src/server/services/TracingRetentionPolicy.ts +56 -0
  265. package/src/server/services/VerificationSchema.ts +31 -31
  266. package/src/server/services/VerificationService.ts +332 -313
  267. package/src/server/services/WorkerEnvManager.ts +198 -198
  268. package/src/server/services/__tests__/SkillRepositoryService.test.ts +33 -33
  269. package/src/server/services/harness-runtime-policy.ts +134 -134
  270. package/src/server/services/pythonGuardTemplate.ts +87 -87
  271. package/src/server/services/sandboxCapabilities.ts +348 -348
  272. package/src/server/skill-hub/actions/__tests__/git-import.test.ts +563 -563
  273. package/src/server/skill-hub/actions/git-import.ts +936 -936
  274. package/src/server/skill-hub/mcp/McpController.ts +107 -107
  275. package/src/server/skill-hub/middlewares/git-import-request-method-policy.ts +51 -51
  276. package/src/server/skill-hub/plugin.ts +1232 -1232
  277. package/src/server/skill-hub/sandbox-config.json +6 -6
  278. package/src/server/skill-hub/services/RegistrySkillInstallationService.ts +281 -281
  279. package/src/server/skill-hub/services/__tests__/RegistrySkillInstallationService.test.ts +295 -295
  280. package/src/server/skill-hub/tasks/SkillExecutionTask.ts +568 -568
  281. package/src/server/skill-hub/utils/json-fields.ts +57 -57
  282. package/src/server/tools/delegate-task.ts +30 -30
  283. package/src/server/tools/external-rag-search.ts +329 -329
  284. package/src/server/tools/skill-execute.ts +216 -216
  285. package/src/server/types.ts +21 -21
  286. package/src/server/utils/ai-manager.ts +24 -24
  287. package/src/server/utils/ctx-utils.ts +132 -132
  288. package/src/server/utils/ensure-indexes.ts +119 -96
  289. package/src/server/utils/ha-lock.ts +80 -80
  290. package/src/server/utils/loop-pattern-context.ts +84 -84
  291. package/src/server/utils/record-utils.ts +19 -19
  292. package/src/server/utils/skill-settings.ts +135 -135
  293. package/src/server/utils/skill-tool-name.ts +58 -58
  294. package/dist/client-v2/117.7565cff57c39318a.js +0 -10
  295. package/dist/client-v2/214.106635011859dede.js +0 -10
  296. package/dist/client-v2/253.59577b40d9875be0.js +0 -10
  297. package/dist/client-v2/264.7ed8bee71fa5935c.js +0 -10
  298. package/dist/client-v2/418.41ed200e7d6da332.js +0 -10
  299. package/dist/client-v2/794.a67a2614405ba627.js +0 -10
  300. package/dist/client-v2/993.b0688fdc5ccb000a.js +0 -10
  301. package/dist/node_modules/simple-git/dist/cjs/index.js +0 -7399
  302. package/dist/node_modules/simple-git/dist/esm/index.js +0 -4745
  303. package/dist/node_modules/simple-git/dist/esm/package.json +0 -3
  304. package/dist/node_modules/simple-git/dist/src/lib/api.d.ts +0 -13
  305. package/dist/node_modules/simple-git/dist/src/lib/args/log-format.d.ts +0 -9
  306. package/dist/node_modules/simple-git/dist/src/lib/errors/git-construct-error.d.ts +0 -15
  307. package/dist/node_modules/simple-git/dist/src/lib/errors/git-error.d.ts +0 -30
  308. package/dist/node_modules/simple-git/dist/src/lib/errors/git-plugin-error.d.ts +0 -7
  309. package/dist/node_modules/simple-git/dist/src/lib/errors/git-response-error.d.ts +0 -32
  310. package/dist/node_modules/simple-git/dist/src/lib/errors/task-configuration-error.d.ts +0 -12
  311. package/dist/node_modules/simple-git/dist/src/lib/git-factory.d.ts +0 -15
  312. package/dist/node_modules/simple-git/dist/src/lib/git-logger.d.ts +0 -21
  313. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-branch-delete.d.ts +0 -5
  314. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-branch.d.ts +0 -2
  315. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-commit.d.ts +0 -2
  316. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-diff-summary.d.ts +0 -3
  317. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-fetch.d.ts +0 -2
  318. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-list-log-summary.d.ts +0 -6
  319. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-merge.d.ts +0 -11
  320. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-move.d.ts +0 -2
  321. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-pull.d.ts +0 -6
  322. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-push.d.ts +0 -4
  323. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-remote-messages.d.ts +0 -5
  324. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-remote-objects.d.ts +0 -3
  325. package/dist/node_modules/simple-git/dist/src/lib/plugins/abort-plugin.d.ts +0 -3
  326. package/dist/node_modules/simple-git/dist/src/lib/plugins/block-unsafe-operations-plugin.d.ts +0 -3
  327. package/dist/node_modules/simple-git/dist/src/lib/plugins/command-config-prefixing-plugin.d.ts +0 -2
  328. package/dist/node_modules/simple-git/dist/src/lib/plugins/completion-detection.plugin.d.ts +0 -3
  329. package/dist/node_modules/simple-git/dist/src/lib/plugins/custom-binary.plugin.d.ts +0 -3
  330. package/dist/node_modules/simple-git/dist/src/lib/plugins/error-detection.plugin.d.ts +0 -7
  331. package/dist/node_modules/simple-git/dist/src/lib/plugins/index.d.ts +0 -11
  332. package/dist/node_modules/simple-git/dist/src/lib/plugins/plugin-store.d.ts +0 -11
  333. package/dist/node_modules/simple-git/dist/src/lib/plugins/progress-monitor-plugin.d.ts +0 -3
  334. package/dist/node_modules/simple-git/dist/src/lib/plugins/simple-git-plugin.d.ts +0 -48
  335. package/dist/node_modules/simple-git/dist/src/lib/plugins/spawn-options-plugin.d.ts +0 -3
  336. package/dist/node_modules/simple-git/dist/src/lib/plugins/suffix-paths.plugin.d.ts +0 -2
  337. package/dist/node_modules/simple-git/dist/src/lib/plugins/timout-plugin.d.ts +0 -3
  338. package/dist/node_modules/simple-git/dist/src/lib/responses/BranchDeleteSummary.d.ts +0 -12
  339. package/dist/node_modules/simple-git/dist/src/lib/responses/BranchSummary.d.ts +0 -14
  340. package/dist/node_modules/simple-git/dist/src/lib/responses/CheckIgnore.d.ts +0 -4
  341. package/dist/node_modules/simple-git/dist/src/lib/responses/CleanSummary.d.ts +0 -9
  342. package/dist/node_modules/simple-git/dist/src/lib/responses/ConfigList.d.ts +0 -13
  343. package/dist/node_modules/simple-git/dist/src/lib/responses/DiffSummary.d.ts +0 -10
  344. package/dist/node_modules/simple-git/dist/src/lib/responses/FileStatusSummary.d.ts +0 -9
  345. package/dist/node_modules/simple-git/dist/src/lib/responses/GetRemoteSummary.d.ts +0 -11
  346. package/dist/node_modules/simple-git/dist/src/lib/responses/InitSummary.d.ts +0 -9
  347. package/dist/node_modules/simple-git/dist/src/lib/responses/MergeSummary.d.ts +0 -16
  348. package/dist/node_modules/simple-git/dist/src/lib/responses/PullSummary.d.ts +0 -25
  349. package/dist/node_modules/simple-git/dist/src/lib/responses/StatusSummary.d.ts +0 -19
  350. package/dist/node_modules/simple-git/dist/src/lib/responses/TagList.d.ts +0 -7
  351. package/dist/node_modules/simple-git/dist/src/lib/runners/git-executor-chain.d.ts +0 -25
  352. package/dist/node_modules/simple-git/dist/src/lib/runners/git-executor.d.ts +0 -14
  353. package/dist/node_modules/simple-git/dist/src/lib/runners/promise-wrapped.d.ts +0 -2
  354. package/dist/node_modules/simple-git/dist/src/lib/runners/scheduler.d.ts +0 -11
  355. package/dist/node_modules/simple-git/dist/src/lib/runners/tasks-pending-queue.d.ts +0 -23
  356. package/dist/node_modules/simple-git/dist/src/lib/simple-git-api.d.ts +0 -20
  357. package/dist/node_modules/simple-git/dist/src/lib/task-callback.d.ts +0 -2
  358. package/dist/node_modules/simple-git/dist/src/lib/tasks/apply-patch.d.ts +0 -3
  359. package/dist/node_modules/simple-git/dist/src/lib/tasks/branch.d.ts +0 -7
  360. package/dist/node_modules/simple-git/dist/src/lib/tasks/change-working-directory.d.ts +0 -2
  361. package/dist/node_modules/simple-git/dist/src/lib/tasks/check-ignore.d.ts +0 -2
  362. package/dist/node_modules/simple-git/dist/src/lib/tasks/check-is-repo.d.ts +0 -9
  363. package/dist/node_modules/simple-git/dist/src/lib/tasks/checkout.d.ts +0 -2
  364. package/dist/node_modules/simple-git/dist/src/lib/tasks/clean.d.ts +0 -25
  365. package/dist/node_modules/simple-git/dist/src/lib/tasks/clone.d.ts +0 -9
  366. package/dist/node_modules/simple-git/dist/src/lib/tasks/commit.d.ts +0 -4
  367. package/dist/node_modules/simple-git/dist/src/lib/tasks/config.d.ts +0 -8
  368. package/dist/node_modules/simple-git/dist/src/lib/tasks/count-objects.d.ts +0 -12
  369. package/dist/node_modules/simple-git/dist/src/lib/tasks/diff-name-status.d.ts +0 -12
  370. package/dist/node_modules/simple-git/dist/src/lib/tasks/diff.d.ts +0 -5
  371. package/dist/node_modules/simple-git/dist/src/lib/tasks/fetch.d.ts +0 -4
  372. package/dist/node_modules/simple-git/dist/src/lib/tasks/first-commit.d.ts +0 -2
  373. package/dist/node_modules/simple-git/dist/src/lib/tasks/grep.d.ts +0 -12
  374. package/dist/node_modules/simple-git/dist/src/lib/tasks/hash-object.d.ts +0 -5
  375. package/dist/node_modules/simple-git/dist/src/lib/tasks/init.d.ts +0 -3
  376. package/dist/node_modules/simple-git/dist/src/lib/tasks/log.d.ts +0 -32
  377. package/dist/node_modules/simple-git/dist/src/lib/tasks/merge.d.ts +0 -4
  378. package/dist/node_modules/simple-git/dist/src/lib/tasks/move.d.ts +0 -3
  379. package/dist/node_modules/simple-git/dist/src/lib/tasks/pull.d.ts +0 -3
  380. package/dist/node_modules/simple-git/dist/src/lib/tasks/push.d.ts +0 -9
  381. package/dist/node_modules/simple-git/dist/src/lib/tasks/remote.d.ts +0 -8
  382. package/dist/node_modules/simple-git/dist/src/lib/tasks/reset.d.ts +0 -11
  383. package/dist/node_modules/simple-git/dist/src/lib/tasks/show.d.ts +0 -2
  384. package/dist/node_modules/simple-git/dist/src/lib/tasks/stash-list.d.ts +0 -4
  385. package/dist/node_modules/simple-git/dist/src/lib/tasks/status.d.ts +0 -3
  386. package/dist/node_modules/simple-git/dist/src/lib/tasks/sub-module.d.ts +0 -5
  387. package/dist/node_modules/simple-git/dist/src/lib/tasks/tag.d.ts +0 -18
  388. package/dist/node_modules/simple-git/dist/src/lib/tasks/task.d.ts +0 -14
  389. package/dist/node_modules/simple-git/dist/src/lib/tasks/version.d.ts +0 -9
  390. package/dist/node_modules/simple-git/dist/src/lib/types/handlers.d.ts +0 -21
  391. package/dist/node_modules/simple-git/dist/src/lib/types/index.d.ts +0 -136
  392. package/dist/node_modules/simple-git/dist/src/lib/types/tasks.d.ts +0 -19
  393. package/dist/node_modules/simple-git/dist/src/lib/utils/argument-filters.d.ts +0 -14
  394. package/dist/node_modules/simple-git/dist/src/lib/utils/exit-codes.d.ts +0 -10
  395. package/dist/node_modules/simple-git/dist/src/lib/utils/git-output-streams.d.ts +0 -7
  396. package/dist/node_modules/simple-git/dist/src/lib/utils/index.d.ts +0 -8
  397. package/dist/node_modules/simple-git/dist/src/lib/utils/line-parser.d.ts +0 -15
  398. package/dist/node_modules/simple-git/dist/src/lib/utils/simple-git-options.d.ts +0 -2
  399. package/dist/node_modules/simple-git/dist/src/lib/utils/task-options.d.ts +0 -13
  400. package/dist/node_modules/simple-git/dist/src/lib/utils/task-parser.d.ts +0 -5
  401. package/dist/node_modules/simple-git/dist/src/lib/utils/util.d.ts +0 -47
  402. package/dist/node_modules/simple-git/dist/typings/errors.d.ts +0 -5
  403. package/dist/node_modules/simple-git/dist/typings/index.d.ts +0 -14
  404. package/dist/node_modules/simple-git/dist/typings/response.d.ts +0 -556
  405. package/dist/node_modules/simple-git/dist/typings/simple-git.d.ts +0 -1033
  406. package/dist/node_modules/simple-git/dist/typings/types.d.ts +0 -22
  407. package/dist/node_modules/simple-git/node_modules/debug/package.json +0 -64
  408. package/dist/node_modules/simple-git/node_modules/debug/src/browser.js +0 -272
  409. package/dist/node_modules/simple-git/node_modules/debug/src/common.js +0 -292
  410. package/dist/node_modules/simple-git/node_modules/debug/src/index.js +0 -10
  411. package/dist/node_modules/simple-git/node_modules/debug/src/node.js +0 -263
  412. package/dist/node_modules/simple-git/package.json +0 -1
  413. package/dist/node_modules/simple-git/promise.js +0 -17
@@ -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
+ }