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
@@ -1,757 +1,324 @@
1
- import { createHash } from 'crypto';
2
- import { mkdirSync, writeFileSync } from 'fs';
3
- import { resolve } from 'path';
4
- import { ExecutionSpanService } from './ExecutionSpanService';
5
- import { AgentMemoryContextService } from './AgentMemoryContextService';
6
- import { TokenTracker } from './TokenTracker';
7
- import { getAgentExecutionContext, runWithAgentExecutionContext } from './AgentExecutionContext';
8
- import { compileHarness } from './HarnessCompiler';
9
- import type { CompiledHarness, HarnessLayer } from './HarnessCompiler';
10
- import { redactSecretsIn, resolveRunRoleHarness, spilledText } from './harness-runtime-policy';
11
- import { asObject, currentUserId, toPlain, trimText } from '../utils/ctx-utils';
12
-
13
- const WRAP_STATE_KEY = Symbol.for('plugin-agent-orchestrator.nativeSubAgentObserver');
14
- const NATIVE_SOURCE = 'native-plugin-ai';
15
-
16
- type NativeWriter = (chunk: Record<string, unknown>) => unknown;
17
-
18
- type NativeSubAgentTask = {
19
- ctx: {
20
- action?: { params?: { values?: Record<string, unknown> } };
21
- auth?: { user?: { id?: string | number } };
22
- db?: { getRepository?: (name: string) => unknown };
23
- app?: unknown;
24
- };
25
- sessionId: string;
26
- employee: unknown;
27
- model?: unknown;
28
- question: string;
29
- skillSettings?: Record<string, unknown>;
30
- writer?: NativeWriter;
31
- };
32
-
33
- type DispatchToolMessage = {
34
- id?: string | number;
35
- messageId?: string | number;
36
- toolCallId?: string;
37
- sessionId?: string;
38
- status?: string;
39
- invokeStatus?: string;
40
- };
41
-
42
- type SpanRecord = {
43
- id?: string | number;
44
- rootRunId?: string;
45
- metadata?: Record<string, unknown>;
46
- };
47
-
48
- type ToolSpanState = {
49
- spanId?: string | number;
50
- startedAt: number;
51
- ready: Promise<void>;
52
- };
53
-
54
- type RunState = {
55
- rootRunId: string;
56
- rootSpanId?: string | number;
57
- rootStartedAt: number;
58
- rootMetadata: Record<string, unknown>;
59
- parentSessionId?: string;
60
- subSessionId?: string;
61
- toolCallId?: string;
62
- leaderUsername?: string;
63
- employeeUsername?: string;
64
- userId?: string | number;
65
- policy: CompiledHarness;
66
- toolSpans: Map<string, ToolSpanState>;
67
- pending: Set<Promise<void>>;
68
- };
69
-
70
- type DispatcherWithRun = {
71
- run: (task: NativeSubAgentTask) => Promise<string>;
72
- [WRAP_STATE_KEY]?: {
73
- originalRun: (task: NativeSubAgentTask) => Promise<string>;
74
- wrappedRun: (task: NativeSubAgentTask) => Promise<string>;
75
- };
76
- };
77
-
78
- function readValue(record: unknown, key: string) {
79
- const model = record as { get?: (name: string) => unknown; [key: string]: unknown };
80
- return typeof model?.get === 'function' ? model.get(key) : model?.[key];
81
- }
82
-
83
- function normalizeString(value: unknown) {
84
- return typeof value === 'string' ? value.trim() : '';
85
- }
86
-
87
- function modelUsername(model: unknown) {
88
- return (
89
- normalizeString(readValue(model, 'username')) ||
90
- normalizeString(readValue(model, 'aiEmployeeUsername')) ||
91
- normalizeString(readValue(model, 'name')) ||
92
- undefined
93
- );
94
- }
95
-
96
- function makeNativeRunId(parts: Array<string | number | undefined>) {
97
- const source = parts.map((part) => String(part || '')).join('|');
98
- return `native_${createHash('sha1')
99
- .update(source || String(Date.now()))
100
- .digest('hex')
101
- .slice(0, 24)}`;
102
- }
103
-
104
- function errorMessage(error: unknown) {
105
- return error instanceof Error ? error.message : String(error || 'Unknown error');
106
- }
107
-
108
- function chunkBody(chunk: Record<string, unknown>) {
109
- return asObject(chunk.body);
110
- }
111
-
112
- function chunkCurrentConversation(chunk: Record<string, unknown>) {
113
- return asObject(chunk.currentConversation);
114
- }
115
-
116
- function readSkillExecutionId(result: Record<string, unknown>): string | number | undefined {
117
- const nestedResult = asObject(result.result);
118
- const direct = nestedResult.execId || result.execId;
119
- if (typeof direct === 'string' || typeof direct === 'number') return direct;
120
-
121
- if (typeof result.content !== 'string') return undefined;
122
- try {
123
- const content = asObject(JSON.parse(result.content));
124
- return typeof content.execId === 'string' || typeof content.execId === 'number' ? content.execId : undefined;
125
- } catch {
126
- return undefined;
127
- }
128
- }
129
-
130
- export class NativeSubAgentObserver {
131
- private readonly spanService: ExecutionSpanService;
132
- private readonly memoryService: AgentMemoryContextService;
133
- private readonly tokenTracker: TokenTracker;
134
-
135
- constructor(private readonly plugin: { app: any; db: any; name?: string }) {
136
- this.spanService = new ExecutionSpanService(plugin);
137
- this.memoryService = new AgentMemoryContextService(plugin);
138
- this.tokenTracker = new TokenTracker(plugin);
139
- }
140
-
141
- install() {
142
- const aiPlugin = this.plugin.app.pm?.get?.('ai');
143
- const dispatcher = aiPlugin?.subAgentsDispatcher as DispatcherWithRun | undefined;
144
- if (!dispatcher?.run) {
145
- this.plugin.app.logger?.warn?.(
146
- '[AgentOrchestrator] plugin-ai subAgentsDispatcher not available; observer skipped.',
147
- );
148
- return false;
149
- }
150
-
151
- const existing = dispatcher[WRAP_STATE_KEY];
152
- if (existing?.wrappedRun === dispatcher.run) {
153
- return false;
154
- }
155
-
156
- const originalRun = existing?.originalRun || dispatcher.run.bind(dispatcher);
157
- const observer = this;
158
- const wrappedRun = async function wrappedNativeSubAgentRun(task: NativeSubAgentTask) {
159
- return observer.runObserved(originalRun, task);
160
- };
161
-
162
- dispatcher.run = wrappedRun;
163
- dispatcher[WRAP_STATE_KEY] = {
164
- originalRun,
165
- wrappedRun,
166
- };
167
-
168
- this.plugin.app.logger?.info?.('[AgentOrchestrator] Native plugin-ai sub-agent observer installed.');
169
- return true;
170
- }
171
-
172
- uninstall() {
173
- const aiPlugin = this.plugin.app.pm?.get?.('ai');
174
- const dispatcher = aiPlugin?.subAgentsDispatcher as DispatcherWithRun | undefined;
175
- const existing = dispatcher?.[WRAP_STATE_KEY];
176
- if (!dispatcher?.run || !existing || existing.wrappedRun !== dispatcher.run) {
177
- return false;
178
- }
179
-
180
- dispatcher.run = existing.originalRun;
181
- delete dispatcher[WRAP_STATE_KEY];
182
- this.plugin.app.logger?.info?.('[AgentOrchestrator] Native plugin-ai sub-agent observer uninstalled.');
183
- return true;
184
- }
185
-
186
- private async runObserved(originalRun: (task: NativeSubAgentTask) => Promise<string>, task: NativeSubAgentTask) {
187
- const settings = await this.safeResolvePolicy(task);
188
- if (settings.nativeObserverEnabled === false) {
189
- return originalRun(task);
190
- }
191
-
192
- const parentSessionId = this.resolveParentSessionId(task) || undefined;
193
- const parentConversation = await this.safeFindParentConversation(task.ctx, parentSessionId);
194
- const parentRunId = this.controlPlaneRunIdOf(parentConversation);
195
- // A sub-agent dispatched from a loop session inherits the role's frozen harness as an extra
196
- // compile layer, so delegation caps, sharing and memory restrictions do not reset at the hop.
197
- const parentRunHarness = parentRunId
198
- ? await this.safeResolveParentRunHarness(
199
- parentRunId,
200
- normalizeString(readValue(parentConversation, 'aiEmployeeUsername')),
201
- )
202
- : null;
203
- const policy = this.compilePolicy(settings, parentRunHarness);
204
- const spansEnabled = policy.observability.sharing !== 'disabled';
205
-
206
- const subSessionId = normalizeString(task.sessionId) || undefined;
207
- const employeeUsername = modelUsername(task.employee);
208
- const userId = currentUserId(task.ctx) || task.ctx?.auth?.user?.id;
209
- const dispatchToolMessage = await this.resolveDispatchToolMessage(task.ctx, parentSessionId, subSessionId);
210
- const toolCallId = dispatchToolMessage?.toolCallId;
211
- const leaderUsername = this.leaderUsernameFor(task.ctx, parentConversation);
212
- const rootRunId = makeNativeRunId([parentSessionId, subSessionId, toolCallId, employeeUsername]);
213
- const delegation = await this.resolveDelegationContext(parentSessionId);
214
- const childDepth = delegation.depth + 1;
215
- const memory = await this.safeBuildMemoryContext({
216
- userId,
217
- aiEmployeeUsername: employeeUsername,
218
- settings,
219
- });
220
- const observedTask: NativeSubAgentTask = {
221
- ...task,
222
- // Native dispatch passes the leader conversation's skillSettings to the
223
- // sub-agent. Clear that inherited filter so plugin-ai resolves tools from
224
- // the sub-agent employee's own bindings instead.
225
- skillSettings: undefined,
226
- question: memory.context ? `${memory.context}\n\n<agent_task>\n${task.question}\n</agent_task>` : task.question,
227
- };
228
-
229
- const state: RunState = {
230
- rootRunId,
231
- rootStartedAt: Date.now(),
232
- rootMetadata: {
233
- source: NATIVE_SOURCE,
234
- parentSessionId,
235
- subSessionId,
236
- toolCallId,
237
- dispatchToolMessageId: dispatchToolMessage?.id,
238
- dispatchMessageId: dispatchToolMessage?.messageId,
239
- memoryContextApplied: Boolean(memory.context),
240
- memoryScopes: memory.appliedScopes,
241
- memoryContextChars: memory.chars,
242
- harnessTag: settings.harnessTag || 'default',
243
- ...(parentRunId ? { agentLoopRunId: parentRunId } : {}),
244
- },
245
- parentSessionId,
246
- subSessionId,
247
- toolCallId,
248
- leaderUsername,
249
- employeeUsername,
250
- userId,
251
- policy,
252
- toolSpans: new Map(),
253
- pending: new Set(),
254
- };
255
-
256
- if (spansEnabled) {
257
- await this.safeCreateRootSpan(state, task.question, {
258
- depth: childDepth,
259
- parentSpanId: delegation.parentSpanId,
260
- agentLoopRunId: parentRunId,
261
- });
262
- }
263
-
264
- // Depth is persisted on the span, not carried in-process, so a resumed child arrives with its
265
- // true depth. The cap comes from the compiled policy, which includes the inherited parent
266
- // layer; exceeding it fails the dispatch instead of silently deepening the recursion.
267
- const maxDepth = policy.delegation.maxDepth;
268
- if (maxDepth !== null && childDepth > maxDepth) {
269
- const message = `Sub-agent delegation depth ${childDepth} exceeds the harness limit of ${maxDepth}.`;
270
- await this.spanService.finish(state.rootSpanId, 'error', state.rootStartedAt, {
271
- error: message,
272
- metadata: {
273
- ...state.rootMetadata,
274
- failedAt: new Date().toISOString(),
275
- },
276
- });
277
- throw new Error(message);
278
- }
279
-
280
- const originalWriter = task.writer;
281
- observedTask.writer = (chunk: Record<string, unknown>) => {
282
- const pending = this.handleWriterChunk(state, chunk).catch((error) => {
283
- this.plugin.app.logger?.warn?.('[AgentOrchestrator] Native writer observer failed', error);
284
- });
285
- state.pending.add(pending);
286
- return originalWriter?.(chunk);
287
- };
288
-
289
- try {
290
- const rawResult = await runWithAgentExecutionContext(
291
- {
292
- rootRunId,
293
- spanId: state.rootSpanId ? String(state.rootSpanId) : undefined,
294
- toolCallId,
295
- leaderUsername,
296
- employeeUsername,
297
- sessionId: subSessionId,
298
- },
299
- () => this.runWithKnowledgeBaseAgentContext(employeeUsername, () => originalRun(observedTask)),
300
- );
301
- const result = this.spillLargeResult(state, rawResult);
302
- await this.flushPending(state);
303
- const capturedOutput = this.spanOutput(state, trimText(result, 20000));
304
- await this.spanService.finish(state.rootSpanId, 'success', state.rootStartedAt, {
305
- ...(capturedOutput !== undefined ? { output: capturedOutput } : {}),
306
- metadata: {
307
- ...state.rootMetadata,
308
- completedAt: new Date().toISOString(),
309
- },
310
- });
311
- await this.tokenTracker.estimateAndTrack(
312
- state.rootSpanId,
313
- task.question,
314
- result,
315
- state.rootMetadata.agentLoopRunId ? Number(state.rootMetadata.agentLoopRunId) : undefined,
316
- );
317
- return result;
318
- } catch (error) {
319
- await this.flushPending(state);
320
- const capturedError = this.spanOutput(state, trimText(errorMessage(error), 10000));
321
- await this.spanService.finish(state.rootSpanId, 'error', state.rootStartedAt, {
322
- ...(capturedError !== undefined ? { error: capturedError } : {}),
323
- metadata: {
324
- ...state.rootMetadata,
325
- failedAt: new Date().toISOString(),
326
- },
327
- });
328
- await this.tokenTracker.estimateAndTrack(
329
- state.rootSpanId,
330
- task.question,
331
- errorMessage(error),
332
- state.rootMetadata.agentLoopRunId ? Number(state.rootMetadata.agentLoopRunId) : undefined,
333
- );
334
- throw error;
335
- }
336
- }
337
-
338
- private async safeResolvePolicy(task: NativeSubAgentTask) {
339
- try {
340
- return await this.memoryService.resolvePolicySettings(task);
341
- } catch (error) {
342
- this.plugin.app.logger?.warn?.('[AgentOrchestrator] Failed to resolve native observer policy', error);
343
- return { harnessTag: 'default' };
344
- }
345
- }
346
-
347
- // Span payload gates: inputs are captured only under 'full' sharing, outputs under 'full' or
348
- // 'feedback-only'. Redaction scrubs secret-looking keys on whatever is captured; free text is
349
- // deliberately left alone.
350
- private spanInput(state: RunState, input: Record<string, unknown>): Record<string, unknown> | undefined {
351
- const observability = state.policy.observability;
352
- if (observability.sharing !== 'full' || !observability.captureInputs) return undefined;
353
- return observability.redactSecrets ? redactSecretsIn(input) : input;
354
- }
355
-
356
- private spanOutput(state: RunState, output: unknown): unknown | undefined {
357
- const observability = state.policy.observability;
358
- if (observability.sharing === 'disabled' || !observability.captureOutputs) return undefined;
359
- return observability.redactSecrets ? redactSecretsIn(output) : output;
360
- }
361
-
362
- // Resolved settings are a raw profile record plus the harnessTag marker; the marker is not a
363
- // schema field. On any compile trouble fall back to an empty (all-default) harness so the
364
- // safety defaults — redaction on, sharing full — still govern the spans.
365
- private compilePolicy(settings: Record<string, unknown>, parentRunHarness: CompiledHarness | null): CompiledHarness {
366
- const tag =
367
- typeof settings.harnessTag === 'string' && settings.harnessTag.trim() ? settings.harnessTag.trim() : 'default';
368
- const { harnessTag: _harnessTag, ...rest } = settings;
369
- try {
370
- const layers: HarnessLayer[] = [];
371
- if (parentRunHarness) {
372
- // `sources` is a compiler artifact the strict schema rejects, so it is stripped before the
373
- // compiled parent harness is re-used as a layer. Most-restrictive-wins then carries the
374
- // parent's delegation caps, sharing mode and memory limits into the child.
375
- const { sources, ...inherited } = parentRunHarness;
376
- layers.push({ source: `run-role:${sources.join('+') || 'snapshot'}`, settings: inherited });
377
- }
378
- layers.push({ source: `profile:${tag}`, settings: rest });
379
- return compileHarness(layers);
380
- } catch (error) {
381
- this.plugin.app.logger?.warn?.('[AgentOrchestrator] Failed to compile observer harness policy', error);
382
- return compileHarness([{ source: 'default', settings: {} }]);
383
- }
384
- }
385
-
386
- // Oversized sub-agent results are stored on disk and replaced by a head/tail preview plus the
387
- // file path, so the parent conversation can read the full text back with its file tools.
388
- // Best effort: a spill failure keeps the original result inline.
389
- private spillLargeResult(state: RunState, result: string): string {
390
- const maxInlineBytes = state.policy.context.spill.maxInlineBytes;
391
- if (!maxInlineBytes || typeof result !== 'string') return result;
392
- try {
393
- const spillDir = resolve(process.cwd(), 'storage', 'plugin-agent-orchestrator', 'spills');
394
- mkdirSync(spillDir, { recursive: true });
395
- const spillPath = resolve(spillDir, `${state.rootRunId}-${Date.now()}.txt`);
396
- const replaced = spilledText(result, maxInlineBytes, spillPath);
397
- if (!replaced) return result;
398
- writeFileSync(spillPath, result, 'utf8');
399
- return replaced;
400
- } catch (error) {
401
- this.plugin.app.logger?.warn?.('[AgentOrchestrator] Sub-agent result spill failed', error);
402
- return result;
403
- }
404
- }
405
-
406
- private async safeBuildMemoryContext(options: {
407
- userId?: string | number;
408
- aiEmployeeUsername?: string;
409
- settings: Record<string, unknown>;
410
- }) {
411
- try {
412
- return await this.memoryService.buildContext(options);
413
- } catch (error) {
414
- this.plugin.app.logger?.warn?.('[AgentOrchestrator] Failed to build agent memory context', error);
415
- return { context: '', appliedScopes: [] as string[], chars: 0 };
416
- }
417
- }
418
-
419
- private async safeCreateRootSpan(
420
- state: RunState,
421
- question: string,
422
- delegationInfo: { depth: number; parentSpanId?: string; agentLoopRunId?: number },
423
- ) {
424
- const span = (await this.spanService.create({
425
- rootRunId: state.rootRunId,
426
- parentSpanId: delegationInfo.parentSpanId,
427
- depth: delegationInfo.depth,
428
- agentLoopRunId: delegationInfo.agentLoopRunId,
429
- source: NATIVE_SOURCE,
430
- parentSessionId: state.parentSessionId,
431
- subSessionId: state.subSessionId,
432
- toolCallId: state.toolCallId,
433
- type: 'sub_agent',
434
- status: 'running',
435
- leaderUsername: state.leaderUsername,
436
- employeeUsername: state.employeeUsername,
437
- toolName: 'dispatch-sub-agent-task',
438
- title: `${state.leaderUsername || 'main'} -> ${state.employeeUsername || 'sub-agent'}`,
439
- input: this.spanInput(state, {
440
- question,
441
- parentSessionId: state.parentSessionId,
442
- subSessionId: state.subSessionId,
443
- }),
444
- metadata: state.rootMetadata,
445
- userId: state.userId,
446
- })) as SpanRecord | null;
447
-
448
- state.rootSpanId = span?.id;
449
- }
450
-
451
- private runWithKnowledgeBaseAgentContext<T>(employeeUsername: string | undefined, fn: () => Promise<T>) {
452
- if (!employeeUsername) return fn();
453
- const knowledgeBasePlugin = this.plugin.app.pm?.get?.('plugin-knowledge-base') as
454
- | { runWithAgentContext?: <TResult>(username: string, callback: () => Promise<TResult>) => Promise<TResult> }
455
- | undefined;
456
- return knowledgeBasePlugin?.runWithAgentContext
457
- ? knowledgeBasePlugin.runWithAgentContext(employeeUsername, fn)
458
- : fn();
459
- }
460
-
461
- private async handleWriterChunk(state: RunState, chunk: Record<string, unknown>) {
462
- const action = chunk.action;
463
- if (action === 'beforeToolCall') {
464
- await this.handleBeforeToolCall(state, chunk);
465
- return;
466
- }
467
- if (action === 'afterToolCall') {
468
- await this.handleAfterToolCall(state, chunk, false);
469
- return;
470
- }
471
- if (action === 'afterToolCallError') {
472
- await this.handleAfterToolCall(state, chunk, true);
473
- return;
474
- }
475
- if (action === 'afterSubAgentInvoke') {
476
- state.rootMetadata = {
477
- ...state.rootMetadata,
478
- afterSubAgentInvokeAt: new Date().toISOString(),
479
- };
480
- await this.spanService.update(state.rootSpanId, { metadata: state.rootMetadata });
481
- }
482
- }
483
-
484
- private async handleBeforeToolCall(state: RunState, chunk: Record<string, unknown>) {
485
- if (state.policy.observability.sharing === 'disabled') return;
486
- const body = chunkBody(chunk);
487
- const toolCall = asObject(body.toolCall);
488
- const toolCallId = normalizeString(toolCall.id);
489
- if (!toolCallId || state.toolSpans.has(toolCallId)) return;
490
-
491
- const conversation = chunkCurrentConversation(chunk);
492
- const startedAt = Date.now();
493
- const toolSpan: ToolSpanState = {
494
- startedAt,
495
- ready: Promise.resolve(),
496
- };
497
- state.toolSpans.set(toolCallId, toolSpan);
498
-
499
- const toolName = normalizeString(toolCall.name);
500
- toolSpan.ready = this.spanService
501
- .create({
502
- rootRunId: state.rootRunId,
503
- parentSpanId: state.rootSpanId ? String(state.rootSpanId) : undefined,
504
- source: NATIVE_SOURCE,
505
- parentSessionId: state.parentSessionId || undefined,
506
- subSessionId: normalizeString(conversation.sessionId) || state.subSessionId || undefined,
507
- toolCallId,
508
- type:
509
- toolName === 'dispatch-sub-agent-task'
510
- ? 'dispatch'
511
- : toolName === 'skill_hub_execute' || toolName.startsWith('skill_hub_')
512
- ? 'skill'
513
- : 'tool',
514
- status: 'running',
515
- leaderUsername: state.leaderUsername,
516
- employeeUsername: normalizeString(conversation.username) || state.employeeUsername,
517
- toolName,
518
- title: toolName || 'tool call',
519
- input: this.spanInput(state, asObject(toolCall.args)),
520
- metadata: {
521
- source: NATIVE_SOURCE,
522
- currentConversation: conversation,
523
- messageId: toolCall.messageId,
524
- },
525
- userId: state.userId,
526
- })
527
- .then((span) => {
528
- toolSpan.spanId = (span as SpanRecord | null)?.id;
529
- });
530
-
531
- await toolSpan.ready;
532
- }
533
-
534
- private async handleAfterToolCall(state: RunState, chunk: Record<string, unknown>, forceError: boolean) {
535
- const body = chunkBody(chunk);
536
- const toolCall = asObject(body.toolCall);
537
- const toolCallId = normalizeString(toolCall.id);
538
- const existing = toolCallId ? state.toolSpans.get(toolCallId) : undefined;
539
- if (!existing) return;
540
- await existing.ready;
541
-
542
- const result = asObject(toPlain(body.toolCallResult));
543
- const error = body.error;
544
- const status = forceError || result.status === 'error' ? 'error' : 'success';
545
- const output = result.content ?? result.result ?? result;
546
- const toolName = normalizeString(toolCall.name);
547
- const skillExecutionId =
548
- toolName === 'skill_hub_execute' || toolName.startsWith('skill_hub_') ? readSkillExecutionId(result) : undefined;
549
- const invokeStart = Number(result.invokeStartTime);
550
- const invokeEnd = Number(result.invokeEndTime);
551
- const durationMs =
552
- Number.isFinite(invokeStart) && Number.isFinite(invokeEnd) && invokeEnd >= invokeStart
553
- ? invokeEnd - invokeStart
554
- : Date.now() - existing.startedAt;
555
-
556
- await this.spanService.update(existing.spanId, {
557
- status,
558
- endedAt: new Date(),
559
- durationMs,
560
- output: forceError ? undefined : this.spanOutput(state, trimText(output, 20000)),
561
- error: forceError ? this.spanOutput(state, trimText(errorMessage(error), 10000)) : undefined,
562
- skillExecutionId,
563
- metadata: {
564
- source: NATIVE_SOURCE,
565
- toolCallResultStatus: result.status,
566
- invokeStatus: result.invokeStatus,
567
- messageId: toolCall.messageId,
568
- },
569
- });
570
-
571
- if (skillExecutionId && existing.spanId) {
572
- await this.linkExecutionToSpan(skillExecutionId, existing.spanId);
573
- }
574
-
575
- await this.tokenTracker.estimateAndTrack(
576
- existing.spanId,
577
- normalizeString(toolCall.name),
578
- typeof output === 'string' ? output : JSON.stringify(output),
579
- );
580
- }
581
-
582
- private async linkExecutionToSpan(skillExecutionId: string | number, spanId: string | number) {
583
- try {
584
- const repo = this.plugin.db.getRepository('skillExecutions');
585
- if (!repo) return;
586
- await repo.update({
587
- filterByTk: skillExecutionId,
588
- values: { orchestratorSpanId: spanId },
589
- });
590
- } catch (error) {
591
- this.plugin.app.logger?.warn?.('[AgentOrchestrator] Failed to link skill execution to native span', error);
592
- }
593
- }
594
-
595
- private resolveParentSessionId(task: NativeSubAgentTask) {
596
- const values = task.ctx?.action?.params?.values || {};
597
- return normalizeString(values.sessionId) || undefined;
598
- }
599
-
600
- private leaderUsernameFor(ctx: NativeSubAgentTask['ctx'], parentConversation: unknown) {
601
- const values = ctx?.action?.params?.values || {};
602
- const direct =
603
- normalizeString(values.aiEmployeeUsername) ||
604
- normalizeString((asObject(values.aiEmployee) as Record<string, unknown>).username);
605
- return direct || normalizeString(readValue(parentConversation, 'aiEmployeeUsername')) || undefined;
606
- }
607
-
608
- private async safeFindParentConversation(ctx: NativeSubAgentTask['ctx'], parentSessionId?: string) {
609
- if (!parentSessionId) return null;
610
- try {
611
- const repo = ctx.db?.getRepository?.('aiConversations') as
612
- | { findOne?: (options: Record<string, unknown>) => Promise<unknown> }
613
- | undefined;
614
- const conversation = await repo?.findOne?.({ filter: { sessionId: parentSessionId } });
615
- return conversation || null;
616
- } catch {
617
- return null;
618
- }
619
- }
620
-
621
- private controlPlaneRunIdOf(conversation: unknown): number | undefined {
622
- const runId = Number(asObject(readValue(conversation, 'options')).controlPlaneRunId);
623
- return Number.isSafeInteger(runId) && runId > 0 ? runId : undefined;
624
- }
625
-
626
- private async safeResolveParentRunHarness(runId: number, parentUsername: string): Promise<CompiledHarness | null> {
627
- if (!parentUsername) return null;
628
- try {
629
- return await resolveRunRoleHarness(this.plugin.db, runId, parentUsername);
630
- } catch (error) {
631
- this.plugin.app.logger?.warn?.('[AgentOrchestrator] Failed to resolve parent run harness for delegation', error);
632
- return null;
633
- }
634
- }
635
-
636
- // The parent's persisted span is the authoritative depth source: it was recorded when the
637
- // parent itself was dispatched, so a resumed child arrives with its true depth even though its
638
- // in-process context is fresh. The runtime context can only confirm or deepen the count, never
639
- // lower it.
640
- private async resolveDelegationContext(parentSessionId?: string): Promise<{ parentSpanId?: string; depth: number }> {
641
- const candidates: Array<{ id?: string | number; depth?: unknown }> = [];
642
- const context = getAgentExecutionContext();
643
- if (context?.spanId) {
644
- const span = await this.safeFindSpan({ filterByTk: context.spanId });
645
- if (span) candidates.push(span);
646
- }
647
- if (parentSessionId) {
648
- const span = await this.safeFindSpan({
649
- filter: { subSessionId: parentSessionId, type: 'sub_agent' },
650
- sort: ['-id'],
651
- });
652
- if (span) candidates.push(span);
653
- }
654
- const depth = candidates.reduce((deepest, span) => Math.max(deepest, Number(span.depth) || 0), 0);
655
- const parentSpanId = candidates.find((span) => span.id !== undefined)?.id;
656
- return { parentSpanId: parentSpanId === undefined ? undefined : String(parentSpanId), depth };
657
- }
658
-
659
- private async safeFindSpan(
660
- options: Record<string, unknown>,
661
- ): Promise<{ id?: string | number; depth?: unknown } | null> {
662
- try {
663
- const repo = this.plugin.db.getRepository('agentExecutionSpans');
664
- if (!repo || typeof repo.findOne !== 'function') return null;
665
- return ((await repo.findOne(options)) as { id?: string | number; depth?: unknown } | null) || null;
666
- } catch (error) {
667
- this.plugin.app.logger?.warn?.('[AgentOrchestrator] Failed to resolve delegation parent span', error);
668
- return null;
669
- }
670
- }
671
-
672
- private async resolveDispatchToolMessage(
673
- ctx: NativeSubAgentTask['ctx'],
674
- parentSessionId?: string,
675
- subSessionId?: string,
676
- ) {
677
- if (!parentSessionId) return null;
678
- try {
679
- const fromMetadata = await this.resolveDispatchToolMessageFromMetadata(ctx, parentSessionId, subSessionId);
680
- if (fromMetadata) {
681
- return fromMetadata;
682
- }
683
-
684
- const repo = ctx.db?.getRepository?.('aiToolMessages') as
685
- | { findOne?: (options: Record<string, unknown>) => Promise<unknown> }
686
- | undefined;
687
- const record = await repo?.findOne?.({
688
- filter: {
689
- sessionId: parentSessionId,
690
- toolName: 'dispatch-sub-agent-task',
691
- invokeStatus: {
692
- $ne: 'confirmed',
693
- },
694
- },
695
- sort: ['-id'],
696
- });
697
- return toPlain(record) as DispatchToolMessage | null;
698
- } catch {
699
- return null;
700
- }
701
- }
702
-
703
- private async resolveDispatchToolMessageFromMetadata(
704
- ctx: NativeSubAgentTask['ctx'],
705
- parentSessionId?: string,
706
- subSessionId?: string,
707
- ) {
708
- if (!parentSessionId || !subSessionId) return null;
709
-
710
- const messageRepo = ctx.db?.getRepository?.('aiMessages') as
711
- | { find?: (options: Record<string, unknown>) => Promise<unknown[]> }
712
- | undefined;
713
- const toolRepo = ctx.db?.getRepository?.('aiToolMessages') as
714
- | { findOne?: (options: Record<string, unknown>) => Promise<unknown> }
715
- | undefined;
716
- const messages = await messageRepo?.find?.({
717
- filter: { sessionId: parentSessionId },
718
- sort: ['-messageId'],
719
- limit: 20,
720
- });
721
- if (!Array.isArray(messages)) return null;
722
-
723
- for (const rawMessage of messages) {
724
- const message = toPlain(rawMessage);
725
- const conversations = asObject(message?.metadata).subAgentConversations;
726
- if (!Array.isArray(conversations)) continue;
727
-
728
- const matched = conversations.find((item) => normalizeString(item?.sessionId) === subSessionId);
729
- const toolCallId = normalizeString(matched?.toolCallId);
730
- if (!toolCallId) continue;
731
-
732
- const toolMessage = await toolRepo?.findOne?.({
733
- filter: {
734
- sessionId: parentSessionId,
735
- toolCallId,
736
- },
737
- });
738
- return {
739
- ...(toPlain(toolMessage) || {}),
740
- toolCallId,
741
- messageId: readValue(toolMessage, 'messageId') || message?.messageId,
742
- sessionId: parentSessionId,
743
- status: matched?.status,
744
- } as DispatchToolMessage;
745
- }
746
-
747
- return null;
748
- }
749
-
750
- private async flushPending(state: RunState) {
751
- const pending = Array.from(state.pending);
752
- if (!pending.length) return;
753
- await Promise.allSettled(pending);
754
- }
755
- }
756
-
757
- export { NATIVE_SOURCE, makeNativeRunId };
1
+ // SPDX-License-Identifier: Apache-2.0
2
+
3
+ import { createHash } from 'crypto';
4
+ import { ExecutionSpanService } from './ExecutionSpanService';
5
+ import { AgentMemoryContextService } from './AgentMemoryContextService';
6
+ import { asObject } from '../utils/ctx-utils';
7
+
8
+ export const NATIVE_SOURCE = 'native-plugin-ai';
9
+ const WRAP_STATE_KEY = Symbol.for('plugin-agent-orchestrator.nativeSubAgentObserver');
10
+
11
+ type NativeRepository = {
12
+ create: (options: Record<string, unknown>) => Promise<unknown>;
13
+ update: (options: Record<string, unknown>) => Promise<unknown>;
14
+ find?: (options?: Record<string, unknown>) => Promise<unknown[]>;
15
+ findOne?: (options: Record<string, unknown>) => Promise<unknown>;
16
+ };
17
+
18
+ type NativeContext = {
19
+ action?: { params?: { values?: Record<string, unknown> } };
20
+ auth?: { user?: { id?: string | number } };
21
+ db?: { getRepository?: (name: string) => NativeRepository | undefined };
22
+ };
23
+
24
+ type NativeSubAgentTask = {
25
+ ctx: NativeContext;
26
+ sessionId: string;
27
+ employee: unknown;
28
+ model?: unknown;
29
+ question: string;
30
+ skillSettings?: Record<string, unknown>;
31
+ writer?: (chunk: Record<string, unknown>) => unknown;
32
+ };
33
+
34
+ type DispatcherWithRun = {
35
+ run: (task: NativeSubAgentTask) => Promise<string>;
36
+ [WRAP_STATE_KEY]?: {
37
+ originalRun: (task: NativeSubAgentTask) => Promise<string>;
38
+ wrappedRun: (task: NativeSubAgentTask) => Promise<string>;
39
+ };
40
+ };
41
+
42
+ type ObserverPlugin = {
43
+ app: {
44
+ logger?: {
45
+ info?: (
46
+ message: string,
47
+ meta?: { module?: string; submodule?: string; method?: string; [key: string]: unknown },
48
+ ) => void;
49
+ warn?: (
50
+ message: string,
51
+ meta?: { module?: string; submodule?: string; method?: string; [key: string]: unknown },
52
+ ) => void;
53
+ };
54
+ pm?: { get?: (name: string) => unknown };
55
+ };
56
+ db: { getRepository: (name: string) => NativeRepository | undefined };
57
+ };
58
+
59
+ type ObserverSettings = {
60
+ nativeObserverEnabled?: boolean;
61
+ harnessTag?: string;
62
+ observability?: {
63
+ enabled?: boolean;
64
+ sharing?: string;
65
+ };
66
+ };
67
+
68
+ function objectValue(value: unknown) {
69
+ return value && typeof value === 'object' && !Array.isArray(value) ? (value as Record<string, unknown>) : {};
70
+ }
71
+
72
+ function readValue(record: unknown, key: string) {
73
+ const model = record as { get?: (name: string) => unknown; [name: string]: unknown };
74
+ return typeof model?.get === 'function' ? model.get(key) : model?.[key];
75
+ }
76
+
77
+ function stringValue(value: unknown) {
78
+ return typeof value === 'string' ? value.trim() : '';
79
+ }
80
+
81
+ function makeNativeRunId(parts: Array<string | number | undefined>) {
82
+ const source = parts.map((part) => String(part || '')).join('|');
83
+ return (
84
+ 'native_' +
85
+ createHash('sha1')
86
+ .update(source || String(Date.now()))
87
+ .digest('hex')
88
+ .slice(0, 24)
89
+ );
90
+ }
91
+
92
+ function errorText(error: unknown) {
93
+ try {
94
+ return error instanceof Error ? error.message : String(error || 'Unknown error');
95
+ } catch {
96
+ return 'Unknown error';
97
+ }
98
+ }
99
+
100
+ function rowAsObject(value: unknown) {
101
+ const record = value as { toJSON?: () => unknown };
102
+ const resolved = typeof record?.toJSON === 'function' ? record.toJSON() : value;
103
+ return objectValue(resolved);
104
+ }
105
+
106
+ export class NativeSubAgentObserver {
107
+ private readonly spanService: ExecutionSpanService;
108
+ private readonly policyService: AgentMemoryContextService;
109
+
110
+ constructor(private readonly plugin: ObserverPlugin) {
111
+ this.spanService = new ExecutionSpanService(plugin);
112
+ this.policyService = new AgentMemoryContextService(plugin);
113
+ }
114
+
115
+ install() {
116
+ const aiPlugin = this.plugin.app.pm?.get?.('ai');
117
+ const dispatcher = objectValue(aiPlugin).subAgentsDispatcher as DispatcherWithRun | undefined;
118
+ if (!dispatcher?.run) {
119
+ this.warn('[AgentOrchestrator] plugin-ai subAgentsDispatcher not available; observer skipped.');
120
+ return false;
121
+ }
122
+
123
+ const existing = dispatcher[WRAP_STATE_KEY];
124
+ if (existing?.wrappedRun === dispatcher.run) return false;
125
+
126
+ const originalRun = existing?.originalRun || dispatcher.run.bind(dispatcher);
127
+ const observer = this;
128
+ const wrappedRun = async function wrappedNativeSubAgentRun(task: NativeSubAgentTask) {
129
+ return observer.runObserved(originalRun, task);
130
+ };
131
+
132
+ dispatcher.run = wrappedRun;
133
+ dispatcher[WRAP_STATE_KEY] = { originalRun, wrappedRun };
134
+ this.info('[AgentOrchestrator] Native plugin-ai sub-agent observer installed.');
135
+ return true;
136
+ }
137
+
138
+ uninstall() {
139
+ const aiPlugin = this.plugin.app.pm?.get?.('ai');
140
+ const dispatcher = objectValue(aiPlugin).subAgentsDispatcher as DispatcherWithRun | undefined;
141
+ const existing = dispatcher?.[WRAP_STATE_KEY];
142
+ if (!dispatcher?.run || !existing || existing.wrappedRun !== dispatcher.run) return false;
143
+
144
+ dispatcher.run = existing.originalRun;
145
+ delete dispatcher[WRAP_STATE_KEY];
146
+ this.info('[AgentOrchestrator] Native plugin-ai sub-agent observer uninstalled.');
147
+ return true;
148
+ }
149
+
150
+ private async runObserved(originalRun: (task: NativeSubAgentTask) => Promise<string>, task: NativeSubAgentTask) {
151
+ const startedAt = Date.now();
152
+ try {
153
+ // Preserve the native task object, writer, prompt, skill settings, and result exactly.
154
+ const result = await originalRun(task);
155
+ this.observeDispatch(task, 'success', startedAt).catch((error) => {
156
+ this.warn('[AgentOrchestrator] Native dispatch telemetry failed; continuing native execution.', error);
157
+ });
158
+ return result;
159
+ } catch (error) {
160
+ this.observeDispatch(task, 'error', startedAt).catch((telemetryError) => {
161
+ this.warn('[AgentOrchestrator] Native dispatch telemetry failed; continuing native execution.', telemetryError);
162
+ });
163
+ throw error;
164
+ }
165
+ }
166
+
167
+ private async observeDispatch(task: NativeSubAgentTask, status: 'success' | 'error', startedAt: number) {
168
+ try {
169
+ const settings = (await this.policyService.resolvePolicySettings(task)) as ObserverSettings;
170
+ if (settings.nativeObserverEnabled === false || settings.observability?.enabled === false) return;
171
+ if (settings.observability?.sharing === 'disabled') return;
172
+
173
+ const parentSessionId = stringValue(task.ctx?.action?.params?.values?.sessionId);
174
+ const subSessionId = stringValue(task.sessionId);
175
+ const employeeUsername =
176
+ stringValue(readValue(task.employee, 'username')) ||
177
+ stringValue(readValue(task.employee, 'aiEmployeeUsername')) ||
178
+ stringValue(readValue(task.employee, 'name')) ||
179
+ undefined;
180
+ const dispatch = await this.resolveDispatch(parentSessionId, subSessionId, task.ctx.db);
181
+ const toolCallId = dispatch?.toolCallId;
182
+ if (!parentSessionId || !subSessionId || !toolCallId) return;
183
+
184
+ const parentConversation = await this.findOne(task.ctx.db, 'aiConversations', {
185
+ filter: { sessionId: parentSessionId },
186
+ });
187
+ const parentSpan = await this.findParentSpan(parentConversation, parentSessionId);
188
+ // If the main projection is not yet available, let reconciliation link this call later;
189
+ // inventing a root here can race a valid legacy control-plane association.
190
+ if (!parentSpan) return;
191
+ const rootRunId = stringValue(parentSpan.rootRunId);
192
+ if (!rootRunId) return;
193
+ const parentSpanId = parentSpan?.id === undefined ? undefined : String(parentSpan.id);
194
+ const endedAt = new Date();
195
+ const nativeIdentity = 'native:tool-call:' + toolCallId;
196
+ const span = await this.spanService.upsertNative(nativeIdentity, {
197
+ nativeIdentity,
198
+ rootRunId,
199
+ parentSpanId,
200
+ depth: Number(parentSpan?.depth) + 1 || 1,
201
+ source: NATIVE_SOURCE,
202
+ parentSessionId,
203
+ subSessionId,
204
+ toolCallId,
205
+ type: 'sub_agent',
206
+ status: status === 'error' ? 'error' : 'unknown',
207
+ leaderUsername: stringValue(readValue(parentConversation, 'aiEmployeeUsername')) || undefined,
208
+ employeeUsername,
209
+ toolName: 'dispatch-sub-agent-task',
210
+ title: 'Native sub-agent dispatch',
211
+ startedAt: new Date(startedAt),
212
+ endedAt,
213
+ nativeActivityAt: endedAt,
214
+ durationMs: Math.max(0, endedAt.getTime() - startedAt),
215
+ metadata: {
216
+ source: NATIVE_SOURCE,
217
+ nativeCoverage: { source: 'dispatcher-return', realtime: false },
218
+ capturePolicy: {
219
+ source: 'native-persistence-no-invocation-snapshot',
220
+ sharing: 'disabled',
221
+ captureInputs: false,
222
+ captureOutputs: false,
223
+ redactSecrets: true,
224
+ },
225
+ dispatchToolMessageId: dispatch.id,
226
+ dispatchMessageId: dispatch.messageId,
227
+ harnessTag: settings.harnessTag || 'default',
228
+ outcome: status,
229
+ },
230
+ userId: task.ctx.auth?.user?.id,
231
+ });
232
+ if (!span) this.warn('[AgentOrchestrator] Native dispatch telemetry was not persisted.');
233
+ } catch (error) {
234
+ this.warn('[AgentOrchestrator] Native dispatch telemetry failed; continuing native execution.', error);
235
+ }
236
+ }
237
+
238
+ private async resolveDispatch(parentSessionId: string, subSessionId: string, db?: NativeContext['db']) {
239
+ if (!parentSessionId || !subSessionId) return null;
240
+ const messages = await this.findMany(db, 'aiMessages', {
241
+ filter: { sessionId: parentSessionId },
242
+ sort: ['-messageId'],
243
+ limit: 100,
244
+ });
245
+ for (const message of messages) {
246
+ const relations = asObject(readValue(message, 'metadata')).subAgentConversations;
247
+ if (!Array.isArray(relations)) continue;
248
+ const relation = relations.find((value) => stringValue(asObject(value).sessionId) === subSessionId);
249
+ const toolCallId = stringValue(asObject(relation).toolCallId);
250
+ if (toolCallId) {
251
+ return {
252
+ id: undefined,
253
+ messageId: stringValue(readValue(message, 'messageId')),
254
+ toolCallId,
255
+ };
256
+ }
257
+ }
258
+
259
+ const toolMessage = await this.findOne(db, 'aiToolMessages', {
260
+ filter: { sessionId: parentSessionId, toolName: 'dispatch-sub-agent-task' },
261
+ sort: ['-id'],
262
+ });
263
+ const contentSessionId = stringValue(asObject(readValue(toolMessage, 'content')).sessionId);
264
+ return contentSessionId === subSessionId
265
+ ? {
266
+ id: readValue(toolMessage, 'id'),
267
+ messageId: stringValue(readValue(toolMessage, 'messageId')),
268
+ toolCallId: stringValue(readValue(toolMessage, 'toolCallId')),
269
+ }
270
+ : null;
271
+ }
272
+
273
+ private async findParentSpan(parentConversation: Record<string, unknown> | null, parentSessionId: string) {
274
+ const from = stringValue(readValue(parentConversation, 'from'));
275
+ if (from === 'sub-agent') {
276
+ return this.findOne(this.plugin.db, 'agentExecutionSpans', {
277
+ filter: { source: NATIVE_SOURCE, type: 'sub_agent', subSessionId: parentSessionId },
278
+ });
279
+ }
280
+ return this.findOne(this.plugin.db, 'agentExecutionSpans', {
281
+ filter: { source: NATIVE_SOURCE, type: 'main_agent', parentSessionId },
282
+ });
283
+ }
284
+
285
+ private async findOne(
286
+ database: NativeContext['db'] | ObserverPlugin['db'],
287
+ name: string,
288
+ options: Record<string, unknown>,
289
+ ): Promise<Record<string, unknown> | null> {
290
+ try {
291
+ const row = await database?.getRepository?.(name)?.findOne?.(options);
292
+ return row ? rowAsObject(row) : null;
293
+ } catch {
294
+ return null;
295
+ }
296
+ }
297
+
298
+ private async findMany(database: NativeContext['db'] | undefined, name: string, options: Record<string, unknown>) {
299
+ try {
300
+ const rows = await database?.getRepository?.(name)?.find?.(options);
301
+ return Array.isArray(rows) ? rows.map(rowAsObject) : [];
302
+ } catch {
303
+ return [];
304
+ }
305
+ }
306
+
307
+ private info(message: string) {
308
+ try {
309
+ this.plugin.app.logger?.info?.(message);
310
+ } catch {
311
+ // Telemetry logging is best effort.
312
+ }
313
+ }
314
+
315
+ private warn(message: string, error?: unknown) {
316
+ try {
317
+ this.plugin.app.logger?.warn?.(message, { error });
318
+ } catch {
319
+ // Telemetry logging must not affect native execution.
320
+ }
321
+ }
322
+ }
323
+
324
+ export { makeNativeRunId };