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,62 @@
1
+ import { useApp, type ToolsManager } from '@nocobase/client-v2';
2
+ import React, { createContext, useContext, useEffect, useState } from 'react';
3
+ import { loadInteractions, type SkillInteraction } from './interactions';
4
+ import { SkillHubCard } from './SkillHubCard';
5
+
6
+ const Context = createContext(new Map<string, SkillInteraction>());
7
+ const registered = new WeakMap<ToolsManager, Set<string>>();
8
+ export const useInteractions = () => useContext(Context);
9
+
10
+ export function registerSkillCard(manager: ToolsManager, name: string) {
11
+ let names = registered.get(manager);
12
+ if (!names) registered.set(manager, (names = new Set()));
13
+ if (names.has(name)) return;
14
+ manager.registerTools(name, { ui: { card: SkillHubCard } });
15
+ names.add(name);
16
+ }
17
+
18
+ export function InteractionSchemasProvider({ children }: React.PropsWithChildren) {
19
+ const app = useApp();
20
+ const api = app.apiClient;
21
+ const [token, setToken] = useState(() => api.auth.getToken());
22
+ const [version, setVersion] = useState(0);
23
+ const [interactions, setInteractions] = useState(new Map<string, SkillInteraction>());
24
+
25
+ useEffect(() => {
26
+ const refresh = () => setVersion((current) => current + 1);
27
+ const authChanged = (event: Event) => {
28
+ const detail = (event as CustomEvent<{ token?: string | null }>).detail;
29
+ setToken(detail && 'token' in detail ? detail.token || '' : api.auth.getToken());
30
+ refresh();
31
+ };
32
+ window.addEventListener('skill-hub-loop-settings-changed', refresh);
33
+ app.eventBus.addEventListener('auth:tokenChanged', authChanged);
34
+ app.eventBus.addEventListener('auth:roleChanged', refresh);
35
+ return () => {
36
+ window.removeEventListener('skill-hub-loop-settings-changed', refresh);
37
+ app.eventBus.removeEventListener('auth:tokenChanged', authChanged);
38
+ app.eventBus.removeEventListener('auth:roleChanged', refresh);
39
+ };
40
+ }, [app, api.auth]);
41
+
42
+ useEffect(() => {
43
+ let cancelled = false;
44
+ setInteractions(new Map());
45
+ if (token) {
46
+ loadInteractions(api)
47
+ .then((next) => {
48
+ if (cancelled) return;
49
+ for (const interaction of next.values()) registerSkillCard(app.aiManager.toolsManager, interaction.toolName);
50
+ setInteractions(next);
51
+ })
52
+ .catch(() => {
53
+ // The generic review card remains available if this user cannot list skill definitions.
54
+ });
55
+ }
56
+ return () => {
57
+ cancelled = true;
58
+ };
59
+ }, [app, api, token, version]);
60
+
61
+ return <Context.Provider value={interactions}>{children}</Context.Provider>;
62
+ }
@@ -0,0 +1,104 @@
1
+ import type { ToolsUIProperties } from '@nocobase/client-v2';
2
+ import { useRequest } from 'ahooks';
3
+ import { App, Button, Card, Checkbox, Form, Input, InputNumber, Radio, Select, Space, Typography } from 'antd';
4
+ import React, { useEffect, useRef } from 'react';
5
+ import { useTranslation } from 'react-i18next';
6
+ import { useInteractions } from './InteractionSchemasProvider';
7
+ import { asRecord, editedSkillArgs, getToolInteraction } from './interactions';
8
+
9
+ export function SkillHubCard({ toolCall, decisions }: ToolsUIProperties) {
10
+ const { t } = useTranslation(['plugin-agent-orchestrator', 'client']);
11
+ const { message } = App.useApp();
12
+ const interactions = useInteractions();
13
+ const schema = getToolInteraction(interactions, toolCall.name, toolCall.args);
14
+ const [form] = Form.useForm<Record<string, unknown>>();
15
+ const busy = useRef(false);
16
+ const generic = toolCall.name === 'skill_hub_execute';
17
+ const needsApproval = ['init', 'interrupted', 'waiting'].includes(toolCall.invokeStatus);
18
+
19
+ useEffect(() => {
20
+ if (!needsApproval) return;
21
+ form.resetFields();
22
+ const args = asRecord(toolCall.args);
23
+ form.setFieldsValue(generic ? asRecord(args.input) : args);
24
+ }, [form, toolCall.id, toolCall.args, schema, generic, needsApproval]);
25
+
26
+ const submit = useRequest(
27
+ async (reject = false) => {
28
+ if (busy.current) return;
29
+ busy.current = true;
30
+ try {
31
+ if (reject) await decisions.reject('user_cancel');
32
+ else if (!schema || schema.type === 'confirm') await decisions.approve();
33
+ else {
34
+ let values: Record<string, unknown>;
35
+ try {
36
+ values = await form.validateFields();
37
+ } catch {
38
+ return;
39
+ }
40
+ await decisions.edit(editedSkillArgs(toolCall.name, toolCall.args, schema, values));
41
+ }
42
+ } finally {
43
+ busy.current = false;
44
+ }
45
+ },
46
+ { manual: true, onError: () => message.error(t('Failed to submit skill decision')) },
47
+ );
48
+
49
+ if (!needsApproval) return null;
50
+ return (
51
+ <Card size="small" style={{ marginTop: 8 }}>
52
+ <Typography.Paragraph>
53
+ {schema?.prompt || t('Review this Skill Hub tool call before execution.')}
54
+ </Typography.Paragraph>
55
+ <Form form={form} layout="vertical" disabled={submit.loading} style={{ marginBottom: 8 }}>
56
+ {schema?.type === 'select' && (
57
+ <Form.Item name="choice" label={t('Choice')} rules={[{ required: true }]}>
58
+ <Radio.Group>
59
+ {schema.options?.map((option) => (
60
+ <Radio key={String(option.value)} value={option.value}>
61
+ {option.label}
62
+ </Radio>
63
+ ))}
64
+ </Radio.Group>
65
+ </Form.Item>
66
+ )}
67
+ {schema?.type === 'form' &&
68
+ Object.entries(schema.fields || {}).map(([key, field]) => (
69
+ <Form.Item
70
+ key={key}
71
+ name={key}
72
+ label={field.title || key}
73
+ valuePropName={field.type === 'boolean' && !field.enum ? 'checked' : 'value'}
74
+ rules={[{ required: field.required }]}
75
+ >
76
+ {field.enum?.some((value) => typeof value === 'boolean') ? (
77
+ <Radio.Group options={field.enum.map((value) => ({ value, label: String(value) }))} />
78
+ ) : field.enum ? (
79
+ <Select
80
+ options={field.enum
81
+ .filter((value): value is string | number => typeof value !== 'boolean')
82
+ .map((value) => ({ value, label: String(value) }))}
83
+ />
84
+ ) : field.type === 'number' || field.type === 'integer' ? (
85
+ <InputNumber precision={field.type === 'integer' ? 0 : undefined} style={{ width: '100%' }} />
86
+ ) : field.type === 'boolean' ? (
87
+ <Checkbox />
88
+ ) : (
89
+ <Input />
90
+ )}
91
+ </Form.Item>
92
+ ))}
93
+ </Form>
94
+ <Space>
95
+ <Button type="primary" loading={submit.loading} onClick={() => submit.run(false)}>
96
+ {t('Run')}
97
+ </Button>
98
+ <Button disabled={submit.loading} onClick={() => submit.run(true)}>
99
+ {t('Cancel')}
100
+ </Button>
101
+ </Space>
102
+ </Card>
103
+ );
104
+ }
@@ -0,0 +1,126 @@
1
+ /**
2
+ * This file is part of the NocoBase (R) project.
3
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
4
+ * Authors: NocoBase Team.
5
+ *
6
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
7
+ * For more information, please refer to: https://www.nocobase.com/agreement.
8
+ */
9
+
10
+ import { describe, expect, it, vi } from 'vitest';
11
+ import {
12
+ buildInteractions,
13
+ editedSkillArgs,
14
+ getToolInteraction,
15
+ loadInteractions,
16
+ parseInteraction,
17
+ } from '../interactions';
18
+
19
+ describe('V2 Skill Hub interactions', () => {
20
+ it('supports legacy fenced/double encoded JSON and validates the review schema', () => {
21
+ const schema = { type: 'form', fields: { approved: { type: 'boolean', enum: [false, true, null, {}] } } };
22
+ const parsed = parseInteraction(JSON.stringify(JSON.stringify(schema)));
23
+ expect(parsed?.fields?.approved.enum).toEqual([false, true]);
24
+ expect(parseInteraction('```json\n{"type":"confirm","prompt":"review"}\n```')?.prompt).toBe('review');
25
+ expect(parseInteraction('{broken')).toBeUndefined();
26
+ expect(parseInteraction({ type: 'unsupported' })).toBeUndefined();
27
+ expect(parseInteraction(null)).toBeUndefined();
28
+ });
29
+
30
+ it('honors persisted tool names after skill renames and falls back to the server legacy naming algorithm', () => {
31
+ const map = buildInteractions(
32
+ [
33
+ { id: 1, name: 'Renamed skill', toolName: 'skill_hub_old_name', interactionSchema: { type: 'confirm' } },
34
+ { id: 2, name: ' Other / Skill ', interactionSchema: { type: 'form' } },
35
+ { id: 3, name: '---' },
36
+ ],
37
+ [],
38
+ );
39
+ expect(map.has('skill_hub_old_name')).toBe(true);
40
+ expect(map.has('skill_hub_renamed_skill')).toBe(false);
41
+ expect(map.has('skill_hub_other_skill')).toBe(true);
42
+ expect(map.size).toBe(2);
43
+ });
44
+
45
+ it('matches the server newest loop override, prompt inheritance and prompt-only confirmation', () => {
46
+ const map = buildInteractions(
47
+ [
48
+ { id: '9007199254740993', name: 'one', interactionSchema: { type: 'form', prompt: 'legacy' } },
49
+ { id: 2, name: 'two' },
50
+ ],
51
+ [
52
+ {
53
+ skillId: '9007199254740993',
54
+ schema: { type: 'select', options: [{ label: 'Yes', value: 1 }] },
55
+ prompt: 'newest',
56
+ },
57
+ { skillId: '9007199254740993', schema: { type: 'confirm', prompt: 'older' } },
58
+ { skillId: 2, prompt: 'confirm this' },
59
+ ],
60
+ );
61
+ expect(map.get('skill_hub_one')?.schema).toMatchObject({ type: 'select', prompt: 'newest' });
62
+ expect(map.get('skill_hub_two')?.schema).toEqual({ type: 'confirm', prompt: 'confirm this' });
63
+ });
64
+
65
+ it('does not apply an execution form to generic list/describe calls and resolves generic execution by exact skill name', () => {
66
+ const map = buildInteractions(
67
+ [{ id: 1, name: 'Renamed Skill', toolName: 'skill_hub_old', interactionSchema: { type: 'form' } }],
68
+ [],
69
+ );
70
+ expect(
71
+ getToolInteraction(map, 'skill_hub_execute', { action: 'list', skillName: 'Renamed Skill' }),
72
+ ).toBeUndefined();
73
+ expect(
74
+ getToolInteraction(map, 'skill_hub_execute', { action: 'describe', skillName: 'Renamed Skill' }),
75
+ ).toBeUndefined();
76
+ expect(getToolInteraction(map, 'skill_hub_execute', { action: 'execute', skillName: 'Renamed Skill' })?.type).toBe(
77
+ 'form',
78
+ );
79
+ expect(getToolInteraction(map, 'skill_hub_old', {})?.type).toBe('form');
80
+ });
81
+
82
+ it('preserves generic action/name and untouched input fields when editing, including false and zero', () => {
83
+ const args = { action: 'execute', skillName: 'test', input: { unchanged: 42, approved: true } };
84
+ expect(editedSkillArgs('skill_hub_execute', args, { type: 'form' }, { approved: false, count: 0 })).toEqual({
85
+ ...args,
86
+ input: { unchanged: 42, approved: false, count: 0 },
87
+ });
88
+ expect(args.input.approved).toBe(true);
89
+ expect(editedSkillArgs('skill_hub_test', { unchanged: 42 }, { type: 'form' }, { updated: 1 })).toEqual({
90
+ unchanged: 42,
91
+ updated: 1,
92
+ });
93
+ expect(editedSkillArgs('skill_hub_execute', args, { type: 'select' }, { choice: 'yes' })).toEqual({
94
+ ...args,
95
+ input: { ...args.input, choice: 'yes' },
96
+ });
97
+ expect(
98
+ editedSkillArgs('skill_hub_test', { unchanged: 42, prior: 'kept' }, { type: 'select' }, { choice: 'yes' }),
99
+ ).toEqual({
100
+ unchanged: 42,
101
+ prior: 'kept',
102
+ choice: 'yes',
103
+ });
104
+ });
105
+
106
+ it('loads all enabled skills with persisted identities and the same loop ordering as the server', async () => {
107
+ const request = vi.fn().mockResolvedValue({ data: { data: [] } });
108
+ await loadInteractions({ request });
109
+ expect(request.mock.calls[0][0].params).toMatchObject({
110
+ fields: ['id', 'name', 'toolName', 'interactionSchema'],
111
+ paginate: false,
112
+ });
113
+ expect(request.mock.calls[1][0].params).toMatchObject({ sort: ['-updatedAt'], paginate: false });
114
+ });
115
+
116
+ it('retains legacy review schemas when loop-config access fails, but rejects when skill definitions are unavailable', async () => {
117
+ const request = vi
118
+ .fn()
119
+ .mockResolvedValueOnce({ data: { data: [{ id: 1, name: 'legacy', interactionSchema: { type: 'confirm' } }] } })
120
+ .mockRejectedValueOnce(new Error('unavailable'));
121
+ expect((await loadInteractions({ request })).get('skill_hub_legacy')?.schema?.type).toBe('confirm');
122
+ await expect(loadInteractions({ request: vi.fn().mockRejectedValue(new Error('unauthorized')) })).rejects.toThrow(
123
+ 'unauthorized',
124
+ );
125
+ });
126
+ });
@@ -0,0 +1,137 @@
1
+ /**
2
+ * This file is part of the NocoBase (R) project.
3
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
4
+ * Authors: NocoBase Team.
5
+ *
6
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
7
+ * For more information, please refer to: https://www.nocobase.com/agreement.
8
+ */
9
+
10
+ import type { APIClient } from '@nocobase/client-v2';
11
+ import { parseJsonText } from '../utils/jsonFields';
12
+
13
+ type Field = { type?: string; title?: string; required?: boolean; enum?: Array<string | number | boolean> };
14
+ export type InteractionSchema = {
15
+ type: 'form' | 'select' | 'confirm';
16
+ prompt?: string;
17
+ fields?: Record<string, Field>;
18
+ options?: Array<{ label: string; value: string | number }>;
19
+ };
20
+ export type SkillDefinition = {
21
+ id: string | number;
22
+ name: string;
23
+ toolName?: string;
24
+ interactionSchema?: unknown;
25
+ };
26
+ export type LoopConfig = { skillId: string | number; schema?: unknown; prompt?: string };
27
+ export type SkillInteraction = { skillName: string; toolName: string; schema?: InteractionSchema };
28
+
29
+ export function asRecord(value: unknown): Record<string, unknown> {
30
+ return value && typeof value === 'object' && !Array.isArray(value) ? (value as Record<string, unknown>) : {};
31
+ }
32
+
33
+ export function parseInteraction(value: unknown): InteractionSchema | undefined {
34
+ const record = asRecord(parseJsonText<unknown>(value, null));
35
+ if (!['form', 'select', 'confirm'].includes(String(record.type))) return;
36
+ const options = Array.isArray(record.options)
37
+ ? record.options.flatMap((option) => {
38
+ const row = asRecord(option);
39
+ return typeof row.label === 'string' && (typeof row.value === 'string' || typeof row.value === 'number')
40
+ ? [{ label: row.label, value: row.value }]
41
+ : [];
42
+ })
43
+ : undefined;
44
+ const fields = Object.fromEntries(
45
+ Object.entries(asRecord(record.fields)).map(([key, value]) => {
46
+ const field = asRecord(value);
47
+ return [
48
+ key,
49
+ {
50
+ type: typeof field.type === 'string' ? field.type : undefined,
51
+ title: typeof field.title === 'string' ? field.title : undefined,
52
+ required: field.required === true,
53
+ enum: Array.isArray(field.enum)
54
+ ? field.enum.filter((item): item is string | number | boolean =>
55
+ ['string', 'number', 'boolean'].includes(typeof item),
56
+ )
57
+ : undefined,
58
+ },
59
+ ];
60
+ }),
61
+ );
62
+ return {
63
+ type: record.type as InteractionSchema['type'],
64
+ prompt: typeof record.prompt === 'string' ? record.prompt : undefined,
65
+ options,
66
+ fields,
67
+ };
68
+ }
69
+
70
+ export function buildInteractions(skills: SkillDefinition[], loops: LoopConfig[]): Map<string, SkillInteraction> {
71
+ const bySkillId = new Map<string, LoopConfig>();
72
+ // The API is sorted newest first, matching the server's loop-config selection.
73
+ for (const loop of loops) if (!bySkillId.has(String(loop.skillId))) bySkillId.set(String(loop.skillId), loop);
74
+ const interactions = new Map<string, SkillInteraction>();
75
+ for (const skill of skills) {
76
+ const normalized = skill.name
77
+ .trim()
78
+ .toLowerCase()
79
+ .replace(/[^a-z0-9_]/g, '_')
80
+ .replace(/_+/g, '_')
81
+ .replace(/^_|_$/g, '');
82
+ const toolName = skill.toolName?.trim() || (normalized ? `skill_hub_${normalized}` : undefined);
83
+ if (!toolName) continue;
84
+ const loop = bySkillId.get(String(skill.id));
85
+ const loopSchema = parseInteraction(loop?.schema);
86
+ const schema = loopSchema
87
+ ? { ...loopSchema, prompt: loopSchema.prompt || loop?.prompt }
88
+ : loop?.prompt
89
+ ? { type: 'confirm' as const, prompt: loop.prompt }
90
+ : parseInteraction(skill.interactionSchema);
91
+ interactions.set(toolName, { skillName: skill.name, toolName, schema });
92
+ }
93
+ return interactions;
94
+ }
95
+
96
+ export async function loadInteractions(api: Pick<APIClient, 'request'>) {
97
+ const [skills, loops] = await Promise.all([
98
+ api.request<{ data: SkillDefinition[] }>({
99
+ url: 'skillDefinitions:list',
100
+ skipNotify: true,
101
+ params: { filter: { enabled: true }, fields: ['id', 'name', 'toolName', 'interactionSchema'], paginate: false },
102
+ }),
103
+ api
104
+ .request<{ data: LoopConfig[] }>({
105
+ url: 'skillLoopConfigs:list',
106
+ skipNotify: true,
107
+ params: {
108
+ filter: { enabled: true },
109
+ fields: ['skillId', 'schema', 'prompt'],
110
+ sort: ['-updatedAt'],
111
+ paginate: false,
112
+ },
113
+ })
114
+ .catch(() => ({ data: { data: [] } })),
115
+ ]);
116
+ return buildInteractions(skills.data.data, loops.data.data);
117
+ }
118
+
119
+ export function getToolInteraction(interactions: Map<string, SkillInteraction>, name: string, args: unknown) {
120
+ const values = asRecord(args);
121
+ if (name !== 'skill_hub_execute') return interactions.get(name)?.schema;
122
+ if (values.action !== 'execute') return;
123
+ return [...interactions.values()].find((item) => item.skillName === values.skillName)?.schema;
124
+ }
125
+
126
+ export function editedSkillArgs(
127
+ name: string,
128
+ args: unknown,
129
+ _schema: InteractionSchema,
130
+ values: Record<string, unknown>,
131
+ ) {
132
+ const original = asRecord(args);
133
+ if (name === 'skill_hub_execute') {
134
+ return { ...original, input: { ...asRecord(original.input), ...values } };
135
+ }
136
+ return { ...original, ...values };
137
+ }
@@ -1,52 +1,52 @@
1
- export type InteractionSchema = {
2
- type: 'form' | 'select' | 'confirm';
3
- prompt: string;
4
- options?: { label: string; value: string | number }[];
5
- fields?: Record<string, { type?: string; title?: string; required?: boolean; enum?: any[] }>;
6
- };
7
-
8
- export type LoopTemplate = {
9
- key: string;
10
- title: string;
11
- description: string;
12
- schema: InteractionSchema;
13
- };
14
-
15
- export const LOOP_TEMPLATES: LoopTemplate[] = [
16
- {
17
- key: 'confirm',
18
- title: 'Confirm before run',
19
- description: 'Ask the user to approve or cancel the skill call.',
20
- schema: {
21
- type: 'confirm',
22
- prompt: 'Review this skill call before execution.',
23
- },
24
- },
25
- {
26
- key: 'review-input',
27
- title: 'Review editable input',
28
- description: 'Show selected input fields so the user can edit them before running.',
29
- schema: {
30
- type: 'form',
31
- prompt: 'Review and edit the skill input before execution.',
32
- fields: {},
33
- },
34
- },
35
- {
36
- key: 'choose-option',
37
- title: 'Choose one option',
38
- description: 'Ask the user to choose one option before running.',
39
- schema: {
40
- type: 'select',
41
- prompt: 'Choose how to run this skill.',
42
- options: [
43
- { label: 'Default', value: 'default' },
44
- { label: 'Careful', value: 'careful' },
45
- ],
46
- },
47
- },
48
- ];
49
-
50
- export function getLoopTemplate(key?: string) {
51
- return LOOP_TEMPLATES.find((template) => template.key === key) || LOOP_TEMPLATES[0];
52
- }
1
+ export type InteractionSchema = {
2
+ type: 'form' | 'select' | 'confirm';
3
+ prompt: string;
4
+ options?: { label: string; value: string | number }[];
5
+ fields?: Record<string, { type?: string; title?: string; required?: boolean; enum?: any[] }>;
6
+ };
7
+
8
+ export type LoopTemplate = {
9
+ key: string;
10
+ title: string;
11
+ description: string;
12
+ schema: InteractionSchema;
13
+ };
14
+
15
+ export const LOOP_TEMPLATES: LoopTemplate[] = [
16
+ {
17
+ key: 'confirm',
18
+ title: 'Confirm before run',
19
+ description: 'Ask the user to approve or cancel the skill call.',
20
+ schema: {
21
+ type: 'confirm',
22
+ prompt: 'Review this skill call before execution.',
23
+ },
24
+ },
25
+ {
26
+ key: 'review-input',
27
+ title: 'Review editable input',
28
+ description: 'Show selected input fields so the user can edit them before running.',
29
+ schema: {
30
+ type: 'form',
31
+ prompt: 'Review and edit the skill input before execution.',
32
+ fields: {},
33
+ },
34
+ },
35
+ {
36
+ key: 'choose-option',
37
+ title: 'Choose one option',
38
+ description: 'Ask the user to choose one option before running.',
39
+ schema: {
40
+ type: 'select',
41
+ prompt: 'Choose how to run this skill.',
42
+ options: [
43
+ { label: 'Default', value: 'default' },
44
+ { label: 'Careful', value: 'careful' },
45
+ ],
46
+ },
47
+ },
48
+ ];
49
+
50
+ export function getLoopTemplate(key?: string) {
51
+ return LOOP_TEMPLATES.find((template) => template.key === key) || LOOP_TEMPLATES[0];
52
+ }
@@ -1,41 +1,41 @@
1
- export function parseJsonText<T = any>(value: any, fallback: T): T {
2
- if (value === undefined || value === null || value === '') return fallback;
3
- if (typeof value !== 'string') return value;
4
-
5
- const trimmed = value.trim();
6
- const fenced = trimmed.match(/^```(?:json)?\s*([\s\S]*?)\s*```$/i);
7
- const json = fenced ? fenced[1].trim() : trimmed;
8
-
9
- try {
10
- let parsed = JSON.parse(json);
11
- if (typeof parsed === 'string') {
12
- const innerTrimmed = parsed.trim();
13
- const innerFenced = innerTrimmed.match(/^```(?:json)?\s*([\s\S]*?)\s*```$/i);
14
- const innerJson = innerFenced ? innerFenced[1].trim() : innerTrimmed;
15
- try {
16
- parsed = JSON.parse(innerJson);
17
- } catch {
18
- // keep the string form if the inner payload is not JSON
19
- }
20
- }
21
- return parsed;
22
- } catch {
23
- return fallback;
24
- }
25
- }
26
-
27
- export function formatJsonText(value: any, fallback: any = null): string {
28
- const parsed = parseJsonText(value, undefined);
29
- const normalized =
30
- parsed === undefined ? (value === undefined || value === null || value === '' ? fallback : value) : parsed;
31
- if (normalized === undefined || normalized === null) return '';
32
- if (typeof normalized === 'string') return normalized;
33
- return JSON.stringify(normalized, null, 2);
34
- }
35
-
36
- export function stringifyJsonText(value: any, fallback: any = null): string {
37
- const parsed = parseJsonText(value, undefined);
38
- const normalized =
39
- parsed === undefined ? (value === undefined || value === null || value === '' ? fallback : value) : parsed;
40
- return `\`\`\`json\n${JSON.stringify(normalized, null, 2)}\n\`\`\``;
41
- }
1
+ export function parseJsonText<T = any>(value: any, fallback: T): T {
2
+ if (value === undefined || value === null || value === '') return fallback;
3
+ if (typeof value !== 'string') return value;
4
+
5
+ const trimmed = value.trim();
6
+ const fenced = trimmed.match(/^```(?:json)?\s*([\s\S]*?)\s*```$/i);
7
+ const json = fenced ? fenced[1].trim() : trimmed;
8
+
9
+ try {
10
+ let parsed = JSON.parse(json);
11
+ if (typeof parsed === 'string') {
12
+ const innerTrimmed = parsed.trim();
13
+ const innerFenced = innerTrimmed.match(/^```(?:json)?\s*([\s\S]*?)\s*```$/i);
14
+ const innerJson = innerFenced ? innerFenced[1].trim() : innerTrimmed;
15
+ try {
16
+ parsed = JSON.parse(innerJson);
17
+ } catch {
18
+ // keep the string form if the inner payload is not JSON
19
+ }
20
+ }
21
+ return parsed;
22
+ } catch {
23
+ return fallback;
24
+ }
25
+ }
26
+
27
+ export function formatJsonText(value: any, fallback: any = null): string {
28
+ const parsed = parseJsonText(value, undefined);
29
+ const normalized =
30
+ parsed === undefined ? (value === undefined || value === null || value === '' ? fallback : value) : parsed;
31
+ if (normalized === undefined || normalized === null) return '';
32
+ if (typeof normalized === 'string') return normalized;
33
+ return JSON.stringify(normalized, null, 2);
34
+ }
35
+
36
+ export function stringifyJsonText(value: any, fallback: any = null): string {
37
+ const parsed = parseJsonText(value, undefined);
38
+ const normalized =
39
+ parsed === undefined ? (value === undefined || value === null || value === '' ? fallback : value) : parsed;
40
+ return `\`\`\`json\n${JSON.stringify(normalized, null, 2)}\n\`\`\``;
41
+ }