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,695 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+
3
+ import React, { useMemo, useState } from 'react';
4
+ import {
5
+ Alert,
6
+ Button,
7
+ Card,
8
+ Descriptions,
9
+ Drawer,
10
+ Form,
11
+ Input,
12
+ InputNumber,
13
+ Popconfirm,
14
+ Select,
15
+ Space,
16
+ Switch,
17
+ Table,
18
+ Tag,
19
+ Typography,
20
+ message,
21
+ } from 'antd';
22
+ import type { ColumnsType } from 'antd/es/table';
23
+ import { useApiClient, useRequest } from '../hooks/useApiRequest';
24
+ import { useT } from '../skill-hub/locale';
25
+ import { useAIEmployees } from './AIEmployeesContext';
26
+
27
+ type PolicyScope = 'department' | 'user' | 'employee';
28
+ type PolicySettings = {
29
+ instruction?: string;
30
+ systemPrompt?: string | null;
31
+ allowedModels?: string[];
32
+ allow?: boolean;
33
+ maxMonthlyTokens?: number | null;
34
+ maxMonthlyCost?: number | null;
35
+ };
36
+ type PolicyVersion = {
37
+ id: string | number;
38
+ policyId: string | number;
39
+ version: number;
40
+ revision?: number;
41
+ status: 'draft' | 'published';
42
+ settings?: PolicySettings;
43
+ publishedAt?: string | null;
44
+ publishedById?: string | number | null;
45
+ };
46
+ type PolicyRecord = {
47
+ id: string | number;
48
+ scope: PolicyScope;
49
+ scopeId: string;
50
+ employeeUsername?: string | null;
51
+ modelKey?: string | null;
52
+ currentVersion?: PolicyVersion | null;
53
+ draft?: PolicyVersion | null;
54
+ };
55
+ type PolicyValues = {
56
+ scope: PolicyScope;
57
+ scopeId: string;
58
+ employeeUsername?: string;
59
+ modelKey?: string;
60
+ instruction?: string;
61
+ access?: 'inherit' | 'allow' | 'deny';
62
+ systemPromptMode?: 'keep' | 'set' | 'clear';
63
+ systemPrompt?: string;
64
+ restrictModels?: boolean;
65
+ allowedModels?: string[];
66
+ maxMonthlyTokens?: number | null;
67
+ maxMonthlyCost?: number | null;
68
+ };
69
+ type TargetValues = { userId: string; employeeUsername: string; modelKey?: string };
70
+ type AuditEvent = {
71
+ id: number | string;
72
+ action: string;
73
+ actorId?: string | number | null;
74
+ userId?: string | number | null;
75
+ departmentId?: string | number | null;
76
+ employeeUsername?: string | null;
77
+ policyId?: string | number | null;
78
+ versionId?: string | number | null;
79
+ createdAt?: string | null;
80
+ };
81
+ type PreviewResult = {
82
+ departmentId?: string | number | null;
83
+ employeeUsername?: string;
84
+ userId?: string | number;
85
+ instruction?: string;
86
+ promptMode?: string;
87
+ warnings?: string[];
88
+ managed?: boolean;
89
+ originalPrompt?: string | null;
90
+ projectedPrompt?: string | null;
91
+ nativePromptHash?: string | null;
92
+ conflict?: boolean;
93
+ policies?: Array<{
94
+ id: string | number;
95
+ scope: PolicyScope;
96
+ scopeId: string;
97
+ modelKey?: string | null;
98
+ version: number;
99
+ settings: PolicySettings;
100
+ }>;
101
+ };
102
+ type ListResult<T> = { data?: T[]; meta?: { count?: number } };
103
+
104
+ function responseData<T>(response: { data?: unknown }): T | undefined {
105
+ const body = response.data;
106
+ if (!body || typeof body !== 'object' || !('data' in body)) return undefined;
107
+ const nested = body.data;
108
+ if (nested && typeof nested === 'object' && !Array.isArray(nested) && 'data' in nested) {
109
+ return nested.data as T;
110
+ }
111
+ return nested as T;
112
+ }
113
+
114
+ function errorText(error: unknown, fallback: string) {
115
+ const result = error as { response?: { data?: { errors?: Array<{ message?: string }> } }; message?: string };
116
+ return result?.response?.data?.errors?.[0]?.message || result?.message || fallback;
117
+ }
118
+
119
+ export const EmployeeGovernanceTab: React.FC = () => {
120
+ const api = useApiClient();
121
+ const t = useT();
122
+ const { employees } = useAIEmployees();
123
+ const [form] = Form.useForm<PolicyValues>();
124
+ const [targetForm] = Form.useForm<TargetValues>();
125
+ const [drawerOpen, setDrawerOpen] = useState(false);
126
+ const [editing, setEditing] = useState<PolicyRecord | null>(null);
127
+ const [versions, setVersions] = useState<PolicyVersion[]>([]);
128
+ const [versionsLoading, setVersionsLoading] = useState(false);
129
+ const [busy, setBusy] = useState(false);
130
+ const [preview, setPreview] = useState<PreviewResult | null>(null);
131
+ const [page, setPage] = useState(1);
132
+ const [auditPage, setAuditPage] = useState(1);
133
+ const scope = Form.useWatch('scope', form);
134
+ const modelKey = Form.useWatch('modelKey', form);
135
+ const restrictModels = Form.useWatch('restrictModels', form);
136
+ const systemPromptMode = Form.useWatch('systemPromptMode', form);
137
+
138
+ const listParams = useMemo(() => ({ page, pageSize: 20 }), [page]);
139
+ const { data, loading, error, refresh } = useRequest<ListResult<PolicyRecord>>(
140
+ { url: 'agentGovernance:list', params: listParams },
141
+ { refreshDeps: [listParams] },
142
+ );
143
+ const auditParams = useMemo(() => ({ page: auditPage, pageSize: 20 }), [auditPage]);
144
+ const auditRequest = useRequest<ListResult<AuditEvent>>(
145
+ { url: 'agentGovernance:events', params: auditParams },
146
+ { refreshDeps: [auditParams] },
147
+ );
148
+ const employeeOptions = useMemo(
149
+ () => employees.map((employee) => ({ value: employee.username, label: employee.nickname || employee.username })),
150
+ [employees],
151
+ );
152
+
153
+ const loadVersions = async (policyId: string | number) => {
154
+ setVersionsLoading(true);
155
+ try {
156
+ const response = await api.request({ url: 'agentGovernance:listVersions', params: { filterByTk: policyId } });
157
+ const result = responseData<PolicyVersion[]>(response);
158
+ setVersions(Array.isArray(result) ? result : []);
159
+ } catch (error) {
160
+ setVersions([]);
161
+ message.error(t('Unable to load policy versions') + ': ' + errorText(error, t('unknown error')));
162
+ } finally {
163
+ setVersionsLoading(false);
164
+ }
165
+ };
166
+
167
+ const openEditor = (record?: PolicyRecord) => {
168
+ const settings = record?.draft?.settings || record?.currentVersion?.settings || {};
169
+ setEditing(record || null);
170
+ setVersions([]);
171
+ form.resetFields();
172
+ form.setFieldsValue({
173
+ scope: record?.scope || 'department',
174
+ scopeId: record?.scopeId || '',
175
+ employeeUsername: record?.employeeUsername || undefined,
176
+ modelKey: record?.modelKey || undefined,
177
+ instruction: settings.instruction || '',
178
+ access: settings.allow === true ? 'allow' : settings.allow === false ? 'deny' : 'inherit',
179
+ systemPromptMode:
180
+ settings.systemPrompt === null ? 'clear' : typeof settings.systemPrompt === 'string' ? 'set' : 'keep',
181
+ systemPrompt: settings.systemPrompt ?? undefined,
182
+ restrictModels: Array.isArray(settings.allowedModels),
183
+ allowedModels: settings.allowedModels,
184
+ maxMonthlyTokens: settings.maxMonthlyTokens,
185
+ maxMonthlyCost: settings.maxMonthlyCost,
186
+ });
187
+ setDrawerOpen(true);
188
+ if (record) loadVersions(record.id);
189
+ };
190
+
191
+ const saveDraft = async (values: PolicyValues) => {
192
+ const settings: PolicySettings = {
193
+ maxMonthlyTokens: values.maxMonthlyTokens ?? null,
194
+ maxMonthlyCost: values.maxMonthlyCost ?? null,
195
+ };
196
+ const selectedModel = values.modelKey?.trim();
197
+ if (values.access === 'allow') settings.allow = true;
198
+ if (values.access === 'deny') settings.allow = false;
199
+ if (!selectedModel) settings.instruction = values.instruction || '';
200
+ if (values.restrictModels) settings.allowedModels = values.allowedModels || [];
201
+ if (!selectedModel && values.scope === 'employee' && values.systemPromptMode === 'set')
202
+ settings.systemPrompt = values.systemPrompt || '';
203
+ if (!selectedModel && values.scope === 'employee' && values.systemPromptMode === 'clear')
204
+ settings.systemPrompt = null;
205
+ setBusy(true);
206
+ try {
207
+ await api.request({
208
+ url: 'agentGovernance:saveDraft',
209
+ method: 'post',
210
+ data: {
211
+ scope: values.scope,
212
+ scopeId: String(values.scopeId).trim(),
213
+ employeeUsername: values.scope === 'employee' ? undefined : values.employeeUsername || undefined,
214
+ modelKey: selectedModel || undefined,
215
+ settings,
216
+ },
217
+ });
218
+ message.success(t('Draft saved'));
219
+ setDrawerOpen(false);
220
+ refresh();
221
+ auditRequest.refresh();
222
+ } catch (error) {
223
+ message.error(t('Save failed: {{message}}', { message: errorText(error, t('unknown error')) }));
224
+ } finally {
225
+ setBusy(false);
226
+ }
227
+ };
228
+
229
+ const publish = async (policy: PolicyRecord) => {
230
+ setBusy(true);
231
+ try {
232
+ if (!policy.draft) throw new Error(t('Policy has no draft to publish.'));
233
+ await api.request({
234
+ url: 'agentGovernance:publish',
235
+ method: 'post',
236
+ data: { policyId: policy.id, versionId: policy.draft.id, revision: policy.draft.revision ?? 1 },
237
+ });
238
+ message.success(t('Version published'));
239
+ refresh();
240
+ auditRequest.refresh();
241
+ if (editing?.id === policy.id) await loadVersions(policy.id);
242
+ } catch (error) {
243
+ message.error(t('Save failed: {{message}}', { message: errorText(error, t('unknown error')) }));
244
+ } finally {
245
+ setBusy(false);
246
+ }
247
+ };
248
+
249
+ const rollback = async (version: PolicyVersion) => {
250
+ if (!editing) return;
251
+ setBusy(true);
252
+ try {
253
+ await api.request({
254
+ url: 'agentGovernance:rollback',
255
+ method: 'post',
256
+ data: { policyId: editing.id, version: version.version },
257
+ });
258
+ message.success(t('Policy version restored'));
259
+ await loadVersions(editing.id);
260
+ setDrawerOpen(false);
261
+ refresh();
262
+ auditRequest.refresh();
263
+ } catch (error) {
264
+ message.error(t('Save failed: {{message}}', { message: errorText(error, t('unknown error')) }));
265
+ } finally {
266
+ setBusy(false);
267
+ }
268
+ };
269
+
270
+ const targetAction = async (action: 'preview' | 'apply' | 'restore' | 'release') => {
271
+ let values: TargetValues;
272
+ try {
273
+ values = await targetForm.validateFields();
274
+ } catch {
275
+ return;
276
+ }
277
+ if (
278
+ action === 'release' &&
279
+ (!preview?.managed ||
280
+ !preview.conflict ||
281
+ String(preview.userId) !== values.userId.trim() ||
282
+ preview.employeeUsername !== values.employeeUsername)
283
+ ) {
284
+ message.error(t('Preview the current conflict before releasing'));
285
+ return;
286
+ }
287
+ setBusy(true);
288
+ try {
289
+ const response = await api.request({
290
+ url: `agentGovernance:${action}`,
291
+ method: 'post',
292
+ data: {
293
+ userId: values.userId.trim(),
294
+ employeeUsername: values.employeeUsername,
295
+ ...(action === 'preview' && values.modelKey?.trim() ? { modelKey: values.modelKey.trim() } : {}),
296
+ ...(action === 'release' ? { expectedHash: preview?.nativePromptHash ?? null } : {}),
297
+ },
298
+ });
299
+ if (action === 'restore') {
300
+ const restored = responseData<{ restored?: boolean; orphaned?: boolean }>(response);
301
+ setPreview(null);
302
+ message.success(
303
+ t(
304
+ restored?.orphaned
305
+ ? 'Orphaned instruction binding removed'
306
+ : restored?.restored
307
+ ? 'Original user instruction restored'
308
+ : 'No managed instruction found',
309
+ ),
310
+ );
311
+ } else if (action === 'release') {
312
+ const released = responseData<{ released?: boolean }>(response);
313
+ setPreview(null);
314
+ message.success(t(released?.released ? 'Instruction management released' : 'No managed instruction found'));
315
+ } else {
316
+ setPreview(responseData<PreviewResult>(response) || null);
317
+ if (action === 'apply') message.success(t('Managed instruction applied'));
318
+ }
319
+ if (action !== 'preview') auditRequest.refresh();
320
+ } catch (error) {
321
+ message.error(t('Operation failed: {{message}}', { message: errorText(error, t('unknown error')) }));
322
+ } finally {
323
+ setBusy(false);
324
+ }
325
+ };
326
+
327
+ const columns: ColumnsType<PolicyRecord> = [
328
+ { title: t('Scope'), dataIndex: 'scope', render: (value: string) => t(`Governance scope: ${value}`) },
329
+ { title: t('Scope ID'), dataIndex: 'scopeId' },
330
+ { title: t('Model selector'), dataIndex: 'modelKey', render: (value: string | null) => value || t('All models') },
331
+ {
332
+ title: t('Employee'),
333
+ dataIndex: 'employeeUsername',
334
+ render: (value: string | null) => value || t('All employees'),
335
+ },
336
+ {
337
+ title: t('Published version'),
338
+ key: 'currentVersion',
339
+ render: (_, row) => (row.currentVersion ? <Tag color="green">{row.currentVersion.version}</Tag> : '—'),
340
+ },
341
+ { title: t('Draft'), key: 'draft', render: (_, row) => (row.draft ? <Tag>{row.draft.version}</Tag> : '—') },
342
+ {
343
+ title: t('Actions'),
344
+ key: 'actions',
345
+ render: (_, row) => (
346
+ <Space>
347
+ <Button onClick={() => openEditor(row)}>{t('Edit')}</Button>
348
+ {row.draft && (
349
+ <Popconfirm title={t('Publish this governance draft?')} onConfirm={() => publish(row)}>
350
+ <Button disabled={busy}>{t('Publish')}</Button>
351
+ </Popconfirm>
352
+ )}
353
+ </Space>
354
+ ),
355
+ },
356
+ ];
357
+ const versionColumns: ColumnsType<PolicyVersion> = [
358
+ {
359
+ title: t('Version'),
360
+ dataIndex: 'version',
361
+ render: (version: number) => (
362
+ <Space>
363
+ {version}
364
+ {editing?.scope === 'employee' && !editing.modelKey && version === 1 && (
365
+ <Tag>{t('Original employee prompt')}</Tag>
366
+ )}
367
+ </Space>
368
+ ),
369
+ },
370
+ { title: t('Status'), dataIndex: 'status', render: (status: string) => t(status) },
371
+ {
372
+ title: t('Published at'),
373
+ dataIndex: 'publishedAt',
374
+ render: (value: string | null) => (value ? new Date(value).toLocaleString() : '—'),
375
+ },
376
+ {
377
+ title: t('Actions'),
378
+ key: 'actions',
379
+ render: (_, version) =>
380
+ version.status === 'published' && (
381
+ <Popconfirm title={t('Publish a copy of this version?')} onConfirm={() => rollback(version)}>
382
+ <Button size="small" disabled={busy}>
383
+ {t('Restore version')}
384
+ </Button>
385
+ </Popconfirm>
386
+ ),
387
+ },
388
+ ];
389
+ const auditColumns: ColumnsType<AuditEvent> = [
390
+ {
391
+ title: t('Time'),
392
+ dataIndex: 'createdAt',
393
+ render: (value: string | null) => (value ? new Date(value).toLocaleString() : '—'),
394
+ },
395
+ { title: t('Action'), dataIndex: 'action', render: (value: string) => t(`Governance audit: ${value}`) },
396
+ { title: t('Administrator ID'), dataIndex: 'actorId', render: (value: string | number | null) => value ?? '—' },
397
+ { title: t('User ID'), dataIndex: 'userId', render: (value: string | number | null) => value ?? '—' },
398
+ { title: t('Department ID'), dataIndex: 'departmentId', render: (value: string | number | null) => value ?? '—' },
399
+ { title: t('Employee'), dataIndex: 'employeeUsername', render: (value: string | null) => value || '—' },
400
+ { title: t('Policy ID'), dataIndex: 'policyId', render: (value: string | number | null) => value ?? '—' },
401
+ { title: t('Version ID'), dataIndex: 'versionId', render: (value: string | number | null) => value ?? '—' },
402
+ ];
403
+
404
+ return (
405
+ <Space direction="vertical" size="large" style={{ width: '100%' }}>
406
+ <Alert
407
+ type="info"
408
+ showIcon
409
+ message={t('Governance capability scope')}
410
+ description={t('Governance capability scope description')}
411
+ />
412
+ <Card
413
+ title={t('Governance policies')}
414
+ extra={
415
+ <Button type="primary" onClick={() => openEditor()}>
416
+ {t('Create policy')}
417
+ </Button>
418
+ }
419
+ >
420
+ {Boolean(error) && <Alert type="error" showIcon message={t('Unable to load governance policies')} />}
421
+ <Table<PolicyRecord>
422
+ rowKey="id"
423
+ columns={columns}
424
+ dataSource={data?.data || []}
425
+ loading={loading}
426
+ scroll={{ x: 'max-content' }}
427
+ pagination={{
428
+ current: page,
429
+ pageSize: 20,
430
+ total: data?.meta?.count || 0,
431
+ showSizeChanger: false,
432
+ onChange: setPage,
433
+ }}
434
+ />
435
+ </Card>
436
+ <Card title={t('Preview and apply managed instruction')}>
437
+ <Alert
438
+ type="warning"
439
+ showIcon
440
+ message={t('Managed instruction visibility')}
441
+ description={t('Managed instruction visibility description')}
442
+ style={{ marginBottom: 16 }}
443
+ />
444
+ <Form form={targetForm} layout="vertical" onValuesChange={() => setPreview(null)}>
445
+ <Space wrap align="start">
446
+ <Form.Item
447
+ name="userId"
448
+ label={t('User ID')}
449
+ rules={[{ required: true, whitespace: true, pattern: /^\d+$/, message: t('Enter a user ID') }]}
450
+ >
451
+ <Input inputMode="numeric" />
452
+ </Form.Item>
453
+ <Form.Item
454
+ name="employeeUsername"
455
+ label={t('Employee')}
456
+ rules={[{ required: true, message: t('Select an employee') }]}
457
+ >
458
+ <Select showSearch optionFilterProp="label" options={employeeOptions} style={{ minWidth: 220 }} />
459
+ </Form.Item>
460
+ <Form.Item name="modelKey" label={t('Model selector')} extra={t('Preview model selector hint')}>
461
+ <Input allowClear />
462
+ </Form.Item>
463
+ </Space>
464
+ <Space wrap>
465
+ <Button loading={busy} onClick={() => targetAction('preview')}>
466
+ {t('Preview effective policy')}
467
+ </Button>
468
+ <Popconfirm title={t('Apply managed instruction to this user?')} onConfirm={() => targetAction('apply')}>
469
+ <Button type="primary" loading={busy}>
470
+ {t('Apply managed instruction')}
471
+ </Button>
472
+ </Popconfirm>
473
+ <Popconfirm title={t('Restore original user instruction?')} onConfirm={() => targetAction('restore')}>
474
+ <Button loading={busy}>{t('Restore original instruction')}</Button>
475
+ </Popconfirm>
476
+ {preview?.managed && preview.conflict && (
477
+ <Popconfirm
478
+ title={t('Release instruction management?')}
479
+ description={t('Release instruction management description')}
480
+ onConfirm={() => targetAction('release')}
481
+ >
482
+ <Button danger loading={busy}>
483
+ {t('Release instruction management')}
484
+ </Button>
485
+ </Popconfirm>
486
+ )}
487
+ </Space>
488
+ </Form>
489
+ {preview && (
490
+ <Descriptions bordered column={1} size="small" style={{ marginTop: 16 }}>
491
+ <Descriptions.Item label={t('Department ID')}>{preview.departmentId ?? t('Unknown')}</Descriptions.Item>
492
+ <Descriptions.Item label={t('Prompt mode')}>{preview.promptMode || '—'}</Descriptions.Item>
493
+ <Descriptions.Item label={t('Managed')}>{preview.managed ? t('Yes') : t('No')}</Descriptions.Item>
494
+ {preview.conflict && (
495
+ <Descriptions.Item label={t('Conflict')}>
496
+ <Alert type="warning" showIcon message={t('Managed prompt conflict')} />
497
+ </Descriptions.Item>
498
+ )}
499
+ <Descriptions.Item label={t('Effective policies')}>
500
+ {preview.policies?.length
501
+ ? preview.policies.map((policy) => (
502
+ <div key={policy.id}>
503
+ <Typography.Text>
504
+ {t(`Governance scope: ${policy.scope}`)} {policy.scopeId}
505
+ {policy.modelKey ? ` (${policy.modelKey})` : ''} v{policy.version}
506
+ </Typography.Text>
507
+ {policy.settings.allow !== undefined && (
508
+ <Tag color={policy.settings.allow ? 'default' : 'red'}>
509
+ {t(policy.settings.allow ? 'Policy access: allow' : 'Policy access: deny')}
510
+ </Tag>
511
+ )}
512
+ {policy.settings.maxMonthlyTokens != null && (
513
+ <Tag>
514
+ {t('Monthly token limit')}: {policy.settings.maxMonthlyTokens}
515
+ </Tag>
516
+ )}
517
+ {policy.settings.maxMonthlyCost != null && (
518
+ <Tag>
519
+ {t('Monthly cost limit (USD)')}: {policy.settings.maxMonthlyCost}
520
+ </Tag>
521
+ )}
522
+ {Array.isArray(policy.settings.allowedModels) && (
523
+ <Tag>
524
+ {t('Allowed models')}:{' '}
525
+ {policy.settings.allowedModels.length
526
+ ? policy.settings.allowedModels.join(', ')
527
+ : t('No models allowed')}
528
+ </Tag>
529
+ )}
530
+ </div>
531
+ ))
532
+ : '—'}
533
+ </Descriptions.Item>
534
+ <Descriptions.Item label={t('Effective instruction')}>
535
+ <Typography.Paragraph style={{ whiteSpace: 'pre-wrap', margin: 0 }}>
536
+ {preview.instruction || '—'}
537
+ </Typography.Paragraph>
538
+ </Descriptions.Item>
539
+ <Descriptions.Item label={t('Projected native prompt')}>
540
+ <Typography.Paragraph style={{ whiteSpace: 'pre-wrap', margin: 0 }}>
541
+ {preview.projectedPrompt || '—'}
542
+ </Typography.Paragraph>
543
+ </Descriptions.Item>
544
+ {Boolean(preview.warnings?.length) && (
545
+ <Descriptions.Item label={t('Warnings')}>
546
+ {preview.warnings?.map((warning) => t(warning)).join('; ')}
547
+ </Descriptions.Item>
548
+ )}
549
+ </Descriptions>
550
+ )}
551
+ </Card>
552
+ <Card title={t('Governance audit')}>
553
+ {Boolean(auditRequest.error) && <Alert type="error" showIcon message={t('Unable to load governance audit')} />}
554
+ <Table<AuditEvent>
555
+ rowKey="id"
556
+ columns={auditColumns}
557
+ dataSource={auditRequest.data?.data || []}
558
+ loading={auditRequest.loading}
559
+ scroll={{ x: 'max-content' }}
560
+ pagination={{
561
+ current: auditPage,
562
+ pageSize: 20,
563
+ total: auditRequest.data?.meta?.count || 0,
564
+ showSizeChanger: false,
565
+ onChange: setAuditPage,
566
+ }}
567
+ />
568
+ </Card>
569
+ <Drawer
570
+ title={editing ? t('Edit governance policy') : t('Create policy')}
571
+ open={drawerOpen}
572
+ width={720}
573
+ onClose={() => setDrawerOpen(false)}
574
+ destroyOnClose
575
+ >
576
+ <Form form={form} layout="vertical" onFinish={saveDraft}>
577
+ <Form.Item name="scope" label={t('Scope')} rules={[{ required: true }]}>
578
+ <Select
579
+ disabled={Boolean(editing)}
580
+ options={[
581
+ { value: 'department', label: t('Governance scope: department') },
582
+ { value: 'user', label: t('Governance scope: user') },
583
+ { value: 'employee', label: t('Governance scope: employee') },
584
+ ]}
585
+ />
586
+ </Form.Item>
587
+ {scope === 'employee' ? (
588
+ <Form.Item
589
+ name="scopeId"
590
+ label={t('Employee')}
591
+ rules={[{ required: true, message: t('Select an employee') }]}
592
+ >
593
+ <Select disabled={Boolean(editing)} showSearch optionFilterProp="label" options={employeeOptions} />
594
+ </Form.Item>
595
+ ) : (
596
+ <Form.Item
597
+ name="scopeId"
598
+ label={scope === 'user' ? t('User ID') : t('Department ID')}
599
+ rules={[{ required: true, whitespace: true, pattern: /^\d+$/, message: t('Enter a scope ID') }]}
600
+ >
601
+ <Input disabled={Boolean(editing)} inputMode="numeric" />
602
+ </Form.Item>
603
+ )}
604
+ {scope !== 'employee' && (
605
+ <Form.Item
606
+ name="employeeUsername"
607
+ label={t('Limit policy to employee')}
608
+ extra={t('Leave empty to apply to all employees')}
609
+ >
610
+ <Select
611
+ allowClear
612
+ disabled={Boolean(editing)}
613
+ showSearch
614
+ optionFilterProp="label"
615
+ options={employeeOptions}
616
+ />
617
+ </Form.Item>
618
+ )}
619
+ <Form.Item name="modelKey" label={t('Model selector')} extra={t('Model selector format hint')}>
620
+ <Input disabled={Boolean(editing)} allowClear />
621
+ </Form.Item>
622
+ <Form.Item name="access" label={t('Policy access')} extra={t('Policy access hint')}>
623
+ <Select
624
+ options={[
625
+ { value: 'inherit', label: t('Policy access: inherit') },
626
+ { value: 'allow', label: t('Policy access: allow') },
627
+ { value: 'deny', label: t('Policy access: deny') },
628
+ ]}
629
+ />
630
+ </Form.Item>
631
+ {!modelKey?.trim() && (
632
+ <Form.Item
633
+ name="instruction"
634
+ label={t('Managed instruction')}
635
+ extra={t('Managed instruction content hint')}
636
+ >
637
+ <Input.TextArea rows={5} />
638
+ </Form.Item>
639
+ )}
640
+ {!modelKey?.trim() && scope === 'employee' && (
641
+ <>
642
+ <Form.Item
643
+ name="systemPromptMode"
644
+ label={t('Employee system prompt action')}
645
+ extra={t('Employee system prompt scope hint')}
646
+ >
647
+ <Select
648
+ options={[
649
+ { value: 'keep', label: t('Keep current system prompt') },
650
+ { value: 'set', label: t('Set employee system prompt') },
651
+ { value: 'clear', label: t('Use employee default system prompt') },
652
+ ]}
653
+ />
654
+ </Form.Item>
655
+ {systemPromptMode === 'set' && (
656
+ <Form.Item name="systemPrompt" label={t('Employee system prompt')}>
657
+ <Input.TextArea rows={5} />
658
+ </Form.Item>
659
+ )}
660
+ </>
661
+ )}
662
+ <Form.Item name="restrictModels" valuePropName="checked" label={t('Restrict allowed models')}>
663
+ <Switch aria-label={t('Restrict allowed models')} />
664
+ </Form.Item>
665
+ {restrictModels && (
666
+ <Form.Item name="allowedModels" label={t('Allowed models')} extra={t('Allowed model format hint')}>
667
+ <Select mode="tags" tokenSeparators={[',']} />
668
+ </Form.Item>
669
+ )}
670
+ <Form.Item name="maxMonthlyTokens" label={t('Monthly token limit')}>
671
+ <InputNumber min={0} precision={0} style={{ width: '100%' }} />
672
+ </Form.Item>
673
+ <Form.Item name="maxMonthlyCost" label={t('Monthly cost limit (USD)')}>
674
+ <InputNumber min={0} precision={8} style={{ width: '100%' }} />
675
+ </Form.Item>
676
+ <Button type="primary" htmlType="submit" loading={busy}>
677
+ {t('Save draft')}
678
+ </Button>
679
+ </Form>
680
+ {editing && (
681
+ <Card title={t('Version history')} style={{ marginTop: 24 }}>
682
+ <Table<PolicyVersion>
683
+ rowKey="id"
684
+ size="small"
685
+ columns={versionColumns}
686
+ dataSource={versions}
687
+ loading={versionsLoading}
688
+ pagination={false}
689
+ />
690
+ </Card>
691
+ )}
692
+ </Drawer>
693
+ </Space>
694
+ );
695
+ };