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,167 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import type { Context, Next } from '@nocobase/actions';
3
+ import type { Filter, Model } from '@nocobase/database';
4
+ import { getAIToolsManager } from '../utils/ai-manager';
5
+ import { asRecord, read } from '../utils/record-utils';
6
+ import { getSkillToolName } from '../utils/skill-tool-name';
7
+ import { parseJsonText } from '../skill-hub/utils/json-fields';
8
+ import {
9
+ autoApprovalCheckpoint,
10
+ coordinateAutoApprovalDecision,
11
+ enrollAutoApprovalCheckpoint,
12
+ } from './AutoApprovalCheckpoint';
13
+
14
+ const interactiveTools = new Set(['suggestions', 'aiEmployeeWorkflowTaskOutput']);
15
+
16
+ export type AutoApprovalCall = { sessionId: string; messageId: string; toolCallId: string };
17
+
18
+ export function autoApprovalCall(values: Record<string, unknown>): AutoApprovalCall | null {
19
+ const { sessionId, messageId, toolCallId } = values;
20
+ if (typeof sessionId !== 'string' || !sessionId.trim() || sessionId.length > 100) return null;
21
+ if (
22
+ !(
23
+ (typeof messageId === 'string' && messageId.trim()) ||
24
+ (typeof messageId === 'number' && Number.isSafeInteger(messageId) && messageId > 0)
25
+ )
26
+ )
27
+ return null;
28
+ if (typeof toolCallId !== 'string' || !toolCallId.trim()) return null;
29
+ return { sessionId, messageId: String(messageId), toolCallId };
30
+ }
31
+
32
+ /** The caller must already have verified access to the root conversation. */
33
+ export async function sessionAutoApprovalEnabled(ctx: Context, sessionId: string): Promise<boolean> {
34
+ const ownerId = ctx.auth?.user?.id;
35
+ if (!ownerId || !sessionId) return false;
36
+ const setting = await ctx.db.getRepository('agentSessionAutoApprovals').findOne({
37
+ filter: { ownerId, sessionId },
38
+ });
39
+ return read(setting, 'enabled') === true;
40
+ }
41
+
42
+ /** Skill Hub interaction schemas request user input and must not be filled by an approval. */
43
+ export async function skillRequiresUserInput(ctx: Context, name: string, args: unknown): Promise<boolean> {
44
+ const repository = ctx.db.getRepository('skillDefinitions');
45
+ let skill;
46
+ if (name === 'skill_hub_execute') {
47
+ const input = asRecord(args);
48
+ if (input.action === 'list' || input.action === 'describe') return false;
49
+ if (input.action !== 'execute' || typeof input.skillName !== 'string' || !input.skillName) return true;
50
+ skill = await repository.findOne({ filter: { name: input.skillName, enabled: true } });
51
+ if (!skill) return true;
52
+ } else {
53
+ skill = await repository.findOne({ filter: { toolName: name, enabled: true } });
54
+ if (!skill && name.startsWith('skill_hub_')) {
55
+ const legacy = await repository.find({ filter: { enabled: true } });
56
+ skill = legacy.find((item: Model) => {
57
+ try {
58
+ return getSkillToolName(item) === name;
59
+ } catch {
60
+ return false;
61
+ }
62
+ });
63
+ }
64
+ if (!skill) return false;
65
+ }
66
+ const skillId = read(skill, 'id');
67
+ if (typeof skillId !== 'number' && typeof skillId !== 'string') return true;
68
+ const loop = await ctx.db.getRepository('skillLoopConfigs').findOne({
69
+ filter: { enabled: true, skillId },
70
+ sort: ['-updatedAt'],
71
+ });
72
+ const loopSchema = parseJsonText<unknown>(read(loop, 'schema'), null);
73
+ if ((loopSchema && typeof loopSchema === 'object') || read(loop, 'prompt')) return true;
74
+ return Boolean(parseJsonText<unknown>(read(skill, 'interactionSchema'), null));
75
+ }
76
+
77
+ /** Verify the persisted root interrupt rather than trusting the event sent to the browser. */
78
+ export async function isAutoApprovalEligible(ctx: Context, call: AutoApprovalCall): Promise<boolean> {
79
+ const ownerId = ctx.auth?.user?.id;
80
+ if (!ownerId || !(await sessionAutoApprovalEnabled(ctx, call.sessionId))) return false;
81
+ const conversation = await ctx.db.getRepository('aiConversations').findOne({
82
+ filter: { sessionId: call.sessionId, userId: ownerId },
83
+ });
84
+ if (!conversation || read(conversation, 'from') === 'sub-agent') return false;
85
+ const username = read(conversation, 'aiEmployeeUsername');
86
+ if (typeof username !== 'string' || !username) return false;
87
+ const requestedRoles = ctx.state.currentRoles;
88
+ if (!Array.isArray(requestedRoles)) return false;
89
+ const memberships = await ctx.db.getRepository('rolesUsers').find({ filter: { userId: ownerId } });
90
+ const memberRoles = new Set(memberships.map((row: Model) => read(row, 'roleName')));
91
+ const roles = requestedRoles.filter(
92
+ (role: unknown): role is string => typeof role === 'string' && memberRoles.has(role),
93
+ );
94
+ if (!roles.length) return false;
95
+ if (
96
+ typeof ctx.state.currentRole === 'string' &&
97
+ ctx.state.currentRole !== '__union__' &&
98
+ !roles.includes(ctx.state.currentRole)
99
+ )
100
+ return false;
101
+ const filter: Filter = { username };
102
+ if (!roles.includes('root')) filter['roles.name'] = roles;
103
+ const employee = await ctx.db.getRepository('aiEmployees').findOne({ filter });
104
+ if (!employee || read(employee, 'enabled') === false) return false;
105
+ const message = await ctx.db.getRepository('aiMessages').findOne({
106
+ filter: { sessionId: call.sessionId, messageId: call.messageId, role: username },
107
+ });
108
+ const calls = read(message, 'toolCalls');
109
+ const selected = Array.isArray(calls) ? calls.map(asRecord).find((item) => item.id === call.toolCallId) : undefined;
110
+ const name = selected?.name;
111
+ if (typeof name !== 'string' || !name || interactiveTools.has(name)) return false;
112
+ if (await skillRequiresUserInput(ctx, name, selected.args)) return false;
113
+ const tool = await ctx.db.getRepository('aiToolMessages').findOne({
114
+ filter: { ...call, toolName: name, invokeStatus: 'interrupted' },
115
+ });
116
+ if (!tool || read(tool, 'auto') !== false || read(tool, 'status') === 'error') return false;
117
+ const interrupt = asRecord(read(tool, 'interruptAction'));
118
+ const interruptCall = asRecord(interrupt.toolCall);
119
+ const interruptedConversation = asRecord(interrupt.currentConversation);
120
+ const metadata = asRecord(read(message, 'metadata'));
121
+ if (
122
+ !Array.isArray(interrupt.allowedDecisions) ||
123
+ !interrupt.allowedDecisions.includes('approve') ||
124
+ interruptCall.id !== call.toolCallId ||
125
+ interruptCall.name !== name ||
126
+ interruptedConversation.sessionId !== call.sessionId ||
127
+ interruptedConversation.from !== 'main-agent' ||
128
+ interruptedConversation.username !== username ||
129
+ typeof metadata.interruptId !== 'string' ||
130
+ !metadata.interruptId
131
+ )
132
+ return false;
133
+ const entry = await getAIToolsManager(ctx.app).getTools(name, { ctx, sessionId: call.sessionId });
134
+ if (!entry || typeof entry.invoke !== 'function') return false;
135
+ if (name === 'executeFrontendTool') {
136
+ const toolId = asRecord(selected.args).toolId;
137
+ const options = asRecord(read(conversation, 'options'));
138
+ const tools = options.frontendTools;
139
+ if (typeof toolId !== 'string' || !Array.isArray(tools)) return false;
140
+ return tools
141
+ .map(asRecord)
142
+ .some((tool) => tool.id === toolId && tool.id === `${tool.blockUid}:${tool.name}` && tool.permission === 'ASK');
143
+ }
144
+ return true;
145
+ }
146
+
147
+ /** Marked automatic decisions are rechecked as the native action receives them. */
148
+ export async function guardAutoApprovalDecision(ctx: Context, next: Next) {
149
+ if (ctx.action?.resourceName !== 'aiConversations' || ctx.action.actionName !== 'updateUserDecision') return next();
150
+ const values = asRecord(ctx.action.params?.values);
151
+ const automatic = values.agentAutoApproval === true;
152
+ const decision = asRecord(values.userDecision);
153
+ const call = autoApprovalCall(values);
154
+ if (automatic && (!call || decision.type !== 'approve' || !(await isAutoApprovalEligible(ctx, call)))) {
155
+ ctx.body = { updated: 0, toolCalls: [] };
156
+ return;
157
+ }
158
+ if (!call) return next();
159
+ const checkpoint = await autoApprovalCheckpoint(ctx, call);
160
+ if (automatic && checkpoint === undefined) {
161
+ ctx.body = { updated: 0, toolCalls: [] };
162
+ return;
163
+ }
164
+ if (automatic && checkpoint) await enrollAutoApprovalCheckpoint(ctx, checkpoint);
165
+ await next();
166
+ if (checkpoint) await coordinateAutoApprovalDecision(ctx, checkpoint, call);
167
+ }
@@ -1,175 +1,175 @@
1
- import { getAgentExecutionContext } from './AgentExecutionContext';
2
- import { asObject, isAdminUser, normalizeEmployeeUsername, valuesFromCtx } from '../utils/ctx-utils';
3
- import { getSkillToolName, normalizeSkillToolScope, readRecordValue } from '../utils/skill-tool-name';
4
-
5
- type ToolBinding = { name?: unknown } | string;
6
-
7
- function bindingName(binding: ToolBinding): string {
8
- if (typeof binding === 'string') return binding.trim();
9
- return typeof binding?.name === 'string' ? binding.name.trim() : '';
10
- }
11
-
12
- export class SkillAccessService {
13
- constructor(
14
- private readonly plugin: {
15
- db: {
16
- getRepository: (name: string) =>
17
- | {
18
- find: (opts?: Record<string, unknown>) => Promise<unknown[]>;
19
- findOne: (opts: Record<string, unknown>) => Promise<unknown>;
20
- update: (opts: Record<string, unknown>) => Promise<unknown>;
21
- }
22
- | undefined;
23
- };
24
- app?: { logger?: { info?: (...args: unknown[]) => void } };
25
- },
26
- ) {}
27
-
28
- async resolveAgentUsername(ctx: Record<string, unknown>): Promise<string | undefined> {
29
- const executionIdentity = getAgentExecutionContext();
30
- if (executionIdentity?.employeeUsername) return executionIdentity.employeeUsername;
31
-
32
- const values = valuesFromCtx(ctx);
33
- const direct = normalizeEmployeeUsername(
34
- ctx?._currentAIEmployee ||
35
- ctx?.state?.currentAIEmployee ||
36
- ctx?.runtime?.context?.currentAIEmployee ||
37
- values.aiEmployee ||
38
- values.aiEmployeeUsername,
39
- );
40
- if (direct) return direct;
41
-
42
- const sessionId =
43
- executionIdentity?.sessionId || values.sessionId || ctx?.action?.params?.sessionId || ctx?.state?.sessionId;
44
- if (!sessionId) return undefined;
45
-
46
- try {
47
- const conversation = await this.plugin.db.getRepository('aiConversations').findOne({
48
- filter: { sessionId },
49
- });
50
- return (
51
- normalizeEmployeeUsername(readRecordValue(conversation, 'aiEmployeeUsername')) ||
52
- normalizeEmployeeUsername(readRecordValue(conversation, 'aiEmployee')) ||
53
- undefined
54
- );
55
- } catch {
56
- return undefined;
57
- }
58
- }
59
-
60
- async canAgentUseSkill(agentUsername: string, skill: unknown): Promise<boolean> {
61
- if (normalizeSkillToolScope(readRecordValue(skill, 'toolScope')) === 'GENERAL') return true;
62
-
63
- const employee = await this.plugin.db.getRepository('aiEmployees').findOne({
64
- filter: { username: agentUsername },
65
- });
66
- if (!employee) return false;
67
-
68
- const skillSettings = asObject(readRecordValue(employee, 'skillSettings'));
69
- const tools = Array.isArray(skillSettings.tools) ? (skillSettings.tools as ToolBinding[]) : [];
70
- const targetToolName = getSkillToolName(skill);
71
- return tools.some((binding) => bindingName(binding) === targetToolName);
72
- }
73
-
74
- async assertCanExecute(
75
- ctx: Record<string, unknown>,
76
- skill: unknown,
77
- options: { privileged?: boolean } = {},
78
- ): Promise<string | undefined> {
79
- if (options.privileged) return this.resolveAgentUsername(ctx);
80
- if (isAdminUser(ctx)) return this.resolveAgentUsername(ctx);
81
-
82
- const agentUsername = await this.resolveAgentUsername(ctx);
83
- if (!agentUsername) {
84
- throw new Error('Skill execution requires an AI employee context.');
85
- }
86
- if (!(await this.canAgentUseSkill(agentUsername, skill))) {
87
- throw new Error(`AI employee "${agentUsername}" is not bound to skill tool "${getSkillToolName(skill)}".`);
88
- }
89
- return agentUsername;
90
- }
91
-
92
- async filterAccessibleSkills(ctx: Record<string, unknown>, skills: unknown[]): Promise<unknown[]> {
93
- if (isAdminUser(ctx)) return skills;
94
- const agentUsername = await this.resolveAgentUsername(ctx);
95
- if (!agentUsername) return [];
96
-
97
- const checks = await Promise.all(skills.map((skill) => this.canAgentUseSkill(agentUsername, skill)));
98
- return skills.filter((_skill, index) => checks[index]);
99
- }
100
-
101
- async findAgentUsernamesUsingTool(toolName: string): Promise<string[]> {
102
- // Cap at 500 employees to prevent unbounded scans. Most deployments have <100.
103
- const employees = await this.plugin.db.getRepository('aiEmployees').find({ limit: 500 });
104
- const usernames: string[] = [];
105
- for (const employee of employees || []) {
106
- const settings = asObject(readRecordValue(employee, 'skillSettings'));
107
- const tools = Array.isArray(settings.tools) ? (settings.tools as ToolBinding[]) : [];
108
- if (!tools.some((binding) => bindingName(binding) === toolName)) continue;
109
- const username = normalizeEmployeeUsername(readRecordValue(employee, 'username'));
110
- if (username) usernames.push(username);
111
- }
112
- return usernames;
113
- }
114
-
115
- /**
116
- * Cascade-disable a skill across all AI employee bindings.
117
- *
118
- * When a skill is disabled or deleted, this method removes its tool from every employee's
119
- * `skillSettings.tools` array. This prevents stale bindings from allowing execution of
120
- * skills that are no longer available.
121
- *
122
- * Returns the list of affected employee usernames for audit logging.
123
- */
124
- async cascadeDisableSkill(skillToolName: string): Promise<string[]> {
125
- const affectedUsernames: string[] = [];
126
- // Cap at 500 employees to prevent unbounded scans. Most deployments have <100.
127
- const employees = await this.plugin.db.getRepository('aiEmployees').find({ limit: 500 });
128
-
129
- // Collect all updates first, then apply in parallel to reduce round-trips.
130
- const updates: Array<{ username: string; skillSettings: Record<string, unknown> }> = [];
131
-
132
- for (const employee of employees || []) {
133
- const skillSettings = asObject(readRecordValue(employee, 'skillSettings'));
134
- const tools = Array.isArray(skillSettings.tools) ? (skillSettings.tools as ToolBinding[]) : [];
135
- const filteredTools = tools.filter((binding) => bindingName(binding) !== skillToolName);
136
-
137
- if (filteredTools.length === tools.length) continue;
138
-
139
- const username = normalizeEmployeeUsername(readRecordValue(employee, 'username'));
140
- if (!username) continue;
141
-
142
- updates.push({
143
- username,
144
- skillSettings: {
145
- ...skillSettings,
146
- tools: filteredTools,
147
- },
148
- });
149
- }
150
-
151
- // Apply updates in parallel (max 10 concurrent to avoid DB overload).
152
- const BATCH_SIZE = 10;
153
- for (let i = 0; i < updates.length; i += BATCH_SIZE) {
154
- const batch = updates.slice(i, i + BATCH_SIZE);
155
- await Promise.all(
156
- batch.map((update) =>
157
- this.plugin.db
158
- .getRepository('aiEmployees')
159
- .update({
160
- filter: { username: update.username },
161
- values: { skillSettings: update.skillSettings },
162
- })
163
- .then(() => {
164
- affectedUsernames.push(update.username);
165
- this.plugin.app?.logger?.info?.(
166
- `[SkillAccess] Cascade-removed skill tool "${skillToolName}" from employee "${update.username}".`,
167
- );
168
- }),
169
- ),
170
- );
171
- }
172
-
173
- return affectedUsernames;
174
- }
175
- }
1
+ import { getAgentExecutionContext } from './AgentExecutionContext';
2
+ import { asObject, isAdminUser, normalizeEmployeeUsername, valuesFromCtx } from '../utils/ctx-utils';
3
+ import { getSkillToolName, normalizeSkillToolScope, readRecordValue } from '../utils/skill-tool-name';
4
+
5
+ type ToolBinding = { name?: unknown } | string;
6
+
7
+ function bindingName(binding: ToolBinding): string {
8
+ if (typeof binding === 'string') return binding.trim();
9
+ return typeof binding?.name === 'string' ? binding.name.trim() : '';
10
+ }
11
+
12
+ export class SkillAccessService {
13
+ constructor(
14
+ private readonly plugin: {
15
+ db: {
16
+ getRepository: (name: string) =>
17
+ | {
18
+ find: (opts?: Record<string, unknown>) => Promise<unknown[]>;
19
+ findOne: (opts: Record<string, unknown>) => Promise<unknown>;
20
+ update: (opts: Record<string, unknown>) => Promise<unknown>;
21
+ }
22
+ | undefined;
23
+ };
24
+ app?: { logger?: { info?: (...args: unknown[]) => void } };
25
+ },
26
+ ) {}
27
+
28
+ async resolveAgentUsername(ctx: Record<string, unknown>): Promise<string | undefined> {
29
+ const executionIdentity = getAgentExecutionContext();
30
+ if (executionIdentity?.employeeUsername) return executionIdentity.employeeUsername;
31
+
32
+ const values = valuesFromCtx(ctx);
33
+ const direct = normalizeEmployeeUsername(
34
+ ctx?._currentAIEmployee ||
35
+ ctx?.state?.currentAIEmployee ||
36
+ ctx?.runtime?.context?.currentAIEmployee ||
37
+ values.aiEmployee ||
38
+ values.aiEmployeeUsername,
39
+ );
40
+ if (direct) return direct;
41
+
42
+ const sessionId =
43
+ executionIdentity?.sessionId || values.sessionId || ctx?.action?.params?.sessionId || ctx?.state?.sessionId;
44
+ if (!sessionId) return undefined;
45
+
46
+ try {
47
+ const conversation = await this.plugin.db.getRepository('aiConversations').findOne({
48
+ filter: { sessionId },
49
+ });
50
+ return (
51
+ normalizeEmployeeUsername(readRecordValue(conversation, 'aiEmployeeUsername')) ||
52
+ normalizeEmployeeUsername(readRecordValue(conversation, 'aiEmployee')) ||
53
+ undefined
54
+ );
55
+ } catch {
56
+ return undefined;
57
+ }
58
+ }
59
+
60
+ async canAgentUseSkill(agentUsername: string, skill: unknown): Promise<boolean> {
61
+ if (normalizeSkillToolScope(readRecordValue(skill, 'toolScope')) === 'GENERAL') return true;
62
+
63
+ const employee = await this.plugin.db.getRepository('aiEmployees').findOne({
64
+ filter: { username: agentUsername },
65
+ });
66
+ if (!employee) return false;
67
+
68
+ const skillSettings = asObject(readRecordValue(employee, 'skillSettings'));
69
+ const tools = Array.isArray(skillSettings.tools) ? (skillSettings.tools as ToolBinding[]) : [];
70
+ const targetToolName = getSkillToolName(skill);
71
+ return tools.some((binding) => bindingName(binding) === targetToolName);
72
+ }
73
+
74
+ async assertCanExecute(
75
+ ctx: Record<string, unknown>,
76
+ skill: unknown,
77
+ options: { privileged?: boolean } = {},
78
+ ): Promise<string | undefined> {
79
+ if (options.privileged) return this.resolveAgentUsername(ctx);
80
+ if (isAdminUser(ctx)) return this.resolveAgentUsername(ctx);
81
+
82
+ const agentUsername = await this.resolveAgentUsername(ctx);
83
+ if (!agentUsername) {
84
+ throw new Error('Skill execution requires an AI employee context.');
85
+ }
86
+ if (!(await this.canAgentUseSkill(agentUsername, skill))) {
87
+ throw new Error(`AI employee "${agentUsername}" is not bound to skill tool "${getSkillToolName(skill)}".`);
88
+ }
89
+ return agentUsername;
90
+ }
91
+
92
+ async filterAccessibleSkills(ctx: Record<string, unknown>, skills: unknown[]): Promise<unknown[]> {
93
+ if (isAdminUser(ctx)) return skills;
94
+ const agentUsername = await this.resolveAgentUsername(ctx);
95
+ if (!agentUsername) return [];
96
+
97
+ const checks = await Promise.all(skills.map((skill) => this.canAgentUseSkill(agentUsername, skill)));
98
+ return skills.filter((_skill, index) => checks[index]);
99
+ }
100
+
101
+ async findAgentUsernamesUsingTool(toolName: string): Promise<string[]> {
102
+ // Cap at 500 employees to prevent unbounded scans. Most deployments have <100.
103
+ const employees = await this.plugin.db.getRepository('aiEmployees').find({ limit: 500 });
104
+ const usernames: string[] = [];
105
+ for (const employee of employees || []) {
106
+ const settings = asObject(readRecordValue(employee, 'skillSettings'));
107
+ const tools = Array.isArray(settings.tools) ? (settings.tools as ToolBinding[]) : [];
108
+ if (!tools.some((binding) => bindingName(binding) === toolName)) continue;
109
+ const username = normalizeEmployeeUsername(readRecordValue(employee, 'username'));
110
+ if (username) usernames.push(username);
111
+ }
112
+ return usernames;
113
+ }
114
+
115
+ /**
116
+ * Cascade-disable a skill across all AI employee bindings.
117
+ *
118
+ * When a skill is disabled or deleted, this method removes its tool from every employee's
119
+ * `skillSettings.tools` array. This prevents stale bindings from allowing execution of
120
+ * skills that are no longer available.
121
+ *
122
+ * Returns the list of affected employee usernames for audit logging.
123
+ */
124
+ async cascadeDisableSkill(skillToolName: string): Promise<string[]> {
125
+ const affectedUsernames: string[] = [];
126
+ // Cap at 500 employees to prevent unbounded scans. Most deployments have <100.
127
+ const employees = await this.plugin.db.getRepository('aiEmployees').find({ limit: 500 });
128
+
129
+ // Collect all updates first, then apply in parallel to reduce round-trips.
130
+ const updates: Array<{ username: string; skillSettings: Record<string, unknown> }> = [];
131
+
132
+ for (const employee of employees || []) {
133
+ const skillSettings = asObject(readRecordValue(employee, 'skillSettings'));
134
+ const tools = Array.isArray(skillSettings.tools) ? (skillSettings.tools as ToolBinding[]) : [];
135
+ const filteredTools = tools.filter((binding) => bindingName(binding) !== skillToolName);
136
+
137
+ if (filteredTools.length === tools.length) continue;
138
+
139
+ const username = normalizeEmployeeUsername(readRecordValue(employee, 'username'));
140
+ if (!username) continue;
141
+
142
+ updates.push({
143
+ username,
144
+ skillSettings: {
145
+ ...skillSettings,
146
+ tools: filteredTools,
147
+ },
148
+ });
149
+ }
150
+
151
+ // Apply updates in parallel (max 10 concurrent to avoid DB overload).
152
+ const BATCH_SIZE = 10;
153
+ for (let i = 0; i < updates.length; i += BATCH_SIZE) {
154
+ const batch = updates.slice(i, i + BATCH_SIZE);
155
+ await Promise.all(
156
+ batch.map((update) =>
157
+ this.plugin.db
158
+ .getRepository('aiEmployees')
159
+ .update({
160
+ filter: { username: update.username },
161
+ values: { skillSettings: update.skillSettings },
162
+ })
163
+ .then(() => {
164
+ affectedUsernames.push(update.username);
165
+ this.plugin.app?.logger?.info?.(
166
+ `[SkillAccess] Cascade-removed skill tool "${skillToolName}" from employee "${update.username}".`,
167
+ );
168
+ }),
169
+ ),
170
+ );
171
+ }
172
+
173
+ return affectedUsernames;
174
+ }
175
+ }