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.
Files changed (495) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +207 -204
  3. package/client-v2.d.ts +2 -2
  4. package/client-v2.js +1 -1
  5. package/client.d.ts +2 -2
  6. package/client.js +1 -1
  7. package/dist/client/117.6c69b6a87751dd18.js +10 -0
  8. package/dist/client/253.52f62e1bc0e9520a.js +10 -0
  9. package/dist/client/325.8f7f509bdb35e142.js +10 -0
  10. package/dist/client/404.86593f98c9768ed5.js +10 -0
  11. package/dist/client/453.fa2d169576262213.js +10 -0
  12. package/dist/client/53.567db3ae078650c6.js +10 -0
  13. package/dist/client/619.01713281e5e951d3.js +10 -0
  14. package/dist/client/652.69da1598312b3a3f.js +10 -0
  15. package/dist/client/773.648965568ff476f9.js +10 -0
  16. package/dist/client/981.37e7aeecdb1ef6fa.js +10 -0
  17. package/dist/client/993.ac89f3852990918d.js +10 -0
  18. package/dist/client/index.js +1 -1
  19. package/dist/client-v2/117.c982d79ff68738f5.js +10 -0
  20. package/dist/client-v2/214.94c4257bf2838577.js +10 -0
  21. package/dist/client-v2/253.8e19956d2a44dfb8.js +10 -0
  22. package/dist/client-v2/264.80e8e358c8c6c2e5.js +10 -0
  23. package/dist/client-v2/325.fafe5a6e83ba9cb3.js +10 -0
  24. package/dist/client-v2/404.ab032b79c95dab6f.js +10 -0
  25. package/dist/client-v2/{41.3deb9e57a0f64fc4.js → 41.cd5610fcf7446127.js} +1 -1
  26. package/dist/client-v2/453.42c6d70628d56cc2.js +10 -0
  27. package/dist/client-v2/{53.349fff8db80b19d4.js → 53.37c08089a648f89a.js} +1 -1
  28. package/dist/client-v2/{619.0a2144aaffefe018.js → 619.6e9618550101e819.js} +1 -1
  29. package/dist/client-v2/652.eeba4e0c38367321.js +10 -0
  30. package/dist/client-v2/{70.ffff2997c10fd4b0.js → 70.332698e53eb59677.js} +1 -1
  31. package/dist/client-v2/773.4de2ba5acb07318c.js +10 -0
  32. package/dist/client-v2/981.76060f466e6f7c11.js +10 -0
  33. package/dist/client-v2/993.f8cdb5172566ce75.js +10 -0
  34. package/dist/client-v2/index.js +1 -1
  35. package/dist/externalVersion.js +13 -7
  36. package/dist/locale/en-US.json +308 -1
  37. package/dist/locale/vi-VN.json +5 -1
  38. package/dist/locale/zh-CN.json +308 -1
  39. package/dist/node_modules/acorn/LICENSE +21 -0
  40. package/dist/node_modules/acorn/bin/acorn +4 -0
  41. package/dist/node_modules/acorn/dist/acorn.d.mts +857 -0
  42. package/dist/node_modules/acorn/dist/acorn.d.ts +857 -0
  43. package/dist/node_modules/acorn/dist/acorn.js +1 -0
  44. package/dist/node_modules/acorn/dist/bin.js +90 -0
  45. package/dist/node_modules/acorn/package.json +1 -0
  46. package/dist/node_modules/acorn-walk/LICENSE +21 -0
  47. package/dist/node_modules/acorn-walk/dist/walk.d.mts +177 -0
  48. package/dist/node_modules/acorn-walk/dist/walk.d.ts +177 -0
  49. package/dist/node_modules/acorn-walk/dist/walk.js +1 -0
  50. package/dist/node_modules/acorn-walk/node_modules/.bin/acorn +15 -0
  51. package/dist/node_modules/acorn-walk/node_modules/.bin/acorn.cmd +7 -0
  52. package/dist/node_modules/acorn-walk/node_modules/acorn/bin/acorn +4 -0
  53. package/dist/node_modules/acorn-walk/node_modules/acorn/dist/acorn.d.mts +866 -0
  54. package/dist/node_modules/acorn-walk/node_modules/acorn/dist/acorn.d.ts +866 -0
  55. package/dist/node_modules/acorn-walk/node_modules/acorn/dist/acorn.js +6174 -0
  56. package/dist/node_modules/acorn-walk/node_modules/acorn/dist/bin.js +90 -0
  57. package/dist/node_modules/acorn-walk/node_modules/acorn/package.json +50 -0
  58. package/dist/node_modules/acorn-walk/package.json +1 -0
  59. package/dist/node_modules/adm-zip/adm-zip.js +1 -1
  60. package/dist/node_modules/adm-zip/package.json +1 -1
  61. package/dist/node_modules/ajv/package.json +1 -1
  62. package/dist/node_modules/zod/index.cjs +1 -1
  63. package/dist/node_modules/zod/package.json +1 -1
  64. package/dist/server/collections/agent-auto-approval-checkpoints.js +47 -0
  65. package/dist/server/collections/agent-execution-spans.js +148 -9
  66. package/dist/server/collections/agent-governance-audit-events.js +47 -0
  67. package/dist/server/collections/agent-governance-policies.js +47 -0
  68. package/dist/server/collections/agent-governance-policy-versions.js +48 -0
  69. package/dist/server/collections/agent-governance-prompt-bindings.js +50 -0
  70. package/dist/server/collections/agent-hierarchy-invocations.js +59 -0
  71. package/dist/server/collections/agent-loop-runs.js +23 -5
  72. package/dist/server/collections/agent-routing-graph-locks.js +40 -0
  73. package/dist/server/collections/agent-session-auto-approvals.js +45 -0
  74. package/dist/server/collections/orchestrator-config.js +17 -0
  75. package/dist/server/migrations/20261110000000-add-usage-pricing-snapshots.js +117 -0
  76. package/dist/server/migrations/20261110010000-add-usage-department-attribution.js +54 -0
  77. package/dist/server/migrations/20261119000000-widen-native-employee-identifiers.js +59 -0
  78. package/dist/server/plugin.js +169 -33
  79. package/dist/server/resources/agent-auto-approval.js +80 -0
  80. package/dist/server/resources/agent-governance.js +192 -0
  81. package/dist/server/resources/agent-harness-profile.js +11 -3
  82. package/dist/server/resources/agent-monitor.js +109 -339
  83. package/dist/server/resources/agent-usage.js +423 -0
  84. package/dist/server/resources/hierarchical-routing.js +60 -0
  85. package/dist/server/resources/native-monitor-format.js +179 -0
  86. package/dist/server/resources/tracing.js +35 -12
  87. package/dist/server/services/AgentGovernanceService.js +500 -0
  88. package/dist/server/services/AutoApprovalCheckpoint.js +133 -0
  89. package/dist/server/services/CodeValidator.js +8 -4
  90. package/dist/server/services/DepartmentAttribution.js +65 -0
  91. package/dist/server/services/ExecutionSpanService.js +96 -3
  92. package/dist/server/services/GovernanceAdmission.js +271 -0
  93. package/dist/server/services/HarnessCapabilities.js +118 -0
  94. package/dist/server/services/HarnessCompiler.js +3 -0
  95. package/dist/server/services/HarnessSchema.js +13 -1
  96. package/dist/server/services/HierarchicalAgentRuntime.js +925 -0
  97. package/dist/server/services/HierarchyEnrollmentGuard.js +216 -0
  98. package/dist/server/services/HierarchyInvocationJournal.js +157 -0
  99. package/dist/server/services/HierarchyRequestCancellation.js +150 -0
  100. package/dist/server/services/LoopBudgetService.js +29 -11
  101. package/dist/server/services/LoopRunRepository.js +16 -7
  102. package/dist/server/services/LoopRunStateMachine.js +20 -9
  103. package/dist/server/services/LoopTriggerService.js +1 -1
  104. package/dist/server/services/LoopWorkerService.js +71 -37
  105. package/dist/server/services/ManagedPromptProtection.js +99 -0
  106. package/dist/server/services/NativeAgentMonitorSyncService.js +584 -0
  107. package/dist/server/services/NativeSubAgentObserver.js +141 -508
  108. package/dist/server/services/NativeUsageAttribution.js +97 -0
  109. package/dist/server/services/PluginAiRuntimeAdapter.js +107 -9
  110. package/dist/server/services/RoutingBindingRepository.js +156 -0
  111. package/dist/server/services/RoutingBindingValidation.js +161 -0
  112. package/dist/server/services/SandboxRunner.js +19 -0
  113. package/dist/server/services/SessionAutoApproval.js +173 -0
  114. package/dist/server/services/TokenTracker.js +787 -104
  115. package/dist/server/services/TracingRetentionPolicy.js +66 -0
  116. package/dist/server/services/VerificationService.js +20 -10
  117. package/dist/server/skill-hub/plugin.js +17 -0
  118. package/dist/server/skill-hub/sandbox-config.json +6 -6
  119. package/dist/server/skill-hub/services/RegistrySkillInstallationService.js +2 -2
  120. package/dist/server/skill-hub/services/registry-node-package.js +191 -0
  121. package/dist/server/skill-hub/tasks/SkillExecutionTask.js +21 -6
  122. package/dist/server/tools/skill-execute.js +1 -0
  123. package/dist/server/utils/ensure-indexes.js +15 -5
  124. package/package.json +66 -53
  125. package/server.d.ts +2 -2
  126. package/server.js +1 -1
  127. package/src/client/AgentRunsTab.tsx +2 -2
  128. package/src/client/ApprovalsTab.tsx +2 -2
  129. package/src/client/HarnessProfilesTab.tsx +2 -2
  130. package/src/client/OrchestratorSettings.tsx +152 -152
  131. package/src/client/SkillPages.tsx +34 -0
  132. package/src/client/__tests__/embedded-settings.test.tsx +225 -0
  133. package/src/client/hooks/useRunEventStream.ts +76 -76
  134. package/src/client/index.tsx +2 -2
  135. package/src/client/plugin.tsx +71 -33
  136. package/src/client/skill-hub/components/ExecutionHistory.tsx +200 -200
  137. package/src/client/skill-hub/components/GitSkillImport.tsx +562 -562
  138. package/src/client/skill-hub/components/LoopSettings.tsx +331 -331
  139. package/src/client/skill-hub/components/SkillEditor.tsx +460 -460
  140. package/src/client/skill-hub/components/SkillManager.tsx +194 -194
  141. package/src/client/skill-hub/components/SkillMetrics.tsx +162 -162
  142. package/src/client/skill-hub/components/SkillTestPanel.tsx +141 -141
  143. package/src/client/skill-hub/index.tsx +6 -6
  144. package/src/client/skill-hub/locale.ts +16 -16
  145. package/src/client/skill-hub/tools/InteractionSchemasProvider.tsx +147 -132
  146. package/src/client/skill-hub/tools/SkillHubCard.tsx +110 -104
  147. package/src/client/skill-hub/tools/__tests__/skill-hub-card.test.tsx +255 -0
  148. package/src/client/skill-hub/tools/loopTemplates.ts +52 -52
  149. package/src/client/skill-hub/tools/registerSkillLoopCards.ts +80 -71
  150. package/src/client/skill-hub/utils/jsonFields.ts +41 -41
  151. package/src/client-v2/__tests__/embedded-settings.test.tsx +202 -0
  152. package/src/client-v2/__tests__/hierarchical-routing-settings.test.tsx +350 -0
  153. package/src/client-v2/auto-approval/AutoApprovalBridge.tsx +513 -0
  154. package/src/client-v2/auto-approval/AutoApprovalProvider.tsx +399 -0
  155. package/src/client-v2/auto-approval/__tests__/session-auto-approval.test.tsx +1676 -0
  156. package/src/client-v2/components/AIEmployeeSelect.tsx +47 -47
  157. package/src/client-v2/components/AIEmployeesContext.tsx +97 -97
  158. package/src/client-v2/components/AgentBindingsTab.tsx +541 -269
  159. package/src/client-v2/components/AgentRunsTab.tsx +85 -83
  160. package/src/client-v2/components/ApprovalsTab.tsx +337 -337
  161. package/src/client-v2/components/EmployeeGovernanceTab.tsx +695 -0
  162. package/src/client-v2/components/HarnessProfilesTab.tsx +700 -541
  163. package/src/client-v2/components/HarnessSettingsForm.tsx +221 -0
  164. package/src/client-v2/components/KnowledgeAccessTab.tsx +116 -116
  165. package/src/client-v2/components/RetrievalTraceTab.tsx +162 -162
  166. package/src/client-v2/components/UsageGovernanceTab.tsx +379 -0
  167. package/src/client-v2/index.tsx +1 -1
  168. package/src/client-v2/pages/AgentBindingsPage.tsx +15 -13
  169. package/src/client-v2/pages/ApprovalsPage.tsx +12 -10
  170. package/src/client-v2/pages/EmployeeGovernancePage.tsx +15 -0
  171. package/src/client-v2/pages/ExecutionHistoryPage.tsx +12 -10
  172. package/src/client-v2/pages/HarnessProfilesPage.tsx +12 -10
  173. package/src/client-v2/pages/KnowledgeAccessPage.tsx +12 -10
  174. package/src/client-v2/pages/LoopSettingsPage.tsx +12 -10
  175. package/src/client-v2/pages/MemoryInspectorPage.tsx +15 -13
  176. package/src/client-v2/pages/RetrievalTracePage.tsx +12 -10
  177. package/src/client-v2/pages/RulesPage.tsx +15 -13
  178. package/src/client-v2/pages/SkillDefinitionsPage.tsx +12 -10
  179. package/src/client-v2/pages/SkillMetricsPage.tsx +12 -10
  180. package/src/client-v2/pages/TracingPage.tsx +15 -13
  181. package/src/client-v2/pages/UsageGovernancePage.tsx +15 -0
  182. package/src/client-v2/plugin.tsx +134 -111
  183. package/src/client-v2/skill-hub/components/ExecutionHistory.tsx +196 -196
  184. package/src/client-v2/skill-hub/components/FileLinkList.tsx +37 -37
  185. package/src/client-v2/skill-hub/components/GitSkillImport.tsx +539 -539
  186. package/src/client-v2/skill-hub/components/LoopSettings.tsx +331 -331
  187. package/src/client-v2/skill-hub/components/SkillEditor.tsx +453 -453
  188. package/src/client-v2/skill-hub/components/SkillManager.tsx +191 -174
  189. package/src/client-v2/skill-hub/components/SkillMetrics.tsx +162 -162
  190. package/src/client-v2/skill-hub/components/SkillTestPanel.tsx +135 -135
  191. package/src/client-v2/skill-hub/locale.ts +13 -13
  192. package/src/client-v2/skill-hub/tools/InteractionSchemasProvider.tsx +62 -0
  193. package/src/client-v2/skill-hub/tools/SkillHubCard.tsx +104 -0
  194. package/src/client-v2/skill-hub/tools/__tests__/interactions.test.ts +126 -0
  195. package/src/client-v2/skill-hub/tools/interactions.ts +137 -0
  196. package/src/client-v2/skill-hub/tools/loopTemplates.ts +52 -52
  197. package/src/client-v2/skill-hub/utils/jsonFields.ts +41 -41
  198. package/src/client-v2/utils/jsonFields.ts +41 -41
  199. package/src/index.ts +2 -2
  200. package/src/locale/en-US.json +308 -1
  201. package/src/locale/vi-VN.json +5 -1
  202. package/src/locale/zh-CN.json +308 -1
  203. package/src/server/__tests__/agent-execution-context.test.ts +18 -18
  204. package/src/server/__tests__/agent-governance.integration.test.ts +385 -0
  205. package/src/server/__tests__/agent-knowledge-insights.test.ts +123 -123
  206. package/src/server/__tests__/agent-monitor-acl.integration.test.ts +267 -0
  207. package/src/server/__tests__/agent-registry-service.test.ts +147 -147
  208. package/src/server/__tests__/agent-runtime-lifecycle.test.ts +46 -46
  209. package/src/server/__tests__/agent-usage-report.integration.test.ts +335 -0
  210. package/src/server/__tests__/auto-approval-checkpoint.integration.test.ts +295 -0
  211. package/src/server/__tests__/code-validator.test.ts +63 -63
  212. package/src/server/__tests__/external-rag-search.test.ts +107 -107
  213. package/src/server/__tests__/harness-capabilities.test.ts +88 -0
  214. package/src/server/__tests__/harness-compiler.test.ts +278 -214
  215. package/src/server/__tests__/harness-profile-service.test.ts +167 -167
  216. package/src/server/__tests__/harness-runtime-policy.test.ts +293 -293
  217. package/src/server/__tests__/harness-tool-plan.test.ts +175 -172
  218. package/src/server/__tests__/hierarchical-routing.integration.test.ts +2318 -0
  219. package/src/server/__tests__/hierarchy-invocation-journal.integration.test.ts +119 -0
  220. package/src/server/__tests__/input-schema-validator.test.ts +26 -26
  221. package/src/server/__tests__/loop-approval-decision.test.ts +624 -512
  222. package/src/server/__tests__/loop-approval-expiry.test.ts +258 -258
  223. package/src/server/__tests__/loop-budget-service.test.ts +29 -0
  224. package/src/server/__tests__/loop-pattern-schema.test.ts +73 -73
  225. package/src/server/__tests__/loop-run-repository.test.ts +25 -0
  226. package/src/server/__tests__/loop-run-state-machine.test.ts +101 -101
  227. package/src/server/__tests__/loop-trigger-service.test.ts +185 -148
  228. package/src/server/__tests__/loop-worker-claim.test.ts +110 -10
  229. package/src/server/__tests__/loop-worker-execution.test.ts +375 -317
  230. package/src/server/__tests__/native-agent-monitor-sync.test.ts +343 -0
  231. package/src/server/__tests__/native-hierarchy-probe.integration.test.ts +527 -0
  232. package/src/server/__tests__/native-sub-agent-observer.test.ts +463 -662
  233. package/src/server/__tests__/native-usage-attribution.integration.test.ts +168 -0
  234. package/src/server/__tests__/plugin-ai-runtime-adapter.test.ts +403 -0
  235. package/src/server/__tests__/registry-node-package.test.ts +299 -0
  236. package/src/server/__tests__/routing-binding-graph.integration.test.ts +217 -0
  237. package/src/server/__tests__/routing-binding-validation.test.ts +256 -0
  238. package/src/server/__tests__/session-auto-approval.integration.test.ts +329 -0
  239. package/src/server/__tests__/skill-access-service.test.ts +64 -64
  240. package/src/server/__tests__/skill-execute.test.ts +81 -70
  241. package/src/server/__tests__/skill-execution-task-policy.test.ts +140 -140
  242. package/src/server/__tests__/skill-review-guard.test.ts +171 -0
  243. package/src/server/__tests__/skill-sandbox-worker-mode.test.ts +15 -15
  244. package/src/server/__tests__/skill-settings.test.ts +63 -63
  245. package/src/server/__tests__/skill-tool-name.test.ts +23 -23
  246. package/src/server/__tests__/token-tracker.test.ts +632 -0
  247. package/src/server/__tests__/tool-loop-detection.test.ts +276 -276
  248. package/src/server/__tests__/tracing-retention-policy.test.ts +30 -0
  249. package/src/server/__tests__/usage-ledger.integration.test.ts +187 -0
  250. package/src/server/collections/agent-auto-approval-checkpoints.ts +18 -0
  251. package/src/server/collections/agent-execution-spans.ts +386 -245
  252. package/src/server/collections/agent-governance-audit-events.ts +19 -0
  253. package/src/server/collections/agent-governance-policies.ts +19 -0
  254. package/src/server/collections/agent-governance-policy-versions.ts +20 -0
  255. package/src/server/collections/agent-governance-prompt-bindings.ts +22 -0
  256. package/src/server/collections/agent-hierarchy-invocations.ts +30 -0
  257. package/src/server/collections/agent-loop-action-approvals.ts +39 -39
  258. package/src/server/collections/agent-loop-runs.ts +389 -369
  259. package/src/server/collections/agent-loop-steps.ts +220 -220
  260. package/src/server/collections/agent-memory-contexts.ts +95 -95
  261. package/src/server/collections/agent-routing-graph-locks.ts +11 -0
  262. package/src/server/collections/agent-session-auto-approvals.ts +16 -0
  263. package/src/server/collections/orchestrator-config.ts +113 -87
  264. package/src/server/collections/orchestrator-logs.ts +116 -116
  265. package/src/server/collections/skill-definitions.ts +159 -159
  266. package/src/server/collections/skill-executions.ts +154 -154
  267. package/src/server/collections/skill-loop-configs.ts +65 -65
  268. package/src/server/collections/skill-metrics.ts +36 -36
  269. package/src/server/collections/skill-registry-installations.ts +41 -41
  270. package/src/server/collections/skill-worker-configs.ts +86 -86
  271. package/src/server/index.ts +1 -1
  272. package/src/server/migrations/20260423000000-add-progress-fields.ts +50 -50
  273. package/src/server/migrations/20260425000000-add-interaction-schema.ts +37 -37
  274. package/src/server/migrations/20260427000000-add-tracing-detail-fields.ts +41 -41
  275. package/src/server/migrations/20260427000001-change-other-json-to-text.ts +61 -61
  276. package/src/server/migrations/20260524001000-add-plan-approval-and-harness-profiles.ts +145 -145
  277. package/src/server/migrations/20260601000000-add-token-fields.ts +89 -89
  278. package/src/server/migrations/20260615000000-normalize-ai-employee-tool-bindings.ts +39 -39
  279. package/src/server/migrations/20260621000000-native-policy-profile-defaults.ts +190 -190
  280. package/src/server/migrations/20260727000000-remove-unused-knowledge-scopes.ts +25 -25
  281. package/src/server/migrations/20260727010000-backfill-skill-tool-names.ts +45 -45
  282. package/src/server/migrations/20261110000000-add-usage-pricing-snapshots.ts +110 -0
  283. package/src/server/migrations/20261110010000-add-usage-department-attribution.ts +28 -0
  284. package/src/server/migrations/20261119000000-widen-native-employee-identifiers.ts +37 -0
  285. package/src/server/plugin.ts +724 -573
  286. package/src/server/resources/agent-auto-approval.ts +51 -0
  287. package/src/server/resources/agent-governance.ts +161 -0
  288. package/src/server/resources/agent-harness-profile.ts +103 -94
  289. package/src/server/resources/agent-knowledge-insights.ts +306 -306
  290. package/src/server/resources/agent-loop-approval.ts +84 -84
  291. package/src/server/resources/agent-loop-events-stream.ts +108 -108
  292. package/src/server/resources/agent-loop.ts +252 -252
  293. package/src/server/resources/agent-monitor.ts +208 -482
  294. package/src/server/resources/agent-usage.ts +413 -0
  295. package/src/server/resources/hierarchical-routing.ts +39 -0
  296. package/src/server/resources/native-monitor-format.ts +150 -0
  297. package/src/server/resources/tracing.ts +296 -267
  298. package/src/server/services/AgentExecutionContext.ts +23 -23
  299. package/src/server/services/AgentGovernanceService.ts +541 -0
  300. package/src/server/services/AgentMemoryContextService.ts +344 -344
  301. package/src/server/services/AgentRegistryService.ts +220 -220
  302. package/src/server/services/AgentRuntimeLifecycle.ts +64 -64
  303. package/src/server/services/AutoApprovalCheckpoint.ts +140 -0
  304. package/src/server/services/CodeValidator.ts +257 -238
  305. package/src/server/services/DepartmentAttribution.ts +47 -0
  306. package/src/server/services/DurableCircuitBreakerService.ts +235 -235
  307. package/src/server/services/ExecutionSpanService.ts +271 -146
  308. package/src/server/services/FileManager.ts +159 -159
  309. package/src/server/services/GovernanceAdmission.ts +314 -0
  310. package/src/server/services/HarnessCapabilities.ts +112 -0
  311. package/src/server/services/HarnessCompiler.ts +182 -170
  312. package/src/server/services/HarnessProfileService.ts +235 -235
  313. package/src/server/services/HarnessSchema.ts +224 -194
  314. package/src/server/services/HierarchicalAgentRuntime.ts +1052 -0
  315. package/src/server/services/HierarchyEnrollmentGuard.ts +211 -0
  316. package/src/server/services/HierarchyInvocationJournal.ts +172 -0
  317. package/src/server/services/HierarchyRequestCancellation.ts +132 -0
  318. package/src/server/services/InputSchemaValidator.ts +44 -44
  319. package/src/server/services/LoopBudgetService.ts +325 -271
  320. package/src/server/services/LoopControlService.ts +120 -120
  321. package/src/server/services/LoopPatternSchema.ts +231 -231
  322. package/src/server/services/LoopPatternService.ts +171 -171
  323. package/src/server/services/LoopRunRepository.ts +343 -332
  324. package/src/server/services/LoopRunStateMachine.ts +538 -525
  325. package/src/server/services/LoopSchedulerService.ts +195 -195
  326. package/src/server/services/LoopTriggerService.ts +162 -159
  327. package/src/server/services/LoopWorkerService.ts +975 -912
  328. package/src/server/services/ManagedPromptProtection.ts +81 -0
  329. package/src/server/services/NativeAgentMonitorSyncService.ts +684 -0
  330. package/src/server/services/NativeSubAgentObserver.ts +324 -757
  331. package/src/server/services/NativeUsageAttribution.ts +91 -0
  332. package/src/server/services/PathLockService.ts +317 -317
  333. package/src/server/services/PluginAiRuntimeAdapter.ts +518 -387
  334. package/src/server/services/RoutingBindingRepository.ts +146 -0
  335. package/src/server/services/RoutingBindingValidation.ts +161 -0
  336. package/src/server/services/RunEventBus.ts +58 -58
  337. package/src/server/services/SandboxRunner.ts +526 -492
  338. package/src/server/services/SessionAutoApproval.ts +167 -0
  339. package/src/server/services/SkillAccessService.ts +175 -175
  340. package/src/server/services/SkillManager.ts +585 -585
  341. package/src/server/services/SkillRepositoryService.ts +236 -236
  342. package/src/server/services/TokenTracker.ts +1151 -287
  343. package/src/server/services/ToolLoopDetectionService.ts +210 -210
  344. package/src/server/services/TracingRetentionPolicy.ts +49 -0
  345. package/src/server/services/VerificationSchema.ts +31 -31
  346. package/src/server/services/VerificationService.ts +325 -313
  347. package/src/server/services/WorkerEnvManager.ts +198 -198
  348. package/src/server/services/__tests__/SkillRepositoryService.test.ts +33 -33
  349. package/src/server/services/harness-runtime-policy.ts +134 -134
  350. package/src/server/services/pythonGuardTemplate.ts +87 -87
  351. package/src/server/services/sandboxCapabilities.ts +348 -348
  352. package/src/server/skill-hub/actions/__tests__/git-import.test.ts +563 -563
  353. package/src/server/skill-hub/actions/git-import.ts +936 -936
  354. package/src/server/skill-hub/mcp/McpController.ts +107 -107
  355. package/src/server/skill-hub/middlewares/git-import-request-method-policy.ts +51 -51
  356. package/src/server/skill-hub/plugin.ts +1272 -1232
  357. package/src/server/skill-hub/sandbox-config.json +6 -6
  358. package/src/server/skill-hub/services/RegistrySkillInstallationService.ts +291 -281
  359. package/src/server/skill-hub/services/__tests__/RegistrySkillInstallationService.test.ts +295 -295
  360. package/src/server/skill-hub/services/registry-node-package.ts +191 -0
  361. package/src/server/skill-hub/tasks/SkillExecutionTask.ts +597 -568
  362. package/src/server/skill-hub/utils/json-fields.ts +57 -57
  363. package/src/server/tools/delegate-task.ts +30 -30
  364. package/src/server/tools/external-rag-search.ts +329 -329
  365. package/src/server/tools/skill-execute.ts +226 -216
  366. package/src/server/types.ts +21 -21
  367. package/src/server/utils/ai-manager.ts +24 -24
  368. package/src/server/utils/ctx-utils.ts +132 -132
  369. package/src/server/utils/ensure-indexes.ts +113 -96
  370. package/src/server/utils/ha-lock.ts +80 -80
  371. package/src/server/utils/loop-pattern-context.ts +84 -84
  372. package/src/server/utils/record-utils.ts +19 -19
  373. package/src/server/utils/skill-settings.ts +135 -135
  374. package/src/server/utils/skill-tool-name.ts +58 -58
  375. package/dist/client-v2/117.7565cff57c39318a.js +0 -10
  376. package/dist/client-v2/214.106635011859dede.js +0 -10
  377. package/dist/client-v2/253.59577b40d9875be0.js +0 -10
  378. package/dist/client-v2/264.7ed8bee71fa5935c.js +0 -10
  379. package/dist/client-v2/418.41ed200e7d6da332.js +0 -10
  380. package/dist/client-v2/794.a67a2614405ba627.js +0 -10
  381. package/dist/client-v2/981.e4a1f41cfc94a856.js +0 -10
  382. package/dist/client-v2/993.b0688fdc5ccb000a.js +0 -10
  383. package/dist/node_modules/simple-git/dist/cjs/index.js +0 -7399
  384. package/dist/node_modules/simple-git/dist/esm/index.js +0 -4745
  385. package/dist/node_modules/simple-git/dist/esm/package.json +0 -3
  386. package/dist/node_modules/simple-git/dist/src/lib/api.d.ts +0 -13
  387. package/dist/node_modules/simple-git/dist/src/lib/args/log-format.d.ts +0 -9
  388. package/dist/node_modules/simple-git/dist/src/lib/errors/git-construct-error.d.ts +0 -15
  389. package/dist/node_modules/simple-git/dist/src/lib/errors/git-error.d.ts +0 -30
  390. package/dist/node_modules/simple-git/dist/src/lib/errors/git-plugin-error.d.ts +0 -7
  391. package/dist/node_modules/simple-git/dist/src/lib/errors/git-response-error.d.ts +0 -32
  392. package/dist/node_modules/simple-git/dist/src/lib/errors/task-configuration-error.d.ts +0 -12
  393. package/dist/node_modules/simple-git/dist/src/lib/git-factory.d.ts +0 -15
  394. package/dist/node_modules/simple-git/dist/src/lib/git-logger.d.ts +0 -21
  395. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-branch-delete.d.ts +0 -5
  396. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-branch.d.ts +0 -2
  397. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-commit.d.ts +0 -2
  398. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-diff-summary.d.ts +0 -3
  399. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-fetch.d.ts +0 -2
  400. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-list-log-summary.d.ts +0 -6
  401. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-merge.d.ts +0 -11
  402. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-move.d.ts +0 -2
  403. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-pull.d.ts +0 -6
  404. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-push.d.ts +0 -4
  405. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-remote-messages.d.ts +0 -5
  406. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-remote-objects.d.ts +0 -3
  407. package/dist/node_modules/simple-git/dist/src/lib/plugins/abort-plugin.d.ts +0 -3
  408. package/dist/node_modules/simple-git/dist/src/lib/plugins/block-unsafe-operations-plugin.d.ts +0 -3
  409. package/dist/node_modules/simple-git/dist/src/lib/plugins/command-config-prefixing-plugin.d.ts +0 -2
  410. package/dist/node_modules/simple-git/dist/src/lib/plugins/completion-detection.plugin.d.ts +0 -3
  411. package/dist/node_modules/simple-git/dist/src/lib/plugins/custom-binary.plugin.d.ts +0 -3
  412. package/dist/node_modules/simple-git/dist/src/lib/plugins/error-detection.plugin.d.ts +0 -7
  413. package/dist/node_modules/simple-git/dist/src/lib/plugins/index.d.ts +0 -11
  414. package/dist/node_modules/simple-git/dist/src/lib/plugins/plugin-store.d.ts +0 -11
  415. package/dist/node_modules/simple-git/dist/src/lib/plugins/progress-monitor-plugin.d.ts +0 -3
  416. package/dist/node_modules/simple-git/dist/src/lib/plugins/simple-git-plugin.d.ts +0 -48
  417. package/dist/node_modules/simple-git/dist/src/lib/plugins/spawn-options-plugin.d.ts +0 -3
  418. package/dist/node_modules/simple-git/dist/src/lib/plugins/suffix-paths.plugin.d.ts +0 -2
  419. package/dist/node_modules/simple-git/dist/src/lib/plugins/timout-plugin.d.ts +0 -3
  420. package/dist/node_modules/simple-git/dist/src/lib/responses/BranchDeleteSummary.d.ts +0 -12
  421. package/dist/node_modules/simple-git/dist/src/lib/responses/BranchSummary.d.ts +0 -14
  422. package/dist/node_modules/simple-git/dist/src/lib/responses/CheckIgnore.d.ts +0 -4
  423. package/dist/node_modules/simple-git/dist/src/lib/responses/CleanSummary.d.ts +0 -9
  424. package/dist/node_modules/simple-git/dist/src/lib/responses/ConfigList.d.ts +0 -13
  425. package/dist/node_modules/simple-git/dist/src/lib/responses/DiffSummary.d.ts +0 -10
  426. package/dist/node_modules/simple-git/dist/src/lib/responses/FileStatusSummary.d.ts +0 -9
  427. package/dist/node_modules/simple-git/dist/src/lib/responses/GetRemoteSummary.d.ts +0 -11
  428. package/dist/node_modules/simple-git/dist/src/lib/responses/InitSummary.d.ts +0 -9
  429. package/dist/node_modules/simple-git/dist/src/lib/responses/MergeSummary.d.ts +0 -16
  430. package/dist/node_modules/simple-git/dist/src/lib/responses/PullSummary.d.ts +0 -25
  431. package/dist/node_modules/simple-git/dist/src/lib/responses/StatusSummary.d.ts +0 -19
  432. package/dist/node_modules/simple-git/dist/src/lib/responses/TagList.d.ts +0 -7
  433. package/dist/node_modules/simple-git/dist/src/lib/runners/git-executor-chain.d.ts +0 -25
  434. package/dist/node_modules/simple-git/dist/src/lib/runners/git-executor.d.ts +0 -14
  435. package/dist/node_modules/simple-git/dist/src/lib/runners/promise-wrapped.d.ts +0 -2
  436. package/dist/node_modules/simple-git/dist/src/lib/runners/scheduler.d.ts +0 -11
  437. package/dist/node_modules/simple-git/dist/src/lib/runners/tasks-pending-queue.d.ts +0 -23
  438. package/dist/node_modules/simple-git/dist/src/lib/simple-git-api.d.ts +0 -20
  439. package/dist/node_modules/simple-git/dist/src/lib/task-callback.d.ts +0 -2
  440. package/dist/node_modules/simple-git/dist/src/lib/tasks/apply-patch.d.ts +0 -3
  441. package/dist/node_modules/simple-git/dist/src/lib/tasks/branch.d.ts +0 -7
  442. package/dist/node_modules/simple-git/dist/src/lib/tasks/change-working-directory.d.ts +0 -2
  443. package/dist/node_modules/simple-git/dist/src/lib/tasks/check-ignore.d.ts +0 -2
  444. package/dist/node_modules/simple-git/dist/src/lib/tasks/check-is-repo.d.ts +0 -9
  445. package/dist/node_modules/simple-git/dist/src/lib/tasks/checkout.d.ts +0 -2
  446. package/dist/node_modules/simple-git/dist/src/lib/tasks/clean.d.ts +0 -25
  447. package/dist/node_modules/simple-git/dist/src/lib/tasks/clone.d.ts +0 -9
  448. package/dist/node_modules/simple-git/dist/src/lib/tasks/commit.d.ts +0 -4
  449. package/dist/node_modules/simple-git/dist/src/lib/tasks/config.d.ts +0 -8
  450. package/dist/node_modules/simple-git/dist/src/lib/tasks/count-objects.d.ts +0 -12
  451. package/dist/node_modules/simple-git/dist/src/lib/tasks/diff-name-status.d.ts +0 -12
  452. package/dist/node_modules/simple-git/dist/src/lib/tasks/diff.d.ts +0 -5
  453. package/dist/node_modules/simple-git/dist/src/lib/tasks/fetch.d.ts +0 -4
  454. package/dist/node_modules/simple-git/dist/src/lib/tasks/first-commit.d.ts +0 -2
  455. package/dist/node_modules/simple-git/dist/src/lib/tasks/grep.d.ts +0 -12
  456. package/dist/node_modules/simple-git/dist/src/lib/tasks/hash-object.d.ts +0 -5
  457. package/dist/node_modules/simple-git/dist/src/lib/tasks/init.d.ts +0 -3
  458. package/dist/node_modules/simple-git/dist/src/lib/tasks/log.d.ts +0 -32
  459. package/dist/node_modules/simple-git/dist/src/lib/tasks/merge.d.ts +0 -4
  460. package/dist/node_modules/simple-git/dist/src/lib/tasks/move.d.ts +0 -3
  461. package/dist/node_modules/simple-git/dist/src/lib/tasks/pull.d.ts +0 -3
  462. package/dist/node_modules/simple-git/dist/src/lib/tasks/push.d.ts +0 -9
  463. package/dist/node_modules/simple-git/dist/src/lib/tasks/remote.d.ts +0 -8
  464. package/dist/node_modules/simple-git/dist/src/lib/tasks/reset.d.ts +0 -11
  465. package/dist/node_modules/simple-git/dist/src/lib/tasks/show.d.ts +0 -2
  466. package/dist/node_modules/simple-git/dist/src/lib/tasks/stash-list.d.ts +0 -4
  467. package/dist/node_modules/simple-git/dist/src/lib/tasks/status.d.ts +0 -3
  468. package/dist/node_modules/simple-git/dist/src/lib/tasks/sub-module.d.ts +0 -5
  469. package/dist/node_modules/simple-git/dist/src/lib/tasks/tag.d.ts +0 -18
  470. package/dist/node_modules/simple-git/dist/src/lib/tasks/task.d.ts +0 -14
  471. package/dist/node_modules/simple-git/dist/src/lib/tasks/version.d.ts +0 -9
  472. package/dist/node_modules/simple-git/dist/src/lib/types/handlers.d.ts +0 -21
  473. package/dist/node_modules/simple-git/dist/src/lib/types/index.d.ts +0 -136
  474. package/dist/node_modules/simple-git/dist/src/lib/types/tasks.d.ts +0 -19
  475. package/dist/node_modules/simple-git/dist/src/lib/utils/argument-filters.d.ts +0 -14
  476. package/dist/node_modules/simple-git/dist/src/lib/utils/exit-codes.d.ts +0 -10
  477. package/dist/node_modules/simple-git/dist/src/lib/utils/git-output-streams.d.ts +0 -7
  478. package/dist/node_modules/simple-git/dist/src/lib/utils/index.d.ts +0 -8
  479. package/dist/node_modules/simple-git/dist/src/lib/utils/line-parser.d.ts +0 -15
  480. package/dist/node_modules/simple-git/dist/src/lib/utils/simple-git-options.d.ts +0 -2
  481. package/dist/node_modules/simple-git/dist/src/lib/utils/task-options.d.ts +0 -13
  482. package/dist/node_modules/simple-git/dist/src/lib/utils/task-parser.d.ts +0 -5
  483. package/dist/node_modules/simple-git/dist/src/lib/utils/util.d.ts +0 -47
  484. package/dist/node_modules/simple-git/dist/typings/errors.d.ts +0 -5
  485. package/dist/node_modules/simple-git/dist/typings/index.d.ts +0 -14
  486. package/dist/node_modules/simple-git/dist/typings/response.d.ts +0 -556
  487. package/dist/node_modules/simple-git/dist/typings/simple-git.d.ts +0 -1033
  488. package/dist/node_modules/simple-git/dist/typings/types.d.ts +0 -22
  489. package/dist/node_modules/simple-git/node_modules/debug/package.json +0 -64
  490. package/dist/node_modules/simple-git/node_modules/debug/src/browser.js +0 -272
  491. package/dist/node_modules/simple-git/node_modules/debug/src/common.js +0 -292
  492. package/dist/node_modules/simple-git/node_modules/debug/src/index.js +0 -10
  493. package/dist/node_modules/simple-git/node_modules/debug/src/node.js +0 -263
  494. package/dist/node_modules/simple-git/package.json +0 -1
  495. 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
+ }